> For the complete documentation index, see [llms.txt](https://tsunammi.gitbook.io/tsunammi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tsunammi.gitbook.io/tsunammi/wallet-management/wallet-pools.md).

# Wallet Pools

**Wallet Pools** (also called **Manage Wallets**) is a system for organizing groups of Solana wallets into named pools. Pools power bulk operations across Tsunammi: initial buyback on PumpFun launches, distributing funds from a CEX, Price Boost, Price Drop, and Smart Buy/Sell.

## The Wallet Pools List

The main **Manage Wallets** page lists all your pools.<br>

<figure><img src="https://36735466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4l8FoYBADwHJ2fgJr3u6%2Fuploads%2FF4Ly7BvKJB9vPvvXVcYU%2Fimage.png?alt=media&amp;token=dcb869bb-cef5-4db2-ad33-4b87d9c06b86" alt=""><figcaption></figcaption></figure>

| Column           | Description                                            |
| ---------------- | ------------------------------------------------------ |
| **Wallet Pools** | Pool name and icon.                                    |
| **Created**      | Date and time the pool was created (`DD.MM.YY HH:MM`). |
| **Lifetime**     | Age of the pool since creation (e.g. `16 days`).       |
| **Quantity**     | Number of wallets in the pool.                         |

Each row also has a **···** menu (pool actions) and a **>** arrow to open the pool.

### Sorting & Filtering

The top-right controls let you reorder and filter the list:

* **Top to bottom** dropdown — sort direction (**Top to bottom** / **Bottom to top**).
* **Date** dropdown — the field to sort by.
* **Pick a date** — open the calendar to filter pools by a **date range**.
* **Refresh** (top of the page) — force a fresh balance/data sync.

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

## Creating a Pool

{% stepper %}
{% step %}

#### Click **Create new Pool**

{% endstep %}

{% step %}

#### Enter a pool name

Enter a name for the pool in the modal (e.g. `Launch_April`, `Boost_WIF`).
{% endstep %}

{% step %}

#### Click **Create**

After creation, you can go straight into the pool to start adding wallets.<br>
{% endstep %}
{% endstepper %}

## Inside a Pool

Open a pool (via the **>** arrow) to manage its wallets. The **< All pools** link returns to the list.<br>

<figure><img src="https://36735466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4l8FoYBADwHJ2fgJr3u6%2Fuploads%2FzK3ymLSvdv9YpvS5TKT8%2Fimage.png?alt=media&amp;token=df7c0bd8-3366-4548-97fb-43baa806d65d" alt=""><figcaption></figcaption></figure>

### Balance Overview

At the top of the pool you'll see:

* **Total balance** — combined balance across all wallets. Use the **dropdown** to switch which token's total is shown (SOL or any other token held by pool wallets). **Sell All** sells the entire holding of the selected token back to SOL across the pool.
* **Frozen Balance** — funds reserved for active operations (frozen while a campaign runs, released automatically when it completes).
* **Last sync** — timestamp of the last balance sync.
* **Project age** — pool age since creation.
* **Wallets quantity** — total number of wallets in the pool.

### Tabs

* **All wallets** — the wallet table (default view).
* **Swap history** — a log of every swap made by the pool's wallets (see [Swap History](#swap-history)).

### Wallet Table

| Column           | Description                                                                                     |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| **Wallet**       | Shortened public address (click the copy icon to copy the full address).                        |
| **Date**         | When the wallet was created (`DD.MM.YY HH:MM`).                                                 |
| **Status**       | **Active** or **Inactive** — controls whether the wallet participates in campaigns (see below). |
| **Balance**      | SOL balance. A `+N` badge indicates the wallet also holds *N* other token types.                |
| **Frozen Money** | Funds currently frozen on this wallet by active operations.                                     |

The **···** button on each row opens a per-wallet context menu:

| Action          | Description                                                              |
| --------------- | ------------------------------------------------------------------------ |
| **Private Key** | Reveal the wallet's private key.                                         |
| **Map**         | Open a bubble map showing on-chain links between this wallet and others. |
| **Delete**      | Remove this wallet from the pool.                                        |

{% hint style="warning" %}
🔒 Keep any revealed **Private Key** confidential — anyone with it has full control over that wallet.
{% endhint %}

Sort the table with the **Top to bottom** (direction) and **Balance** (sort-by) dropdowns above it.

### Activating & Deactivating Wallets

<figure><img src="https://36735466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4l8FoYBADwHJ2fgJr3u6%2Fuploads%2FQwCynigcWW3Rzpmwt5GV%2Fimage.png?alt=media&amp;token=34bfba3e-029f-44b7-bd34-280dce8bd1b2" alt=""><figcaption></figcaption></figure>

You can choose exactly which wallets take part in a campaign without removing the others from the pool.

* Every wallet has a **Status**: **Active** or **Inactive**.
* Only **Active** wallets participate in operations (PumpFun buyback, Price Boost, Price Drop, Smart Buy/Sell, etc.). **Inactive** wallets stay in the pool but are skipped.
* To change status in bulk: tick the checkboxes for one or more wallets, then use the **Status** dropdown at the top of the table and choose **● Active** or **● Inactive**. The header shows how many are **Selected** (e.g. *Selected 3/4*).
* The **Delete** action next to it removes the selected wallets from the pool.

{% hint style="info" %}
**Tip:** Deactivate wallets when you want to run a campaign with only a subset of the pool — no need to move or delete the rest.
{% endhint %}

### Adding Wallets

#### Create new wallets

{% stepper %}
{% step %}

#### Click **Create wallet**

Click **Create wallet** (or **Create wallets** if the pool is empty).
{% endstep %}

{% step %}

#### Enter the number of wallets

Enter the number of wallets to generate — between **1 and 1000**.
{% endstep %}

{% step %}

#### Click **Generate**

New wallets appear in the table instantly.
{% endstep %}
{% endstepper %}

#### Import existing wallets

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

* **Manual** — paste addresses or private keys into the **Address** field, or use **Paste from clipboard**. A live counter shows **Valid**, **Invalid**, and **Duplicates**.
* **From file** — upload a file containing addresses or private keys (`.txt`, `.csv`, `.xlsx`) via drag & drop or file picker.

Then click **Import** to confirm.<br>

<figure><img src="https://36735466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4l8FoYBADwHJ2fgJr3u6%2Fuploads%2F1NXJGEY7a6TW6bswSd7p%2Fimage.png?alt=media&amp;token=4f4978bd-df5f-4788-b550-c9d7d1e82698" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
🔒 Private keys are encrypted and stored securely. Tsunammi never has access to your keys in plain text.
{% endhint %}

### Pool Actions Menu

The **···** menu at the top of an open pool (next to **Export XLSX**) provides:

| Action                  | Description                                           |
| ----------------------- | ----------------------------------------------------- |
| **Edit**                | Rename the pool.                                      |
| **Export Private keys** | Download the private keys of all wallets in the pool. |
| **Top-up wallets**      | Fund the pool's wallets with SOL.                     |
| **Delete**              | Permanently delete the pool and all its wallets.      |

**Export XLSX** (top-right of an open pool) exports a spreadsheet with all wallet addresses, balances, and related data.<br>

{% hint style="warning" %}
⚠️ Store any exported private-keys file somewhere safe. Anyone with access to the private keys has full control over those wallets.
{% endhint %}

### Swap History

The **Swap history** tab logs every swap performed by the pool's wallets:

| Column       | Description                                                          |
| ------------ | -------------------------------------------------------------------- |
| **Time**     | When the swap happened (`DD.MM.YY HH:MM`).                           |
| **Status**   | **Success** or **Failed**.                                           |
| **Wallet**   | The wallet that made the swap (with copy icon).                      |
| **TX**       | Transaction signature (with copy icon); shows `--` for failed swaps. |
| **Sold**     | Token and amount sold.                                               |
| **Received** | Token and amount received (e.g. SOL).                                |

<figure><img src="https://36735466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4l8FoYBADwHJ2fgJr3u6%2Fuploads%2FQPzodMkF1s9TyJjrElqW%2Fimage.png?alt=media&amp;token=412a2c9f-170f-46e0-b03a-808785a07396" alt=""><figcaption></figcaption></figure>

## Tips

* **Use meaningful pool names** — e.g. by token or operation (`PEPE_launch`, `boost_pool_1`). This makes selecting the right pool in operation forms much easier.
* **Fund wallets before operating** — the minimum deposit per wallet is **0.016 SOL**. Funds are frozen during active operations and released automatically once they complete.
* **Activate only what you need** — set unused wallets to **Inactive** to run a campaign with a specific subset.
* **Refresh / Last sync** — use **Refresh** to force a balance update after topping up wallets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.