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

# Utilities

> Address conversion and amount formatting

```python theme={"theme":{"light":"github-light-default","dark":"dark-plus"}}
from pytonapi.utils import raw_to_userfriendly, userfriendly_to_raw, to_nano, to_amount
```

## Address Conversion

**raw\_to\_userfriendly** — convert a raw address (`workchain:hex`) to user-friendly base64 format.

```python theme={"theme":{"light":"github-light-default","dark":"dark-plus"}}
raw = "0:83ae019a23a8162beaa5cb0ebdc56668b2eac6c6ba51808812915b206a152dc5"

raw_to_userfriendly(raw)
# UQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxZR0

raw_to_userfriendly(raw, is_bounceable=True)
# EQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxcmx

raw_to_userfriendly(raw, is_test_only=True)
# 0QCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxS_-

raw_to_userfriendly(raw, is_test_only=True, is_bounceable=True)
# kQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxXI7
```

| Parameter       | Default  | Description                        |
| --------------- | -------- | ---------------------------------- |
| `address`       | Required | Raw address in workchain:hex form. |
| `is_bounceable` | False    | Bounceable flag.                   |
| `is_url_safe`   | True     | URL-safe base64 encoding.          |
| `is_test_only`  | False    | Test-only address flag.            |

**userfriendly\_to\_raw** — convert a user-friendly base64 address back to raw format.

```python theme={"theme":{"light":"github-light-default","dark":"dark-plus"}}
userfriendly_to_raw("EQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxcmx")
# 0:83ae019a23a8162beaa5cb0ebdc56668b2eac6c6ba51808812915b206a152dc5
```

Accepts both standard and URL-safe base64. Raises `ValueError` on invalid input.

## Amount Conversion

**to\_nano** — convert a human-readable amount to the smallest unit (nanotons for TON).

```python theme={"theme":{"light":"github-light-default","dark":"dark-plus"}}
to_nano(1.5)                # 1_500_000_000
to_nano("0.001")            # 1_000_000
to_nano(100, decimals=6)    # 100_000_000 (USDT)
```

| Parameter  | Default  | Description                 |
| ---------- | -------- | --------------------------- |
| `value`    | Required | Amount (number or string).  |
| `decimals` | 9        | Decimal places (9 for TON). |

**to\_amount** — convert the smallest unit back to a human-readable `Decimal`.

```python theme={"theme":{"light":"github-light-default","dark":"dark-plus"}}
to_amount(1_500_000_000)               # Decimal("1.5")
to_amount(1_500_000_000, precision=2)  # Decimal("1.50")
to_amount(100_000_000, decimals=6)     # Decimal("100")
```

| Parameter   | Default  | Description                       |
| ----------- | -------- | --------------------------------- |
| `value`     | Required | Amount in smallest units.         |
| `decimals`  | 9        | Decimal places (9 for TON).       |
| `precision` | Optional | Round result to N decimal places. |