getBlockHeader | TON v2

The getBlockHeader method retrieves the header of a specific block in the TON blockchain. This method provides detailed metadata about a block, including its identifiers, state flags, and timing information.

Parameters

• workchain (integer, required) — The ID of the workchain. Example: -1 for the masterchain.
• shard (string, required) — The ID of the shard. Example: "-9223372036854775808" for the masterchain.
• seqno (integer, required) — The sequence number of the block. Example: 39064874.

JSON-RPC example

curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlockHeader",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064874
    }
  }'

Response

• id (object) — The identifier of the block, containing:
  • workchain (integer) — The workchain ID of the block.
  • shard (string) — The shard ID of the block.
  • seqno (integer) — The sequence number of the block.
  • root_hash (string) — The root hash of the block.
  • file_hash (string) — The file hash of the block.
• global_id (integer) — The global ID of the block.
• version (integer) — The version of the block.
• after_merge (boolean) — Whether the block was created after a merge.
• before_split (boolean) — Whether the block was created before a split.
• after_split (boolean) — Whether the block was created after a split.
• want_merge (boolean) — Whether the block wants to merge.
• want_split (boolean) — Whether the block wants to split.
• validator_list_hash_short (integer) — The short hash of the validator list.
• catchain_seqno (integer) — The sequence number in the catchain.
• min_ref_mc_seqno (integer) — The minimum referenced masterchain sequence number.
• is_key_block (boolean) — Whether the block is a key block.
• prev_key_block_seqno (integer) — The sequence number of the previous key block.
• start_lt (string) — The start logical time of the block.
• end_lt (string) — The end logical time of the block.
• gen_utime (integer) — The generation time of the block.
• vert_seqno (integer) — The vertical sequence number of the block.

Use case

A possible use case for the getBlockHeader method in TON is for blockchain explorers, validators, or any application that needs detailed metadata about specific blocks. This method can be used to:

1. Display comprehensive block information in a block explorer.
2. Analyze the structure and evolution of the blockchain, including shard splits and merges.
3. Verify the integrity and sequence of blocks in a custom validation process.
4. Track key blocks and their relationships in the blockchain.

Try the getBlockHeader RPC method yourself