APN 智能体支付节点
为 AI 智能体提供本地优先的支付运行时:所有签名都在前台由人类批准,每笔付款都是可恢复的持久操作。
- Star 数
- ★ 73
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 80/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望让智能体自动准备付款、但坚持由人类逐笔确认签名的个人开发者或小团队。
- 不适合
- 需要 Linux 或 Windows 生产部署的团队
- 偏好云端托管托管式钱包与无人工审批的团队
- 需要储蓄级/多签托管保管的场景
- 官网
- agentpaymentnode.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19最新版本 v0.5.110(2026-11-18)
- 源码审查
- 80/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
APN(Agent Payment Node)是一个本地优先的开源支付运行时,AI 智能体通过 apn 命令行或本地 stdio MCP 服务器来驱动它,真正掌控资金的是人类所有者。所有者先在允许清单(allowlist)策略里逐资产、逐通道地设定单笔与每日上限,然后在具备真实 TTY 的前台终端里输入绑定操作的确认码来完成每次签名。每个命令都打印唯一的 apn.cli.v1 JSON 信封(含 ok、error、operation、receipt、next_actions),并以幂等键绑定一个持久操作,所以崩溃或响应丢失都不会重复付款。覆盖范围很广:EVM、Solana、TRON 的原生币与代币直转,x402 购买(EIP-3009 USDC、Permit2、ERC-20 转账凭证商户),USDC 免 Gas 转账,LI.FI/Relay/Circle CCTP V2/Stargate V2 等跨链桥,以及 Uniswap、SunSwap、Jupiter、Orca 的受控兑换。它目前运行在 Apple Silicon macOS + Node 24 上,钱包密钥以 AES-256-GCM 信封加密,包装密钥存放在 macOS 登录钥匙串中;README 明确说明这是 local_software_disposable 级别的保管,而不是储蓄级托管。
智能体侧只需要调用 apn pay transfer prepare-asset、x402 fetch prepare、bridge prepare、swap ethereum uniswap prepare 等 prepare 命令:这些命令在幂等键下冻结链、资产、金额、收款方与费用预算,并且不签名。随后由人类在前台终端执行 approve/execute,重新校验冻结事实与当前策略,展示精确条款并索取确认码后再签名。所有发送都置于持久标记之后,结果不明的发送只会被观察,绝不会重发;operation status、operation resume、operation abandon 与 receipt get 负责后续的恢复、放弃与凭证获取。MCP 侧通过 apn mcp config 输出启动描述符、apn mcp serve 启动 stdio 服务器,工具由同一命令目录投影而来,但没有独立的审批工具:需要人类介入的命令通过 apn_foreground_handoff 校验参数并返回给人类在终端执行的确切命令。RPC 通过命令上的 --rpc-url 或 APN_<CHAIN>_RPC_URL 环境变量获取,缺失时以 APN_RPC_CONFIG 拒绝而不是替换端点;apn wallet portfolio 只读地汇总 EVM、Solana、TRON 上的原生币与允许清单代币余额。
- 希望让智能体自动准备付款、但坚持由人类逐笔确认签名的个人开发者或小团队。
- 需要为智能体购买 x402 付费资源(USDC 的 EIP-3009 或 Permit2 路径)并受单笔与每日上限约束的服务方。
- 在 Base、Arbitrum 等 EVM 网络与 Solana、TRON 之间搬运稳定币,需要桥接或兑换且要求可审计凭证的运营人员。
- 要把支付能力接入自有 MCP 客户端(如通过
apn mcp serve)但又不想让模型直接拿到签名权的平台团队。 - 需要复现性供应链校验(GH attestation、SBOM、release manifest)的组织,用来验证所装 APN 构件与源码提交一致。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install nuanu-ai/tap/apn
- 配置文件
~/.apn- 运行环境
- Node.js 24
- 安装说明涉及
- macOS
如何安装或部署这个 Agent?
需要 Apple Silicon 的 macOS 与 Node 24(>=24 <27),推荐用 Homebrew 安装:
brew install nuanu-ai/tap/apnHomebrew 的 node@24 是 keg-only,不在 PATH 上;apn 使用 PATH 里第一个 node,版本不符时只打印一行 APN_NODE_UNSUPPORTED 并以 1 退出。此时把 Node 24 放到最前面:
export PATH="/opt/homebrew/opt/node@24/bin:$PATH"首次执行钱包命令会创建 ~/.apn(权限 0700)以及每个 profile 一个加密钱包信封(权限 0600)。安装后可验证已安装契约:
apn --version
apn help --json如何使用这个 Agent?
先创建本地钱包并读取公开地址,然后手动向该地址转入少量 Base ETH(Gas)和 Base USDC:
apn wallet ensure --profile agent
apn wallet status --profile agent编写允许清单策略文件(1 USDC = 1000000 原子单位,上限由所有者自定):
{
"schemaVersion": "apn.allowlist-policy-file.v1",
"overlayVersion": "agent.1",
"accounts": { "evm": "<address from wallet status>" },
"effectiveAt": "<ISO-8601 instant>",
"admissions": [
{ "chain": "eip155:8453", "kind": "token", "identifier": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"rail": "direct", "maximumPerTransferAtomic": "3000000", "dailyLimitAtomic": "10000000" }
]
}暂存并在前台终端激活策略,然后试一笔最小转账:
apn allowlist policy stage --profile agent --file /absolute/path/policy.json
apn allowlist policy activate --profile agent --revision 1
apn wallet balance --profile agent --chain eip155:8453 --asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 --rpc-url https://mainnet.base.org
apn pay transfer prepare-asset --profile agent --chain eip155:8453 --asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 --to <recipient-address> --amount 0.01 --max-fee-wei <fee-budget-wei> --idempotency-key first-transfer-0001 --rpc-url https://mainnet.base.org
apn pay transfer approve --operation <operation-id> --rpc-url https://mainnet.base.org
apn operation status --operation <operation-id>
apn receipt get --operation <operation-id>若要给 MCP 客户端使用,输出启动描述符并启动 stdio 服务器:
apn mcp config
apn mcp serve这个 Agent 有哪些优点和局限?
- 以幂等键 + 持久操作标记实现不重发保证:结果不明的发送只观察不重试,崩溃、重启和升级后仍可恢复。
- 人类审批是硬边界:approve/execute/abandon 等命令需要真实 TTY 与绑定操作的确认码,MCP 侧只能通过
apn_foreground_handoff返回给人类执行。 - 覆盖范围在开源支付工具中少见:EVM/Solana/TRON 直转、x402 三种路径、多桥、多 DEX 兑换统一在同一操作契约下。
- 所有者允许清单粒度细到资产、通道(direct/x402/gasless/bridge/swap)、机制与收款方,并带单笔与每日上限。
- 供应链可验证:发布构件用 Node 24.15.0 构建两次要求逐字节一致,并提供 SPDX SBOM、release manifest 与 GitHub attestation 校验脚本。
- 平台绑定强:README 明确只支持 Apple Silicon macOS + Node 24,Linux/Windows 仅记录“需要什么”,非生产可用路径。
- 保管级别有限:项目自述为 local_software_disposable,无法抵御同一登录会话、进程或主机被攻破;JavaScript 内存中的临时密钥副本不保证清零。
- 依赖若干第三方提供商与版本(awal 2.12.1、@metamask/agent-wallet 6.1.5 等),且 awal 会启动常驻 Electron 服务,README 提醒同一用户的其他进程可读到一次性验证码。
- 上手成本不低:需要策略文件、前台审批终端、RPC 环境变量与多条命令协同,
help --json与版本/来源三件套也要人工核对。 - 测试证据是源码级证明,主网实盘验收按家族分别记录在文档中,部分行仍标注为未验证。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| APN 智能体支付节点 当前 | 80 · 表现良好 | 命令行工具免费 | ★ 73 | 2 天前 | TypeScript | — |
| Agency Orchestrator:一句话组队 AI 专家团队 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.5k | 10 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| OpenOSINT:AI 驱动的 OSINT 调查代理 | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2k | 5 天前 | Python | Claude Code · Claude.ai · OpenAI API |
| assh | 65 · 存在缺口 | 命令行工具免费 | ★ 22 | 11 天前 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
最小权限:README 明确 MCP 不批准、前台终端人工确认、owner allowlist 逐资产逐通道限额,且 MCP 工具由同一目录投影,证据充分(3)。用户确认:prepare/approve 分离、冻结事实、输入键入码、纯降额才可 MCP 执行,证据充分(3)。数据流透明:RPC 配置、环境变量、无密钥默认端点、portfolio 发送公开地址均写明(3)。敏感数据:私钥不打印不导出、~/.apn 0700、钱包信封 0600、Keychain 原生代理、zeroize 依赖,证据充分(3)。依赖安全:npm-shrinkwrap、精确版本、overrides、SBOM、双构建字节一致、attestation 验证脚本、CI 审计门禁,证据充分(3)。外部影响:幂等键、durable marker、模糊发送只观察不重发、finality 校验,证据充分(3)。回滚:有 operation abandon 与 resume,但 abandon 保留账本占用、部分家族无后继命令,恢复路径不完整,扣分(2)。来源归属:MIT 与版权行清晰,但发布者身份未经验证、无签名者身份说明,扣分(2)。
自一致性:README 命令目录、help --json 清单、removed_v1_commands 与代码中错误码(APN_IDEMPOTENCY_CONFLICT、APN_STATE_CORRUPT 等)互相吻合,证据充分(3)。依赖可用性:engines 与 os/cpu 限定 darwin/arm64、Node >=24 <27,Homebrew keg-only node@24 需手动 PATH,平台面窄,扣分(2)。失败信息:APN_NODE_UNSUPPORTED、APN_RPC_CONFIG、APN_RPC_RATE_LIMITED、next_actions、closed_blockers 等结构化错误与下一步指引明确,证据充分(3)。
受众与场景:面向需要 agent 自主付款的开发者/运营者,场景覆盖广但门槛高,扣分(2)。能力边界:明确列出 CLI-only 家族、MCP 无 handoff 的十条命令、平台支持矩阵边界,证据充分(3)。触发精度:命令与工具一一投影、参数校验与 CLI 一致,但命令面极宽、家族众多,选择成本高,扣分(2)。环境适配:仅 Apple Silicon macOS + Node 24,Linux/Windows 仅文档说明需改造,扣分(1)。
信息架构:README 分节清晰、命令目录生成、docs 分家族指南,证据充分(3)。安装说明:brew tap、PATH 说明、版本核验步骤完整(3)。命名稳定性:manifest v2 合并/移除 v1 命令并给出替代,说明存在破坏性变更历史,扣分(2)。示例与 FAQ:有首个旅程示例与多份指南,但无独立 FAQ,扣分(2)。已知限制:平台矩阵与各指南标注 proven/open 行,但限制分散、未集中列出,扣分(2)。许可证:MIT 全文与 package.json 一致(3)。版本与变更日志:有语义化版本号与 removed_v1_commands,但无独立 CHANGELOG,扣分(2)。维护责任:SECURITY.md 仅覆盖最新版本,发布者未经验证、无维护者名单或 SLA,扣分(1)。
输出可用性:统一 apn.cli.v1 JSON 信封、receipt、next_actions,机器可消费,证据充分(3)。边际价值:本地优先、幂等、owner 限额的支付运行时确有差异化价值,但生态与平台受限,扣分(2)。成本收益:安全与可审计性强,但安装门槛、平台限制与命令复杂度提高采用成本,扣分(2)。
主张可追溯:README 主张多可对应到代码、测试与文档,但部分主张(双构建字节一致、attestation)仅由文档声明,静态审查无法核实,扣分(2)。跨源印证:测试文件与 README 在 allowlist、策略激活、MCP 一致性上互相印证,但样本有限,扣分(2)。事实与推断分离:文档区分 source tests 与 live payment proof,并标注 proven/open,但部分安全主张仍为断言,扣分(2)。
- 仅支持 Apple Silicon macOS 与 Node >=24 <27;Homebrew 的 node@24 为 keg-only,需手动调整 PATH,否则 apn 会以 APN_NODE_UNSUPPORTED 退出。
- 发布者身份未经验证,SECURITY.md 仅覆盖最新版本,无维护者名单或支持承诺;生产使用前应自行核验发布来源与 attestation。
- operation abandon 会保留账本占用(金额仍计入限额),且部分家族无后继恢复命令,回滚并非完全可逆。
- 命令面极宽(多链、多桥、多 swap、x402 多机制),误选命令或参数的风险需由 owner allowlist 与前台确认兜底。
- 双构建字节一致、SBOM 与 attestation 等供应链主张仅见于文档,静态审查无法核实,需按 README 步骤自行验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.5.110 Agent Payment Node v0.5.110
发布说明摘录
What's Changed * fix(metamask): 0.5.109 seal the revoke request id and read it on resume by @Oscorped in https://github.com/nuanu-ai/agent-payment-node/pull/630 Full Changelog: https://github.com/nuanu-ai/agent-payment-node/compare/v0.5.109...v0.5.110在 GitHub 查看 ↗ -
v0.5.109 Agent Payment Node v0.5.109
发布说明摘录
What's Changed * fix(metamask): native and revoke sends name their own MetaMask request id (0.5.108) by @Oscorped in https://github.com/nuanu-ai/agent-payment-node/pull/629 Full Changelog: https://github.com/nuanu-ai/agent-payment-node/compare/v0.5.108...v0.5.109在 GitHub 查看 ↗ -
v0.5.108 Agent Payment Node v0.5.108
发布说明摘录
What's Changed * 0.5.107: QA fixes (19 findings + MetaMask request read) by @Oscorped in https://github.com/nuanu-ai/agent-payment-node/pull/628 Full Changelog: https://github.com/nuanu-ai/agent-payment-node/compare/v0.5.107...v0.5.108在 GitHub 查看 ↗
常见问题
智能体会不会在无人看管时把钱转走?
apn_foreground_handoff 返回给人类执行,工具本身不读写任何状态。在 Linux 或 Windows 上能跑吗?
apn 要求 >=24 <27),并提供了 docs/platform-support.md 记录 Linux 与 Windows 的边界与所需工作,但没有把这些平台列为受支持路径。必须自己买 RPC 账号吗?
--rpc-url 或 APN_<CHAIN>_RPC_URL 获取端点,端点必须是无需凭据的公共 HTTPS;部分家族(如 portfolio、Circle CCTP 源链)有内置 keyless 默认值,无默认值的家族缺失变量时会以 APN_RPC_CONFIG 拒绝而不是替换端点。一笔交易卡住或结果不明会怎样?
operation resume 只执行下一个合法状态转换,结果不明的发送永不被重发;operation abandon 需在前台接受未解决的风险后关闭操作,账本中的占用金额仍保持计费。密钥和个人凭据存在哪里?
~/.apn/wallets/<profile>.json 是版本化 AES-256-GCM 信封,包装密钥作为通用密码 ai.nuanu.apn.wrapping-secret.v1/default 存在 macOS 登录钥匙串中;APN 不打印、导出私钥,也不接收二维码载荷、浏览器凭据或助记词。APN 智能体支付节点 官网是什么?
APN 智能体支付节点 免费吗?
APN 智能体支付节点 开源吗?
APN 智能体支付节点 安全吗?
APN 智能体支付节点 还在维护吗?
APN 智能体支付节点 是谁开发的?
谢谢反馈,我们会据此改进页面。