用途:x402 是开放支付协议,复用 HTTP 402「Payment Required」状态码,让任意 HTTP 端点直接收取稳定币,适用于 API 按次付费与 AI 智能体间的自动商务。
主要能力:采用三参与者模型——Client(买家)、Resource Server(卖家)、Facilitator(结算)。支付即认证,客户端签名 USDC 转账授权并放入 X-PAYMENT 请求头,服务端验证签名与余额后放行。协议基于 EIP-3009 transferWithAuthorization 实现免 Gas 的 USDC 转账:客户端仅做链下 EIP-712 签名,由 Facilitator 广播上链并承担 Gas。支持 Base、Ethereum、Arbitrum、Optimism、Polygon 等实现 EIP-3009 的 EVM 链以及 Solana,网络用 CAIP-2 标识(如 eip155:8453)。nonce 为随机 bytes32,而非递增计数器,合约记录已用 nonce 防重放。
使用方式:服务端可安装 @x402/express、@x402/hono、@x402/next 中间件;客户端 TypeScript 用 @x402/fetch、@x402/axios,Python 用 pip install "x402[evm,requests]",Go 用 go get github.com/coinbase/x402/go。核心包为 @x402/core、@x402/evm、@x402/svm。CDP 托管 Facilitator 端点为 https://api.cdp.coinbase.com/platform/v2/x402,提供 /verify 与 /settle。也可用 createFacilitatorServer 自建 Facilitator。
适用场景:API 按请求/分层定价、AI 智能体自主发现并支付服务费用(如 .well-known/x402 发现端点)、多链多网络结算。
限制:主路径依赖 USDC 与 EIP-3009;Permit2 回退支持任意 ERC-20,但需用户预先授权且需原生 Gas。CDP 托管 Facilitator 免费额度为每月 1,000 笔交易,超出后每笔 $0.001,Base 主网 Gas 由 Facilitator 承担。Facilitator 仅负责广播,无法修改金额或收款地址。文档另指出常见误解:当前包名为 @x402/* 命名空间,旧的无 scope 包名与 @coinbase/x402 不适用;支付头名为 X-PAYMENT,响应头为 X-PAYMENT-RESPONSE。其余细节资料未完整提供。