getShardBlockProof - Ton

getShardBlockProof. Retrieves the proof for a specified block within a shard, allowing verification of its validity.

getShardBlockProof - ton [Value: 100CU]
Retrieves the proof for a specified block within a shard, allowing verification of its validity.
Use cases

Use cases

  • Retrieve proof of a specific block in a TON shard
  • Verify block validity within a shard context
  • Audit blockchain data for integrity checks
Constraints

Constraints

  • Requires a valid shard ID and block ID
  • Only provides proof for existing blocks
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url  'https://ton.drpc.org/rest/getShardBlockProof?workchain=0&shard=-9223372036854775808&seqno=1000000' \
     --header 'accept: application/json'
Copy
Response
200
{
    "id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "workchain": 0,
    "shard": -9223372036854775808,
    "seqno": 1000000,
    "proof": {
        "block_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "prev_block_id": "0:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "shard_state": {
            "last_seqno": 1000000,
            "root_hash": "abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
            "state_hash": "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
        },
        "transactions": [
            {
                "id": "transaction1-id",
                "status": "confirmed",
                "value": "5000",
                "to": "recipient-address-1",
                "from": "sender-address-1",
                "created_at": 1693527600
            },
            {
                "id": "transaction2-id",
                "status": "pending",
                "value": "2000",
                "to": "recipient-address-2",
                "from": "sender-address-2",
                "created_at": 1693527700
            }
        ]
    },
    "status": "success"
}
Copy

Request params

Parametersobject
object
workchaininteger
Represents the workchain ID; 0 denotes the masterchain (TON's main chain).
shardinteger
Denotes the shard ID; -9223372036854775808 represents the leftmost shard.
seqnointeger
The sequence number of the block.

Response

200

Response params

object
idstring
Unique identifier for the block.
workchaininteger
ID of the workchain; 0 represents the masterchain.
shardinteger
ID of the shard, represented as a signed integer.
seqnointeger
Sequence number of the block.
proofobject
Proof data related to the block.
object
block_idstring
Identifier of the block.
prev_block_idstring
Identifier of the previous block.
shard_stateobject
State information for the shard.
object
last_seqnointeger
The last sequence number for the shard.
root_hashstring
Root hash of the shard's state.
state_hashstring
Hash representing the current state of the shard.
transactionsarray
List of transactions included in the block.
object
idstring
Identifier for the transaction.
statusstring
Current status of the transaction (e.g., confirmed, pending).
valuestring
Amount of value transferred in the transaction.
tostring
Recipient address of the transaction.
fromstring
Sender address of the transaction.
created_atinteger
Timestamp when the transaction was created.
statusstring
Status of the request.
getMasterchainBlockSignatureslookupBlock