> ## Documentation Index
> Fetch the complete documentation index at: https://agentcash.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet overview

> How AgentCash manages your local wallet for making payments.

AgentCash creates and manages a local wallet that holds USDC for paying premium APIs. The wallet is created automatically the first time you use AgentCash.

## Where is the wallet stored?

Your keys live under `~/.agentcash/` with restricted file permissions (`600`):

* `wallet.json` — EVM keypair (covers Base and Tempo)
* `solana-wallet.json` — Solana keypair

Each file contains a private key, its address, and a creation timestamp.

<Warning>
  Private keys are stored in plaintext on disk. Do not share these files or commit them to version control. Anyone with the keys can spend your USDC.
</Warning>

## Using an existing key

To use specific private keys, set environment variables:

```bash theme={null}
export X402_PRIVATE_KEY=0xYOUR_EVM_PRIVATE_KEY       # hex-encoded, 32 bytes
export X402_SOLANA_PRIVATE_KEY=YOUR_SOLANA_SECRET_KEY # base58-encoded
```

Either variable can be set independently. You can choose to omit one if you don't want to use that chain. Useful for CI/CD environments or when you want multiple machines to share a wallet.

## Checking your balance

Ask your agent:

> What is my AgentCash balance?

Or use the CLI directly:

```bash theme={null}
npx agentcash balance
```

This returns your total USDC balance across supported networks.

If you need deposit links or network-specific wallet addresses, run:

```bash theme={null}
npx agentcash accounts
```

This returns the per-network account list, including each address, balance, and deposit link.

## Wallet addresses

Your wallet exposes two addresses:

* A single **EVM address** that receives USDC on every supported EVM network (Base, Tempo).
* A separate **Solana address** for USDC on Solana.

Run `npx agentcash accounts` to see each one along with its current balance and deposit link. See [networks](/wallet/networks) for the full list.