Skip to main content

getConfirmedBlock RPC Method

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

Updated on
Dec 7, 2023

getConfirmedBlock RPC Method

This method is deprecated and will not be supported in future versions. For a similar method, you can use solana's getBlock RPC method.

Parameters

slot_number
string
The slot number encoded as u64, 64-bit unsigned integer
object
array
The configuration object with the following fields:
commitment
string
The level of commitment required for the query. The options include:
finalized
string
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
string
The node will query the most recent block that has been voted on by the supermajority of the cluster
processed
string
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

result
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 the following fields:
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 and it's 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 and it's 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 and it's omitted if inner instruction recording was not yet enabled during the transaction
rewards
An array of reward objects detailing the rewards for this block. It is only present if rewards are requested; an array of JSON objects with the following fields:
pubkey
The public key of the account receiving the reward
lamports
The amount of lamports rewarded
postBalance
The balance of the account after receiving the reward
rewardType
The type of reward such as fee or stake
comission
The vote account commission when the reward was credited, only present for voting and staking rewards
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 the following fields:
accountKeys
An array of public keys involved in the transaction
header
An object containing the transaction's header, including the following fields:
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 the following fields:
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
Request
1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"jsonrpc": "2.0","id":1,"method":"getConfirmedBlock","params":[94101948, {"encoding": "json","transactionDetails":"full","rewards":false}]}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free