getwalletinformation - TON

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

This method returns wallet-specific information for a TON address. It identifies the wallet type, returns the current seqno (used as a nonce), wallet ID, and the last transaction. Use this method to prepare outgoing transactions from a wallet contract.

Parameters

Parameter

Type

Required

Description

address

string

Yes

Wallet address in any form

seqno

integer

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

Request Example

REST (GET):

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

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "getWalletInformation",
    "params": {
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    },
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    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>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "getWalletInformation",
    "params": {
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    },
    "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": "getWalletInformation",
        "params": {
                "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
        },
        "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": {
        "wallet": true,
        "balance": "1234567890",
        "account_state": "active",
        "wallet_type": "wallet v4 r2",
        "seqno": 42,
        "last_transaction_id": {
            "@type": "internal.transactionId",
            "lt": "47652103000003",
            "hash": "AbCdEfGhIjKlMnOpQrStUvWxYz0123456789+/="
        },
        "wallet_id": 698983191
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field

Type

Description

result.wallet

boolean

Whether the contract is a recognised wallet

result.wallet_type

string

Identifier of the wallet version (e.g. wallet v4 r2, wallet v3 r2)

result.seqno

integer

Current wallet seqno — use as the nonce for the next outgoing message

result.wallet_id

integer

Subwallet identifier for the wallet contract

result.balance

string

Wallet balance in nanotons

result.account_state

string

Account state: active, uninitialized, or frozen

result.last_transaction_id

object

Last transaction logical time and hash

Use Cases

Preparing a transfer by reading the current wallet seqno
Detecting wallet version to build a compatible message body
Wallet application UX that displays type and version
Validating that a destination is an initialised wallet before depositing

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.

Previousgettransactionsstd - TON Nextlookupblock - TON

Last updated 24 days ago

Was this helpful?