Frequently asked questions about APN
Questions on this page are grouped by topic. Use the questions below for quick answers, then follow the links for the full explanation.
Basics
- What APN is: an open-source, local-first payment runtime for AI agents, driven through the
apnCLI or a local stdio MCP server. - License: MIT, copyright Nuanu AI.
- Platform: Apple Silicon macOS with Node 24, installed with
brew install nuanu-ai/tap/apn. - Not covered: Linux, Windows, remote MCP and hosted service.
Control and safety
- Approval of transfers, bridges and swaps: only the human owner, in a foreground terminal, with a typed code. Standard x402 purchases run unattended inside the owner's profile caps.
- Limits: the owner allowlist with per-operation and daily caps, plus the profile policy for x402.
- Double sends: prevented by idempotency keys and durable operations.
- Keys: encrypted locally, never printed or exported.
The full answers follow in the question list at the end of this page.
Questions
What is Agent Payment Node (APN)?
Agent Payment Node (APN) is an open-source, local-first payment runtime for AI agents. An agent drives it through the apn CLI or a local stdio MCP server. A human owner sets the spending limits and approves direct transfers in a foreground terminal. See what is APN.
Is APN the same as Access Point Name?
No. On this site APN always means Agent Payment Node, a payment tool for AI agents. It has nothing to do with the mobile-network term Access Point Name.
Is APN open source, and what is the license?
Yes. The source is on GitHub at nuanu-ai/agent-payment-node and the license is MIT. The copyright line reads Copyright (c) 2026 Nuanu AI.
Is APN free to use?
The MIT license grants use, copying and modification free of charge. APN needs no RPC account or API key. Sending money still costs network fees: a direct transfer needs the chain's gas coin, such as Base ETH on Base, while a gasless USDC transfer pays its fee from the USDC amount.
Which platforms does APN support?
Apple Silicon macOS (darwin / arm64) with Node 24, installed through Homebrew. The package is restricted to that platform, and the wrapping secret lives in the macOS login Keychain.
Does APN run on Linux or Windows?
No. The platform matrix marks both as unsupported. They have no package, no release target and no supported credential backend. Each would need a tested credential backend and more work before a support claim.
How do I install APN?
Run brew install nuanu-ai/tap/apn. The Formula installs apn and the Homebrew node@24 dependency. If apn prints APN_NODE_UNSUPPORTED, put /opt/homebrew/opt/node@24/bin first on PATH. See install.
Which blockchains does APN support?
Direct transfers cover eleven EVM networks: Ethereum, Base, Arbitrum One, OP Mainnet, Polygon PoS, BNB Smart Chain, Avalanche C-Chain, Unichain, Linea, Monad and Sei EVM. Solana and TRON have their own commands. Bridges, swaps, x402 and gasless transfers cover specific networks, listed on their pages.
What can an agent do with APN?
It can make direct transfers, standard x402 purchases, gasless USDC transfers, bridges and guarded swaps, all under owner limits: the allowlist, and the profile policy for x402. It can also read balances and a portfolio of native coins and listed tokens, which never signs or moves funds.
Does the MCP server approve payments?
No. Commands that need a human (approve, execute, abandon, wallet connect, allowlist activate) are not MCP tools. The apn_foreground_handoff tool returns the exact command for the human to run in a terminal and reads and writes nothing. Standard x402 and Solana x402 purchases do run over MCP, unattended, within the caps the owner set in the foreground. See MCP.
Is there a remote or hosted APN MCP server?
No. apn mcp serve runs a local stdio server. APN is not a hosted service, and the README places remote MCP outside this repository.
Can APN send the same payment twice?
No. Each payment is a durable operation under an idempotency key, and the same key resolves to the same operation. Local execution recovers only the exact signed bytes and never signs a second transaction. A lost outcome is observed, not resent. See recovery.
Who holds the private keys?
On your machine, APN does. A local wallet is an AES-256-GCM encrypted envelope in ~/.apn/wallets/<profile>.json, with its wrapping secret in your macOS login Keychain. APN never prints or exports a private key. Provider-managed wallets stay with the provider. See wallets.
Is APN safe for savings?
No. The README calls its custody local_software_disposable, not savings custody. Encryption protects a copied ~/.apn without the Keychain secret, but not a compromised, unlocked login session. Fund it with amounts you can afford to lose.
What is the owner allowlist?
It is the owner's list of what an agent may pay. Each entry admits an exact asset on a rail (direct, x402, gasless, bridge or swap) with per-operation and daily caps. It can also pin the mechanism and the recipients. APN never fills in a missing cap, account, recipient or amount. See security.
Which wallets can APN use?
Local wallets that APN creates or imports, and provider-managed wallets bound with wallet connect: Coinbase Agentic Wallet, MetaMask Agent Wallet and MetaMask Smart Account. A provider balance is never spending authority. Where the allowlist does not cover a provider lane, the provider's own controls set the limit: Guard policy and MFA for MetaMask Agent Wallet, the root permission for a Smart Account, Coinbase's own controls.
Does APN support x402?
Yes. APN covers standard x402 purchases with EIP-3009 USDC, Permit2 and ERC-20 transfer-proof merchants, and x402 solana pay for Solana exact offers. See x402.
Where does APN store its data?
In ~/.apn, created with mode 0700 on the first wallet command. Homebrew does not own that folder, so status and receipts survive restart, reinstall and upgrades.
Has APN been proven with live payments?
Not by its tests alone. The README says deterministic tests are source proof, not live provider acceptance or payment proof. Live mainnet acceptance is recorded per family in each guide.
How do I report a security problem?
Use GitHub private vulnerability reporting for nuanu-ai/agent-payment-node. Do not open a public issue, and do not include wallet secrets, private keys or live payment authorization in the report.