masterchainBlockShardsState - Ton

masterchainBlockShardsState . Provides the state of each shard in a specified masterchain block

masterchainBlockShardsState - ton [Value: 100CU]
Provides the state of each shard in a specified masterchain block
Use cases

Use cases

  • Get shard state of a masterchain block
  • Analyze shard state data
  • Audit shard information
Constraints

Constraints

  • Needs valid masterchain block ID
  • Supports Blocks V3 only
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/api/v3/masterchainBlockShardsState?seqno=41089440' \
     --header 'accept: application/json'
Copy
Response
200
{
    "ok": true,
    "result": {
        "seqno": 40467413,
        "workchain": -1,
        "shards": [
            {
                "workchain": 0,
                "shard": -9223372036854775808,
                "seqno": 40467413,
                "state_root_hash": "abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
                "block_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
                "transactions_count": 42
            },
            {
                "workchain": 0,
                "shard": -9223372036854775807,
                "seqno": 40467413,
                "state_root_hash": "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
                "block_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
                "transactions_count": 30
            }
        ]
    }
}
Copy

Request params

Parametersinteger
integer
seqnointeger
The sequence number of the block.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultobject
Details of the masterchain block and its associated shards.
object
seqnointeger
Sequence number of the masterchain block.
workchaininteger
ID of the workchain; -1 represents the masterchain.
shardsarray
List of shard blocks associated with the masterchain block.
object
workchaininteger
ID of the workchain where the shard resides.
shardinteger
ID of the shard in the specified workchain.
seqnointeger
Sequence number of the shard block.
state_root_hashstring
Root hash of the shard block's state.
block_idstring
Unique identifier of the shard block.
transactions_countinteger
Number of transactions in the shard block.
masterchainBlockShardState Transactions info