APN gasless USDC and USDT transfers

Agent Payment Node (APN) can send canonical USDC on one chain while the network fee is covered from the transfer itself or by a sponsor, so the agent's wallet needs no native gas. Ethereum USDT works through a separate keyless sponsor. This page lists each route, its networks, who pays for gas, and the commands.

Updated

How does gasless USDC work in APN?

apn gasless sends canonical USDC on one chain. The sender needs no native gas balance. Which routes exist depends on the wallet profile. This is a same-chain USDC transfer only. It does not imply gasless x402 or bridge support.

ProfileNetworks (chain ID)Who pays native gasUSDC fee charged to sender
Local walletEthereum 1, Optimism 10, Unichain 130, Polygon PoS 137, Base 8453, Arbitrum One 42161Circle USDC paymaster, through a bundlerActual fee A, at most the frozen budget F
Local wallet on AvalancheAvalanche C-Chain 43114PayAI public x402 facilitator0
Coinbase Agentic WalletBase 8453Coinbase CDP paymaster0
MetaMask Agent server walletEthereum 1, Optimism 10, Polygon PoS 137, Monad 143, Sei 1329, Base 8453, Arbitrum One 42161, Linea 59144MetaMask relayQuoted fee F, inside your caps
MetaMask Smart AccountBase 8453Public MetaMask facilitator0

apn gasless capabilities lists the exact adapters, networks and RPC variables without reading any wallet or provider. There is no default chain and no native-payment fallback.

Which owner allowlist rail applies to gasless transfers?

The gasless rail. The owner admits the chain's canonical USDC on that rail with positive per-operation and UTC daily caps, plus the exact mechanism for the lane. Preparation checks the policy, and approval reserves the gross amount in the shared usage ledger before the first signature. A recipients pin of 1 to 16 addresses is optional, except on the Coinbase lane, where a pin is required.

LaneMechanism { provider, reference }
Local wallet, Circle paymasterlocal, eip155:<chain-id>:0x0578cFB241215b77442a541325d6A4E6dFE700Ec
Local wallet on Avalanchepayai-x402-facilitator, eip155:43114:https://facilitator.payai.network
Coinbase Agentic Wallet on Basecoinbase-agentic-wallet, awal@2.12.1:send_base_usdc:eip155:8453
Ethereum USDTpimlico-erc20-paymaster, eip155:1:0x888888888888Ec68A58AB8094Cc1AD20Ba3D2402

How do I send gasless USDC from a local wallet?

The shared command set is below. --amount is the gross amount, --max-fee is the most you will pay in USDC fees, and --min-received is the least the recipient must get. --chain takes a numeric mainnet chain ID.

apn gasless balance --profile <profile> --chain <chain-id>
apn gasless transfer prepare --profile <profile> --chain <chain-id> --to <recipient-address> \
  --amount <gross-usdc> --max-fee <usdc> --min-received <usdc> --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>
apn operation resume --operation <operation-id> [--observation-rpc-env <APN_..._RPC_URL>]
apn receipt get --operation <operation-id>

A local Base example from the repository:

apn gasless transfer prepare --profile default --chain 8453 \
  --to <recipient-address> --amount 10 --max-fee 0.2 --min-received 9.8 \
  --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>
apn operation resume --operation <operation-id>

This permits a total of 10 USDC, a fee of at most 0.2 USDC and delivery of at least 9.8 USDC. APN freezes the fee budget F = min(max-fee, amount - min-received), here 0.2 USDC, and the recipient amount N = amount - F. A quote above F is refused at preparation. If the actual fee A is lower, the unused F - A stays with the sender. The sender pays N + A.

  • The local route sets an explicit public HTTPS RPC for the chain, for example APN_BASE_RPC_URL. The default bundler is the chain's public Pimlico endpoint, which needs no API key.
  • On first use, approval includes an EIP-7702 delegation of the address to a pinned account implementation. It persists after the transfer.
  • APN signs a permit for exactly F USDC to the paymaster. The batch sends exactly N USDC and clears the allowance. A failed transfer can still pay a USDC fee.
  • A successful first send returns submitted_pending. Run operation resume to observe finality and settlement.

Avalanche USDT is blocked because neither keyless sponsor accepts EIP-7702 there. The Circle-paymaster adapter cannot run on Avalanche for the same reason.

How does gasless USDC work on Avalanche with the PayAI facilitator?

A local wallet sends Avalanche C-Chain USDC without holding AVAX. The owner signs one EIP-3009 transferWithAuthorization for the exact recipient and amount. PayAI's public x402 facilitator at https://facilitator.payai.network verifies it and submits the transaction, paying the gas. No token fee is taken, and the account keeps no delegation or allowance. The authorization is valid for 120 seconds after approval.

apn gasless balance --profile <profile> --chain 43114
apn gasless transfer prepare --profile <profile> --chain 43114 --to <recipient> \
  --amount 1.5 --max-fee 0 --min-received 1.5 --idempotency-key <key>
apn gasless transfer approve --operation <operation-id>

