Skip to main content
POST
/
api
/
v2
/
getShardBlockProof
Get shard block proof
curl --request POST \
  --url https://toncenter.com/api/v2/getShardBlockProof \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "workchain": "<string>",
  "shard": "<string>",
  "seqno": "<string>",
  "from_seqno": "<string>"
}
'
{
  "ok": true,
  "result": {
    "@type": "blocks.shardBlockProof",
    "from": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "mc_id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "links": [
      {
        "@type": "blocks.shardBlockLink",
        "id": {
          "@type": "ton.blockIdExt",
          "workchain": 123,
          "shard": "<string>",
          "seqno": 123,
          "root_hash": "<string>",
          "file_hash": "<string>"
        },
        "proof": "<string>"
      }
    ],
    "mc_proof": [
      {
        "@type": "blocks.blockLinkBack",
        "to_key_block": true,
        "from": {
          "@type": "ton.blockIdExt",
          "workchain": 123,
          "shard": "<string>",
          "seqno": 123,
          "root_hash": "<string>",
          "file_hash": "<string>"
        },
        "to": {
          "@type": "ton.blockIdExt",
          "workchain": 123,
          "shard": "<string>",
          "seqno": 123,
          "root_hash": "<string>",
          "file_hash": "<string>"
        },
        "dest_proof": "<string>",
        "proof": "<string>",
        "state_proof": "<string>"
      }
    ]
  },
  "@extra": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
workchain
required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

​
shard
required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

​
seqno
required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

​
from_seqno

Starting masterchain block for proof generation.

Response

OK

Response containing Merkle proof linking shard block to masterchain.

​
ok
boolean
default:true
required

Indicates if the request succeeded. If false, check the error field for details.

​
result
object
required

The response data. Only present when ok is true.

​
@extra
string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.