Skip to content

metavault-fi/solana-pumpfun-bundler

Repository files navigation

Pump.fun Bundler

Launch tokens on Pump.fun with coordinated Jito bundles. Create, fund bundler wallets, execute simultaneous buys, and manage SOL distribution — all from an interactive CLI built for Solana token launches.

Node.js Solana Jito License: ISC


What Is a Bundler?

On Pump.fun, the first blocks after launch often determine who holds supply. A bundler lets you:

  1. Create a token with metadata uploaded to Pump.fun IPFS
  2. Fund multiple bundler wallets in one batch
  3. Buy simultaneously via Jito bundles — all txs land in the same block
  4. Manage holder wallets — distribute SOL, gather proceeds, sell positions

This repo is the full toolkit: presimulation, ALT (Address Lookup Table) setup, LilJito execution, and an interactive menu for every step.


Features

Feature Benefit
Interactive menu No memorizing CLI flags
Presimulation Validate create tx before spending SOL
IPFS metadata upload Pump.fun-compatible token info
Jito bundle buys Atomic multi-wallet entry
SOL distribute / gather Batch fund and sweep bundler wallets
ALT support Compact txs for large bundles
TypeScript + Anchor Type-safe Pump.fun IDL client

Quick Start

Prerequisites

  • Node.js LTS
  • Solana wallets with SOL (creator + bundler provider)
  • Fast RPC (HTTPS + WSS)
  • Jito block engine access

Install

git clone https://github.com/metavault-fi/solana-pumpfun-bundler.git
cd solana-pumpfun-bundler
npm install
cp .env.example.ts .env.ts
cp settings.example.ts settings.ts

Configure .env.ts

RPC_ENDPOINT=https://your-rpc.com
RPC_WEBSOCKET_ENDPOINT=wss://your-rpc.com
LILJITO_RPC_ENDPOINT=https://your-jito-rpc.com
JITO_FEE=0.001
BLOCKENGINE_URL=https://mainnet.block-engine.jito.wtf
COMPUTE_UNIT_PRICE=100000

Configure settings.ts (gitignored)

// Creator wallet (token deployer)
LP_wallet_privateKey: "..."

// Funds bundlers and pays Jito tips
Bundler_provider_privateKey: "..."

// Token metadata
token: {
  name: "My Token",
  symbol: "MTK",
  description: "...",
  image: "./assets/logo.png",
  // socials, mintPk (filled after launch)
}

Run

npm start       # interactive menu
npm run dev     # ts-node development
npm run close   # close LUT (closeLut.ts)

Launch Pipeline

flowchart LR
    A[Presimulate] --> B[Upload Metadata]
    B --> C[Send Create Tx]
    C --> D[Fund Bundlers]
    D --> E[Build ALT]
    E --> F[Jito Bundle Buys]
    F --> G[Monitor / Sell]
Loading
Step Module Description
1 layout/presimulate.ts Dry-run create tx
2 Pump.fun IPFS Upload name, symbol, image
3 layout/createTokenBuy.ts On-chain token creation
4 layout/solDistribute.ts Batch SOL to bundler wallets
5 ALT builder Address Lookup Table for compact bundles
6 executor/lilJito.ts Jito sendBundle multi-buy

Project Structure

index.ts                  # Interactive menu entry
menu/                     # Menu navigation
layout/
  createTokenBuy.ts       # Launch + bundle buy pipeline
  presimulate.ts          # Pre-flight simulation
  solDistribute.ts        # Batch SOL to bundlers
  solGather.ts            # Sweep bundler wallets
src/pumpfun/              # Anchor IDL client
executor/
  lilJito.ts              # Jito bundle sender
  jito.ts                 # Legacy executor
  legacy.ts               # Fallback paths
config.ts                 # Env loading
settings.ts               # Wallets + token config (gitignored)
closeLut.ts               # Close Address Lookup Table

Health Checks

Check Command
Dependencies npm install
Types npm run typecheck (requires settings.ts)
CLI smoke printf "5\n" | npm start → exit menu

Menu Overview

The interactive CLI walks you through:

  • Token creation and metadata setup
  • Presimulation and validation
  • Bundler wallet funding
  • Coordinated Jito buy bundles
  • SOL distribution and gathering
  • Position selling workflows

Select options by number — no complex flag combinations required.


Security Best Practices

  • Dedicated hot wallets — never use your main holdings wallet
  • Authenticated RPC — public endpoints leak txs to mempool snipers
  • Review npm audit — transitive Anchor/Raydium deps may have advisories
  • Keep settings.ts gitignored — it holds private keys
  • Test on devnet before mainnet launches (where supported)

Environment Reference

Variable Purpose
RPC_ENDPOINT HTTPS Solana RPC
RPC_WEBSOCKET_ENDPOINT WSS for subscriptions
LILJITO_RPC_ENDPOINT Jito-aware RPC
JITO_FEE Tip amount per bundle (SOL)
BLOCKENGINE_URL Jito block engine endpoint
COMPUTE_UNIT_PRICE Priority fee micro-lamports

Disclaimer

Token launches involve regulatory, financial, and technical risk. Bundled buys may be subject to platform rules and local laws. This software is provided as-is for developers who understand Solana and Pump.fun mechanics. Authors not liable for losses, failed bundles, or account restrictions.


License

ISC — see package.json.

About

Solana Pumpfun Bundler Solana Pump.fun bundler Solana Pumpfun Bundler Solana Pump.fun bundler Solana Pumpfun Bundler Solana Pump.fun bundler Solana Pumpfun Bundler Solana Pump.fun bundler Solana Pumpfun Bundler Solana Pumpfun bundler Solana Pumpfun Bundler Solana Pumpfun bundler Solana Pumpfun Bundler Solana Pumpfun Bundler Solana Pumpfun bundler

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors