ton-swap

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Swap tokens on TON via DEX aggregator. Two-step flow: get a quote, confirm with the user, then execute.

通过DEX聚合器在TON上兑换代币。分为两步流程：获取报价、与用户确认后执行。

If the user mentions a token by name (e.g., "USDT", "jUSDC"), call
```
get_known_jettons
```
to resolve the jetton address
Call
```
get_swap_quote
```
with
```
fromToken
```
,
```
toToken
```
, and
```
amount
```
- Use
```
"TON"
```
  for native TON, or the jetton master contract address for tokens
- Amount is human-readable (e.g.,
```
"1.5"
```
  = 1.5 TON)
Call
```
emulate_transaction
```
with the quote's
```
transaction.messages
```
to dry-run the swap — verify the expected money flow (TON/jetton balance changes) before sending
Show the quote details and emulation results to the user and ask one short yes/no confirmation
Call
```
send_raw_transaction
```
with the transaction params returned by the quote
Poll
```
get_transaction_status
```
with the returned
```
normalizedHash
```
until status is
```
completed
```
or
```
failed
```
(see
```
ton-balance
```
skill). User can ask to skip polling.

Always confirm the swap with the user before executing; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
The quote returns transaction messages ready for
```
send_raw_transaction
```
After execution, poll
```
get_transaction_status
```
by default. User can specify whether to check status.
If no wallet is configured, use the
```
ton-create-wallet
```
skill first