Send TON

​

Parameters

​

Return value

{ boc: string; hash: string }

• hash — the transaction hash, useful for status lookups on a TON explorer.
• boc — the base64-encoded Bag-of-Cells of the broadcasted transaction, in case you want to display or persist it.

​

Example

import { dynamicClient } from '<path to client file>';

const wallet = dynamicClient.wallets.userWallets.find((w) => w.chain === 'TON');
if (!wallet) {
  throw new Error('No TON wallet');
}

const { hash, boc } = await dynamicClient.ton.sendTon({
  walletId: wallet.id,
  to: 'EQ...recipient',
  amount: '500000000', // 0.5 TON
  comment: 'thanks!',
});

console.log('Broadcasted:', hash);

​

Converting between TON and nanotons

const ton = '0.5';
const nano = (Number(ton) * 1e9).toString();
//=> '500000000'

const nano = BigInt(Math.round(parseFloat(ton) * 1e9)).toString();

​

Errors

• The wallet is not a TON wallet, or the walletId doesn’t match a wallet in the current session.
• The user cancels the signing prompt in the WebView.
• The connected external wallet refuses the request (insufficient balance, network mismatch, expired TonConnect session, etc.).
• The broadcast fails (the network rejects the message).