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

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

版本：0\.6\.1
npm 元数据更新时间：2026-11-06T21:21:57.801Z
中文译文更新时间：2026-11-06T22:29:12.577Z
软件包许可：Apache-2\.0

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

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

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

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

## 中文简介

LI.FI通过LI.FI Diamond进行跨链互换和桥接任何钱包包:EVM路线,单独或作为交换2路由器的提供者守卫索拉纳交易.

## 安装

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

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

## README

# @anywalletkit/protocol-swap2-lifi (英语)

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

LI.FI REST 作为互换2模块的跨链互换和桥:EVM呼叫数据 穿越LI.FI钻石的路线(通过防守序列的索拉纳腿) 交易)。 独立通过 `LifiSwap2Protocol`,或作为 `@anywalletkit/protocol-swap2-router`。 。 。 .

## 安装

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

时间: [@anywalletkit/protocol-swap2-lifi (英语)](https://www.npmjs.com/package/@anywalletkit/protocol-swap2-lifi)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处.

## 引用前所检查的内容

引用 `action` 必须匹配请求(链条、令牌、数量、发送者、收件人)、 交易必须针对连锁公司的LI.FI钻石和钻石 **调用数据** 已解码,必须 采取同样的做法:同链互换(GenericSwapFacet / V3)至少向受审查者支付 经审查的最低数额,支出输入符并交付请求的;桥接电话必须是 一个LI。 金融情报室的名单上 `startBridgeTokensVia*` 编号 : `swapAndStartBridgeTokensVia*` 入口(包装) 拒绝打电话) `BridgeData` 必须指定被审查的接收者和链条,并连接 输入符(或其源交换对它的影响). 退款、存款人或退款地址a 桥载自有数据(Stargate's LayerZero的退款,过期的交叉存款或LI.FI) 意向,玛雅斯威夫特命令的商人,Chainflip的退款地址,...)必须是发件人或发件人 接收者。 拒绝,因为接收者无法从调用数据读取:有目的地呼叫的路由,EVM源路由到非EVM链,以及 其面部不绑定交货的桥梁 `BridgeData` (续曰:园圃也;德布里奇DLN也, ThorSwap, Squid, Symbiosis)——跨链请求请LI.FI绕接Relay, Garden, Squid 绕行 和共生,不提供目的地电话`allowDestinationCall=false`),所以他们的对得到 又一座桥 未知的调用数据被拒绝 .

每一个交换步骤都读取,不仅仅是结尾: 每一个步骤必须花在交付之前,只有 花掉输入符的步骤可能从钱包中拉出(`requiresDeposit`)),最多在一起 投入——拒绝在旧津贴下采取中间步骤。 V3入境点是: 与转移的资产种类挂钩(`*ToNative` 只为本族的产物, `*ToERC20` 为一种迹象, `NativeTo*` 编号 : `ERC20To*` ),因为每个值都计入了自身资产的最低值。 A 类 没有源交换的桥必须桥接输入,最多减少1%的桥接费. `apiUrl` 必须是 `https:` (单位:千美元)`allowInsecureApiUrl` (c) 促进地方发展.

大部分没有选中: 桥的输出 。 最低目的地——以及一些桥梁(中继、横跨) 最终到达接收者的—— 以桥接数据为单位, 因此在大多数跨链路上 经审查的最低限度依靠LI。 FI的API(或您的 `apiUrl` 代理)诚实回答. 两个桥名 它直截了当地被引用:生态意图必须在目的地及其路线上运行 必须在目的地标志中结束 `transfer` 至少是接受审查的最低数额 (拒绝16通以上电话的路线); M0命令必须在 至少为审查的最低比率。 M0命令可以部分填入:然后接收者得到 以命令的速率分享,其余输入则在命令的速率后返回发送者 填入截止日期。 也不可能通过这个模块(Eco 或 M0 路径)来传递原生符号 目的地标志是本地的(ETH,POL,.)总是被拒绝的. 模块不再询问 LI.FI 所以,当LI.FI选择其中之一 对于这样的一对,对 显示没有LI.FI路线.

