工程笔记
用 MCP 和 AI 智能体在 TON 上开发的实战指南：速率限制、Jetton、USDT 支付、非托管兑换与跨链。
2026 年 tonapi.io 替代方案的实话盘点：公共 API、429 限流与 TONNode——通过 MCP 访问 TON，覆盖读取、swap、跨链与钱包。
2026 年 toncenter 替代方案实测：公共全局配置、自建 liteserver 与 TON MCP 逐一拆解。保证吞吐量与非托管工具，告别 HTTP 429。
TON 上的 USDT 付款检测：通过 get_transactions 解析 jetton 的 transfer_notification，用 get_jetton_info 取 decimals，核对金额并保证幂等。
用 generate_wallet 一次调用以编程方式创建 TON 钱包：v3r2、v4、v5r1、highload 版本怎么选，助记词、密钥、地址，以及如何安全完成首笔入金。
通过 MCP 完成 TON → Avalanche 跨链兑换：原子化 HTLC 锁仓、非托管、服务器不保存私钥。5 个工具加一套可跑通的实战流程。
通过 MCP 完成 TON 到 Polygon 跨链兑换：原子化 HTLC 锁定如何在服务器从不保管私钥的前提下，非托管地把价值从 TON 转移到 Polygon。
TON 跨链兑换 BNB：原子化 HTLC 锁定合约如何以非托管方式把价值从 TON 转移到 BNB Chain，全程通过 TONNode 的 MCP 工具完成。
通过 MCP 完成 TON → Base 跨链兑换：HTLC 锁仓、严格非托管、5 个工具。AI 智能体如何不依赖托管跨链桥，把价值从 TON 转到 Base。
通过 MCP 实现 TON → Arbitrum 跨链兑换：原子化 HTLC 托管合约，全程非托管、服务器不保存私钥。详解完整流程与六条支持的目标网络。
通过原子 HTLC 锁定完成 TON → Ethereum 跨链兑换：quote、build、track、disclose 与 refund 全流程。非托管——私钥与资金始终在你手中。
TONNode 是首个不止会读 TON 的 MCP：AI 智能体可以非托管地兑换资产，并跨链兑换到 6 条 EVM 网络。在 TON 上构建 DeFAI 智能体。
AI 智能体如何在 TON 上完成非托管代币 Swap：通过 Omniston 调用 get_swap_quote 与 build_swap_tx，服务器不签名、不保管私钥，签名始终在用户钱包。
详解 TON 地址格式 EQ、UQ 与 raw 的区别，bounceable 与 non-bounceable 标志的含义，以及新钱包首笔充值被弹回发送方的原因与正确做法。
解析 TON 上 Jetton 的 decimals：为什么 USDT 是 6 而多数 Jetton 是 9，get_jetton_info 如何返回 decimals，以及为什么它决定余额换算的成败
在 TON 上一次调用 get_jetton_balance 就能查出钱包的 USDT 余额——jetton 钱包地址直接在链上计算，无需自建索引器。
基于 MCP 的 TON 交易智能体：AI 如何读取余额、获取硬报价并以非托管方式构建 swap——get_balance、get_swap_quote、build_swap_tx 全流程。
tonapi.io 在超出 rate limit 时返回 HTTP 429。本文讲解如何解决 429 错误、为什么「228」只是社区梗，以及如何通过 TONNode 的 MCP 拿到专属密钥。
深入解析 TON 交易历史机制：逻辑时间（lt）、交易哈希与最后交易指针。AI 智能体如何通过 MCP 分页读取历史，以及深度历史为什么需要归档节点。
解析 toncenter 429「Too Many Requests」报错：为什么 AI 智能体最容易中招、指数退避的快速缓解方案，以及真正的解法——带吞吐量保障的专属 Key。
手把手通过 MCP 把 Claude Desktop、Claude Code、Cursor 和 Codex 接入 TON：完整配置、免费 npx 启动，以及 TONNode 的 hosted 密钥。
TON MCP 横评：官方 @ton/mcp 与 TONNode 有何不同？托管型智能体钱包 vs 非托管跨链 MCP，附完整对比表与选型建议。
托管型 MCP 自持 operator 密钥并直接签名，非托管智能体钱包只返回未签名交易。本文拆解 TON MCP 两种模型：私钥在谁手里、谁来签名、各自的真实风险。
用 run_get_method 调用 TON 合约的任意 get 方法：seqno、get_jetton_data、get_sale_data，参数与栈怎么传、exit_code 怎么读、返回栈怎么解析——全程不用 SDK。
免费 TON MCP：用 npx 免密钥把 AI 智能体接入 TON，或领取免费 Hobby 套餐（60 请求/分钟，无需绑卡）。附完整配置，一步步照做即可。
TON liteserver 返回 not ready 或 ADNL 超时？从公共 global-config 节点的根因讲起，用重试、端点轮换和 TONNode hosted 密钥彻底消掉这个报错。
TON MCP 服务器完整指南：什么是 MCP、AI 智能体为什么需要接入 TON、如何用 npx 免费接入或使用 hosted 密钥，以及 TONNode 全部 16 个工具速览。
