getBlock RPC Method

Though getBlock is supported, Solana Foundation recommends using jsonParsed encoding because it includes all transaction account keys (including those from Lookup Tables). To do this with JavaScript, please refer to the getParsedBlock RPC method.

Parameters

slot

integer

The slot number of the block to retrieve encoded as u64 (64-bit unsigned integer) integer

object

array

The configuration object with the following fields:

encoding

string

The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed

transactionDetails

string

(default:full) The level of transaction detail to return. It could be full, accounts, signatures, or none

rewards

boolean

(default:false) A boolean flag that indicates whether to include reward information in the block response

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 supermajority of the cluster

processed

string

It is not supported for this method

maxSupportedTransactionVersion

boolean

The maximum transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error

legacy

boolean

The older transaction format with no additional benefit

0

boolean

The additional support for Address Lookup Tables

Returns

result

Null if the specified block is not confirmed otherwise RpcResponse JSON object with the following fields:

blockHeight

The number of blocks beneath this block

blockTime

The estimated production time, as Unix timestamp (seconds since the Unix epoch). It's null if not available

blockhash

The hash of the block encoded as base-58 string

parentSlot

The slot index of this block's parent

previousBlockhash

The blockhash of this block's parent encoded as base-58 string; if the parent block is not available due to ledger cleanup, the field will return 11111111111111111111111111111111

transactions

It is present if full transaction details are requested; an array of JSON objects with the following fields:

meta

The transaction status metadata object, which contains additional information about the block and its transactions. The meta object can be null, or it may contain the following fields:

err

Error code if the transaction failed or null if the transaction succeeds

fee

The total fees paid by all transactions in the block encoded as u64 integer

innerInstructions

An array of objects representing the inner instructions of all transactions in the block (omitted if inner instruction recording is not enabled). Each object has the following fields:

logMessages

An array of strings containing any log messages generated by the block's transactions (omitted if inner instruction recording is not enabled)

postBalances

An array of lamport balances for each account in the block after the transactions were processed

postTokenBalances

An array of token balances for each token account in the block after the transactions were processed (omitted if inner instruction recording is not enabled)

preBalances

An array of lamport balances for each account in the block before the transactions were processed

preTokenBalances

An array of token balances for each token account in the block before the transactions were processed (omitted if inner instruction recording is not enabled)

rewards

An object containing information about the rewards earned by the block's validators (only present if the rewards are requested). It has the following fields:

pubkey

The public key of the account that received the award encoded as base-58 string

lamports

The number of reward lamports credited or debited by the account

postBalance

The account balance in lamports after the reward was applied

rewardType

The type of reward. It could be fee, rent, voting, staking

commission

The vote account commission when the reward was credited, only present for voting and staking rewards

status

The status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError

transaction

The transaction object. It could be either JSON format or encoded binary data, depending on the encoding parameter

message

An array of transactions included in the block

accountKeys

An array of public keys associated with the accounts that were accessed during the execution of transactions in the block

pubkey

The public key associated with the block producer who created the block

signer

It is used to sign transactions in the block. It can also be used to identify the signers involved in the block's transactions and to verify the authenticity of the signatures

source

It is used to identify the accounts that provided the funds for the block's transactions

writable

A boolean value that indicates whether the accounts associated with the given public keys were modified by the transactions or not

instructions

An array of instructions that were executed in the block's transactions

parsed

An array of parsed instructions that were executed in the block's transactions

info

An array of information objects that provide additional details about the transactions in the block

clockSysvar

It provides information about the current state of the Solana blockchain

slotHashesSysvar

It provides information about the hashes of recent slots

vote

An array of vote accounts that were involved in the block's transactions

hash

The hash of the block. It can be used to uniquely identify the block and to verify the authenticity of the block's contents

slots

An array of slot numbers that correspond to the transactions in the block

timestamp

The Unix timestamp of the block's creation

voteAccount

A vote account to identify the validator who produced the block and to verify the validity of their vote

voteAuthority

An authority associated with the vote account used to produce the block

type

The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks

program

The data associated with the program that was executed in the block's transactions

programId

The public key of the program that was executed in the block's transactions

stackHeight

The current depth of the execution stack

recentBlockhash

The recent block hash for the account's cluster

signatures

The list of transaction signatures contained within a particular block

version

The transaction version. It's undefined if maxSupportedTransactionVersion is not set in the requested parameters

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":"getBlock","params":[94101948, {"encoding": "jsonParsed","maxSupportedTransactionVersion":0,"transactionDetails":"full","rewards":false}]}'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free