Ctrlk
Go to websiteDashboard
For the complete documentation index, see llms.txt. This page is also available as Markdown.

block - NEAR Protocol

Example code for the block json-rpc method. Сomplete guide on how to use block json-rpc in GetBlock.io Web3 documentation.

This method returns detailed information about a specific block on the NEAR blockchain. You can query a block by block ID (height), hash, and finality (e.g., final or optimistic).

Supported Network

  • Mainnet

Parameters

Parameter
Type
Required
Description

id

string

Optional

The height or hash of the block you want to query.

finality

string

Required

Specifies which finalized block to return. Acceptable values: "final", "optimistic", "near-final".

method

string

Required

Always set to "block".

Request

  • URL (endpoint)

    https://go.getblock.io/

  • Example (cURL)

    curl --location 'https://go.getblock.io/<ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{"jsonrpc": "2.0",
"method": "block",
"params": {"finality": "final"},
"id": "17821130"}'

Response

Response Definition

Field

Type

Description

author

string

The name of the validator (block producer).

header

object

The main metadata header of the block.

header.approvals

array

An array of signatures encoded in standard ed25519 format.

header.block_merkle_root

string

Merkle root of the block.

header.block_ordinal

integer

The ordinal number of the block.

header.challenges_result

array

List of challenge outcomes.

header.challenges_root

string

Root of the challenges incurred in this block.

header.chunk_headers_root

string

Root of the chunk headers trie.

header.chunk_mask

boolean

Boolean mask indicating included chunks.

header.chunk_receipts_root

string

Root of the receipts trie of the block.

header.chunk_tx_root

string

Root of the transaction trie of the block.

header.chunks_included

integer

Number of chunks included in the queried block.

header.epoch_id

string

Identifier of the epoch in which this block was produced.

header.epoch_sync_data_hash

string

Epoch synchronization data hash.

header.gas_price

string

Gas price used for each transaction in the block (hexadecimal).

header.hash

string

The block hash (unique identifier).

header.height

integer

Block height (index in the blockchain).

header.last_ds_final_block

string

Hash of the last double-signature final block.

header.last_final_block

string

Hash of the last finalized block.

header.latest_protocol_version

integer

Version number of the latest NEAR protocol.

header.next_bp_hash

string

Hash of the next block producer node.

header.next_epoch_id

string

Identifier of the next epoch.

header.outcome_root

string

Root hash of the outcome trie.

header.prev_block_hash

string

Hash of the previous block.

header.prev_height

integer

Height of the previous block.

header.prev_state_root

string

Root of the previous block state.

header.random_value

string

Random value generated to ensure deterministic outcomes.

header.rent_paid

string

Number of tokens paid as rent.

header.signature

string

ed25519 digital signature of the block producer.

header.timestamp

integer

Unix timestamp when the block was produced.

header.timestamp_nanosec

string

Timestamp in nanoseconds when the block was collated.

header.total_supply

string

Total number of tokens in circulation.

header.validator_proposals

array

List of validator proposals for the next epoch.

header.validator_reward

string

Reward amount sent to validators.

chunks

array

List of chunks included in the block.

chunks.balance_burnt

string

Number of tokens burnt in this chunk.

chunks.chunk_hash

string

Unique hash of the chunk.

chunks.encoded_length

integer

Length of the chunk (encoded as integer).

chunks.encoded_merkle_root

string

Encoded Merkle root of the chunk (hexadecimal).

chunks.gas_limit

string

Maximum gas allowed for transactions in this chunk.

chunks.gas_used

string

Total gas used by all transactions in this chunk.

chunks.height_created

integer

Block height when this chunk was created.

chunks.height_included

integer

Block height where this chunk was included.

chunks.outcome_root

string

Outcome root hash of the chunk.

chunks.outgoing_receipts_root

string

Root of the outgoing receipts of this chunk.

chunks.prev_block_hash

string

Previous block hash corresponding to this chunk.

chunks.prev_state_root

string

Previous state root of the chunk.

chunks.rent_paid

string

Tokens paid as rent within the chunk.

chunks.shard_id

integer

ID of the shard where this chunk belongs.

chunks.tx_root

string

Root of the transaction trie within this chunk.

chunks.validator_proposals

array

Validator proposals associated with this chunk.

chunks.validator_reward

string

Validator reward earned for processing the chunk.

Use Cases

The block method can be used for:

  • Track recently produced blocks and validators.

  • Verify inclusion of transactions in a specific block.

  • Monitor gas price and network performance.

  • Retrieve block metadata for analytics or dashboards.

Code Example

  • Node(Axios)

  • Python(Requests)

Error handling

HTTP Code
Error Message
Description

400 Bad Request

REQUEST_VALIDATION_ERROR

Failed parsing args: invalid type: null, expected string or map or expected one of optimistic, near-final, final.

500

Internal Server Error

Network issues.

Integration with Web3

By integrating the block method into your NEAR Core API setup, developers can:

  • Fetch live blockchain data for block explorers.

  • Power validator dashboards with real-time metrics.

  • Support analytics tools to visualise transaction throughput.

PreviousEXPERIMENTAL_tx_status {disallowed} - NEAR ProtocolNextbroadcast_tx_async - NEAR Protocol

Last updated

Was this helpful?