# How to use

#### Getting Started <a href="#getting-started" id="getting-started"></a>

**Initial Setup**

1. **Access the Application**
   * Navigate to <https://bundler.bot/>
   * The interface will load with a dark theme and green accent colors
2. **System Configuration**
   * Click the settings icon (⚙️) in the top-right corner
   * Configure your network settings, RPC endpoint, and transaction fees
   * Set up API keys for enhanced features if needed

**Wallet Management**

**Creating Wallets**

1. Access **System Settings** → **Wallets** tab
2. In the **Create Wallets** section:
   * Set quantity (1-180 wallets)
   * Click **CREATE** to generate new wallets
3. Newly created wallets will appear in your wallet list

**Importing Wallets**

**Single Wallet Import:**

1. Click **IMPORT SINGLE WALLET**
2. Enter the private key or seed phrase
3. Confirm the import

**Bulk Import:**

1. Click **IMPORT FROM FILE (.txt)**
2. Upload a text file containing private keys (one per line)
3. The system will process and import all valid wallets

**Wallet Management Options**

* **Export All Wallets**: Download all wallet private keys
* **Remove Empty Wallets**: Clean up wallets with zero balances
* **View Statistics**: Monitor total wallets, SOL balance, tokens, and active wallets

***

#### Core Operations <a href="#core-operations" id="core-operations"></a>

**Token Selection and Monitoring**

1. **Set Token Address**
   * Enter any SPL token mint address in the search bar at the top
   * The system will display balances for that token across all wallets
   * Toggle between SOL and custom token views
2. **Balance Overview**
   * Total aggregated balance shown in header
   * Individual wallet balances displayed in the main list
   * Real-time updates with refresh button (🔄)

**Trading Operations**

**DEX Selection**

The platform supports multiple DEX routes:

* **Auto**: Automatic best route selection
* **PumpFun**: For meme tokens and new launches
* **Moonshot**: Alternative meme token platform
* **PumpSwap**: Decentralized exchange
* **Raydium**: Major Solana AMM
* **Jupiter**: Aggregated routing
* **Launchpad**: New token launches
* **BoopFun**: Additional trading venue

**Buy/Sell Operations**

1. **Select Token**: Enter token address in the search bar
2. **Choose Route**: Select from available DEX options or use Auto
3. **Configure Trade**:
   * Set buy amount in SOL
   * Set sell percentage or amount
   * Configure slippage tolerance
4. **Execute**: Select wallets and execute trades

***

#### Fund Wallets Operations <a href="#fund-wallets-operations" id="fund-wallets-operations"></a>

The Fund Wallets section provides two distinct operations for managing SOL across multiple wallets:

**Distribute SOL**

Standard distribution from one wallet to multiple recipients for direct funding operations.

1. **Access Distribution**
   * Navigate to **Wallet Operations** → **Fund Wallets**
   * Select **Distribute SOL**
2. **Configure Source**
   * Select sender wallet from "FROM WALLET" section
   * View current balance
3. **Select Recipients**
   * Choose destination wallets in "TO WALLETS" section
   * Use "SELECT ALL" for all wallets or individual selection
4. **Set Amount**
   * Enter SOL amount per recipient wallet
   * Option for custom amounts per wallet (if enabled)
5. **Review & Execute**
   * Verify distribution summary
   * Confirm total amount and remaining balance
   * Check "I CONFIRM THIS DISTRIBUTION OPERATION"
   * Click "DISTRIBUTE SOL"

**Mixer SOL (Privacy Feature)**

**From Wallet Section:**

* Search functionality to find sender wallets
* Wallet selection with balance displays
* Address dropdown for specific wallet targeting
* Real-time balance verification

**To Wallets Section:**

* Recipient wallet selection interface
* "SELECT ALL" option for batch operations
* Individual wallet selection with balance tracking
* Live preview of selected recipients

**Amount Settings:**

* Amount per wallet configuration
* Custom amount per wallet toggle
* Total SOL calculation display
* Fee estimation and balance verification

