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 即将发布会话和自动发现功能，当前实现可能需要升级适配

核心用法

x402 是 Coinbase 官方开发的开放支付标准，复用 HTTP 402 状态码实现原生加密货币支付。主要用途包括：

• 自动 API 付费：AI 代理调用付费 API 时自动处理 402 响应
• USDC 即时结算：支持 Base、Ethereum 等 EVM 链的稳定币支付
• 零开发集成：SDK 提供 fetch 包装器，402 自动拦截重试

使用方式

import { x402Client } from 'x402';
const client = x402Client({ privateKey: env.WALLET_PRIVATE_KEY, network: 'base' });
const res = await client.fetch('https://paid-api.com/data'); // 自动付费

显著优点

1. 官方背书：Coinbase 主导开发，T1 级可信来源
2. 协议级原生：复用标准 HTTP 402，无需额外协商
3. 多链支持：Base（主推）、Ethereum、Arbitrum、Optimism、Polygon
4. 灵活定价模式：固定金额(exact)、用量上限(upto)、订阅会话(V2)
5. 低摩擦体验：SDK 自动处理签名-重试流程，开发者无感知

潜在局限

• 生态早期：需服务端同时实现 x402 规范才能互通
• 私钥暴露风险：必须在环境变量中配置钱包私钥，需严格保密
• Gas 波动：链上结算受网络拥堵影响，小额支付可能不经济
• 依赖 EVM：非 EVM 链（如 Solana）支持有限

适合人群

• 需要为 AI 代理或自动化系统接入付费 API 的开发者
• 构建按用量计费 API 的服务商
• 探索加密货币原生支付场景的产品团队

常规风险

• 私钥泄露：环境变量配置不当可能导致资金被盗
• 金额误付：建议大额支付前人工复核 payment requirement
• 合约风险：依赖链上 USDC 合约，需关注升级公告
• 网络钓鱼：警惕仿冒 x402 的恶意服务端诱导支付