> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# unpackAddress | TON v2

> The unpackAddress method converts a user-friendly TON address to its raw format. Available on TON v2 via Chainstack JSON-RPC nodes.

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.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## JSON-RPC example

```shell Shell theme={"system"}
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.


## OpenAPI

````yaml openapi/ton_node_api/v2/unpackAddress.json GET /unpackAddress
openapi: 3.0.0
info:
  title: unpackAddress example
  version: 1.0.0
  description: >-
    This is an API example for unpackAddress, a method to convert a
    user-friendly TON address to its raw format.
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2
security: []
paths:
  /unpackAddress:
    get:
      tags:
        - TON Operations
      summary: unpackAddress
      operationId: unpackAddress
      parameters:
        - name: address
          in: query
          required: true
          description: The user-friendly address to unpack
          schema:
            type: string
            default: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
          example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
      responses:
        '200':
          description: The unpacked (raw) address
          content:
            application/json:
              schema:
                type: object
                properties:
                  address:
                    type: string
                    description: The unpacked address in raw format

````