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.
| Profile | Networks (chain ID) | Who pays native gas | USDC fee charged to sender |
|---|---|---|---|
| Local wallet | Ethereum 1, Optimism 10, Unichain 130, Polygon PoS 137, Base 8453, Arbitrum One 42161 | Circle USDC paymaster, through a bundler | Actual fee A, at most the frozen budget F |
| Local wallet on Avalanche | Avalanche C-Chain 43114 | PayAI public x402 facilitator | 0 |
| Coinbase Agentic Wallet | Base 8453 | Coinbase CDP paymaster | 0 |
| MetaMask Agent server wallet | Ethereum 1, Optimism 10, Polygon PoS 137, Monad 143, Sei 1329, Base 8453, Arbitrum One 42161, Linea 59144 | MetaMask relay | Quoted fee F, inside your caps |
| MetaMask Smart Account | Base 8453 | Public MetaMask facilitator | 0 |
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.
| Lane | Mechanism { provider, reference } |
|---|---|
| Local wallet, Circle paymaster | local, eip155:<chain-id>:0x0578cFB241215b77442a541325d6A4E6dFE700Ec |
| Local wallet on Avalanche | payai-x402-facilitator, eip155:43114:https://facilitator.payai.network |
| Coinbase Agentic Wallet on Base | coinbase-agentic-wallet, awal@2.12.1:send_base_usdc:eip155:8453 |
| Ethereum USDT | pimlico-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
FUSDC to the paymaster. The batch sends exactlyNUSDC and clears the allowance. A failed transfer can still pay a USDC fee. - A successful first send returns
submitted_pending. Runoperation resumeto 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 isN = amount - F. The batch calls USDTapprove(paymaster, 0),approve(paymaster, F), thentransfer(recipient, N). - A quote whose worst case exceeds
Fis refused. - Over MCP,
executereturns a handoff throughapn_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 anotherexecutenever resends. Terminal states arefinalized,failed_confirmed_revert,expired_never_landedandfailed_before_effect. apn operation abandonis the owner's exit when the RPC cannot prove either outcome. It recordsabandoned_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.