Tipos de Respuesta RPC

Esquemas JSON detallados para todos los objetos de respuesta RPC.

BlockResponse

Devuelto por chain_getBlock, chain_getBlockByNumber, chain_getBlockByHash, chain_getLatestBlock.

{
  "hash": "0a1b2c...",
  "height": 42,
  "timestamp": 1710000000,
  "parent_hash": "ff0011...",
  "state_root": "abc123...",
  "tx_root": "def456...",
  "proposer": "aabbcc...",
  "version": 1,
  "transaction_count": 15
}

Campo	Tipo	Descripción
hash	string	Hash del bloque (hex, 128 chars = 64 bytes SHA-512)
height	u64	Número de bloque
timestamp	u64	Marca de tiempo Unix (segundos)
parent_hash	string	Hash del bloque padre (hex)
state_root	string	Hash de la raíz de estado (hex, 64 chars)
tx_root	string	Hash de la raíz de transacciones (hex, 64 chars)
proposer	string	Clave pública del proponente (hex, 64 chars)
version	u32	Versión del formato de bloque
transaction_count	u64	Número de transacciones en el bloque

AccountResponse

Devuelto por account_getAccount, account_getBalance, account_getNonce.

{
  "address": "aabbcc...",
  "balance": "1000000000000000000",
  "nonce": 5
}

Campo	Tipo	Descripción
address	string	Dirección de la cuenta (hex, 64 chars = clave pública ed25519 de 32 bytes)
balance	string	Saldo en la unidad más pequeña (u128 como string decimal, 18 decimales)
nonce	u64	Nonce actual de la transacción

TransactionResponse

Devuelto por tx_getTransaction.

{
  "hash": "aabbcc...",
  "from": "112233...",
  "to": "445566...",
  "amount": 1000,
  "nonce": 1,
  "fee": 1000000000000000,
  "timestamp": 1710000000,
  "block_height": 42
}

Campo	Tipo	Descripción
hash	string	Hash de la transacción (hex)
from	string	Dirección del remitente (hex)
to	string	Dirección del destinatario (hex)
amount	u64	Monto de la transferencia
nonce	u64	Nonce del remitente en el momento del envío
fee	u128?	Comisión de la transacción (opcional)
timestamp	u64?	Marca de tiempo del bloque si está confirmada
block_height	u64?	Altura del bloque si está confirmada

TransactionReceiptResponse

Devuelto por tx_getTransactionReceipt.

{
  "hash": "aabbcc...",
  "from": "112233...",
  "to": "445566...",
  "amount": 1000,
  "fee": 1000000000000000,
  "block_height": 42,
  "block_hash": "ff0011...",
  "timestamp": 1710000000,
  "status": "confirmed"
}

Valores de estado: "confirmed", "pending", "not_found".

HealthResponse

Devuelto por savitri_health.

{
  "status": "ok",
  "service": "savitri-rpc",
  "mode": "lightnode"
}

Valores de modo: "lightnode", "masternode", "unknown".

PouLocalResponse

Devuelto por pou_getConsensusState / savitri_pouLocal.

{
  "local_score": 750,
  "leader": "12Dxyz...",
  "leader_score": 920,
  "epoch": 15,
  "local_is_leader": false,
  "election_ready": true
}

Campo	Tipo	Descripción
local_score	u16?	Puntuación PoU de este nodo (0-1000)
leader	string?	ID de par del líder actual
leader_score	u16?	Puntuación PoU del líder
epoch	u64?	Número de época actual
local_is_leader	bool	Si este nodo es el líder actual
election_ready	bool	Si puede ejecutarse una elección

PouPeersResponse

Devuelto por savitri_pouPeers.

{
  "peers": {
    "12D3KooW...abc": 750,
    "12D3KooW...def": 820
  }
}

NodeInfoResponse

Devuelto por net_nodeInfo.

{
  "node_id": "12D3KooW...",
  "protocol_version": "1.0.0",
  "network": "savitri-testnet",
  "listening": true,
  "peer_count": 14,
  "block_height": 42,
  "syncing": false,
  "mode": "lightnode"
}

MempoolSizeResponse

Devuelto por mempool_getSize.

{
  "pending": 150,
  "queued": 30
}

TokenInfoResponse

Devuelto por token_getTokenInfo.

{
  "token_id": "savt",
  "name": "Savitri Test Token",
  "symbol": "TEST",
  "decimals": 18,
  "total_supply": "100000000000000000000000000"
}

FaucetClaimResponse

Devuelto por savitri_faucetClaim.

{
  "tx_hash": "0xabc...",
  "amount": "5000000000000000000"
}

El monto es 5 SAVT (5 * 10^18 unidades mínimas).

SyncingResponse

Devuelto por savitri_syncing.

{
  "syncing": true,
  "current_block": 100,
  "highest_block": 500
}

MonolithInfoResponse

Devuelto por savitri_getMonolithHead.

{
  "exec_height": 1000,
  "window_start": 900,
  "epoch_id": 5,
  "block_count": 100,
  "size_bytes": 524288,
  "monolith_id": "mono_1000",
  "produced_at_ms": 1710000000000,
  "cosignature_count": 3
}