TON

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

Overview

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

Prerequisites

• Dynamic SDK initialized (see Quickstart)
• User authenticated (see Authentication)
• TON enabled in the Dynamic dashboard

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:

let sdk = DynamicSDK.instance()

// Filter existing
let tonWallet = sdk.wallets.userWallets.first(where: { $0.chain == "TON" })

// Or create
let wallet = try await sdk.wallets.embedded.createWallet(chain: .ton)

Get Balance

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

let balance = try await sdk.ton.getBalance(walletId: wallet.id)
print("Balance: \(balance) nanotons")

Sign a Message

Sign a message using the connected TON wallet:

let signature = try await sdk.ton.signMessage(
  walletId: wallet.id,
  message: "Hello, TON!"
)
print("Signature: \(signature)")

Send TON

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

let result = try await sdk.ton.sendTon(
  walletId: wallet.id,
  to: "EQBYLTm4nsvoqJRxs2525chuMyfNIS0Tg98TYSLttqzK5YDv",
  amount: "1000000000", // 1 TON in nanotons
  comment: nil          // optional
)
print("BOC: \(result.boc)")
print("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):

let result = try await sdk.ton.sendJetton(
  walletId: wallet.id,
  to: "EQBYLTm4nsvoqJRxs2525chuMyfNIS0Tg98TYSLttqzK5YDv",
  amount: "1000000",
  jettonMasterAddress: "EQBlqsm144Dq6SjbPI4jjZvA1hqTIP3CvHovbIfW_t-SCALE",
  comment: nil
)
print("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:

let details = try await sdk.ton.getNetworkDetails(walletId: wallet.id)
print("Chain ID: \(details.chainId)")
print("Network:  \(details.name)")

Returned struct:

• 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 — Bitcoin operations
• SUI Operations — SUI operations
• Token Balances — Multi-chain balance queries