Skip to content

Referência de Comandos RPC ​

Referência completa de todos os comandos JSON-RPC da Cloud Service.

Comandos da Blockchain ​

getblockchaininfo ​

Retorna informações sobre o estado da blockchain.

bash
cs-cli getblockchaininfo

Resposta:

json
{
    "chain": "main",
    "blocks": 524288,
    "headers": 524288,
    "bestblockhash": "0000...",
    "difficulty": 12345678.90,
    "mediantime": 1234567890,
    "verificationprogress": 0.999999,
    "pruned": false,
    "chainwork": "0000..."
}

getblockhash ​

Retorna o hash do bloco no índice fornecido.

bash
cs-cli getblockhash 1000

getblock ​

Retorna informações do bloco dado o hash do bloco.

bash
cs-cli getblock "hash_do_bloco"
cs-cli getblock "hash_do_bloco" 2  # Com detalhes completos

getblockcount ​

Retorna o número de blocos na cadeia mais longa.

bash
cs-cli getblockcount

Comandos de Rede ​

getnetworkinfo ​

Retorna informações sobre o estado da rede P2P.

bash
cs-cli getnetworkinfo

getpeerinfo ​

Retorna dados sobre cada nó peer conectado.

bash
cs-cli getpeerinfo

addnode ​

Adiciona manualmente um nó peer.

bash
cs-cli addnode "192.168.1.100:26125" add
cs-cli addnode "192.168.1.100:26125" remove
cs-cli addnode "192.168.1.100:26125" onetry

getconnectioncount ​

Retorna o número de conexões com outros nós.

bash
cs-cli getconnectioncount

Comandos da Carteira ​

getbalance ​

Retorna o saldo total disponível da carteira.

bash
cs-cli getbalance
cs-cli getbalance "*" 6  # Com 6 confirmações mínimas

getnewaddress ​

Gera um novo endereço CS para receber pagamentos.

bash
cs-cli getnewaddress
cs-cli getnewaddress "rótulo"

sendtoaddress ​

Envia uma quantia para um endereço CS fornecido.

bash
cs-cli sendtoaddress "endereço" 10.0
cs-cli sendtoaddress "endereço" 10.0 "comentário" "para"

listtransactions ​

Retorna até 'n' transações mais recentes.

bash
cs-cli listtransactions
cs-cli listtransactions "*" 50  # 50 mais recentes

getwalletinfo ​

Retorna informações sobre a carteira.

bash
cs-cli getwalletinfo

backupwallet ​

Salva o arquivo de carteira atual em um destino.

bash
cs-cli backupwallet "/caminho/para/backup.dat"

importprivkey ​

Importa uma chave privada para a carteira.

bash
cs-cli importprivkey "chave_privada"
cs-cli importprivkey "chave_privada" "rótulo" true  # Com rescan

dumpprivkey ​

Revela a chave privada correspondente a um endereço.

bash
cs-cli dumpprivkey "seu_endereço"

Comandos de Mineração ​

getmininginfo ​

Retorna informações relacionadas à mineração.

bash
cs-cli getmininginfo

Resposta:

json
{
    "blocks": 524288,
    "currentblockweight": 4000,
    "currentblocktx": 0,
    "difficulty": 12345678.90,
    "networkhashps": 1234567890,
    "pooledtx": 5,
    "chain": "main",
    "generate": false
}

setgenerate ​

Ativa ou desativa a geração de hashes (mineração CPU).

bash
cs-cli setgenerate true       # Ativar
cs-cli setgenerate true 4     # Com 4 threads
cs-cli setgenerate false      # Desativar

getblocktemplate ​

Retorna dados necessários para construir um bloco.

bash
cs-cli getblocktemplate

submitblock ​

Tenta enviar um novo bloco à rede.

bash
cs-cli submitblock "bloco_hex_codificado"

Comandos de Transação ​

getrawtransaction ​

Retorna os dados brutos de uma transação.

bash
cs-cli getrawtransaction "txid"
cs-cli getrawtransaction "txid" true  # Decodificado

sendrawtransaction ​

Envia uma transação bruta (serializada e em hex-codificada) à rede local.

bash
cs-cli sendrawtransaction "hex_da_transação"

decoderawtransaction ​

Decodifica uma transação bruta.

bash
cs-cli decoderawtransaction "hex_da_transação"

gettxout ​

Retorna detalhes sobre uma saída de transação não gasta.

bash
cs-cli gettxout "txid" 0

Comandos Utilitários ​

stop ​

Para o servidor da Cloud Service.

bash
cs-cli stop

getinfo ​

Retorna informações gerais sobre o nó (depreciado em versões recentes).

bash
cs-cli getinfo

validateaddress ​

Verifica se um endereço é válido.

bash
cs-cli validateaddress "endereço_cs"

signmessage ​

Assina uma mensagem com a chave privada de um endereço.

bash
cs-cli signmessage "endereço" "mensagem"

verifymessage ​

Verifica uma mensagem assinada.

bash
cs-cli verifymessage "endereço" "assinatura" "mensagem"

Próximos Passos ​

Lançado sob a Licença MIT.