Tipi di Risposta RPC

Schemi JSON dettagliati per tutti gli oggetti di risposta RPC.

BlockResponse

Restituito da 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	Descrizione
hash	string	Hash del blocco (esadecimale, 128 caratteri = 64 byte SHA-512)
height	u64	Numero del blocco
timestamp	u64	Timestamp Unix (secondi)
parent_hash	string	Hash del blocco padre (esadecimale)
state_root	string	Hash della radice dello stato (esadecimale, 64 caratteri)
tx_root	string	Hash della radice delle transazioni (esadecimale, 64 caratteri)
proposer	string	Chiave pubblica del propositore (esadecimale, 64 caratteri)
version	u32	Versione del formato del blocco
transaction_count	u64	Numero di transazioni nel blocco

AccountResponse

Restituito da account_getAccount, account_getBalance, account_getNonce.

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

Campo	Tipo	Descrizione
address	string	Indirizzo account (esadecimale, 64 caratteri = chiave pubblica ed25519 di 32 byte)
balance	string	Saldo nell'unità minima (u128 come stringa decimale, 18 decimali)
nonce	u64	Nonce della transazione corrente

TransactionResponse

Restituito da tx_getTransaction.

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

Campo	Tipo	Descrizione
hash	string	Hash della transazione (esadecimale)
from	string	Indirizzo del mittente (esadecimale)
to	string	Indirizzo del destinatario (esadecimale)
amount	u64	Importo del trasferimento
nonce	u64	Nonce del mittente al momento dell'invio
fee	u128?	Commissione della transazione (opzionale)
timestamp	u64?	Timestamp del blocco se confermata
block_height	u64?	Altezza del blocco se confermata

TransactionReceiptResponse

Restituito da tx_getTransactionReceipt.

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

Valori di stato: "confirmed", "pending", "not_found".

HealthResponse

Restituito da savitri_health.

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

Valori della modalità: "lightnode", "masternode", "unknown".

PouLocalResponse

Restituito da pou_getConsensusState / savitri_pouLocal.

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

Campo	Tipo	Descrizione
local_score	u16?	Punteggio PoU di questo nodo (0-1000)
leader	string?	ID peer del leader corrente
leader_score	u16?	Punteggio PoU del leader
epoch	u64?	Numero dell'epoch corrente
local_is_leader	bool	Se questo nodo è il leader corrente
election_ready	bool	Se un'elezione può essere eseguita

PouPeersResponse

Restituito da savitri_pouPeers.

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

NodeInfoResponse

Restituito da 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

Restituito da mempool_getSize.

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

TokenInfoResponse

Restituito da token_getTokenInfo.

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

FaucetClaimResponse

Restituito da savitri_faucetClaim.

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

L'importo è 5 SAVT (5 * 10^18 unità minime).

SyncingResponse

Restituito da savitri_syncing.

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

MonolithInfoResponse

Restituito da 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
}