getshards - TON

Example code for the getshards JSON-RPC method. Сomplete guide on how to use getshards JSON-RPC in GetBlock.io Web3 documentation.

This method returns the list of shardchain blocks referenced by a given masterchain block. Use it to enumerate all shards active in a given moment in time.

Parameters

Parameter

Type

Required

Description

seqno

integer

Yes

Masterchain block seqno

Request Example

REST (GET):

curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/getShards?seqno=45792554' \
--header 'Content-Type: application/json'

JSON-RPC (POST):

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "getShards",
    "params": {
        "seqno": 45792554
    },
    "id": "getblock.io"
}'

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "getShards",
    "params": {
        "seqno": 45792554
    },
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let payload = json!({
        "jsonrpc": "2.0",
        "method": "getShards",
        "params": {
                "seqno": 45792554
        },
        "id": "getblock.io"
});

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);

    Ok(())
}

Response Example

{
    "ok": true,
    "result": {
        "@type": "blocks.shards",
        "shards": [
            {
                "@type": "ton.blockIdExt",
                "workchain": 0,
                "shard": "8000000000000000",
                "seqno": 51234567,
                "root_hash": "AA\u2026",
                "file_hash": "BB\u2026"
            }
        ]
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field

Type

Description

result.shards

array

Array of shardchain block IDs referenced by the given masterchain block

result.shards[].workchain

integer

Workchain ID

result.shards[].shard

string

Shard ID

result.shards[].seqno

integer

Shard block sequence number

Use Cases

Enumerating active shards at a given masterchain height
Driving block-by-block indexing across all shards
Building TON explorers that walk the shard tree

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid <ACCESS-TOKEN>

422

Validation Error

Request parameters are missing or malformed

429

Too Many Requests

Rate limit exceeded for your plan

504

Lite Server Timeout

Upstream TON liteserver timed out

SDK Integration

import { TonClient } from '@ton/ton';

const client = new TonClient({
    endpoint: 'https://go.getblock.io/<ACCESS-TOKEN>'
});

// The @ton/ton client wraps the same JSON-RPC methods.
// For low-level access, use client.callGetMethod or client.provider.

Previousgetshardblockproof - TON Nextgettokendata - TON

Last updated 1 month ago

Was this helpful?