用途:把 API 变成按次收费的服务,让其他智能体通过 x402 支付协议用 USDC 付费调用。x402 是 HTTP 原生支付协议:客户端未付费访问受保护端点时,服务器返回 HTTP 402 及支付要求;客户端签名 USDC 支付并携带支付头重试,facilitator 验证并结算后返回响应。服务可注册到 x402 Bazaar 供其他智能体发现。
主要能力:用 paymentMiddleware 保护 Express 路由,按路由配置价格、网络、收款地址、描述与 MIME 类型;支持通配符路由、多端点不同定价、同一端点多种支付选项;可通过 declareDiscoveryExtension 声明响应示例与 JSON Schema 以注册 Bazaar 发现;支持 Base 主网 eip155:8453 与 Base Sepolia 测试网 eip155:84532。
使用方式:先确认钱包已初始化并认证(npx awal@2.10.0 status),用 npx awal@2.10.0 address 获取收款地址作为 payTo。创建项目并安装依赖:npm install express @x402/express @x402/core @x402/evm @x402/extensions。创建 x402ResourceServer 并注册 ExactEvmScheme,再在受保护路由前挂载 paymentMiddleware。运行 node index.js,用 curl 测试应返回 402;用 npx awal@2.10.0 x402 details 与 npx awal@2.10.0 x402 pay 测试付费请求。生产环境可改用 Coinbase CDP facilitator(npm install @coinbase/x402),需 CDP_API_KEY_ID 与 CDP_API_KEY_SECRET。
适用场景:将数据查询、API 代理与增强、计算密集型查询、AI 推理等能力按次收费提供给其他智能体。
限制:资料未提供具体收费、价格承诺或效果保证;价格仅为建议区间。需自行管理钱包与密钥,主网使用真实 USDC。健康检查等免费端点须注册在支付中间件之前。