# @bosonprotocol/x402-evm 中文文档

规范地址：https://npmcn.com/package/%40bosonprotocol/x402-evm/

版本：0\.2\.2
npm 元数据更新时间：2026-09-14T10:21:27.143Z
中文译文更新时间：2026-11-08T11:55:25.797Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40bosonprotocol/x402-evm
原文对照：https://npmcn.com/package/%40bosonprotocol/x402-evm/?lang=original
项目主页：https://github.com/bosonprotocol/x402B/tree/main/typescript/packages/evm
源码仓库：https://github.com/bosonprotocol/x402B

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

- 包体积（解压后）：134 kB，33 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-05-27T16:25:51.069Z
- 最新版本发布：2026-09-14T10:21:26.803Z
- 近 30 天下载量：5161（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Boson Protocol EVM calldata + 适配器胶水用于x402代管方案——承诺步骤的内-动作ABI编码和viem QQ Web3LibAdapter桥. 环绕 @bosonprotocol/ core-sdk 其他所有东西 .

## 安装

```sh
npm install @bosonprotocol/x402-evm
```

也可以使用：`pnpm add @bosonprotocol/x402-evm`、`yarn add @bosonprotocol/x402-evm`、`bun add @bosonprotocol/x402-evm`

## README

# @bosonprotocol/x402-evm (英语)

用于 Boson 协议的 EVM 特定调用数据构建器 [`escrow`](https://github.com/bosonprotocol/x402-escrow-schema) 方案——EVM的半数 [x402B (韩语)](https://github.com/bosonprotocol/x402B) 执行.

见 `docs/boson-impl-00-overview.md` 用于上下文的单列波根.

## 范围

这个包裹船 **仅限** x402B 代管计划需要的 什麽 [`@bosonprotocol/core-sdk`](https://github.com/bosonprotocol/core-components) 已经规定:

| 子路径 | 目的 |
| --- | --- |
| `./actions` | 内部动作ABI为承诺步骤编码. `buildCreateOfferAndCommitCalldata` (Flow A, 推迟- redeem)和 `buildCreateOfferCommitAndRedeemCalldata` (Flow B,原子承诺+redeem)每个返回 `{ functionName, functionSignature }` 用于输入买方签名的元数据。 两位代表 `metaTx.handler.signMetaTx*({ returnTypedDataToSign: true })` 在核心- sdk 中,所以选择的字面编码和ABI编码来自买主所标注的同一来源——在签名和核实之间没有漂移. |
| `./adapters` | 维埃姆 维埃姆 `Web3LibAdapter` 桥梁. `walletClientToWeb3LibAdapter` 包裹一个viem `WalletClient` + 键 `PublicClient` 这样 `coreSdk.executeMetaTransaction(...)` (外接信封的统一出入口)可以通过viem配置的运输提交. 提交失败显示为标签 `RelayerSubmitError` 因此,呼叫者可以保存精确的错误代码(`INSUFFICIENT_FUNDS_FOR_GAS`, (中文(简体) ), `ONCHAIN_REVERT`, (中文(简体) ), `INTERNAL_ERROR`) (中文(简体) ). |

外部元tx信封(`executeMetaTransaction` 编号 : `executeMetaTransactionWithTokenTransferAuthorization`)为 **没有** 此处被重新执行. 通过 Core-sdk 提交 `coreSdk.executeMetaTransaction(metaTxParams)`,它接受 选项 `transferAuthorizations` 数组和向右的路由 内部进入点.

## 这个包裹是故意不运送的

Boson的元tx和直接呼叫流量 用于其他行动 已经完全覆盖 `@bosonprotocol/core-sdk`到达它 直接 :

### Meta-tx 签名( 默认) —— `coreSdk.signMetaTxXxx`

每个 `signMetaTxXxx` 方法在配置上 `CoreSDK` 实例使用 标注EIP-712 类型 `MetaTransactionsHandlerFacet` 期望这个行动家族(`MetaTxExchange` 页:1 `redeem/complete/cancel/revoke/raise/retract/escalate`, (中文(简体) ), `MetaTxDisputeResolution` 页:1 `resolveDispute`常规 `MetaTransaction` 页:1 `createOfferAndCommit` (见A/CN.9/WG.III/WP.83,第6段)。 它回来了 `SignedMetaTx = { functionName, functionSignature, r, s, v }` - 没错 购买方有效载荷 `X-PAYMENT` 车头载着,准备迎接 调解人通过 `coreSdk.executeMetaTransaction(metaTxParams)`。 。 。 .

```ts
const signed = await coreSdk.signMetaTxRedeemVoucher({ nonce, exchangeId });
// signed = { functionName: "redeemVoucher(uint256)", functionSignature, r, s, v }
```

`coreSdk` 填补 `web3Lib`, (中文(简体) ), `metaTxHandlerAddress`,以及 `chainId` 从 sDK实例,所以呼叫站点 保持最低。 独立 `metaTx.handler.signMetaTxXxx` 如果需要,也可以出口 他们没有 `CoreSDK` 举个例子.

### 直接链上提交- `coreSdk.xxx`

对于链上通道(买方自付汽油,或 "链上"倒下 `nextActions[i].channels`),使用同样的 `CoreSDK` 在一个呼叫中处理签名和提交问题的混合方法:

```ts
const tx = await coreSdk.redeemVoucher(exchangeId);
// → also: completeExchange, cancelVoucher, revokeVoucher,
//          raiseDispute, retractDispute, escalateDispute, resolveDispute
await tx.wait();
```

过 `returnTxInfo: true` 回来 `TransactionRequest` 手册 提交(例如交给中继器或分批器时)而不是 通过SDK的广播 `web3Lib`。 。 。 .

### 键侧 `approve` / 许可批准2

买方预先核准交易的呼叫数据构建者(由 `tokenAuthStrategy: "none"`)和一次性许可2合同批准 住在这里 [`@bosonprotocol/x402-core`](https://npmcn.com/package/%40bosonprotocol/core)数字 :

```ts
import {
  createErc20ApprovalTx,
  createPermit2ApprovalTx,
} from "@bosonprotocol/x402-core/eip712/token-auth";
```

## 常见问题

### @bosonprotocol/x402-evm 是什么？

Boson Protocol EVM calldata \+ 适配器胶水用于x402代管方案——承诺步骤的内-动作ABI编码和viem QQ Web3LibAdapter桥\. 环绕 @bosonprotocol/ core-sdk 其他所有东西 \.

### 如何安装 @bosonprotocol/x402-evm？

在项目目录运行 npm install @bosonprotocol/x402-evm，或使用 pnpm add / yarn add / bun add。

### @bosonprotocol/x402-evm 支持 TypeScript 吗？

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

### @bosonprotocol/x402-evm 支持 ESM 还是 CommonJS？

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

### @bosonprotocol/x402-evm 可以商用吗？

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

### @bosonprotocol/x402-evm 的下载量有多少？

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

### @bosonprotocol/x402-evm 还在维护吗？

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