PumpFun Volume Booster

A TypeScript automation layer for Solana that orchestrates multi-wallet flows around a single SPL token mint—funding ephemeral wallets, executing pump.fun-compatible buy and sell paths, consolidating positions, and recovering residual SOL. Built for operators who need repeatable, scriptable control over RPC-backed execution on mainnet-class infrastructure.

---

Capabilities

Area	Description
Wallet topology	Generates a configurable number of signer keypairs and routes SOL from a primary fee payer using randomized per-wallet amounts within bounds.
Trading loop	Coordinates timed buys across distributed wallets, then aggregates token balances to the main wallet for exit or further processing.
Liquidity exit	Sells consolidated token inventory from the main wallet and closes associated token accounts where applicable.
Recovery	Sweeps SOL from logged key material (e.g. amount.json) when prior runs leave stranded balances; optional ATA cleanup paths.

The runtime exposes an interactive CLI (readline) so you can select modes (buy sequence, full sell, SOL sweep, etc.) without redeploying configuration.

---

Stack

• Runtime: Node.js, TypeScript (strict)
• Chain: Solana (@solana/web3.js, @solana/spl-token)
• Programs: Anchor (@coral-xyz/anchor) for shared tooling and layout utilities
• Secrets & config: dotenv + environment variables

---

Prerequisites

• Node.js 18+ recommended
• A funded Solana keypair (base58 secret) used as the fee payer
• Reliable RPC access (public or dedicated); throughput and confirmation behavior depend on endpoint quality

---

Setup

git clone <repository-url>
cd pumpfun-volume-booster
npm install

Create a .env in the project root (never commit real keys):

RPC_ENDPOINT=https://api.mainnet-beta.solana.com
TOKEN_MINT=<SPL_mint_address>
DISTRIBUTENUM=<number_of_ephemeral_wallets>
MIN_AMOUNT=<min_SOL_per_wallet>
MAX_AMOUNT=<max_SOL_per_wallet>
PRIVATE_KEY=<base58_secret_key>

Defaults in code fall back to public mainnet RPC and conservative numeric bounds if variables are omitted—set TOKEN_MINT and PRIVATE_KEY before any live run.

---

Run

npm start

package.json maps start to ts-node src/index.ts. Follow the on-screen menu to select the desired operational mode.

---

Project layout (high level)

Path	Role
src/index.ts	CLI entry and orchestration
src/utils.ts	Multi-wallet SOL distribution, buys, transfers, sells, ATA lifecycle
src/getBuyTx.ts / src/getSellTx.ts	Transaction construction for pump.fun-style interactions
src/execute.ts	Transaction submission / execution helpers
src/sweepSol.ts	SOL recovery from persisted key material
src/constants.ts	Environment-backed configuration surface

---

Security & compliance

• Private keys in .env and generated wallet material grant full control of funds. Restrict file permissions, use dedicated wallets, and assume compromise if logs or amount.json leak.
• This software interacts with live blockchain state and third-party venues. You are solely responsible for compliance with applicable laws, platform terms, and jurisdictional rules.
• No warranty is implied; use at your own risk.

---

License

ISC — see package.json.

---

Contact

Telegram: @sebasneuron

For integrations, custom RPC topologies, or operational questions, reach out via the link above.