@anywalletkit/protocol-swap2-omniston

中文文档
0.5.2发布于 2026/11/05Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2558

STON.fi Omniston for Any Wallet Kit: TON在STON.fi DEX和TON EVM / EVM 通过 HTLC 代管,在Omniston RFQ上互换稳定订单;独立或作为交换2路由器的提供者.

中文使用文档
文档目录4 节
  1. 安装
  2. 路线和大门
  3. 验证器
  4. 活动

@anywalletkit/protocol-swap2-omniston (英语)

npm

STON.fi Omniston作为互换2模块:TON QTON互换在STON.fi DEX上结算, 和TON EVM和EVM通过HTLC代管解决的EVM稳定订单 (resolver Arbiter),位于奥姆尼斯通WebSocket RFQ上. 独立通过 OmnistonSwap2Protocol,或作为路由器的提供者.

安装

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 (英语)发表于 发布工作流程 与出处.

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 <reason> (包括:. 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 共发布 15 个版本,首次发布于 2026/10/25;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.2latest2026/11/052 天前
0.5.12026/11/034 天前
0.5.02026/10/308 天前
0.4.02026/10/309 天前
0.3.12026/10/2910 天前
0.3.02026/10/2910 天前

关于 @anywalletkit/protocol-swap2-omniston 的常见问题

@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 和提交记录判断。