# @anywalletkit/protocol-swap2-router 中文文档

规范地址：https://npmcn.com/package/%40anywalletkit/protocol-swap2-router/

版本：0\.5\.3
npm 元数据更新时间：2026-11-06T21:21:48.275Z
中文译文更新时间：2026-11-06T21:46:00.116Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anywalletkit/protocol-swap2-router
原文对照：https://npmcn.com/package/%40anywalletkit/protocol-swap2-router/?lang=original
项目主页：https://docs.anywallet.tech/
源码仓库：https://github.com/ultratestbro/anywalletkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：304 kB，34 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：2 个
- peer 依赖：@anywalletkit/core 0\.8\.0
- 首次发布：2026-10-24T18:42:25.585Z
- 最新版本发布：2026-11-06T21:21:47.769Z
- 近 30 天下载量：2300（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

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

## 安装

```sh
npm install @anywalletkit/protocol-swap2-router
```

也可以使用：`pnpm add @anywalletkit/protocol-swap2-router`、`yarn add @anywalletkit/protocol-swap2-router`、`bun add @anywalletkit/protocol-swap2-router`

## README

# @anywalletkit/protocol-swap2路由器

[![npm](https://img.shields.io/npm/v/@anywalletkit/protocol-swap2-router?label=npm)](https://www.npmjs.com/package/@anywalletkit/protocol-swap2-router)

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

## 安装

```sh
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路由器](https://www.npmjs.com/package/@anywalletkit/protocol-swap2-router)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处.

## 提供跨链互换的三种方式

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

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

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

```ts
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\. 带取道器的聚合器.** 列出每条路线,标有最好和最快的标记,让我们 用户选择,然后精确执行提供者.

```ts
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 是什么？

任意钱包套件的可选互换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 和提交记录判断。