Wallet Management
The Wallet Management menu provides all the tools you need to create, fund, and manage your bundle wallets.
Accessing Wallet Management
Run npm start in your terminal
Select Option 2 from the main menu
You'll see the Wallet Management submenu
Menu Options
Wallet Management Modules:
Check Wallet Balances
What it does: Shows SOL balance for all wallets with live USD values
How to use:
Select option 1 from wallet management menu
Automatically displays all wallet balances
Features:
Live SOL price from CoinGecko (fallback: $170)
Shows dev wallet, funder wallet, and all bundle wallets
Grand total in SOL and USD
Fund Wallets (Stealth Mode)
What it does: Funds bundle wallets using 1:1 intermediate wallets to avoid detection
How to use:
Select option 2 from wallet management menu
Choose funding option: - Fund all wallets → Enter amount per wallet - Fund specific wallets → Enter different amounts for each wallet - Recover intermediate wallets (emergency recovery)
Features:
Anti-detection
Automatic cleanup of intermediate wallets
Saves recovery data in case of failures
Configurable delays between transactions
Refund SOL
What it does: Returns SOL from bundle wallets to funder wallet
How to use:
Select option 3 from wallet management menu
Choose refund type: - All SOL from all wallets - Percentage from all wallets → Enter percentage - Individual wallets → Select each wallet
Features:
Preserves minimum balance for rent (0.00089088 SOL)
Fast batch processing (no confirmation wait)
Shows refundable amount per wallet
Interactive wallet selection with balance display
Note: ALWAYS CONFIRM WALLET BALANCES AFTER REFUNDING - If one or more wallets failed to refund, run the option again
Close Token Accounts
What it does: Closes empty token accounts to recover ~0.00203 SOL rent per account
How to use:
Select option 4 from wallet management menu
Choose mode: - Single wallet → Select wallet number - All wallets → Automatic processing
Features:
Shows token names and balances
Only closes zero-balance accounts
Displays total recoverable SOL
Vanity Address Generator
What it does: Creates wallets with custom address endings (e.g., "pump")
How to use:
Select option 5 from wallet management menu
Choose action: - Generate → Enter suffix (default: "pump") → Enter count (1-5) - List → Shows all generated addresses - Clear used → Removes only used addresses - Clear all → Removes all vanity addresses
Features:
Real-time progress display
Press Enter twice to stop early
Tracks used vs available addresses
Saved in vanity/vanityInfo.json
Refund Deleted Wallets
What it does: Recovers SOL from accidentally deleted wallet files
How to use:
Select option 6 from wallet management menu
Automatically scans key-backups folder
Shows recoverable amounts
Confirm to proceed with recovery
Features:
Finds wallets in key-backups directory
Closes token accounts first (extra recovery)
Drains all wallets completely to 0 SOL
Best Practices
Wallet Setup
Create up to 16 wallets initially
Generate vanity addresses for launch
Fund each wallet with at least 0.1 SOL more than needed for optimal performance
Keep extra in funder for refills
During Operations
Check balances before launches
Monitor for low balances
Refund between launches
Close token accounts regularly
Security
Never share keypair files
Keep funder wallet secure
Monitor for unusual activity
Common Issues
"Insufficient funds" errors
Check funder wallet balance
Ensure enough for fees
Try smaller distribution amounts
"Transaction failed"
RPC may be rate limited
Try again after a moment
Check network congestion
"No wallets found"
Create wallets first (Main Menu → Option 1)
Check src/keypairs folder exists
Tips for Success
Post-launch Cleanup - Refund remaining SOL - Close new token accounts
Maintenance - Token account cleanup - Regular balance checks
Last updated