getConfirmedBlock RPC Method

Description

Returns identity and transaction information about a confirmed block in the ledger.

Parameters

1. slot_number (string) - The slot number encoded as u64, 64-bit unsigned integer
2. object (array) - The configuration object with the following fields:
   • commitment (string, optional) - The level of commitment required for the query. The options include:
     • finalized - The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized
     • confirmed - The node will query the most recent block that has been voted on by the supermajority of the cluster
     • processed - The node will query its most recent block. Note that the block may not be complete
   • encoding (string) - (default: json) The encoding format for account data. It can be base58 (slow), base64, base64+zstd or jsonParsed
   • transactionDetails (string) - (default: full) It specifies the level of transaction details to include in the response. The possible values are full, signatures, and none
   • rewards (boolean) - (default: true) It determines whether to populate the rewards array or not.

Returns

Returns null if the specified block is not confirmed, otherwise an object with the following fields:

• blockHeight - The height of the confirmed block
• blockTime - The estimated production time as Unix timestamp (seconds since the Unix epoch). It is null if not available
• blockhash - The hash of the confirmed block
• parentSlot - The slot number of the block's parent
• previousBlockhash - The hash of the block's predecessor
• transactions - An array of transaction objects within the block. Each transaction object contains:
  • meta - The transaction status metadata object with the following fields:
    • err - Error code if the transaction failed or null if the transaction succeeds
    • fee - The transaction fee
    • innerInstructions - The list of inner instructions (omitted or null if inner instruction recording was not yet enabled during the transaction)
    • loadedAddresses - The list of loaded addresses objects:
      • readonly - The ordered list of base-58 encoded addresses for readonly loaded accounts
      • writable - The ordered list of base-58 encoded addresses for writable loaded accounts
    • logMessages - An array of string log messages (omitted or null if log message recording was not yet enabled during the transaction)
    • postBalances - An array of u64 account balances after the transaction was processed
    • postTokenBalances - The list of token balances from after the transaction was processed (omitted if inner instruction recording was not yet enabled during the transaction)
    • preBalances - An array of u64 account balances from before the transaction was processed
    • preTokenBalances - The list of token balances from before the transaction was processed (omitted if inner instruction recording was not yet enabled during the transaction)
    • rewards - An array of reward objects detailing the rewards for this block (only present if rewards are requested)
    • status - The processing status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError
  • transaction - The transaction object with the following fields:
    • message - The transaction message containing:
      • accountKeys - An array of public keys involved in the transaction
      • header - An object containing the transaction's header, including:
        • numRequiredSignatures - The number of required signatures for the transaction
        • numReadonlySignedAccounts - The number of readonly accounts that have signed the transaction
        • numReadonlyUnsignedAccounts - The number of readonly accounts that have not signed the transaction
      • instructions - An array of instruction objects for the transaction with:
        • accounts - An array of integers representing the indices of accounts involved in the instruction
        • data - The instruction data encoded in the specified format
        • programIdIndex - The index of the program ID in the accountKeys
  • recentBlockhash - The most recent blockhash used for the transaction
  • signatures - An array of signatures strings corresponding to the transaction order in the block

Code Examples

curl "https://rpc-mainnet.solanatracker.io/?api_key=YOUR_API_KEY_HERE" \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc": "2.0","id":1,"method":"getConfirmedBlock","params":[235157119, {"encoding": "json","transactionDetails":"full","rewards":false}]}'