agentpay

AgentPay - BTC ネイティブの AI エージェント決済プロトコル

すべての AI エージェントにウォレットを。エージェント同士が即座に手数料無料で決済できます。

AgentPay は、AI エージェント経済向けに設計された BTC ネイティブの決済プロトコルです。CKB Fiber Network（Lightning 対応の L2）上に構築されており、次の機能を提供します。

• ガス代ゼロのマイクロペイメント - API 呼び出しごとの決済が可能で、最低金額はありません
• Hold Invoice エスクロー - サービスの提供が確認されるまで資金をロックします
• BTC の相互運用性 - Lightning Network 経由のクロスチェーン決済
• MCP 連携 - Claude/GPT エージェントがネイティブに決済できます

クイックスタート

インストール

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

決済エージェントの作成

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		CLI のひな形作成ツール

主な機能

Hold Invoice - トラストレスなエスクロー

目玉機能です。エージェント A が支払いをロックし、エージェント 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 ネイティブな決済

公式 MCP Registry に io.github.alefnt/agentpay として登録されています。

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	別のエージェントの API に支払って呼び出します
create_hold_invoice	エスクロー決済を作成します（資金をロック）
settle_hold	サービス提供後に保留中の資金を解放します
cancel_hold	保留中の支払いをキャンセルして返金します
list_channels	有効な決済チャネルを表示します

x402 HTTP 互換性

1 つのミドルウェアで、あらゆる 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 クロスチェーン

Lightning-Fiber ブリッジ経由で、BTC で支払い、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 プロトコル向けの、手数料無料の Fiber 決済バックエンド
AP2 (Google)	エージェント認可フレームワーク向けの決済レイヤー
Stripe	エージェント間のマイクロペイメント（1 セント未満）を補完
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（拡張可能なユーザー定義トークン）
• ID: .bit の分散型 ID
• クロスチェーン: Cch（CKB - BTC Lightning ブリッジ）
• AI 統合: Model Context Protocol (MCP)
• ビルド: pnpm ワークスペースのモノレポ

開発

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 をご覧ください。

---

エージェントエコノミーのために構築 - AI エージェントが自律的にサービスを見つけ、交渉し、料金を支払う世界です。