TONTONDocs
TON CenterV2Blocks

applications/api/toncenter/v2/blocks/get-shard-block-proof

GET
/api/v2/getShardBlockProof

Authorization

X-API-Key<token>

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

workchain*integer

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.

Formatint32
shard*string

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

seqno*integer

Masterchain block sequence number (block height). Used to query state at a specific point in time. If omitted, returns the current state.

Formatint32
from_seqno?integer

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

Formatint32

Response 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"
}
{
  "ok": false,
  "code": 401,
  "error": "API key does not exist"
}
{
  "ok": false,
  "code": 403,
  "error": "Network not allowed"
}
{
  "ok": false,
  "code": 422,
  "error": "workchain required"
}
{
  "ok": false,
  "code": 429,
  "error": "Ratelimit exceeded"
}
{
  "ok": false,
  "code": 504,
  "error": "LITE_SERVER_NETWORK timeout"
}

Last updated on

applications/api/toncenter/v2/blocks/get-outbound-message-queue-size

applications/api/toncenter/v2/blocks/get-shards