**Step-by-Step Mixing Process**

1. **Access SOL Mixer**
   * Navigate to **Wallet Operations** → **Fund Wallets**
   * Select **Mixer SOL**
   * The SOL Mixer interface opens with privacy-focused options
2. **Configure Source Wallet**
   * In "FROM WALLET" section, search or select sender wallet
   * Example: Select wallet "BGcw11...HvyL" with 9.6901 SOL balance
   * System verifies sufficient balance for mixing operation plus fees
3. **Select Recipient Wallets**
   * In "TO WALLETS" section, choose destination wallets
   * Use "SELECT ALL" to include all available wallets
   * Select individual wallets based on mixing strategy
   * System displays current balances for each wallet
4. **Configure Mixing Parameters**
   * Set amount per wallet (e.g., 0.001 SOL)
   * Toggle "CUSTOM AMOUNT PER WALLET" for varying amounts
   * System shows "SELECTED: X WALLETS" count
   * Review total SOL required for operation
5. **Execute Privacy Mixing**
   * Verify all settings in "AMOUNT SETTINGS" section
   * Check total distribution amount and fee calculations
   * Click "MIX" to execute privacy-enhanced distribution
   * Monitor transaction progress across all wallets

***

#### Fund Consolidation <a href="#fund-consolidation" id="fund-consolidation"></a>

Gather SOL from multiple wallets into one destination:

1. **Access Consolidation**
   * Select "Consolidate SOL" from operations menu
2. **Select Recipient**
   * Choose destination wallet from "RECIPIENT WALLET" section
3. **Choose Sources**
   * Select source wallets from "SOURCE WALLETS" section
   * Use search or "SELECT ALL" for multiple wallets
4. **Set Percentage**
   * Enter percentage of balance to transfer (e.g., 0.01 for 0.01%)
   * View live preview of amounts
5. **Review & Execute**
   * Verify consolidation summary
   * Check estimated new balance
   * Confirm operation and execute

**Asset Transfer**

Transfer SOL or SPL tokens to any address:

1. **Initiate Transfer**
   * Access "Transfer Assets" from operations
2. **Configure Transfer**
   * Select source wallet
   * Enter recipient Solana address
   * For SOL: Leave token address empty
   * For SPL tokens: Enter token mint address
   * Specify transfer amount
3. **Review & Execute**
   * Verify transfer details
   * Confirm and authorize transaction

**Token Deployment**

Create and deploy new SPL tokens:

1. **Access Deployer**
   * Select "DEPLOY" from operations panel
2. **Generate Mint Key**
   * Click "GENERATE" for new keypair
   * Or enter existing mint public key
3. **Token Metadata**
   * **Name**: Full token name
   * **Symbol**: Ticker symbol (keep short)
   * **Description**: Token purpose/utility
   * **Logo URL**: Direct link to token logo image
4. **Social Links**
   * Telegram group link
   * Twitter handle
   * Project website URL
5. **Deploy**
   * Review all information
   * Confirm deployment transaction

**Cleaner Operations**

Execute complex atomic operations across multiple wallets:

1. **Access Cleaner**
   * Click "CLEANER" from operations panel
2. **Configure Sellers**
   * System displays wallets holding the target token
   * Select wallets to act as sellers/sources
   * Choose one or multiple seller wallets
3. **Advanced Configuration**
   * Define specific actions (buy/sell/transfer)
   * Set atomic operation parameters
   * Configure simultaneous execution

***

#### Advanced Features <a href="#advanced-features" id="advanced-features"></a>

**System Settings**

**Network Configuration**

* **RPC Endpoint**: Configure custom Solana RPC endpoint for optimal performance
* **Transaction Fee**: Set default transaction fee (typically 0.000005 SOL)
* **Connection Status**: Monitor network connectivity and latency
* **Mixing Optimization**: Special RPC settings for privacy operations

**Advanced Settings**

