@anywalletkit/protocol-swap2-router

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

任意钱包套件的可选互换2聚合器: 拍卖 由您安装和传递的互换2提供者进行.

中文使用文档
文档目录4 节
  1. 安装
  2. 提供跨链互换的三种方式
  3. 如何选择胜者
  4. 活动

@anywalletkit/protocol-swap2路由器

npm

可选互换2聚合器. 每个供应商模块-lifi, (中文(简体) ), -near-intents, (中文(简体) ), -thorchain, (中文(简体) ), -omniston, (中文(简体) ), -cctp, (中文(简体) ), -uniswap, (中文(简体) ), -balancer, (中文(简体) ), -wrap独立工作;在 您想要一个协议 拍卖一条跨供应商的路线 你们 传入。 它没有捆绑.

安装

npm install @anywalletkit/protocol-swap2-router @anywalletkit/core
# or: pnpm add @anywalletkit/protocol-swap2-router @anywalletkit/core  ·  yarn add @anywalletkit/protocol-swap2-router @anywalletkit/core

时间: @anywalletkit/protocol-swap2路由器发表于 发布工作流程 与出处.

提供跨链互换的三种方式

1. 一项协议,无汇总器. 安装单一提供者并使用自己的协议类.

import {LifiSwap2Protocol} from "@anywalletkit/protocol-swap2-lifi";
const swap2 = new LifiSwap2Protocol(account, {fromChain: "eip155:1"});

2. 为用户选取聚合物. 引用并行的每个提供者,验证每个引用 同样的方式,并处决胜者.

import {RouterSwap2Protocol, usdValue} from "@anywalletkit/protocol-swap2-router";

const swap2 = new RouterSwap2Protocol(account, {
  fromChain: "eip155:1",
  providers: [lifiProvider({}), nearIntentsProvider({}), cctpProvider({rpcUrls})],
  valueUsd: usdValue(prices),   // optional: rank on net USD (see below)
  prefer: "best",               // or "fastest"
});
await swap2.swap2({fromToken: "USDC", toToken, toChain: "eip155:8453", fromTokenAmount, minAmountOut});

3. 带取道器的聚合器. 列出每条路线,标有最好和最快的标记,让我们 用户选择,然后精确执行提供者.

const routes = await swap2.quoteSwap2Routes(options, {
  // Called each time another provider answers: show the first price at once,
  // a "searching…" hint while `pending` is non-empty.
  onUpdate: (routes, pending) => render(routes, pending),
});
// routes[i] = {provider, quote, netValueUsd, relativeValue, tags: ["best"] | ["fastest"] | …}
await swap2.using(picked.provider).swap2({...options, minAmountOut: picked.quote.toTokenAmountMin});

下一个级别也是如此 CrossChainRouter#getQuotes(params, {onUpdate})。 。 。 .

如何选择胜者

  1. 价值. 与 valueUsd (例如:. usdValue(prices, {gasUsd})每条引文都值得保证 产出(美元)减去最高路由费:当地桥梁费,当你能说时, 来源气体。 没有每一报价的价格 拍卖比较保证的产出.
  2. 先标价. 引用在 tieBand (默认值为0.2%)最高值的同价.
  3. 速度和可靠性在领带内. 在等价中,越快越可靠, 路径胜出( e)weights默认值 price:0.6,speed:0.3,reliability:0.1) (中文(简体) ). 额外输出的活口没有 超过20倍的航道, 真正的价格差距仍然取胜.

fastest 总是最低的ETA。 每个报价都会通过引擎的检查 然后再排出排行榜 已执行的路由在签署任何文件之前,以它密封的引号重新验证.

活动

路由器通过任何提供者胜出执行,所以没有交易 其所属单位: describeActivity(tx, ctx) 按顺序询问每个已安装的提供者 并返回第一个描述(没有人要求交易时取消,或 当路由器没有提供者时。 每个提供者软件包记录其内容 承认(@anywalletkit/protocol-swap2-lifi - LI.FI钻石电话, -thorchain • 路由器 depositWithExpiry 编号 : transferOut, (中文(简体) ), -cctp 燃烧和 索赔, -uniswap 编号 : -balancer 编号 : -wrap - DEX路由器 / Vault / WETH9 呼叫, -omniston STON.fi路由器 和Omniston代管在TON, -near-intents – 报告 intents.near - 腿吗? 这里的合规装置是公开的WETH9存款 由测试后提供者确认,证明授权; 阴性是 LI.FI 互换未安装的供应商债权.

版本与发布记录

@anywalletkit/protocol-swap2-router 共发布 15 个版本,首次发布于 2026/10/25;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

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

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

@anywalletkit/protocol-swap2-router 是什么?

任意钱包套件的可选互换2聚合器: 拍卖 由您安装和传递的互换2提供者进行.

如何安装 @anywalletkit/protocol-swap2-router?

在项目目录运行 npm install @anywalletkit/protocol-swap2-router,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@anywalletkit/core(0.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@anywalletkit/protocol-swap2-router 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@anywalletkit/protocol-swap2-router 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@anywalletkit/protocol-swap2-router 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@anywalletkit/protocol-swap2-router 可以商用吗?

@anywalletkit/protocol-swap2-router 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@anywalletkit/protocol-swap2-router 的下载量有多少?

根据 npm 官方下载统计,@anywalletkit/protocol-swap2-router 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,300 次,日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@anywalletkit/protocol-swap2-router 还在维护吗?

最新版本 0.5.3 发布于 2026/11/07(今天);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。