# Adding a Wallet

> Choose a chain, paste a wallet address, and pick a nickname — the bot starts tracking immediately.

**Adding a wallet** takes three small steps. Once it is in, the bot starts fetching balances and *cost-basis PnL* for that address right away, and the new *portfolio* appears in the main menu.

## The Flow

1. From the main menu, tap **➕ Add Portfolio**.
2. **Choose the chain.** Pick *Ethereum*, *Base*, *BNB Chain*, or *Solana*. If the same address holds tokens on more than one chain, add it once per chain — each becomes its own portfolio.
3. **Paste the wallet address.** The bot validates the format — `0x…` for *EVM-compatible chains*, base58 for *Solana*. If the address is malformed, the bot will ask you to try again.
4. **Pick a nickname.** 1–8 alphanumeric characters. This is what you will see in the portfolio list.

Once verification is successful, the bot replies with a confirmation and returns you to the main menu with the new portfolio in place.

## The Onboarding Wait

The first time a wallet is added, the bot fetches two things in the background:

- **Balances** — usually ready in a few seconds.
- **Cost-basis PnL** — can take up to about a minute the first time, because the full trade history for the wallet is being computed from scratch.

While the PnL calculation is still running, the bot shows an onboarding panel with three buttons:

- **🔄 Refresh** — check whether the PnL data is ready yet.
- **📊 View Portfolio** — open the portfolio once balances *and* PnL are in.
- **👁 View without PnL** — open the portfolio right away with balances only; the PnL columns fill in automatically on the next refresh.

> **INFO**
>
> Cold PnL computation only happens once per wallet, ever. Every future refresh is near-instant.

## Renaming and Removing

Tap a portfolio from the main menu to open its detail view. From here you can:

- **✏️ Rename** — change the nickname at any time.
- **🗑 Remove** — delete the portfolio, along with its price alerts, pinned tokens, hidden tokens, and display preferences. The on-chain wallet itself is untouched.

> **WARNING: Removal is permanent**
>
> Removing a portfolio clears every preference and anchor tied to it. The wallet can always be re-added, but your *PnL anchors* and *display settings* will start fresh.