x402 Payments 是 XActions 对 x402 支付协议的支持,x402 是一种 HTTP 原生的加密货币微支付标准,用于按次付费的 API 访问。
用途:让受保护的 XActions API 路由支持加密货币按次计费,无需订阅。
主要能力:
- 多链支持:Base、Ethereum、Polygon、Arbitrum。
- 多代币支持:base 支持 USDC、ETH;ethereum 支持 USDC、USDT、ETH;polygon 支持 USDC、MATIC;arbitrum 支持 USDC、ETH。
- 按路由定价,例如 POST /api/operations/unfollow 为 0.01 USDC,POST /api/operations/follow 为 0.005 USDC。
- 支付证明在链上加密验证后才执行操作。
入口与发现:
- GET /.well-known/x402:公开,返回可支付路由、支持网络、各网络代币合约地址及支付验证端点。
- GET /api/x402/openapi:公开,返回带支付信息的 OpenAPI 规范。
- 任意受保护路由:使用带 x402 头的 REST API 调用。
配置:位于 api/config/x402-config.js,包含 networks、tokens、pricing 等设置。
手动集成流程:先请求受保护路由,收到 402 Payment Required 及 X-Payment-Required 头(含 amount、token、network、recipient);再提交链上支付与证明,通过 X-Payment 头传入签名支付证明。
中间件:api/middleware/x402.js 负责识别受保护路由、返回 402 及支付详情、验证支付证明,并跨四条链进行多链验证。
支持的客户端:x402-axios、x402-fetch、带 x402 MCP 工具的 Claude 智能体,以及遵循 x402 规范的自定义实现。
限制与说明:x402 为按请求付费,无需订阅;Stripe 订阅计费(billing-management 技能)仍作为替代方案。相关技能包括 billing-management、xactions-mcp-server、a2a-multi-agent。