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:16178" add
cs-cli addnode "192.168.1.100:16178" remove
cs-cli addnode "192.168.1.100:16178" 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.