Skip to main content
GET
/
getShardBlockProof
getShardBlockProof
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getShardBlockProof
{
  "masterchain_block_root_hash": "<string>",
  "masterchain_block_seq_no": 123,
  "links": [
    {
      "from": "<string>",
      "to": "<string>",
      "dest_proof": "<string>",
      "proof": "<string>"
    }
  ],
  "block_header": "<string>"
}
The getShardBlockProof method retrieves the proof of a specific shard block in the TON blockchain. This method is crucial for verifying the authenticity and inclusion of shard blocks within the overall TON blockchain structure.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
TON billing: full or archive by block ageThis method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See Request units — TON method scope.

​
JSON-RPC examples

Shell
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": "getShardBlockProof",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064874
    }
  }'

​
Parameters

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

​
Response

  • masterchain_block_root_hash (string) — The root hash of the masterchain block that includes this shard block.
  • masterchain_block_seq_no (integer) — The sequence number of the masterchain block.
  • links (array of objects) — An array of link objects, each containing:
    • from (string) — The source block hash.
    • to (string) — The destination block hash.
    • dest_proof (string) — The proof of the destination block.
    • proof (string) — The proof of the link.
  • block_header (string) — The header of the shard block.

​
Use case

A possible use case for the getShardBlockProof method in TON is for applications or services that need to verify the authenticity and inclusion of shard blocks within the TON blockchain. This method can be used to:
  1. Implement light clients that can verify shard blocks without downloading the entire blockchain.
  2. Provide cryptographic proof of a shard block’s inclusion in the blockchain.
  3. Verify cross-shard transactions by proving the existence of blocks in different shards.
  4. Build block explorers that can show detailed proof information for each block.

Query Parameters

​
workchain
integer
default:-1
required

The workchain ID

​
shard
string
default:-9223372036854775808
required

The shard ID

​
seqno
integer
default:39064874
required

The sequence number of the block

Response

200 - application/json

Proof of the specified shard block

​
masterchain_block_root_hash
string

The root hash of the masterchain block

​
masterchain_block_seq_no
integer

The sequence number of the masterchain block

​
links
object[]
​
block_header
string

The header of the shard block

Last modified on June 4, 2026