SuperAPI AI 工具集

x402-payments

通用与其它

查看项目

更新于 10-15 17:23

技能介绍

用途:帮助开发者使用 x402 协议构建应用。x402 是 Coinbase 的开放标准,利用 HTTP 402 状态码把稳定币支付嵌入 HTTP,服务器返回付款要求,客户端签名授权后重发请求,验证结算后取得资源。

主要能力:提供卖家侧(保护 API 端点)与买家/智能体侧(付费访问资源)的快速上手流程。支付流程为:客户端发请求、服务器返回 402 与 PAYMENT-REQUIRED 头、客户端生成签名付款载荷、带 PAYMENT-SIGNATURE 头重发、服务器经 facilitator 的 /verify 验证、执行工作并通过 /settle 结算、返回 200 与含 txHash 的 PAYMENT-RESPONSE 头。

使用方式:安装 @x402/express、@x402/core、@x402/evm 等包;服务器通过 paymentMiddleware、paymentProxy 等接入 Express、Next.js、Hono;客户端可用 wrapFetchWithPayment、wrapAxiosWithPayment 或 @x402/core 的 x402Client + x402HTTPClient。链上支持 EVM 的 registerExactEvmScheme 与 Solana 的 registerExactSvmScheme。网络以 CAIP-2 标识,如 eip155:84532(Base Sepolia)、eip155:8453(Base Mainnet)。

适用场景:面向按请求付费的 API 保护、AI 智能体付款、MCP 服务器、工具发现与预算控制等。

限制:生产方案为 exact;upto 与 deferred 仍为提议。Python SDK 仅用 V1 模式,V2 需 TypeScript 或 Go;TypeScript SDK 需 Node.js v24+。价格格式为美元字符串,SDK 转换为原子单位。测试网用 https://x402.org/facilitator,主网用 CDP facilitator 及 API 密钥。资料标注时效为 2026 年 7 月,需核对定价、模型 ID 与协议细节。