estimatefee - TON

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

This method estimates the fees that a given message would incur if applied to the specified contract, without actually broadcasting it. Use it to give users an accurate fee preview before signing.

Parameters

Parameter

Type

Required

Description

address

string

Yes

Destination contract address

body

string

Yes

Base64-encoded BOC of the message body

init_code

string

Base64-encoded BOC of the init code (for uninitialised contracts)

init_data

string

Base64-encoded BOC of the init data (for uninitialised contracts)

ignore_chksig

boolean

Whether to ignore the signature check during emulation (default: true)

Request Example

JSON-RPC (POST):

curl --location --request POST 'https://go.getblock.io/<ACCESS_TOKEN>/estimateFee' \
--header 'Content-Type: application/json' \
--data-raw '{
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "body": "te6cckEBAQEAAgAAAEysuc0=",
        "ignore_chksig": true
}'

import axios from 'axios';

const data = JSON.stringify({
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "body": "te6cckEBAQEAAgAAAEysuc0=",
        "ignore_chksig": true
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/estimateFee',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

import requests
import json

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

payload = json.dumps({
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "body": "te6cckEBAQEAAgAAAEysuc0=",
        "ignore_chksig": true
})

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!({
                "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
                "body": "te6cckEBAQEAAgAAAEysuc0=",
                "ignore_chksig": true
});

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/estimateFee")
        .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": "query.fees",
        "source_fees": {
            "@type": "fees",
            "in_fwd_fee": 66667,
            "storage_fee": 1272,
            "gas_fee": 0,
            "fwd_fee": 0
        },
        "destination_fees": [],
        "@extra": "1778769555.4294026:0:0.3188598314708605"
    }
}

Response Parameters

Field

Type

Description

result.source_fees.in_fwd_fee

integer

Inbound forward fee (nanotons)

result.source_fees.storage_fee

integer

Storage fee (nanotons)

result.source_fees.gas_fee

integer

Gas fee (nanotons)

result.source_fees.fwd_fee

integer

Outbound forward fee (nanotons)

result.destination_fees

array

Fees at destination accounts, if any

Use Cases

Showing a user an accurate fee preview before they sign
Server-side fee budgeting in dApps
Validating that a contract call will not run out of gas

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

422

Validation Error

Body, init_code, or init_data is malformed

SDK Integration

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

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

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

Previousdetecthash - TON Nextgetaddressbalance - TON

Last updated 24 days ago

Was this helpful?