agentic-pay

Agentic Pay

サードパーティのAIエージェントが、7種類の暗号資産決済レール（BTC、ETH、USDT、USDC、XRP、 XMR、ZEC）を介して支払いを送受信できる、クロスプラットフォーム決済エンジンです。

1つのNode.jsコアが、Linux、Windows、macOSで変更なしで動作します。同じバックエンドに、インストール可能なプログレッシブウェブアプリ（PWA）を介してiOSおよびAndroidからもアクセスできます。別個のネイティブモバイルコードベースを保守する必要はありません。

アーキテクチャ

                     ┌───────────────────────────┐
                     │   core/railManager.js     │  <- one call-site for
                     │  (policy + ledger + auth) │     every asset
                     └─────────────┬─────────────┘
                                   │
        ┌───────────┬─────────────┼─────────────┬───────────┬──────────┐
        │            │             │             │           │          │
     rails/btc   rails/eth    rails/xrp     rails/xmr    rails/zec       │
     (bitcoinjs) (ethers.js,  (xrpl.js)   (JSON-RPC to  (JSON-RPC to     │
                  ETH+USDT+                monero-       zcashd)         │
                  USDC ERC20)              wallet-rpc)                   │
                                                                          │
        Agent-facing surfaces (both call railManager, never a rail       │
        adapter directly):                                               │
        ┌────────────────────────┐   ┌───────────────────────────┐      │
        │ server/restApi.js      │   │ server/mcpServer.mjs      │      │
        │ HTTP/JSON, API-key     │   │ MCP stdio server for       │      │
        │ auth, for any HTTP-    │   │ Claude / other MCP-        │      │
        │ capable agent stack    │   │ compatible agent clients   │      │
        └────────────────────────┘   └───────────────────────────┘      │
                                                                          │
        Human-facing surfaces:                                           │
        ┌────────────────────────┐   ┌───────────────────────────┐      │
        │ cli/index.js           │   │ web/ (PWA)                │      │
        │ Linux/Windows/macOS    │   │ served by server/          │      │
        │ terminal                │   │ staticWeb.js, installable  │      │
        │                        │   │ on iOS/Android home screen │      │
        └────────────────────────┘   └───────────────────────────┘      │

どの環境からの送金も、すべてcore/limits.js（エージェントごとの支出上限と人間による確認のしきい値）とcore/ledger.js（冪等性を確保し、ツール呼び出しを再試行しても二重払いが起きないようにします）を経由します。

クイックスタート（Node.js 18以降が動作する任意のOS）

git clone <this repo>          # or unzip the delivered archive
cd agentic-pay
npm install

cp config/.env.example .env
cp config/config.example.json config/config.json
# edit both files — see docs/SETUP_<YOUR_OS>.md for exact values per rail

npm run start:rest     # REST API on :8787
npm run start:web      # PWA on :8788 (optional, for mobile/browser access)
npm run start:mcp      # MCP stdio server (for Claude Desktop / Claude Code)
node cli/index.js rails   # sanity check from the terminal

**まずはテストネットで始めてください。**各決済レールの設定例は、デフォルトでテストネットを使用するか、メインネットの値を明示的に入力する必要があります。これは意図的な仕様です。core/limits.jsを確認し、納得できる支出上限を設定するまでは、このシステムに実際の資金を投入しないでください。

ホステッド（カストディアル）— セットアップを省略

自分のノードを動かしたくない場合は、Aumniumが**https://api.aumnium.tech**でホステッドインスタンスを運用しています。USDCを入金して、支払いに使えるカストディアル残高を取得すれば、何もインストールしたり、自分で資金を用意したりせずに、7種類すべての決済レールで送金を始められます。

これは上記のセルフホスト手順とは異なる信頼モデルです。資金はAumniumが運用する共有ウォレット（自身の秘密鍵ではありません）に保管され、送金ごとに1％の手数料とネットワークコストが残高から差し引かれます。上記のセルフホスト方式は引き続き完全な非カストディアル方式ですが、このホステッド方式では利便性を優先しています。

# 1. Get your deposit address
curl -H "x-api-key: YOUR_KEY" https://api.aumnium.tech/v1/deposit/address

# 2. Send USDC to that address on Ethereum mainnet

# 3. Claim your deposit once it confirms
curl -X POST -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" \
  -d \'{"txHash":"0x..."}\' \
  https://api.aumnium.tech/v1/deposit/claim

# 4. Send payments (billed per-call via x402, USDC on Base)
curl -X POST -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" \
  -d \'{"asset":"USDC","to":"0x...","amount":1,"idempotencyKey":"unique-key"}\' \
  https://api.aumnium.tech/v1/send

APIキーについては[email protected]までお問い合わせください。エンドポイントの全リストはhttps://api.aumnium.techをご覧ください。

次に読むもの

• docs/SETUP_LINUX.md
• docs/SETUP_WINDOWS.md
• docs/SETUP_MACOS.md
• docs/SETUP_MOBILE.md — PWAを介したiOSおよびAndroidでの利用
• docs/AGENT_INTEGRATION.md — Claude、MCPクライアント、またはHTTPベースのエージェントフレームワークとの接続方法
• docs/SECURITY.md — キー管理、支出上限、法務・規制上の考慮事項 — 実際の資金を送る前にお読みください

ここで本当に本番環境に対応できるものと、出発点にすぎないもの

• **本番運用を想定したもの：**ポリシーエンジン（トランザクションごとの上限、1日の上限、確認のしきい値、アドレスの許可リスト）、冪等性を備えた台帳、統一された決済レールインターフェース。
• **出発点であり、実際の資金を大規模に扱うには強化が必要なもの：**JSONファイルの台帳（高負荷時は実際のデータベースに置き換えてください）、固定の米ドル価格テーブル（リアルタイムの価格フィードに接続してください）、キーの保管方法（開発用途を超える場合は.envからOSのキーチェーンまたはHSM/KMSに移行してください。拡張ポイントについてはcore/keystore.jsをご覧ください）。

ライセンス

agentic-payはBusiness Source License 1.1の下でライセンスされています（LICENSEを参照）。簡単に言うと、次のとおりです。

• 個人利用、自組織での利用、自身のエージェントでの利用（本番利用を含む）を目的として、自由に使用、変更、セルフホストできます。
• 商用ライセンスなしに、これを第三者向けの競合するホステッド／マネージド決済サービス製品として提供することはできません。
• 2030-07-14に、このバージョンは自動的にApache License 2.0に切り替わり、制限のない完全なオープンソースになります。

それ以前にホステッド／マネージドサービス向けの商用ライセンスをご希望ですか？[email protected]までお問い合わせください。