detectaddress - TON

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

This method returns all possible representations of a TON address: raw (workchain:hex), user-friendly bounceable (EQ…), user-friendly non-bounceable (UQ…), URL-safe encodings, and testnet variants.

Parameters

Parameter

Type

Required

Description

address

string

Yes

Address in any form

Request Example

REST (GET):

curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/detectAddress?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2' \
--header 'Content-Type: application/json'

JSON-RPC (POST):

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

import axios from 'axios';

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

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

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "detectAddress",
    "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": "detectAddress",
        "params": {
                "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
        },
        "id": "getblock.io"
});

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/jsonRPC")
        .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": {
        "raw_form": "0:ed16913070500471175e992b561d8de82d31fbf84910ced6eb5fc92e74485ef8a",
        "bounceable": {
            "b64": "EQDtFpEwcFAEcRe5mLVh2N6C0x+/hJEM7W61/JLnSF74p4q2",
            "b64url": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
        },
        "non_bounceable": {
            "b64": "UQDtFpEwcFAEcRe5mLVh2N6C0x+/hJEM7W61/JLnSF74p2nm",
            "b64url": "UQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p2nm"
        },
        "given_type": "friendly_bounceable",
        "test_only": false
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field

Type

Description

result.raw_form

string

Raw workchain:hex representation

result.bounceable.b64

string

User-friendly bounceable address (EQ…) in base64

result.bounceable.b64url

string

User-friendly bounceable address in URL-safe base64

result.non_bounceable.b64

string

User-friendly non-bounceable address (UQ…) in base64

result.non_bounceable.b64url

string

User-friendly non-bounceable address in URL-safe base64

result.given_type

string

Type of the address that was supplied

result.test_only

boolean

Whether the address belongs to the testnet

Use Cases

Normalising user-entered addresses across forms
Detecting whether a user pasted a testnet address
Switching between bounceable and non-bounceable forms based on context (e.g. depositing to a new wallet)

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>/jsonRPC'
});

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

PreviousThe Open Network (TON)Nextdetecthash - TON

Last updated 25 days ago

Was this helpful?