blocks

Get Shard Block Proof

Returns a Merkle proof that links a shardchain block to a masterchain block. This proof cryptographically verifies that the shard block is part of the canonical chain. Used by light clients and cross-chain bridges to verify shard data without trusting the API.

get/api/v2/getShardBlockProof

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/getShardBlockProof
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

workchaininteger required

The workchain to query. Use -1 for masterchain (validators, system contracts, config) or 0 for basechain (regular accounts and contracts). Most user transactions happen on workchain 0.

shardstring required

The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.

seqnointeger required

Block sequence number within the specified workchain and shard.

from_seqnointeger

Seqno of masterchain block starting from which proof is required. If not specified latest masterchain block is used

Response

Returns a cryptographic proof chain linking a shard block to the masterchain.

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.