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

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

版本：0\.10\.1
npm 元数据更新时间：2026-11-05T12:22:19.697Z
中文译文更新时间：2026-11-06T08:10:52.102Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.5 MB，87 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：3 个
- peer 依赖：@anywalletkit/core 0\.8\.0
- 首次发布：2026-10-24T18:40:31.053Z
- 最新版本发布：2026-11-05T12:22:19.368Z
- 近 30 天下载量：3972（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

Any Walet Kit的互换2引擎:一个互换和桥接的接口,引文绑定,批准,审查门,费用上限和状态恢复;供应商作为单独的包插入.

## 安装

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

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

## README

# @anywalletkit/protocol-swap2分数

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

互换2引擎:一个用于互换和桥接("swap2")的接口,每个互换2供应商包都依赖执行安全.

## 安装

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

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

-   **`BaseSwap2Protocol` 编号 : `SingleProviderSwap2`** a 包括: `Swap2Protocol` (从) `@anywalletkit/core`)过一供养. 它引用,将执行与引用绑定起来,运行批准,发送,并由id恢复状态(`getSwap2Status`, (中文(简体) ), `claimSwap2` 用于两相路线.
-   **安全检查.** 引文验证,最小输出层,收费上限,签前有审查闸口,并拒绝说明理由. 身份识别像 `awk1.<provider>.<intent>[.<hash>]` (单位:千美元)`SWAP2_ID_PREFIX`) (中文(简体) ).
-   **`remoteProvider`** 在您的服务器上运行一个提供者( API 密钥, 共享状态) , 而应用程序则保存密钥和符号 。 后端不是钱包标志的权威: 将服务商包的针头放入柱子(`remoteProvider({name, baseUrl, ...lifiPins})`, (中文(简体) ), `fyndPins`, (中文(简体) ), `uniswapPins`, (中文(简体) ), `cctpPins`(......) (中文(简体) ). 引擎让一个EVM路线只调用被绑 `callTargets`,只批准钉入 `spenders`,并运行提供者自己的 `verifyQuote` (阴: `checkFyndTransaction`)在客户端上;一个没有被指针的树根完全得不到EVM呼叫数据路由(路由器随其原因而放弃),一个被指针的树根也没有被指针的呼号目标,但却没有携带对呼号本身的检查—— `verifyQuote`,或一个 `verifyBuild` 应用用品——因为一个被绑定的合同不管它的论点怎么说都会执行. 每发运的EVM接头都带有一个. 支付地址后端名称的路由 – 存款地址, 或纯值发送 – 只运行在打开的应用程序上 `depositAddressRoutes: true` (单位:千美元)`nearIntentsPins`· ; `thorchainPins()` 财务报告和审定财务报表 `chainflipPins` 每条链子上都有他们的金库。 任何提供商在互换的调用数据中每一次象征性的调用都必须移动出源的调用符,最多只能移动出互换金额;运营商和Preasure2批准书从来不是互换的主要调用. 键入的(无气)订单只有在是互换自己的限制顺序协议时才会签名 `Order` ——核查合同 = 经批准的结算合同,制造者 = 这个账户,来源符号,确切输入——从未输入过 `Permit*` 或另一个打出的消息; 提供者自己对构建的检查也可以运行在客户端上(`verifyBuild`),而一个远程 stub的打出的命令只有在它有一个时才会签名(Omniston: `omnistonVerifyBuild` 打开顺序 `orderExtension` 建筑载体。 TON 细胞体存款(`bodyBoc`)也捆绑着:它最多附加输入 `tonGasCeiling` 气体(默认 1 TON; 一个喷气通源: 单是天花板),喷气通源的机体必须是 TEP-74 完全从该账户的喷气通钱包中转出输入的 (`getJettonWalletAddress`)随着多余的返回到这里,解码机构到达审查(`cellBodyDecoded`),一个远程的stub的细胞体需要应用自己的验证器(`verifyBuild`) (中文(简体) ). 绝对的 `baseUrl` 必须是 `https:` (同一来源的路径很好;); `allowInsecureBaseUrl` (c) 促进地方发展。 具有索偿步骤(CCTP)的供应商也采取 `claimTargets` 从应用程序: `claimSwap2` 只有这些合同.
-   **`createSwap2Handler`** (单位:千美元)`@anywalletkit/protocol-swap2-core/server`, 只使用服务器) — 另一端 `remoteProvider`:验证每个请求,HMAC-searls只引用通过引擎自身检查的报价(`validQuote`: 提供者、输入、楼层、出错、过期; 否则502 , 并且只建有密封的、未过期的, 在每个互换标识( 跟踪、 索赔和通知而不拒绝) 上贴出意向符号, 用编辑过的 URL 传递拒绝; 您提供 `guard` (auth + 速率限制,它看到经验证的请求),并在每个用户签名的情况下, `subject` (引用和互换ID绑定给用户). 参考服务器 : [`examples/server`](https://github.com/ultratestbro/anywalletkit/tree/main/examples/server)。 。 。 .
-   **在目录之外** —— 说 `allowUnlistedTokens: true` 发动机上(和 `createSwap2Handler` 用于远程引擎)让一个互换名符号,目录在其EVM合同或索拉纳薄荷上没有列出:用户自己的代号. 默认关闭。 引擎读取符号的十进制 与账户 `getTokenInfo` 并把他们当作 `sourceDecimals`; 交易任何符号的提供者解决源 `sourceAssetOf(params)`其他人拒绝 批准和价值约束与目录符号相同. 通向未上市目的地的桥牌取自呼叫者的十进制 `toTokenDecimals` (在目的地链上读出), 绝不单独从引文中读出:一个引文 `destDecimals` 没有他们,索拉纳的玛雅人腿没有经过审查,也没有签字时被拒绝.
-   **错误** —— 说 `Swap2Error` 及其子类(引文、审定、执行、费用限制、现状.).
-   **活动助手** - 什麽 `describeActivity` 执行份额.

供应商住在自己的包里: `@anywalletkit/protocol-swap2-near-intents`, (中文(简体) ), `-lifi`, (中文(简体) ), `-thorchain`, (中文(简体) ), `-omniston`, (中文(简体) ), `-cctp`, (中文(简体) ), `-usdt0`, (中文(简体) ), `-chainflip`, (中文(简体) ), `-jupiter`, (中文(简体) ), `-uniswap`, (中文(简体) ), `-balancer`, (中文(简体) ), `-wrap`。 。 。 . `@anywalletkit/protocol-swap2-router` 拍卖其中几个.

文档 : [交换](https://docs.anywallet.tech/guides/swaps/)

阿帕奇 - 2.0

## 常见问题

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

Any Walet Kit的互换2引擎:一个互换和桥接的接口,引文绑定,批准,审查门,费用上限和状态恢复;供应商作为单独的包插入\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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