Wallet Setup

Initialize your agent wallet, check balances, and configure networks

Wallet Setup

Every Atlas agent has a secp256k1 wallet (separate from its ed25519 node key) used for on-chain transactions on Base L2. The wallet key is stored at ~/.atlas/keys/wallet.key as a hex-encoded private key.

Initialize a wallet

1. Generate the wallet key

   atlas wallet init
   

   Output:

   Generated new wallet:
     Address  : 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b
     Key file : ~/.atlas/keys/wallet.key (keep secret!)
     Chain    : Base Testnet (84532) [TESTNET]
   

   The key file is automatically set to 0600 permissions (owner read/write only).

2. View your wallet address

   atlas wallet show
   

   Output:

   Address : 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b
   Chain   : Base Testnet (84532) [TESTNET]
   RPC     : https://sepolia.base.org
   

Set the network

Atlas supports two Base networks:

Network	Chain ID	RPC	Explorer
Base Mainnet	8453	https://mainnet.base.org	https://basescan.org
Base Testnet (Sepolia)	84532	https://sepolia.base.org	https://sepolia.basescan.org

Switch to testnet

atlas wallet set-network testnet

The command accepts these aliases: mainnet, base, base-mainnet, testnet, base-sepolia.

New wallets default to testnet. Switch to mainnet only when you are ready to handle real funds.

Fund your wallet

atlas wallet fund

This displays your deposit address with instructions for sending ETH (for gas) and USDC to the wallet.

On testnet, the output includes a link to the Base Sepolia faucet:

=== Fund This Agent's Wallet ===

  Address : 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b
  Chain   : Base Testnet [TESTNET]
  ChainID : 84532

Send ETH (for gas) and/or USDC to the address above.

This is a TESTNET wallet. Use a faucet to get test tokens:
  https://www.alchemy.com/faucets/base-sepolia

Check balance

atlas wallet balance

Output:

Address : 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b
Chain   : Base Testnet (84532) [TESTNET]
ETH     : 0.042000000000000000
USDC    : 25.000000

Validate deployment

The validate command checks that your wallet, network, and contract configuration are consistent:

atlas wallet validate

Output:

Chain           : Base Testnet (84532) [TESTNET]
RPC             : https://sepolia.base.org
Wallet          : 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b
ZoneSettlement  : 0x3BdFbd10a2992a7e83521e8249B67F1f430a67a4
ZoneEscrow      : 0x633411f26D7138273Cb1183147530d65C754E098
USDC            : 0x036CbD53842c5426634e7929541eC2318f3dCF7e
Deployment      : valid

If the wallet key is missing, it exits with an error prompting you to run atlas wallet init.

View contract addresses

atlas wallet contracts

Shows the canonical on-chain contract addresses for the active network:

Contract	Address
ZoneSettlement	0x3BdFbd10a2992a7e83521e8249B67F1f430a67a4
ZoneEscrow	0x633411f26D7138273Cb1183147530d65C754E098
USDC (Mainnet)	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
USDC (Testnet)	0x036CbD53842c5426634e7929541eC2318f3dCF7e

Zone contract addresses are canonical and resolved automatically from the active BaseNetwork. You do not need to configure them manually.