Send a Jetton

​

Parameters

​

Return value

{ boc: string; hash: string }

​

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');
}

// Example: send 10 USDT (USDT on TON has 6 decimals)
const decimals = 6;
const human = '10';
const jettonAmount = (Number(human) * 10 ** decimals).toString();

const { hash } = await dynamicClient.ton.sendJetton({
  walletId: wallet.id,
  jettonMasterAddress: 'EQ...usdt-master',
  recipientAddress: 'EQ...recipient',
  jettonAmount,
  forwardTonAmount: '1', // 1 nanoton — enough to trigger the notification
});

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

​

Notes

• jettonAmount must be in the Jetton’s smallest unit. The decimals are defined by the Jetton master contract (typically 6 or 9). Apply them on the client side; the SDK does not auto-convert.
• The user’s Jetton wallet contract for a given master must have enough Toncoin to pay for the forward fee. If forwardTonAmount is too small, the transfer notification may be dropped (transfer still succeeds, but recipient-side bookkeeping won’t be triggered).
• The bridge call surfaces the underlying connector’s errors verbatim — typical failure modes are insufficient Jetton balance, the recipient address being malformed, or the user cancelling the prompt.