`routeWideSlippage: true` (默认关闭) 向 LI.FI 请求整个路线的一次滑行预算 (单位:千美元)`slippageScope=route`EVM – EVM 请求,而不是每一步一个;当 LI.FI 能够保护否 请求的路由`ROUTE_SLIPPAGE_UNSUPPORTED`)或已关闭全程滑行 (单位:千美元)`ROUTE_SLIPPAGE_UNAVAILABLE`)),在默认范围中再次被问到,被困在同一层. 那个 引用时会发生,所以引用的用户评论是每步一次,有其自身的最小值.

## 后面,我们走 `remoteProvider`

当供应商运行在您的服务器上时, 将它的接头分散到应用程序的分贝中: `remoteProvider({name: "lifi", baseUrl, ...lifiPins})`。然后引擎让 EVM 路由呼叫和 只批准该链条的LI.FI钻石,从不批准后端名称的地址,以及 `lifiVerifyQuote` 解码 服务器的"钻石"(Diamond)调用设备,同时使用供应商运行在LI上的相同检查. FI 的回答( 收到、 最小值、 输入) 符号和金额、输出符号、目的链、退款地址;输入类型的价值和批准)。 没有了针头 树枝 无法获得 EVM 调用数据路由( 未关闭) .

## 活动

`describeActivity(tx, ctx)` 发现LI.FI钻石 EVM 链条 本模块路线——每条链条记录的钻石(`provider.ts`, (中文(简体) ), `LIFI_DIAMONDS`加上任意 `trustedTransactionTargets` 您已配置 :

-   通用SwapFacetV3 选择器(`swapTokensSingleV3…` 编号 : `swapTokensMultipleV3…`, (中文(简体) ), 列入清单 `src/activity.ts`页:1 `swap`,"从地主的网"取出"Swapped A B" 转让(包括内侧腿,例如 " 擦去的USDT-ETH").
-   其它方位( N)`swapAndStartBridgeTokensVia…`, (中文(简体) ), `startBridgeTokensVia…`(中文(简体) ) 是桥的源腿 ~ `bridge`,"Bridged A" (英国英语). 尘埃入去 在同一交易中的退款(玛雅WETH退款)不会变成 交换.
-   子标题"Li.FI",对应方="钻石". 目的地的腿是给的 另一条链由第三方中继器,不能被绑回下线,所以 `related` 保留为空——工具包的意向日记链接了两条腿.

未识别: Solana legs(尚未在正态 tx 中设置程序级别标记), 和一桥的目的地一侧(从中继器中普通的转接).

固定设备(`fixtures/activity/`,测试钱包 `0x8AbE…55bA` 以物配主者,两人 同链互换(USDT-USDC,USDT-ETH), 三条桥源腿 (续存,玛雅有回扣,NEARINENTENTS facet;底片:一THORCHIN) `depositWithExpiry`一个WETH9 `deposit()`。 。 。 .

## 常见问题

### @anywalletkit/protocol-swap2-lifi 是什么？

LI\.FI通过LI\.FI Diamond进行跨链互换和桥接任何钱包包:EVM路线,单独或作为交换2路由器的提供者守卫索拉纳交易\.

### 如何安装 @anywalletkit/protocol-swap2-lifi？

在项目目录运行 npm install @anywalletkit/protocol-swap2-lifi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@anywalletkit/core（0\.8\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @anywalletkit/protocol-swap2-lifi 支持 TypeScript 吗？

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

### @anywalletkit/protocol-swap2-lifi 支持 ESM 还是 CommonJS？

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

### @anywalletkit/protocol-swap2-lifi 需要什么版本的 Node\.js？

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

### @anywalletkit/protocol-swap2-lifi 可以商用吗？

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

### @anywalletkit/protocol-swap2-lifi 的下载量有多少？

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

### @anywalletkit/protocol-swap2-lifi 还在维护吗？

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

