# Wallet Pools

**Wallet Pools** (also referred to as Manage Wallets) is a system for managing groups of Solana wallets organized into named pools. Pools are used for bulk operations: initial buy-back on PumpFun launches, distributing funds from CEX, Price Boost, Price Drop, and Smart Buyback.

***

### Overview

The main Wallet Pools page displays a list of all your pools:

| Column           | Description                        |
| ---------------- | ---------------------------------- |
| **Wallet Pools** | Pool name                          |
| **Created**      | Date and time the pool was created |
| **Lifetime**     | Age of the pool since creation     |
| **Quantity**     | Number of wallets in the pool      |

Use the **Create new Pool** button in the top-right corner to add a new pool.

***

### Creating a Pool

1. Click **Create new Pool**
2. Enter a name for the pool in the modal window (e.g. `Launch_April`, `Boost_WIF`)
3. Click **Create**
4. After successful creation, a confirmation message appears — click **Manage Pool** to go directly to wallet management

***

### Managing Wallets Inside a Pool

When you open a pool, the following information is displayed at the top:

* **Total balance** — combined SOL balance across all wallets in the pool
* **Frozen Balance** — funds reserved for active operations
* **Token Balance** *(if applicable)* — if wallets in the pool hold tokens other than SOL, a third balance block appears. By default, it shows the token with the largest total balance across the pool. Use the dropdown to switch to any other token held by pool wallets<br>

  <figure><img src="/files/J9vEgMmyryiEiUhA2rt3" alt=""><figcaption></figcaption></figure>
* **Last sync** — timestamp of the last balance sync
* **Project age** — pool age since creation
* **Wallets quantity** — total number of wallets in the pool

#### Wallet Table

| Column           | Description                                                            |
| ---------------- | ---------------------------------------------------------------------- |
| **Wallet**       | Shortened public address. Click the copy icon to copy the full address |
| **Age**          | Wallet age since creation                                              |
| **Balance**      | SOL balance                                                            |
| **Frozen Money** | Funds currently frozen on this wallet                                  |

The `···` button next to each wallet opens a context menu with additional actions.

***

### Adding Wallets

#### Create New Wallets

1. Click **Create wallets** (or **Create wallet** if wallets already exist in the pool)
2. Enter the number of wallets to generate — between 1 and 1000
3. Click **Generate**

New wallets are generated instantly and appear in the table immediately.

#### Import Existing Wallets

Click **Import wallets**. Two import modes are available:

**Manual**

Paste public addresses or private keys directly into the text field, or use the **Paste from clipboard** button. The system shows a live counter: `Valid`, `Invalid`, `Duplicates`.

**From File**

Upload a file containing public addresses or private keys. Supported formats: `.txt`, `.csv`, `.xlsx`. Drag & drop the file or click **Upload file**.

> 🔒 **Private keys are encrypted and stored securely.** Tsunammi never has access to your keys in plain text.

After pasting or uploading, click **Import** to confirm.

***

### Pool Context Menu (`···`)

Click the three-dot menu on any pool row in the list to access the following actions:

| Action                  | Description                                          |
| ----------------------- | ---------------------------------------------------- |
| **Edit**                | Rename the pool                                      |
| **Export Private keys** | Download the private keys of all wallets in the pool |
| **Delete**              | Permanently delete the pool and all its wallets      |

> ⚠️ **Export Private keys** — store the exported file in a safe place. Anyone with access to private keys has full control over those wallets.

***

### Export XLSX

The **Export XLSX** button in the top-right corner of an open pool exports a spreadsheet with all wallet addresses, balances, and related data in Excel format.

***

### Tips

* **Use meaningful pool names** — for example, by token or operation: `PEPE_launch`, `boost_pool_1`. This makes it easier to select the right pool in operation forms.
* **Minimum balance** — before running any operations, make sure wallets are funded. The minimum deposit per wallet is **0.016 SOL**.
* **Frozen Balance** — funds are frozen during active operations (Price Boost, Buyback, etc.) and released automatically once the operation completes.
* **Sync now** — use to force a balance refresh after topping up wallets.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tsunammi.gitbook.io/tsunammi/wallet-management/wallet-pools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
