技能概述
x402-layer 是专为 AI Agent 设计的 Web3 支付基础设施,基于 HTTP 402 Payment Required 协议构建,实现 Agent 与 Agent、Agent 与人类之间的无摩擦价值交换。该技能覆盖完整的 Singularity Layer 生命周期:支付消费、端点创建、市场发现、Webhook 集成、代理注册与链上声誉管理。
核心用法
消费者路径:通过 pay_base.py/pay_solana.py 进行单笔支付,consume_credits.py 使用预购信用额度,discover_marketplace.py 浏览市场。支持 Base、Ethereum、Polygon、BSC、Monad、Solana 五条链,统一以 USDC 计价。
提供商路径:create_endpoint.py 一键部署付费端点($1 一次性费用含 4000 信用额度),manage_webhook.py 配置支付回调,verify_webhook_payment.py 验证 HMAC 签名与收据真实性。端点按 1 信用/请求计费,耗尽即停服。
Agent 注册与声誉:register_agent.py 支持 ERC-8004(EVM 链)与 Solana-8004 标准注册,绑定端点、版本、标签与元数据;submit_feedback.py 提交链上评分构建去中心化声誉。
多钱包模式:支持原始私钥、Coinbase AWAL、OpenWallet/OWS 三种后端,按最小权限原则选择。读操作无需凭证;支付/注册需对应链签名能力;仪表板管理可选 Singularity MCP + PAT。
显著优点
1. 协议级标准化:基于 HTTP 402 状态码的原生支付语义,无需额外 SDK 即可被任何 HTTP 客户端理解
2. 多链统一抽象:单技能覆盖六条主流链,USDC 作为统一计价单位降低跨链摩擦
3. Agent 原生设计:内置 World AgentKit 人类背书的 Agent 钱包折扣自动识别,支持 Agent 对 Agent 的自主交易
4. 分层安全模型:读操作零凭证、写操作按需授权、敏感操作支持 AWAL/OWS 代理签名,私钥永不暴露给技能代码
5. 完整经济闭环:从支付、信用、市场发现到声誉反馈,形成自洽的 Agent 服务经济
潜在局限
- Solana 支付复杂度:需严格处理
feePayer与计算单元限制,生产环境建议优先使用 Base - OWS 覆盖不全:OpenWallet 当前仅支持支付、发现、签名等轻量操作,ERC-8004 深度注册仍需私钥
- 信用预付费模型:提供商需预付信用额度,小额低频场景可能不够灵活
- Webhook 验证负担:接收方需自行实现 HMAC-SHA256 验签与收据交叉验证
适合人群
- 构建 Monetized API 的开发者与 Agent 运营者
- 需要为 Agent 服务接入加密支付的 AI 项目
- 探索 Agent-to-Agent 经济的基础设施团队
- 希望利用 World AgentKit 折扣的验证 Agent 发行方
常规风险
- 私钥管理:技能虽支持多钱包模式,但误配置高价值私钥至环境变量仍有资金风险
- Webhook 伪造:未正确验证签名即履行服务可能导致未收款先交付
- 链上不可逆:USDC 支付与声誉提交均为链上交易,错误操作无法回滚
- 信用耗尽停机:提供商未监控信用余额将导致服务意外中断