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.
API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.
In: header
Query Parameters
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.
int32The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.
Masterchain block sequence number (block height). Used to query state at a specific point in time. If omitted, returns the current state.
int32Seqno of masterchain block starting from which proof is required. If not specified latest masterchain block is used
int32Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/getShardBlockProof?workchain=0&shard=string&seqno=0"{ "ok": true, "result": { "@type": "blocks.shardBlockProof", "from": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "mc_id": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "links": [ { "@type": "blocks.shardBlockLink", "id": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "proof": "string" } ], "mc_proof": [ { "@type": "blocks.blockLinkBack", "to_key_block": true, "from": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "to": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "dest_proof": "string", "proof": "string", "state_proof": "string" } ] }, "@extra": "string"}