ton-swap 用于在 TON 区块链上通过 DEX 聚合器兑换代币,适合用户提出 swap、trade、exchange、convert、buy 或 sell 等代币交易需求时使用。
主要能力:提供 get_swap_quote(必填 fromToken、toToken、amount,可选 walletSelector)、emulate_transaction(messages,可选 validUntil)、send_raw_transaction(messages,可选 walletSelector)和 get_known_jettons 等 MCP 工具。
使用方式:若用户以名称提及代币(如 USDT、jUSDC),先调用 get_known_jettons 解析 jetton 地址;再用 fromToken、toToken、amount 调用 get_swap_quote,原生代币写 "TON",其他代币用 jetton 主合约地址,amount 为人类可读格式(如 "1.5" 表示 1.5 GRAM);随后用报价中的 transaction.messages 调用 emulate_transaction 进行干跑,核对 GRAM/jetton 余额变化;将报价详情与模拟结果展示给用户,请求一次简短的 yes/no 确认;再调用 send_raw_transaction 发送交易;最后按返回的 normalizedHash 轮询 get_transaction_status,直到 completed 或 failed(用户可要求跳过轮询)。
限制与注意:执行前必须经用户确认,优先使用宿主客户端的结构化确认界面,否则接受自然语言 yes/no,不要求固定确认语句;报价返回的消息可直接用于 send_raw_transaction;若未配置钱包,需先使用 ton-create-wallet 技能。其他未在资料中说明的收费、价格或平台支持情况暂未提供。