# @anywalletkit/protocol-swap2-omniston 中文文档 规范地址：https://npmcn.com/package/%40anywalletkit/protocol-swap2-omniston/ 版本：0\.5\.2 npm 元数据更新时间：2026-11-05T12:23:37.495Z 中文译文更新时间：2026-11-06T17:41:51.295Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40anywalletkit/protocol-swap2-omniston 原文对照：https://npmcn.com/package/%40anywalletkit/protocol-swap2-omniston/?lang=original 项目主页：https://docs.anywallet.tech/ 源码仓库：https://github.com/ultratestbro/anywalletkit ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.2 MB，52 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - Node.js 要求：\>=22 - 运行依赖：7 个 - peer 依赖：@anywalletkit/core 0\.8\.0 - 首次发布：2026-10-24T18:42:21.062Z - 最新版本发布：2026-11-05T12:23:37.098Z - 近 30 天下载量：2558（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：15（近 12 个月 15 个） ## 中文简介 STON.fi Omniston for Any Wallet Kit: TON在STON.fi DEX和TON EVM / EVM 通过 HTLC 代管,在Omniston RFQ上互换稳定订单;独立或作为交换2路由器的提供者. ## 安装 ```sh npm install @anywalletkit/protocol-swap2-omniston ``` 也可以使用：`pnpm add @anywalletkit/protocol-swap2-omniston`、`yarn add @anywalletkit/protocol-swap2-omniston`、`bun add @anywalletkit/protocol-swap2-omniston` ## README # @anywalletkit/protocol-swap2-omniston (英语) [![npm](https://img.shields.io/npm/v/@anywalletkit/protocol-swap2-omniston?label=npm)](https://www.npmjs.com/package/@anywalletkit/protocol-swap2-omniston) STON.fi Omniston作为互换2模块:TON QTON互换在STON.fi DEX上结算, 和TON EVM和EVM通过HTLC代管解决的EVM稳定订单 (resolver Arbiter),位于奥姆尼斯通WebSocket RFQ上. 独立通过 `OmnistonSwap2Protocol`,或作为路由器的提供者. ## 安装 ```sh npm install @anywalletkit/protocol-swap2-omniston @anywalletkit/core # or: pnpm add @anywalletkit/protocol-swap2-omniston @anywalletkit/core · yarn add @anywalletkit/protocol-swap2-omniston @anywalletkit/core ``` 时间: [@anywalletkit/protocol-swap2-omniston (英语)](https://www.npmjs.com/package/@anywalletkit/protocol-swap2-omniston)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处. EVM链:Ethereum,BNB,多边形,X层,HyperEVM,Robinhood, Base,Plasma,, (原始内容存档于2018-09-29). Arbitrum, Avalanche. ARC(在Omniston的矩阵中)等待资产目录; TRON需要自己的订单路径,还没有被接通. ## 路线和大门 每条路由在配置允许列表和验证符之前都会被关闭: - **顿 顿** (DEX互换): `trustedSettlementContracts["ton:-239"]`, (中文(简体) ), `validateTonJettonWallet`, (中文(简体) ), `validateTonSwapTarget`, (中文(简体) ), `validateTonSwapLeg`。构建的信息的DEX 调用在包中被解码(STON.fi v1/v2 incl.). PTON和横扫, DeDust v1, DeDust CPMM v2):接收者=目的地,退款/过额=贸易商, \* 引用的、无外国转录的 拆分/多路引号因名称而被拒绝. `validateTonSwapLeg` (由 `createOmnistonTonValidators`)确认路由器的询问 钱包、 pTON 钱包所有权和 脱尘池对连锁. 没有它,解码器无法分辨 DEX的支付,所以 路线没有广告. `tonSwapPayloadCheck: "report"` 跟踪 `ton-swap-payload ` (包括:. `legs-unverified`而不是拒绝 (默认) `"enforce"`)——明确推出选入. 后面,我们走 `remoteProvider`应用程序检查了建筑体本身: `remoteProvider({name: "omniston", baseUrl, verifyBuild: omnistonVerifyBuild({...createOmnistonTonValidators()})})`。 。 。 . 一个TON ~ TON 交换机的机身打开了 `checkTonSwapPayload` 根据应用程序本身的要求(收件人, 退款,最低连锁,输入;引号带有 `routeSteps`和它支付的DEX被确认 应用程序的验证器 - `validateTonSwapTarget` 财务报告和审定财务报表 `validateTonSwapLeg`没有腿检查一个TON交换体 被拒绝。 一个TON —— EVM 代管机构 `verifyTonEscrowBuild`: 喷出量 商人作为所有者, 目的地链,地址和信使 报价的最低交货来自 程序,协议合同来自 `trustedProtocolAddresses`,以及代管代码、授权键和 时间档是审计时间档。 无 `verifyBuild` 引擎拒绝远程细胞体. - **TON —— EVM (英语)** (HTLC订单,钱包支付喷气机代管):工厂 允许列入两条链条, `validateTonJettonWallet`, (中文(简体) ), `validateTonEscrowPayload`, (中文(简体) ), `validateEvmOutputPosition`。 。 。 . - **EVM —— 顿** (无气令):钱包批准奥姆尼斯通令 协议(一英寸限制顺序协议 v4分叉, `trustedEvmOrderProtocols` 每条链子——与工厂不同的表,因为一个地址播放 并签署EIP-712 `Order`· ; `buildDeposit` 返回 a `typedData` `UnsignedTx` 只有在命令之后 已绑定的 v1beta8 扩展和序列化订单细节得到验证 反对引用, `registerSignedOrder` 把签名交给奥姆尼斯顿, 财务报告和审定财务报表 `trackIntent` 仅当 `validateEvmInputPosition` (最后确定) `SrcEscrowCreated` + 代管状态) 和 `validateTonOutputPosition` (部署在TON的有约束位置) 状态,在其完成窗口内)两个通过. 后面,我们走 `remoteProvider` 命令建在您的服务器上, 所以应用针 命令协议本身: `remoteProvider({name: "omniston", baseUrl, ...omnistonPins(trustedEvmOrderProtocols)})` ——同一个已审计的表格. 这个 然后,引擎只签名 `Order` 他们的核查合同是固定的 花花公子,这个账户是谁的造作者 正好卖掉交换的输入 源代码; a `Permit` 或任何其它打字信件被拒绝. 其余的订单是应用软件的检查,引擎签一个遥控器 仅以 `verifyBuild`数字 : `remoteProvider({name: "omniston", baseUrl, ...omnistonPins(AUDITED_OMNISTON_EVM_ORDER_PROTOCOLS), verifyBuild: omnistonVerifyBuild({...createOmnistonTonValidators()})})`。建筑承载 页:1 `orderExtension` 命令的盐承诺,和 `omnistonVerifyBuild` 打开两个: 信任的命令协议上的 v4 域名, 精确的 Order schema, `takingAmount` 至少报价的最小值, 单填顺序为无 允许寄件人和 过期后几分钟, 被封住 v1beta8 拍卖和收费 条件,一个可信任的代管工厂`trustedSettlementContracts`默认 作为扩展目标,列入白名单的解析器作为 指令的接收者 目的地链和信使 审计的时钟 TON标志和收件人 和引号。 散列锁是服务器的: 服务器持有 HTLC 秘密 。 这同样适用于EVM → EVM. `validateEvmTypedOrder` 用于保存结算数据的应用程序. - **EVM — EVM (英语)** (无气令,与EVM → TON 相同的命令协议):已签协议 扩展的 ExtraDataArgs 将目的地链、 令牌和存款和 与引文对照。 EVM的接收者在任何东西 钱包标记(它按未签名的命令细节),所以秘诀是 仅在 `validateEvmInputPosition` (来源填充,包括 目标补充)和 `validateEvmOutputPosition` (代管 受信任的工厂来自支付收款人的不可改变的许可证). 目的地代管人的收费分成必须是引用的协议和 合并费,只付给引文 `protocolFeeRecipientAddress` 编号 : 集成器,它的目的地阶段必须是1/120/180 s, 秘密是 未在取消阶段的45 s 内释放(反驳理由) 验证符 `onRefusal`) (中文(简体) ). ## 验证器 `@anywalletkit/protocol-swap2-omniston/validators` 由RPC/indexer支持的船舶 以上所有路线,加上已审计合同表: `createOmnistonEvmOutputValidator`, (中文(简体) ), `createOmnistonEvmInputValidator`, (中文(简体) ), `createOmnistonTonValidators` (TonAPI), (法语), `createOmnistonEvmDeliveryLocator` (饲料) `locateEvmDelivery`:完成的EVM指定命令随即携带 `destTxHash`,代管人给收受者的付款——Omniston的饲料名称 代管,而不是交易, `AUDITED_OMNISTON_SETTLEMENT_CONTRACTS`, (中文(简体) ), `AUDITED_OMNISTON_EVM_ORDER_PROTOCOLS`。不读取“部署环境”:通过您的 自己的终点为 `rpcUrls` (CAIP-2 = URLs,在公众倒计时前尝试) 财务报告和审定财务报表 `tonApiUrl` 编号 : `tonApiKey`。在无服务器上,也注入耐用 `secretStore` 编号 : `quoteStore` ——HTLC秘密必须活到民意调查 揭发它。 给引号商店一个 `claim` (原子创建- if- absent: Redis) : `SET NX`,一个有条件的 KV put : 平台选择引用 ids, 而上下文是 从来没有反弹到另一个用户的引文 在同一个ID。 秘密被泄露出来 只按确切的顺序锁定(存储在捆绑上),所以 反弹上下文一无所获. 目的地- 地层的证明要求从 解析器的调用数据 并通过可信任的工厂 `addressOfEscrowDst` (以区块时间戳印出) 宣布的工厂代管地址; 诱饵拖拉机或隐藏的不可移动器失效 关闭. ## 活动 `describeActivity(tx, ctx)` 以 TON 侧交易确认其交易 交易对手(原始形式比较,所以) `EQ…`, (中文(简体) ), `UQ…` 财务报告和审定财务报表 `0:…` 全部对齐),看 在目的地合同和每笔转让的双方: - STON.fi DEX路由器(`STONFI_ROUTERS` 内 `src/activity.ts`; v2.2 (中文(简体) ) `EQCS4UEa…cN3` 是钱包的交换打出的东西,v1为旧历史保存)- `swap`,"Swapped GRAM ~ $₮"/"Swapped $₮ ~ GRAM",副标题"STON.fi ~ TON". - 奥姆尼斯顿 HTLC 代管人(`OMNISTON_ESCROWS`,取而代之的密尔 `EQAbWJ3Y…mrZ` 每一个活的引用名称为 `srcProtocolContractAddress`页:1 `bridge`"Bridged USDQ",副标题"Omniston .STON.fi". EVM的脚由 解析器,无法识别离线. EVM — TON: EVM 腿是脱链签名(没有交易到 (b) 交付是同一代管合同中的喷气式飞机转帐 显示为 `bridge`有关EVM的任何信息都无法识别. 固定设备(`fixtures/activity/`,测试钱包 `UQCbXJ1-…fQaq`,托纳皮事件): 两次STON.fi互换(GRAM-USD₮,USD₮-GRAM)和一次代管订单(1.6美元₮); 负数: TON 上1Click的存款(一次性的平面喷气机转接) 地址——必须保持无效)和EVM LI.FI交换. ## 常见问题 ### @anywalletkit/protocol-swap2-omniston 是什么？ STON\.fi Omniston for Any Wallet Kit: TON在STON\.fi DEX和TON EVM / EVM 通过 HTLC 代管,在Omniston RFQ上互换稳定订单;独立或作为交换2路由器的提供者\. ### 如何安装 @anywalletkit/protocol-swap2-omniston？ 在项目目录运行 npm install @anywalletkit/protocol-swap2-omniston，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@anywalletkit/core（0\.8\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @anywalletkit/protocol-swap2-omniston 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @anywalletkit/protocol-swap2-omniston 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @anywalletkit/protocol-swap2-omniston 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @anywalletkit/protocol-swap2-omniston 可以商用吗？ @anywalletkit/protocol-swap2-omniston 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @anywalletkit/protocol-swap2-omniston 的下载量有多少？ 根据 npm 官方下载统计，@anywalletkit/protocol-swap2-omniston 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,558 次，日均约 85 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @anywalletkit/protocol-swap2-omniston 还在维护吗？ 最新版本 0\.5\.2 发布于 2026/11/05（2 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。