@bosonprotocol/x402-evm

中文文档
0.2.2发布于 2026/09/14Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 5161

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

中文使用文档
文档目录5 节
  1. 范围
  2. 这个包裹是故意不运送的
  3. Meta-tx 签名( 默认) —— coreSdk.signMetaTxXxx
  4. 直接链上提交- coreSdk.xxx
  5. 键侧 approve / 许可批准2

@bosonprotocol/x402-evm (英语)

用于 Boson 协议的 EVM 特定调用数据构建器 escrow 方案——EVM的半数 x402B (韩语) 执行.

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

范围

这个包裹船 仅限 x402B 代管计划需要的 什麽 @bosonprotocol/core-sdk 已经规定:

子路径目的
./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)。 。 。 .

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 在一个呼叫中处理签名和提交问题的混合方法:

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数字 :

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

版本与发布记录

@bosonprotocol/x402-evm 共发布 10 个版本,首次发布于 2026/05/28;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.2latest2026/09/141 个月前
0.2.2-alpha-0alpha2026/09/141 个月前
0.2.12026/06/114 个月前
0.2.1-alpha-02026/06/114 个月前
0.2.02026/05/285 个月前
0.1.1-alpha-22026/05/285 个月前

关于 @bosonprotocol/x402-evm 的常见问题

@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 和提交记录判断。