Set APN_AVALANCHE_RPC_URL. After the approval marker, only chain evidence ends the operation. A completed transfer needs a finalized receipt with one AuthorizationUsed and one USDC Transfer of the exact amount. An unused expired authorization ends as expired_unused. Run apn operation resume after the 120-second window to record the outcome.

How does gasless USDC work with Coinbase Agentic Wallet on Base?

Use an existing coinbase-agentic-wallet profile and set APN_BASE_RPC_URL. Coinbase's CDP paymaster pays native gas. The sender's USDC debit and the recipient's credit both equal --amount, with no token fee. APN writes a started marker before exactly one awal@2.12.1 send ... --chain base --asset usdc --json child process. After that marker, nothing invokes AWAL again. See wallets.

export APN_BASE_RPC_URL='<https-base-rpc-url>'
apn gasless balance --profile coinbase --chain 8453
apn gasless transfer prepare --profile coinbase --chain 8453 \
  --to <recipient-address> --amount 0.001 --max-fee 0 --min-received 0.001 \
  --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>
apn operation resume --operation <operation-id>

How does gasless USDC work with MetaMask Agent Wallet and Smart Account?

MetaMask Agent server wallet. Use a profile bound to the intended server-wallet address and its existing production session. MetaMask supplies the relay, and no bundler configuration is used. --amount is the exact sender debit G. APN quotes the provider's fee F and recipient amount N, requiring G = N + F, F <= --max-fee and N >= --min-received.

apn gasless balance --profile metamask --chain 8453
apn gasless transfer prepare --profile metamask --chain 8453 \
  --to <recipient-address> --amount 10 --max-fee 0.2 --min-received 9.8 \
  --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>

The Agent wallet also accepts a fixed recipient net, where the three atomic options are required together:

apn gasless transfer prepare --profile metamask --chain 42161 \
  --to <recipient-address> --net-amount-atomic 1000 \
  --max-gross-atomic 25000 --max-fee-atomic 24000 \
  --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>

MetaMask Smart Account. It runs on Base only, with the profile's original owner, session key and active periodic USDC permission. The public MetaMask facilitator pays gas, and the fee is zero. APN signs one child permission for the exact transfer, with an on-chain expiry.

apn gasless balance --profile smart-account --chain 8453
apn gasless transfer prepare --profile smart-account --chain 8453 \
  --to <recipient-address> --amount 1 --max-fee 0 --min-received 1 \
  --idempotency-key <unique-key>
apn gasless transfer approve --operation <operation-id>

How does gasless USDT work on Ethereum?

apn gasless usdt sends USDT on Ethereum from a local wallet without holding ETH. Pimlico's keyless ERC-20 paymaster pays the gas and takes its fee in USDT from the same transfer. The flow has two stages. prepare saves an unsigned, policy-bound operation. execute signs it locally and sends it at most once after foreground approval. The sponsor endpoint is https://public.pimlico.io/v2/1/rpc, and APN_ETHEREUM_RPC_URL is required.

apn gasless usdt prepare --profile <profile> --to <recipient> --amount <gross-USDT> \
  --max-fee <USDT> --min-received <USDT> --idempotency-key <key>
apn gasless usdt status --profile-hash <hash> --operation <operation-id>
apn gasless usdt execute --profile-hash <hash> --operation <operation-id>
apn gasless usdt resume --profile-hash <hash> --operation <operation-id>
apn gasless usdt observe --profile-hash <hash> --operation <operation-id>
  • The fee budget is F = min(max-fee, amount - min-received) and the recipient amount is N = amount - F. The batch calls USDT approve(paymaster, 0), approve(paymaster, F), then transfer(recipient, N).
  • A quote whose worst case exceeds F is refused.
  • Over MCP, execute returns a handoff through apn_foreground_handoff.

What happens if a gasless transfer fails midway?

Preparation never signs or submits. Approval shows the terms and asks for a six-character code typed in a foreground terminal. An approval never sends the same operation twice. A recorded signing, disclosure or send attempt is never repeated by approval replay, operation resume or any later command. See recovery.

  • For USDT, a lost send response becomes unknown_finality, and another execute never resends. Terminal states are finalized, failed_confirmed_revert, expired_never_landed and failed_before_effect.
  • apn operation abandon is the owner's exit when the RPC cannot prove either outcome. It records abandoned_unknown.

Questions

Can an AI agent send USDC without holding ETH for gas?

Yes. With APN's gasless routes the sender needs no native gas balance. On Ethereum, Optimism, Unichain, Polygon PoS, Base and Arbitrum One the Circle paymaster takes its fee in USDC from the transfer.

Does APN support gasless USDT?

Yes, on Ethereum only, from a local wallet, through Pimlico's keyless ERC-20 paymaster. The paymaster pays the gas and takes its fee in USDT from the same transfer, so the sender needs no ETH.

Does the owner allowlist cap MetaMask gasless transfers?

No. Those lanes are limited by MetaMask's Guard policy and MFA, or by the Smart Account's root permission.

Sources
  1. gasless.md: profiles, commands, each route
  2. gasless-usdt.md: Ethereum USDT sponsor route
  3. allowlist-policy.md: gasless rail, mechanisms, pins
  4. README: families table