Skip to main content
GET
/
unpackAddress
unpackAddress
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/unpackAddress
{
  "address": "<string>"
}
The unpackAddress method converts a user-friendly TON address to its raw format. This method is useful for converting human-readable addresses into the format required for certain low-level operations or for consistency in data storage.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
TON pricing is the same for full, archive, v2, v3There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
JSON-RPC example

Shell
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "unpackAddress",
    "params": {
      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    }
  }'

​
Parameters

  • address (string, required) — The user-friendly address to unpack. Example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2.

​
Response

  • address (string) — The unpacked address in raw format. This format typically includes the workchain ID and the raw address without any encoding or checksum.

​
Use case

A possible use case for the unpackAddress method in TON is for developers building applications that need to interact with the TON blockchain at a lower level. This method can be used to:
  1. Convert user-input addresses to the raw format required for certain blockchain operations.
  2. Standardize address storage in databases or other backend systems.
  3. Prepare addresses for use in smart contract interactions that require the raw format.
  4. Verify the validity of a user-friendly address by unpacking it and checking its structure.

Query Parameters

​
address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The user-friendly address to unpack

Response

200 - application/json

The unpacked (raw) address

​
address
string

The unpacked address in raw format