用途:x402 是开放标准,把 HTTP 402 Payment Required 用于程序化链上支付,客户端通过 HTTP 直接提交签名加密交易完成付款,无需账户、会话或 API 密钥。适合构建接受加密微支付的付费 API、为网页内容或端点加付费墙、让 AI 智能体自主为资源付费、集成需付费的 MCP 工具、构建智能体间(A2A)支付流,以及按用量计费(upto 方案,如 LLM token、带宽、算力)。
主要能力:每次支付涉及三个角色——资源服务器保护端点并返回 402 与支付要求,客户端签名支付授权并带支付头重试,facilitator 验证签名并在链上结算。HTTP 流程为:客户端请求资源,服务器返回 402 与 PAYMENT-REQUIRED 头;客户端签名后带 PAYMENT-SIGNATURE 重试;服务器向 facilitator 调用 /verify 与 /settle;最后返回 200、PAYMENT-RESPONSE 头与资源数据。支持 exact(精确转账)、upto(授权上限、按实际用量结算)、batch-settlement、auth-capture 等方案,支持自托管进程内 facilitator,以及 HTTP、MCP、A2A 传输和 bazaar、offer-receipt、payment-identifier、sign-in-with-x、gas sponsoring 等扩展。
使用方式:官方提供 TypeScript、Python、Go 绑定,Java 绑定在仓库中但尚未发布到包注册表。安装示例:npm install @x402/express @x402/core @x402/evm;pip install "x402[fastapi,evm]";go get github.com/x402-foundation/x402/go/v2(Go 模块路径带 /v2 后缀)。服务端可用 Express、Fastify、Hono、Next.js 中间件或 FastAPI、Flask 中间件;客户端可用 Axios 拦截器或 Fetch 封装。默认 facilitator 为 https://x402.org/facilitator。
适用场景与限制:支持 EVM(Base、Ethereum、MegaETH、Monad、Polygon、Stable、Arbitrum、XDC、Mezo、Avalanche、Radius、ADI、HPP、Igra)、Solana、Stellar、Aptos、NEAR、XRPL、TON、Hedera、Algorand、Keeta、Concordium 等多条网络,具体主网/测试网状态与 CAIP-2 ID 见资料。注意:公共 x402.org facilitator 仅面向开发与测试网工作流,不应假定为生产主网默认路径;部分网络与方案仅支持特定 SDK(如 Stellar、Aptos、NEAR、XRPL 仅 TypeScript SDK),upto 方案目前仅 EVM Permit2,XRPL 不支持费用赞助。生产部署需切换 facilitator URL、网络 ID 与钱包地址。