getconfigparam - TON

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

This method returns a single network configuration parameter by its numeric identifier. TON configuration parameters control gas pricing, validator economics, message routing, and many other protocol-level constants.

Parameters

Parameter

Type

Required

Description

param

integer

Yes

Configuration parameter number (e.g. 0 for config address, 20 for gas prices on masterchain)

seqno

integer

Masterchain block seqno at which to read the config. Defaults to the latest

Request Example

REST (GET):

curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/getConfigParam?param=20' \
--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": "getConfigParam",
    "params": {
        "param": 20
    },
    "id": "getblock.io"
}'

import requests
import json

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

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "getConfigParam",
    "params": {
        "param": 20
    },
    "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": "getConfigParam",
        "params": {
                "param": 20
        },
        "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": "configInfo",
        "config": {
            "@type": "tvm.cell",
            "bytes": "te6cckEBAQEA\u2026"
        }
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field

Type

Description

result.config.@type

string

Always tvm.cell

result.config.bytes

string

Base64-encoded BOC of the configuration parameter

Use Cases

Reading gas prices for cost-aware applications
Inspecting validator and election parameters
Auditing protocol-level changes after key blocks

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.

Previousgetconfigall - TON Nextgetconsensusblock - TON

Last updated 24 days ago

Was this helpful?