agentpay

AgentPay - 原生支持 BTC 的 AI Agent 支付协议

为每个 AI Agent 配备钱包。让 Agent 之间即时支付，零手续费。

AgentPay 是一种专为 AI Agent 经济设计的原生支持 BTC 的支付协议。它基于 CKB Fiber Network（兼容 Lightning 的 L2）构建，可实现：

• 零 Gas 微支付——按 API 调用付费，无最低金额限制
• Hold Invoice 托管——锁定资金，直到确认服务已交付
• BTC 互操作性——通过 Lightning Network 跨链支付
• MCP 集成——让 Claude/GPT Agent 原生发起支付

快速开始

安装

npm install @agentpay-dev/sdk @agentpay-dev/core

创建支付 Agent

import { AgentWallet } from '@agentpay-dev/sdk';

const wallet = new AgentWallet({ fiberRpcUrl: process.env.FIBER_RPC_URL });

// Pay another agent for a service
const result = await wallet.payAndCall(
  'https://translator-agent.example.com',
  'translate',
  { text: 'Hello World', target: 'zh' }
);

搭建新项目

npx create-agentpay my-agent
cd my-agent && npm install

架构

+-----------------------------------------------------+
|                    Applications                      |
|  AI Agents  |  DePIN Devices  |  API Marketplaces    |
+-----------------------------------------------------+
|                   AgentPay SDK                       |
|  AgentWallet  |  ServiceProvider  |  HubClient       |
+-----------------------------------------------------+
|                   AgentPay Core                      |
|  Settlement  |  Metering  |  DID  |  Assets          |
+-----------------------------------------------------+
|              CKB Fiber Network (L2)                  |
|  Payment Channels  |  Hold Invoice  |  HTLC Routing  |
+-----------------------------------------------------+
|         CKB L1  +  BTC Lightning Network             |
|    xUDT Assets  |  RGB++  |  Cross-chain (Cch)       |
+-----------------------------------------------------+

软件包

软件包	npm	描述
@agentpay-dev/core		协议核心：Fiber RPC、结算、资产、DePIN 计量
@agentpay-dev/sdk		开发者 SDK：AgentWallet、ServiceProvider、HubClient
@agentpay-dev/mcp-server		MCP 服务：为 Claude/GPT 提供 8 种支付工具
@agentpay-dev/x402-facilitator		通过 Fiber 结算的 HTTP 402 支付中间件
@agentpay-dev/ap2		Google AP2 协议到 Fiber 的桥接
create-agentpay		命令行搭建工具

核心功能

Hold Invoice——无需信任的托管

核心亮点。Agent A 锁定付款，Agent B 交付服务，只有确认后才会释放资金：

import { ServiceProvider } from '@agentpay-dev/sdk';

const provider = new ServiceProvider({
  fiberRpcUrl: process.env.FIBER_RPC_URL,
  services: {
    translate: {
      price: 100_000_000n,  // 1 CKB per request
      handler: async (params) => {
        const result = await doTranslation(params.text, params.target);
        return { translation: result };
      }
    }
  }
});

// Hold flow: Lock -> Deliver -> Release (atomic)
// If service fails, funds auto-refund via HTLC timeout

MCP 服务——面向 AI 的原生支付

已以 io.github.alefnt/agentpay 注册到官方 MCP Registry。

添加到 Claude Desktop 配置：

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["@agentpay-dev/mcp-server"],
      "env": { "FIBER_RPC_URL": "http://localhost:8227" }
    }
  }
}

8 种 MCP 工具：

工具	描述
get_balance	查看钱包余额（CKB + xUDT）
send_payment	通过 Fiber 发票发送付款
create_invoice	生成 Fiber 发票以收款
pay_for_service	付费并调用另一个 Agent 的 API
create_hold_invoice	创建托管付款（锁定资金）
settle_hold	服务交付后释放托管资金
cancel_hold	取消并退款已托管的付款
list_channels	查看活跃的支付通道

x402 HTTP 兼容性

只需一个中间件，即可将任意 HTTP API 变为付费 API：

import { createX402Middleware } from '@agentpay-dev/x402-facilitator';

const paywall = createX402Middleware({ price: '100000000' });

http.createServer((req, res) => {
  paywall(req, res, () => {
    res.end(JSON.stringify({ data: 'premium content' }));
  });
});
// Client: HTTP 402 -> pay Fiber invoice -> retry -> get content

BTC 跨链

使用 BTC 付款，通过 Lightning-Fiber 桥接在 CKB 上结算：

import { CchClient } from '@agentpay-dev/core';

const cch = new CchClient({ cchRpcUrl: process.env.CCH_RPC_URL });

await cch.sendBtcToCkb({
  btcPayReq: 'lnbc100n1p...',
  fiberChannelId: '0x...',
});

生态集成

AgentPay 增强现有支付解决方案：

平台	AgentPay 的作用
x402 (Coinbase)	为 HTTP 402 协议提供零 Gas 的 Fiber 结算后端
AP2 (Google)	为 Agent 授权框架提供结算层
Stripe	提供 Agent 间微支付（低于分币单位），形成补充
Lightning Network	通过 Cch 桥接实现跨链，扩大 BTC 支付范围

项目结构

AgentPay/
  packages/
    core/               # Protocol core (Fiber RPC, settlement, DePIN)
    sdk/                # Developer SDK (Wallet, Provider, Hub)
    mcp-server/         # MCP Server for AI agents
    x402-facilitator/   # HTTP 402 middleware
    ap2/                # Google AP2 bridge
    create-agentpay/    # CLI scaffolding
  services/
    hub/                # Hosted wallet service
    registry/           # Agent discovery service
  examples/
    translate-agent/    # Translation service example
    code-review-agent/  # Code review agent example
    btc-to-ckb/         # Cross-chain payment example
  docs/
    product.md          # Product overview
    architecture.md     # Technical architecture

文档

• 产品概览 - AgentPay 解决什么问题以及如何解决
• 架构 - 技术设计和协议层
• 竞品分析 - 与 x402、AP2、Stripe 的比较

技术栈

• 运行时：Node.js 20+ / TypeScript 5.5+
• L2 网络：CKB Fiber Network（兼容 Lightning）
• L1 区块链：Nervos CKB
• 资产标准：xUDT（可扩展用户自定义代币）
• 身份：.bit 去中心化身份
• 跨链：Cch（CKB - BTC Lightning 桥）
• AI 集成：Model Context Protocol (MCP)
• 构建：pnpm 工作区 monorepo

开发

git clone https://github.com/alefnt/AgentPay.git
cd AgentPay
pnpm install
pnpm build
pnpm test

路线图

• 核心协议（Fiber RPC、结算、资产）
• SDK（AgentWallet、ServiceProvider、HubClient）
• 提供 8 种支付工具的 MCP 服务
• x402 HTTP 402 处理器
• AP2 协议桥接
• DePIN 计量模块
• BTC 跨链（Cch + LND）
• RGB++ 桥接集成
• 已发布 npm 包
• 已注册 MCP Registry
• Fiber 主网上线
• 在 CKB 上支持稳定币（RUSD）
• 公共演示网站
• 生产级 Hub 服务

许可证

MIT - 详情请参阅 LICENSE。

---

为 Agent 经济而构建——让 AI Agent 自主发现、协商并为服务付费。