用途:x402 协议重新启用 HTTP 402 Payment Required 状态码,让付费内容或 API 通过 HTTP 直接完成区块链支付。x402-rs 是配套 Rust 库,用于构建付费服务端、自动付费客户端和 facilitator。
主要能力:协议涉及客户端、资源服务器、facilitator 三方。客户端生成链下签名,facilitator 负责验证与链上结算,客户端不直接接触区块链。库按 crate 拆分:x402-types(协议类型、CAIP-2 链 ID、V1/V2 线格式)、x402-axum(服务端 Axum 中间件)、x402-reqwest(客户端 Reqwest 中间件)、x402-facilitator-local(本地验证结算)、x402-chain-eip155、x402-chain-solana、x402-chain-aptos(仅 git 依赖)及生产用 x402-facilitator 二进制。支持任意 ERC-20 代币、多链同时收款、动态定价、结算时机选择(handler 前或后)、自定义 facilitator 端点。EVM 免 gas 机制包括 EIP-3009、Permit2、EIP-2612。V1 与 V2 协议并存,V2 使用 CAIP-2 链 ID 与 Payment-Signature 头,建议新项目用 V2。
使用方式:服务端在 Cargo.toml 引入 x402-axum 与链 crate(server feature),用 X402Middleware 保护路由并设置 price_tag;客户端引入 x402-reqwest 与链 crate(client feature),注册签名者后支付自动处理;facilitator 可用 Docker 运行 ghcr.io/x402-rs/x402-facilitator,或 cargo run --package x402-facilitator --features full。
适用场景:付费 API、按次计费数据接口、多链收款服务、需要免 gas 支付的代理程序。
限制:Aptos 与生产 facilitator 不在 crates.io;Permit2 需用户一次性 approve;具体收费、价格与效果资料未提供。