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

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

版本：0\.4\.4
npm 元数据更新时间：2026-11-06T21:21:21.138Z
中文译文更新时间：2026-11-06T21:47:22.283Z
软件包许可：Apache-2\.0

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

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

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

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

## 中文简介

Chainflip金库互换换互换2引擎:本地BTC / ETH / SOL / TRX 和 USDC / USDT 通过Chainflip的公共后端(它自己的经纪人,0 bps,没有账户)跨越埃特鲁姆,阿比特鲁姆,索拉纳,特龙和比特币. 本版的资料来源:Ethereum、Arbitru

## 安装

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

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

## README

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

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

[链脚](https://docs.chainflip.io/) 保险库互换为互换2 提供者: 本地 BTC / ETH / SOL / TRX 和 USDC / USDT 在伊特鲁姆,阿比特鲁姆,索拉纳,特龙之间 比特币,由Chainflip的JIT AMM定价. 引用和编码来自 Chineflip的公用后端 (`chainflip-swap.chainflip.io`) (中文(简体) ). 你不需要经纪人 账户,没有 API 密钥,佣金为 0 bps.

## 安装

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

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

```ts
import {chainflipProvider} from "@anywalletkit/protocol-swap2-chainflip/provider";
import {RouterSwap2Protocol} from "@anywalletkit/protocol-swap2-router/swap2/router";

const swap2 = new RouterSwap2Protocol(tronAccount, {fromChain: "tron:728126428", providers: [chainflipProvider()]});
const res = await swap2.swap2({fromToken: "USDT", toToken: "USDC", toChain: 42161, fromTokenAmount: 20_000_000n});
const status = await swap2.getSwap2Status(res.id); // pending → depositReceived → completed (+ egress tx) | refunded
```

| 从 (出自) | 互换是如何发送的 |
| --- | --- |
| 伊特鲁姆,阿比特鲁姆 | `xSwapNative` 编号 : `xSwapToken` 在链条倒塌地块上; 令牌首先获得对地块的确切批准 |
| 龙 | TRC-20 USDT(或TRX) **切换到**,将交换作为二进制音符 `raw_data.data` (单位:千美元)`memoEncoding: "hex"`(中文(简体) ) |

目的地:Ethereum(ETH、USDC、USDT、WBTC)、Arbitrum(ETH、USDC、USDT)、, 索拉纳(索拉纳、美国得克、美国得克)、特龙(TRX、美国得克)和比特币(BTC)。 索拉纳和 比特币作为 **来源** 还没有接线.

## 为什么金库互换而不是存款渠道

一个存款频道是Chainflip经纪人为你打开的地址. 这个 客户端无法证明该地址在哪些地方转发资金:后端没有 用存款地址查查 有了金库交换,交换参数就在 交易本身——在EVM上的调用数据,在Tron上的注释——所以钱包可以 在签名前解码并检查它们. Tron 保险库交换也跳过 频道的入侵成本(2026-10-20年:20美元 — 19.48美元) -19.5%通过频道).

## 签名前检查什么

提供者从不盲目地转发编码器的输出. `getQuote` 解码 (会议) `VersionedCfParameters` V1,Tron笔记,或EVM Vault ABI)和 拒绝引用, 除非所有下列保留 :

-   目标为已知源链的断层(`CF_VAULTS`) (中文(简体) ). 打开它 一定是TRC -20型机车 `transfer(Vault, amountIn)` 引证;
-   目的链 id、 输出资产 id 和目的地址字节 与请求相匹配(EVM hex、Tron 20 B、Solana 32 B、BTC为ASCII);
-   退款地址是发件人,互换是填充或杀死: `minPriceX128 ≥ ceil(minOut · 2^128 / amountIn)`,重试 600个区块 我们要求的是神谕的护卫;
-   没有DCA、没有提振、没有经纪人佣金和附属公司.

最小输出是呼叫者的 `minAmountOut` 或预期 金额减去滑动( e)`slippageBps`,或后端的建议何时 没有。 如果在重试窗口内无法满足价格, Chainflip 向发送者退还输入.

## 最低限度

这些是链脚的每个资产入侵的最低值。 少一点就不用引用了. Ethereum USDC/USDT:20. 阿比特伦,索拉纳和特隆马厩:10. BTC:40000座. 特克斯:30号.

## 状态

`trackIntent` 读取 `GET /v2/swaps/{sourceTxHash}`数字 :

-   404表示尚未看到交换(待定);
-   收款、汇兑和汇兑是指收到押金;
-   完整返回目标 tx (`swapEgress.txRef`(三);
-   错误返回 `refunded` 如果有退款退款,否则 `failed`。 。 。 .

端点收分限(429);提供方重试一次.

## 后面,我们走 `remoteProvider`

当供应商运行在您的服务器上时, 将它的接头分散到应用程序的分贝中: `remoteProvider({name: "chainflip", baseUrl, ...chainflipPins})`。然后引擎让 EVM 路由呼叫和 只批准 chainflip 断层 `CF_VAULTS`后端名称;没有后端名称,则根部不会 EVM 调用数据路由( 未关闭) 。 钉子上放着 `verifyQuote: chainflipVerifyQuote`,提供商自己的解码运行 在设备上: EVM 金库呼叫,或Tron Note, 必须指定应用程序的目的地,退款地址和最小值 价格保证报价最低。 Tron金库交换是Tron地铁的寄件,所以针头也打开了 存款路线的支点(`depositAddressRoutes`),核查者会把它付的"瓦特"(Vault)钉上.

## 配置

```ts
chainflipProvider({
  enabled: true,                    // default
  apiUrl: "https://chainflip-swap.chainflip.io",
  maxOraclePriceSlippageBps: 100,   // oracle guard in the fill-or-kill params; default = the quote's recommendation, null = off
})
```

## 常见问题

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

Chainflip金库互换换互换2引擎:本地BTC / ETH / SOL / TRX 和 USDC / USDT 通过Chainflip的公共后端\(它自己的经纪人,0 bps,没有账户\)跨越埃特鲁姆,阿比特鲁姆,索拉纳,特龙和比特币\. 本版的资料来源:Ethereum、Arbitru

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

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

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

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

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

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

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

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

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

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

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

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

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

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