agentic-pay

Agentic Pay

一个跨平台支付引擎，让第三方 AI Agent 能够通过七种加密货币通道发送和接收付款：BTC、ETH、USDT、USDC、XRP、XMR、ZEC。

同一个 Node.js 核心无需修改，即可在 Linux、Windows 和 macOS 上运行。通过可安装的渐进式 Web 应用（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（每个 Agent 的支出上限 + 人工确认门槛）和 core/ledger.js（幂等性，确保重试工具调用绝不会导致重复付款）。

快速开始（适用于任何安装了 Node.js 18+ 的操作系统）

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，即可获得可支用的托管余额，并开始通过全部七种通道发送付款，无需自行安装或注资。

这与上述自托管说明采用的是不同的信任模式：你的资金存放在由 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

请联系 [email protected] 获取 API 密钥。完整的端点列表请见 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 的 Agent 框架
• docs/SECURITY.md — 密钥管理、支出限额 以及法律和监管方面的注意事项 — 发送真实资金前请务必阅读

哪些功能真正适合投入生产，哪些只是起点

• **具备生产环境基础：**策略引擎（单笔交易上限、每日上限、 确认门槛、地址允许列表）、幂等账本，以及 统一的支付通道接口。
• **起点，投入大规模真实资金前需要加固：**JSON 文件账本（负载增大时应 换成真正的数据库）、静态 USD 价格表（接入实时价格源），以及密钥存储（开发以外的用途应从 .env 迁移 到操作系统密钥链或 HSM/KMS——扩展入口请见 core/keystore.js）。

许可证

agentic-pay 采用 Business Source License 1.1 授权（详见 LICENSE）。简而言之：

• 你可以自由使用、修改和自托管本项目——供自己、自己的 组织或自己的 Agent 使用，包括用于生产环境。
• 未取得商业许可证，你不得将其转而作为竞争性的托管式或托管管理式 支付即服务产品提供给第三方。
• 到 2030-07-14，此版本将自动转换为 Apache License 2.0——完全开源，不受限制。

想在此日期之前获取托管式或托管管理式服务的商业许可证？ 请联系 [email protected]。