ton-org/kit

ton-swap

Swap or trade tokens on the TON blockchain via DEX.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/ton-org/kit --skill ton-swap

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Swap TON Tokens

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

MCP Tools

ToolRequiredOptional
get_swap_quotefromToken, toToken, amountwalletSelector
emulate_transactionmessagesvalidUntil
send_raw_transactionmessageswalletSelector
get_known_jettons——

Workflow

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

Notes

  • 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
来自同一仓库

更多 Skills

全部 Skills