# How Wallets Work

> Understanding Sumo's secure wallet architecture.

- URL: https://docs.sumo.trade/wallets/how-wallets-work
- Markdown: https://docs.sumo.trade/wallets/how-wallets-work.md
- Docs index: https://docs.sumo.trade/llms.txt

Sumo manages real on-chain wallets for your trading operations. Each wallet is a standard blockchain address that holds and trades your funds — there's no custodial pool or shared wallet.

## Wallet Architecture

### Seeds and Derivation

Sumo uses **BIP-39 mnemonic phrases** (12 or 24 words) as master seeds. From each seed, wallets are derived using **BIP-44 HD derivation**, which means:

* Each seed can generate an unlimited number of wallets
* All wallets from the same seed are deterministically reproducible
* You can have multiple seeds per profile

### On-Chain Addresses

Every wallet in Sumo maps to a real on-chain address:

* **Solana** — Standard Ed25519 keypairs
* **EVM** (Ethereum, BSC, Base) — Standard ECDSA keypairs

You can view any wallet's public address on the Wallets page and use it to send/receive funds directly.

## Wallet Table

The Wallets page shows all your wallets in a sortable table:

| Column                    | Description                                             |
| ------------------------- | ------------------------------------------------------- |
| **Address**               | Wallet public address with group color indicator        |
| **SOL** (or native asset) | Native asset balance                                    |
| **Tokens**                | Your token balance in this wallet                       |
| **% Supply**              | What percentage of total token supply this wallet holds |
| **$ Value**               | Total USD value of all assets in the wallet             |
| **Status**                | Active, archived, or excluded                           |

Click any column header to sort. Use the search bar to filter by wallet address.

## Profile and Wallet Actions

The profile workspace combines wallet-table actions with treasury operations:

* **Copy addresses** — Copy all filtered wallet addresses to clipboard
* **Edit groups** — Assign selected wallets to groups
* **Archive/Unarchive** — Toggle wallet active status
* **Exclude** — Move wallets to the Excluded tab when they should not be reused accidentally
* **Withdraw** — Send native assets, quote tokens, project tokens, or all balances to external destinations
* **Treasury Swap** — Rotate selected wallets between native assets and supported stablecoins from the Swap modal
* **Cross-Chain Swap** — Cash out from a project wallet to an address on a different chain
* **Privacy Cashout** — Move native assets or supported stablecoins privately between wallets
* **Swap Wallets** — Rotate wallet assignments
* **Token Cleanup** — Rebalance token holdings between wallet groups through direct transfers or market redistribution
* **Wrap/Unwrap** — Convert between native and wrapped assets
* **Bubblemaps analysis** — Review holder clusters and create wallet groups for matching Sumo wallets
* **Claim creator fees** — Claim eligible creator fees on supported PumpFun/PumpSwap profiles
* **Change creator** — Permanently route future PumpFun/PumpSwap creator fees to one wallet or a percentage split; admin only
* **Create or Import** — Add new wallets

## Wallet Statuses

Sumo wallets have three statuses:

* **Active** — Wallet participates in strategies and shows in wallet selectors
* **Archived** — Wallet is excluded from new operations but balances remain queryable. You can unarchive wallets at any time to make them active again.
* **Excluded** — Wallet is intentionally kept out of trading and strategies. Excluded wallets appear in a separate **Excluded** tab so they cannot be accidentally reactivated during bulk operations. Common examples include deployment wallets used for launching tokens or pools that are never meant to trade.

The Excluded tab only appears in the profile navigation when at least one wallet has been excluded.

> **Status Changes Don't Move Funds**
>
> Excluding or archiving a wallet only changes its status in Sumo. Funds remain in the wallet on-chain. To move funds out, use [Withdraw](/treasury/withdraw) or [Swap Wallets](/treasury/swap-wallets).

### When to Exclude vs. Archive

| Scenario                                             | Recommended Status                            |
| ---------------------------------------------------- | --------------------------------------------- |
| Wallet temporarily out of service (e.g. low balance) | **Archived** — unarchive when ready           |
| Deployment wallet (token launch, pool creation)      | **Excluded** — never meant to trade           |
| Wallet replaced through Swap Wallets                 | **Archived** — funds already moved            |
| Wallet reserved for non-trading purposes             | **Excluded** — prevents accidental activation |

- [Generate Wallets](/wallets/generate-wallets): Create new wallets from a seed phrase.

- [Import Wallets](/wallets/import-wallets): Bring existing wallets into Sumo.