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

# TON

> Sign messages, send TON and Jettons, and query network details using the Dynamic Kotlin SDK.

## Overview

`TonModule` provides native TON blockchain operations including message signing, TON and Jetton transfers, balance queries, and network details. Access it via `DynamicSDK.getInstance().ton`.

## Prerequisites

* Dynamic SDK initialized (see [Quickstart](/kotlin/quickstart))
* User authenticated (see [Authentication](/kotlin/authentication))
* TON enabled in the [Dynamic dashboard](https://app.dynamic.xyz/dashboard/chains-and-networks#ton)

## Get a TON Wallet

If TON is enabled in the dashboard, the user gets a TON wallet on signup. Find it via `userWallets`, or create one explicitly with `EmbeddedWalletChain.TON`:

```kotlin theme={"system"}
val sdk = DynamicSDK.getInstance()

// Filter existing
val tonWallet = sdk.wallets.userWallets.firstOrNull { it.chain == "TON" }

// Or create
val wallet = sdk.wallets.embedded.createWallet(chain = EmbeddedWalletChain.TON)
```

## Get Balance

Query the TON balance for a wallet. Returned as a string (nanotons) to preserve precision.

```kotlin theme={"system"}
val balance = sdk.ton.getBalance(walletId = wallet.id)
println("Balance: $balance nanotons")
```

## Sign a Message

Sign a message using the connected TON wallet:

```kotlin theme={"system"}
val signature = sdk.ton.signMessage(
  walletId = wallet.id,
  message = "Hello, TON!"
)
println("Signature: $signature")
```

## Send TON

Send TON tokens to a recipient address. Returns a `TonTransactionResult` containing the BOC and transaction hash.

```kotlin theme={"system"}
val result = sdk.ton.sendTon(
  walletId = wallet.id,
  to = "EQBYLTm4nsvoqJRxs2525chuMyfNIS0Tg98TYSLttqzK5YDv",
  amount = "1000000000", // 1 TON in nanotons
  comment = null         // optional
)
println("BOC: ${result.boc}")
println("Hash: ${result.hash}")
```

| Parameter  | Type      | Description                                   |
| ---------- | --------- | --------------------------------------------- |
| `walletId` | `String`  | The wallet ID to send from                    |
| `to`       | `String`  | Recipient TON address                         |
| `amount`   | `String`  | Amount in nanotons (1 TON = 10⁹ nanotons)     |
| `comment`  | `String?` | Optional comment to attach to the transaction |

## Send Jettons

Send Jetton tokens (TON's fungible token standard, similar to ERC-20):

```kotlin theme={"system"}
val result = sdk.ton.sendJetton(
  walletId = wallet.id,
  to = "EQBYLTm4nsvoqJRxs2525chuMyfNIS0Tg98TYSLttqzK5YDv",
  amount = "1000000",
  jettonMasterAddress = "EQBlqsm144Dq6SjbPI4jjZvA1hqTIP3CvHovbIfW_t-SCALE",
  comment = null
)
println("Hash: ${result.hash}")
```

| Parameter             | Type      | Description                          |
| --------------------- | --------- | ------------------------------------ |
| `walletId`            | `String`  | The wallet ID to send from           |
| `to`                  | `String`  | Recipient TON address                |
| `amount`              | `String`  | Amount in the Jetton's smallest unit |
| `jettonMasterAddress` | `String`  | Jetton master (contract) address     |
| `comment`             | `String?` | Optional comment                     |

## Get Network Details

Query the chain ID and network name for the connected wallet:

```kotlin theme={"system"}
val details = sdk.ton.getNetworkDetails(walletId = wallet.id)
println("Chain ID: ${details.chainId}")
println("Network:  ${details.name}")
```

Returned data class:

* `chainId` — `-239` for mainnet, `-3` for testnet
* `name` — `"mainnet"` or `"testnet"`

## API Reference

| Method              | Returns                | Description                         |
| ------------------- | ---------------------- | ----------------------------------- |
| `getBalance`        | `String`               | Get wallet balance (nanotons)       |
| `signMessage`       | `String`               | Sign a message                      |
| `sendTon`           | `TonTransactionResult` | Send TON, returns `{boc, hash}`     |
| `sendJetton`        | `TonTransactionResult` | Send Jettons, returns `{boc, hash}` |
| `getNetworkDetails` | `TonNetworkDetails`    | Get `{chainId, name}`               |

## Next Steps

* [Bitcoin Operations](/kotlin/wallets/bitcoin/overview) — Bitcoin operations
* [SUI Operations](/kotlin/wallets/sui/overview) — SUI operations
* [Token Balances](/kotlin/wallets/general/token-balances) — Multi-chain balance queries