Skip to main content

Transfers

Atlas agents can send ETH (for gas) and USDC tokens directly from the CLI. All transfers occur on the active Base network (testnet or mainnet).

Send ETH

atlas wallet send <recipient> <amount>
1

Specify recipient and amount

atlas wallet send 0xRecipient1234567890abcdef1234567890abcdef 0.01
2

Confirm the transaction

The CLI displays a confirmation prompt before broadcasting:
Chain   : Base Testnet (84532) [TESTNET]
From    : 0xYourAddress...
To      : 0xRecipient1234567890abcdef1234567890abcdef
Amount  : 0.01 ETH

Send this transaction? [y/N]
Type y to proceed or N to cancel.
3

View the result

TX Hash : 0xabc123...
View    : https://sepolia.basescan.org/tx/0xabc123...
Status  : Confirmed
Gas     : 21000

Send USDC

atlas wallet send-usdc <recipient> <amount>
Example:
atlas wallet send-usdc 0xRecipient1234567890abcdef1234567890abcdef 10.5
The same confirmation prompt is displayed before sending.

Amount format

TokenFormatExamplesDecimals
ETHDecimal string0.01, 1.5, 0.00118
USDCDecimal string10, 2.50, 0.016
Amounts are parsed as human-readable decimals. The CLI converts them to the correct on-chain representation (wei for ETH, 6-decimal raw units for USDC).
USDC transfers call the ERC-20 transfer function on the USDC contract for the active network. Make sure your wallet has enough ETH for gas in addition to the USDC balance.

Transaction confirmation

After broadcasting, the CLI waits for the transaction to be confirmed on-chain. Three outcomes are possible:
StatusMeaning
ConfirmedTransaction included in a block and succeeded
REVERTEDTransaction included but execution failed on-chain
PendingConfirmation timed out; check the explorer link manually
The gas used is displayed when the transaction is confirmed.

Common errors

The recipient must be a valid EVM address: 0x followed by exactly 40 hexadecimal characters. Checksummed and lowercase addresses are both accepted.
No wallet key file exists at ~/.atlas/keys/wallet.key. Run atlas wallet init to generate one.
The active network does not have a configured USDC contract address. This should not occur on Base mainnet or testnet.
Your wallet does not have enough ETH or USDC to cover the transfer amount plus gas fees. Use atlas wallet balance to check current balances and atlas wallet fund for deposit instructions.