* **API Key**: Enter API key for enhanced features and higher limits
* **System Information**: View connection status and RPC endpoint details
* **Performance Optimization**: Configure for optimal mixing and trading operations
* **Privacy Settings**: Configure mixing parameters and privacy preferences

**Operations Panel**

The right sidebar provides quick access to key functions:

* **🧹 CLEANER**: Multi-wallet atomic operations
* **📱 DEPLOY**: Token creation and deployment
* **🔥 BURN**: Token burning operations
* **🎯 STAGGER**: Staged transaction execution

**Wallet Operations Menu**

Complete wallet management functions:

* **Manage Wallets**: Full wallet management interface with bulk operations
* **Fund Wallets**:
  * **Distribute SOL**: Standard multi-wallet distribution
  * **Mixer SOL**: Privacy-enhanced mixing operations
* **Consolidate SOL**: Advanced funds consolidation with percentage controls
* **Transfer Assets**: Direct SOL and SPL token transfers
* **Deposit SOL**: Funding operations and wallet management

***

#### User Interface Guide <a href="#user-interface-guide" id="user-interface-guide"></a>

**Main Dashboard**

* **Header**: Shows total balances, token selection, and privacy status
* **Sidebar (Left)**: Wallet list with balances, selection options, and privacy indicators
* **Center**: Token information, operation status, and mixing progress
* **Sidebar (Right)**: Trading controls, operations panel, and privacy tools

**Color Coding**

* **Green**: Positive balances, successful operations, active elements, mixing status
* **Red**: Sell operations, removal actions, alerts, failed transactions
* **Blue**: Information, links, secondary actions, privacy features
* **Gray**: Inactive elements, placeholders, pending operations

**Navigation**

* **Start Here >**: Quick start guide and privacy tutorials
* **Settings (⚙️)**: System configuration including privacy settings
* **Wallets Counter**: Shows active/total wallets and mixing status
* **Operations Panel**: Quick access to main functions including mixer

***

#### Best Practices <a href="#best-practices" id="best-practices"></a>

**Security**

* Always backup wallet private keys securely using encrypted storage
* Use strong, reliable RPC endpoints for consistent connectivity
* Verify all transaction details before confirmation, especially for mixing
* Keep API keys confidential and rotate regularly
* Monitor mixing operations for completion and success

**Privacy and Mixing**

* **Timing Variation**: Avoid predictable mixing schedules to prevent pattern analysis
* **Amount Randomization**: Vary mixing amounts to avoid creating detectable patterns
* **Wallet Rotation**: Use different source wallets for mixing operations
* **Balance Management**: Maintain sufficient balances for fees across all mixing wallets
* **Network Timing**: Consider network congestion when executing privacy operations

**Performance**

* Use wallet selection efficiently for large-scale operations
* Monitor network congestion and adjust fees accordingly for mixing
* Utilize batch operations for efficiency while maintaining privacy
* Regular cleanup of empty wallets to optimize interface performance
* Strategic mixing during low-traffic periods for better privacy

**Trading**

* Test with small amounts first, especially when combining with mixing
* Monitor slippage on large trades that may affect mixing operations
* Use auto-routing for best execution while maintaining operational security
* Keep track of gas fees across all operations including privacy features

***

#### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

**Common Issues**

* **Connection Problems**: Check RPC endpoint in settings, verify privacy-compatible endpoints
* **Transaction Failures**: Verify sufficient SOL for fees across all mixing wallets
* **Wallet Import Issues**: Ensure correct private key format for bulk imports
* **Balance Not Updating**: Use refresh button, check network status, verify mixing completion
* **Mixing Incomplete**: Verify all recipient wallets received funds, check for failed transactions

**Support Resources**

* **Live Demo**: <https://bundler.bot/>
* **Open Source**: Built with transparency for security auditing
* **API Documentation**: Comprehensive API documentation
* **Community Support**: GitHub issues, community channels, and privacy-focused forums
* **Privacy Guides**: Detailed documentation on mixing best practices


---

# 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://docs.bundler.bot/overview/how-to-use.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.
