StonkFun Multi-Wallet Volume Bot

A production-oriented CLI for generating on-chain trading volume on StonkFun LaunchLab bonding curves on Solana. The bot coordinates multiple funded wallets through automated buy-and-sell cycles, with configurable sizing, timing, budget controls, and graduation safeguards.

Developed by CoolBB Agency — Web3 infrastructure, trading automation, and token launch tooling.

Tokens launched on StonkFun trade on a Raydium LaunchLab constant-product bonding curve before graduating to a Raydium CPMM pool. While a token remains on the curve (status: new or aboutToGraduate), this bot:

1. Resolves your token's pool, quote asset, and graduation progress via StonkFun API + on-chain state.
2. Distributes activity across a pool of wallets using round-robin selection.
3. Executes a buy → delay → sell cycle on each eligible wallet.
4. Tracks cumulative volume, fees, and spend against operator-defined limits.
5. Halts automatically when safety thresholds are reached or on graceful shutdown.

Supported quote assets (v1): SOL and xStocks (SPYx, NVDAx, TSLAX, etc.).

┌─────────────┐     ┌──────────────┐     ┌───────────────────┐
│  CLI        │────▶│  BotRunner   │────▶│ WashVolumeStrategy│
│  (index.ts) │     │  (runner.ts) │     │ (washVolume.ts)   │
└─────────────┘     └──────────────┘     └─────────┬─────────┘
                                                   │
                     ┌─────────────────────────────┼─────────────────────────────┐
                     ▼                             ▼                             ▼
              ┌─────────────┐              ┌─────────────┐              ┌─────────────┐
              │ WalletPool  │              │ LaunchLab   │              │ QuoteEngine │
              │ (pool.ts)   │              │ Trader      │              │ (quote.ts)  │
              └─────────────┘              └─────────────┘              └─────────────┘
                                                  │
                                                  ▼
                                    Solana RPC + Raydium LaunchLab
                                    StonkFun REST API

1. Node.js 18+
2. A StonkFun token still on its LaunchLab bonding curve (not graduated)
3. Funded wallets with sufficient quote asset and SOL for fees
4. Private keys (base58 or JSON byte array) via env or key file
5. Dedicated Solana RPC (Helius, Triton, etc. — public RPC will rate-limit)

npm install
cp .env.example .env
# Edit .env with your TOKEN_MINT, RPC_URL, and WALLET_KEYS

Each wallet needs:

• SOL for trades (MAX_TRADE_QUOTE × expected cycles)
• SOL for transaction fees and rent (~0.02–0.05 SOL)

Each wallet needs:

• Quote token balance (xStock Token-2022) for trades
• SOL for transaction fees and ATA rent (~0.02–0.05 SOL)

The bot does not auto-acquire xStocks — fund wallets manually before starting.

# Check token status and wallet balances
npm run status

# Preview a round-trip quote (no transactions)
npm run quote -- --amount 0.05

# Run the bot (respects DRY_RUN setting)
npm run start

# Type-check
npm run build

# Run unit tests
npm test

• Graduation cap — stops when curve progress reaches MAX_GRADUATION_PROGRESS_PCT
• Ready-to-graduate — stops if quote vault meets graduation threshold
• Budget limit — stops when cumulative buy spend exceeds MAX_TOTAL_SPEND_QUOTE
• Cycle limit — stops after MAX_CYCLES (when > 0)
• Dry-run default — DRY_RUN=true prevents accidental live trades
• Graceful shutdown — Ctrl+C finishes the current cycle and prints metrics

Reward-mode tokens carry a Token-2022 transfer tax (1–3%). The bot warns at startup; consider higher SLIPPAGE_BPS.

1. Set DRY_RUN=true, run npm run status — verify token resolves and wallets show balances
2. Run npm run quote -- --amount 0.01 — verify round-trip quote looks reasonable
3. Set MAX_CYCLES=3, MIN_TRADE_QUOTE=0.001, MAX_TRADE_QUOTE=0.005
4. Set DRY_RUN=false with a single funded wallet
5. Run npm run start — confirm 3 cycles complete and metrics print
6. Verify transactions on Solscan

This software is provided for legitimate use cases such as testing and liquidity activity. Artificial volume generation may violate platform terms of service or applicable regulations depending on jurisdiction. Operators are solely responsible for compliance.

Private — CoolBB Agency. All rights reserved.