Skip to main content

block RPC Method

Queries the network and returns block information for the given block height or hash. To return the latest block information, the finality parameter shall be used.

Updated on
Oct 4, 2023

block RPC Method

Parameters

finality
string
The assurance that the transaction cannot be altered, reversed, or canceled after they are completed. For finality=final, it means that it has been validated on at least 66% of the nodes in the network and for finality=optimistic, it uses the latest block recorded on the node that responded to the query passed
block_id
integer/string
The block id which could be either a block number or block hash

Returns

author
The author name
chunks
The information about the chunks
balance_burnt
The number of tokens burnt
chunk_hash
The hash of the chunk
encoded_length
The chunk length encoded in integer format
encoded_merkle_root
The merkle root encoded in hexadecimal form
gas_limit
The maximum gas allowed in this block
gas_used
The total used gas by all transactions in this block
height_created
The chunk height created
height_included
The included height of the chunk
outcome_root
The outcome root
outgoing_receipts_root
The root of the outgoing receipts of the block
prev_block_hash
The hash of the previous block corresponding to the current one
prev_state_root
The previous root state of the corresponding block
rent_paid
The number of tokens paid as rent
shard_id
The id of the multiple data grouped together
validator_reward
The reward sent to the validators
signature
The standard ed25519 signature type
tx_root
The transaction root
validator_proposals
An array of proposals provided by the validators
header
The header of the block
approvals
An array of signatures, encoded in the standard ed25519 signature type
block_merkle_root
The merkle root of the block
block_ordinal
The ordinal number of the block
challenges_result
An array of challenges outcome
challenges_root
The root challenges incurred
chunk_headers_root
The root of the headers trie of the block
chunk_mask
A boolean value
chunk_receipts_root
The root of the receipts trie of the block
chunk_tx_root
The root of the transaction trie of the block
chunks_included
The chunks included in the queried block
epoch_id
The corresponding epoch id
epoch_sync_data_hash
The epoch sync data hash
gas_price
Integer of the gasPrice used for each paid gas encoded as a hexadecimal
hash
The block hash
height
The block height or index
last_ds_final_block
The last ds final block
last_final_block
The address of the last final block
latest_protocol_version
The version of the latest protocol
next_bp_hash
The hash of the next bp node
next_epoch_id
The id next to the current epoch number
outcome_root
The root of the outcome trie of the block
prev_hash
The hash of the previous block
prev_height
The height of the previous block
prev_state_root
The previous state of the root of corresponding block
random_value
The random value generated to make the result deterministic
rent_paid
The number of tokens paid as rent
signature
The standard ed25519 signature type
timestamp
The unix timestamp for when the block was collated
timestamp_nanosec
The timestamp in nano second for when the block was collated
total_supply
The total number of tokens supplied
validator_proposals
The validator proposals
validator_reward
The reward sent to the validators
Request
1
curl https://docs-demo.near-mainnet.quiknode.pro/ \
2
--request POST \
3
--header "Content-Type: application/json" \
4
--data '{"method": "block","params": {"finality": "final"},"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free