x402 Singularity Layer

⚡ AI Agent 的 USDC 支付基础设施

x402-layer 为 AI Agent 提供 USDC 加密支付基础设施,支持多链 API 付费、端点部署、信用管理与 ERC-8004 代理注册,实现无摩擦的 Agent 经济生态。

收藏
5.6k
安装
2.6k
版本
1.10.6
CLS 安全扫描中
预计需要 3 分钟...

使用说明

技能概述

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 支付与声誉提交均为链上交易,错误操作无法回滚
  • 信用耗尽停机:提供商未监控信用余额将导致服务意外中断

x402 Singularity Layer 内容

references文件夹
scripts文件夹
手动下载zip · 84.8 kB
agent-registry-reputation.mdtext/markdown
请选择文件