（1795期）x402 (official examples) – API 微支付协议 · 多链即时结算

API 微支付协议 · 多链即时结算 Coinbase 推出的开源 API 微支付协议，基于 HTTP 402 标准实现无账户、即时稳定币结算，支持多链 EVM/Solana 及 AI 代理自动化支付。 使用说明 核心用法 x402 是 Coinbase 主导开发的互联网原生支付协议，复活了 HTTP 402 Payment Required 状态码，用于 API 和数字资源的程序化支付。协议采用「请求-支付-验证」三步模型：客户端请求资源 → 服务端返回 402 + 支付指令 → 客户端签名提交链上支付 → 服务端验证后返回资源。 协议支持双角色接入： 买方（Buyer）：通过 @x402/fetch、@x402/axios（TypeScript）或 x402[httpx]、x402[requests]（Python）等客户端库，将现有 HTTP 请求自动包装为带支付能力的调用 卖方（Seller）：通过 @x402/express、@x402/hono、x402[fastapi]、x402[flask] 等中间件，为指定路由配置定价和收款地址，自动拦截未支付请求 多链支持涵盖 Base、Polygon、Avalanche、Sei、X Layer、SKALE 等 EVM 链及 Solana，采用 CAIP-2 网络标识符。支付验证可由 Facilitator（托管服务）或自托管完成，官方及社区已提供 14 个生产级 Facilitator 节点。 显著优点 零摩擦体验：无需注册账户、KYC 或会话管理，私钥即身份，符合 AI Agent 自动化场景需求 零协议费用：仅承担区块链网络 Gas 费，无中间商抽成 即时终局结算：基于 USDC 等稳定币的链上转账，秒级确认 生态完备：官方提供 TypeScript/Python/Go 三语言 SDK，覆盖 fetch/axios/httpx/requests/Gin/FastAPI/Flask/Express/Hono 等主流框架 灵活定价：支持固定美元定价（$0.001）或自定义 ERC-20 代币原子金额 潜在缺点与局限性 私钥安全：买方需将 EVM/SVM 私钥暴露给应用环境，存在泄露风险；无硬件钱包或 MPC 方案的原生支持 网络依赖性：支付验证依赖 Facilitator 或链上 RPC，存在单点故障和延迟风险 价格波动：自定义代币定价需自行处理汇率波动；美元定价实际仍按链上 USDC 结算 浏览器场景受限：@x402/paywall 为服务端渲染的独立 HTML 页面（~3.5MB），无法作为 React 组件嵌入现有应用，需额外集成第三方库（如 @payai/x402-solana-react） 合规灰色地带：无 KYC 设计在某些司法管辖区可能面临监管审查 适合人群 AI 开发者：为 LLM Agent、自动化脚本提供无摩擦的 API 付费能力 API 提供商：希望按调用量微付费 monetization，避免订阅制复杂度 Web3 项目方：需要多链支付基础设施的 DApp 后端 微服务架构：服务间调用需引入经济激励机制的场景 常规风险 | 风险类别 | 说明 ||---------|------|| 私钥泄露 | 环境变量存储私钥，生产环境需配合密钥管理服务（KMS）或密文注入 || Facilitator 作恶 | 验证节点可能拒绝服务或延迟确认，建议生产环境自托管验证逻辑 || 智能合约风险 | ERC-20 代币合约存在重入、溢出等漏洞可能，需审计依赖 || 网络分叉 | 链上支付在分叉场景下可能出现双花，需等待足够确认数 || 价格波动 | USDC 脱锚或 Gas 费暴涨会影响实际成本和用户体验 | 原始说明 Internet-native payments using the HTTP 402 Payment Required standard. Set up as a buyer to pay for API access, or as a seller to monetize your APIs.