x402

核心用法

x402 是一个专为 AI 代理设计的 HTTP 原生加密支付协议技能，基于 Coinbase 开源的 x402 标准实现。它通过复用 HTTP 402 Payment Required 状态码，让 AI 代理能够自动、即时地使用 USDC 等稳定币支付 API 费用。核心工作流程为：代理请求付费 API → 收到 402 响应获取支付要求 → 自动签名并支付 → 携带支付证明重试请求 → 获得资源访问权限。支持 TypeScript SDK 集成、fetch 包装器自动处理，以及手动 curl 流程，覆盖从全自动到精细控制的多种使用场景。

显著优点

1. 协议级标准化：基于 HTTP 402 状态码和标准化头部，无需自定义协议，与现有 Web 基础设施兼容
2. 即时结算：区块链原生支付，无需传统支付网关的账期延迟，适合按调用计费的微支付场景
3. 多链支持：覆盖 Base、Ethereum、Arbitrum、Optimism、Polygon 等主流 EVM 网络，Base 为主推网络
4. AI 代理原生设计：自动处理 402 响应、签名、重试全流程，代理无需人工干预即可完成支付
5. 灵活定价模式：支持固定金额（exact）、按量计费（upto）、订阅会话（V2）等多种方案
6. 安全架构：私钥仅用于环境变量，使用 viem 等成熟库，无动态代码执行风险

潜在缺点与局限性

1. 加密货币门槛：用户需持有 USDC 并管理钱包私钥，对非加密原生用户存在学习成本
2. 网络依赖性：必须连接区块链 RPC 节点和互联网，完全离线场景无法使用
3. Gas 费用波动：虽然 USDC 本身稳定，但链上交易仍需支付网络 Gas 费，小额支付可能不经济
4. 生态早期：x402 协议和接受该标准的 API 提供商仍在增长期，可用付费资源有限
5. 私钥管理风险：虽然技能本身安全，但用户若不当管理 WALLET_PRIVATE_KEY 环境变量可能导致资金损失
6. T3 来源限制：当前为社区/个人来源，非 Coinbase 官方直接维护，长期支持存在不确定性

适合的目标群体

• AI 代理开发者：需要让自主代理访问付费 API、数据服务或计算资源的工程师
• 自动化脚本编写者：希望用加密货币支付替代传统信用卡，实现无摩擦 API 调用的开发者
• 加密原生团队：已使用 USDC 进行资金管理的 DAO、DeFi 协议或 Web3 项目
• API 提供商：希望为 AI 客户提供即时加密货币支付选项的服务商
• 实验性项目：探索 AI + 加密支付融合创新的研究人员和创业者

使用风险

1. 资金风险：私钥泄露或环境变量配置错误可能导致钱包资金被盗，建议专用小额钱包
2. 交易失败：网络拥堵或 Gas 设置不当可能导致支付交易失败，需实现重试和错误处理逻辑
3. API 可用性：依赖外部 x402 兼容 API 的可用性和定价稳定性，建议实现熔断机制
4. 监管不确定性：加密货币支付在不同司法管辖区合规要求不同，企业用户需自行评估
5. 版本兼容性：x402 V2 即将发布会话和自动发现功能，当前实现可能需要升级适配