SuperAPI AI 工具集

x402

智能体与模型

查看项目

更新于 10-15 20:12

技能介绍

用途:x402 复用 HTTP 402 "Payment Required" 状态码,使任意 HTTP 接口可即时收取稳定币付款,常用于 AI 智能体之间的自动付费调用(服务发现、按次计费)。付款即认证,无需 API 密钥、会话或账户。

主要能力:采用客户端(买方)、资源服务器(卖方)与 Facilitator(结算)三方模型。基于 EIP-3009 的 transferWithAuthorization 实现免 Gas 的 USDC 转账——客户端离线签名 EIP-712 授权,Facilitator 广播链上结算并支付 Gas。支持实现 EIP-3009 的 EVM 链(Base、Ethereum、Arbitrum、Optimism、Polygon)及 Solana,网络标识采用 CAIP-2 格式。支付头为 X-PAYMENT(base64 编码 JSON),响应头为 X-PAYMENT-RESPONSE。

使用方式: 服务端(TypeScript):npm install @x402/core @x402/evm @x402/express,也可用 @x402/hono、@x402/next。 客户端(TypeScript):@x402/fetch、@x402/axios。 客户端(Python):pip install x402(示例用 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。 流程:请求资源→返回 402 及付款要求(scheme、network、amount、asset、payTo)→客户端签名并以 X-PAYMENT 重试→服务器经 Facilitator /verify 校验→返回资源→/settle 链上结算。可用于 Express、Hono、Next.js 中间件。

限制与注意:金额以最小单位表示(USDC 6 位小数,10000=$0.01)。nonce 为随机 bytes32,非顺序计数器,复用或顺序使用会导致结算回滚。客户端不支付 Gas。主路径用 USDC;Permit2 回退方案需用户预先授权且有原生 Gas。早期包名 x402-express、x402-fetch 无作用域,@coinbase/x402 从未发布。CDP 托管 Facilitator 免费额度为每月 1,000 笔,之后每笔 $0.001,Base 主网免 Gas;也可自建 Facilitator。其他功能、价格或平台细节资料暂未提供。