已在沙盒环境中成功运行 STON.fi 代币兑换的开发者们正收到警告：如果代码中保留了一些看似无害的捷径，那么向主网的迁移可能会导致用户资金清零。开发人员博客上发布的一份由社区编写的清单概述了大多数集成失败的具体环节，并为生产环境就绪的发布提供了一套具体的方案。

为什么这种过渡至关重要

STON.fi 提供了一个路由（router），用于聚合 TON 区块链上多个 DEX 的流动性。想要为用户提供一键兑换功能的项目，通常会从前端或智能合约封装器（wrapper）中调用该路由。在测试环境中，路由地址是静态的，费用标准是已知的，且沙盒可以容忍错误的交易指向。然而，在主网上，路由可能会升级，费用参数可能会发生变化，而一个错误的地址就会将真实的代币发送到一个失效的合约中。因此，这关乎资金安全，其结果要么是流畅的用户体验，要么是可能在一夜之间损害项目声誉的损失。

最常见的错误：硬编码数值

在失败的发布案例中，一个反复出现的模式是硬编码了在测试期间有效的路由地址或费用常量。当 STON.fi 升级其路由时（为了提高性能或修复漏洞的常规操作），硬编码的地址将不再指向一个可用的合约。这种集成要么抛出一个用户根本看不到的错误，要么更糟——静默地将资金路由到一个无法处理它们的地址。社区指南强调了一条准则：让 STON.fi REST API 来决定使用哪个路由。

分步安全检查清单

该清单将迁移过程分为四个逻辑层：环境、合约交互、费用计算和边缘情况处理。

  • 尽早验证环境变量。 测试时将 WebSocket 端点和 REST API 基础 URL 指向沙盒；发布前将其切换到主网节点。这里的拼写错误可能会将真实的兑换重定向到测试路由，导致代币永久锁定。

  • 切勿嵌入合约地址。 向 STON.fi API 发送模拟请求，从响应中获取当前的路由地址，并在运行时将其输入到您的 dexFactory（或等效的合约工厂）中。这样可以自动适应未来的任何路由升级。

  • 实时计算费用。 从 API 的配置负载（payload）中获取费用参数，并将其用于您的费用计算程序中。一旦平台调整其经济模型，硬编码的百分比就会立即失效。

  • 优先使用官方 SDK 和 TonConnect。 SDK 会为您构建 BOC (Bag of Cells) 结构，并包含对 gas 限制、数据编码和签名验证的检查。手动编译 BOC 应仅保留给 SDK 无法覆盖的高度专业化的用例。

  • 进行故障模式测试。 在沙盒中模拟 gas 不足、授权不足（insufficient allowance）和响应格式错误等场景。验证您的合约是否会退还用户资金或发出清晰的错误事件。依赖用户在生产环境中发现这些错误会导致用户流失。

  • 确认推荐奖励的提取路径。 在该 DEX 的第二个版本中，推荐费用会进入一个专门的 Vault 合约，而不是钱包。您的集成必须调用 Vault 的提取方法，并在将资金计入推荐人账户之前处理收到的代币。

开发者们正在争论的问题

一些开发者认为 SDK 增加了不必要的开销，且手动构建的 BOC 负载可以更小、更节省 gas。指南承认了这一观点，但指出 SDK 还捆绑了路由地址和费用模式的更新，这意味着每次 STON.fi 升级后，都必须重新检查手动构建的负载。因此，这是在微小的 gas 节省与静默失效风险之间的权衡。

后续关注事项

  • 路由升级公告。 STON.fi 会在其开发者频道发布即将进行的路由变更。订阅这些动态可以让您在切换到主网之前，预先在沙盒中测试新地址。
  • 费用参数修订。 由于费用百分比可能会根据市场情况进行调整，因此请在任何监控服务中加入定期获取配置端点的功能。
  • SDK 版本发布。 新的 SDK 版本通常包含针对主网发布后发现的边缘情况的错误修复。保持 SDK 的最新状态与更新路由地址同样重要。

核心结论很明确：在测试环境中“运行正常”的交易，并不等同于在主网上也能提供安全的体验。通过从实时的 STON.fi API 获取所有关键参数——从路由地址到费用表，并在用户接触到界面之前对错误路径进行严格测试，开发者在迈向生产环境的“最后一公里”时，能够有效保护用户资金并维护用户信任。

Source: https://dev.to/web3kd/the-last-mile-taking-a-stonfi-integration-from-test-network-to-real-users-2ho0