想把 STON.fi 的链上兑换和流动性操作整合进自己的应用，第一步就是正确安装 SDK。这件事不止是敲一个 npm install 那么简单——SDK 负责创建并打开智能合约包装器，但一个完整的集成通常还需要 TON RPC 客户端、STON.fi API 以及钱包连接层。

在正式安装之前，先搞清楚 SDK 在应用里的定位。官方 SDK 专门为 JavaScript 和 TypeScript 环境设计，它像一层薄薄的包装，把 Router、Pool、LP Account、Vault、pTON 等合约变成了方便调用的 TypeScript 类。也就是说，你无需手动拼装 cell、操作码和消息体，SDK 直接帮你做好这些脏活累活。

打开网易新闻 查看精彩图片

不过 SDK 并不是万能组件。它不管代币搜索界面，也不替你管私钥，更不会代用户挑钱包或保证一笔交易经济上是否划算。一个实用的心理模型是：SDK 只管合约交互，其余的事交给 TON Connect、API 和你的业务逻辑。

安装前你得先想清楚 SDK 跑在什么地方。浏览器 DApp 常见搭配是 SDK + STON.fi API 客户端 + TON Connect。后端服务则可能用 SDK + TON RPC 客户端，但如果要主动发交易，你还得额外部署一套安全的签名机制。千万别顺手装成 @ston-fi/omniston-sdk，那是供跨 DEX 聚合用的独立协议，跟直接和 STON.fi 合约打交道不是一回事。

接下来用 React + TypeScript + Vite 搭一个可运行的起步项目。依次执行：

npm create vite@latest stonfi-sdk-starter -- --template react-tscd stonfi-sdk-starternpm install

运行 npm run dev 就能看到初始页面。后续再逐步添加 @ston-fi/sdk、TON RPC 客户端、STON.fi API 客户端和 tconnect 钱包连接库。整套工具链装好后，STON.fi API 负责发现资产、模拟交易并返回 Router 元数据，SDK 把元数据转成合约实例和交易参数，TON Connect 则拉起用户钱包签名发送——三个环节各司其职，让整个集成更好测试、更容易升级。

如果你用的是 Node.js 脚本、机器人或后端服务，可以省略 TON Connect 层面的库，但要自己搞定交易签名，并把私钥保护妥当。简而言之，先确定运行环境，再按需选装组件，就能为后续的 swap 和流动性操作打下一个可靠基础。