Skip to content

chris-ruther/solana-pump.fun-bundler

BranchesTags

Repository files navigation

Pumpfun Bundler · Pump.fun Bundler · Solana Bundler for Pump.fun

Pumpfun bundler / pump.fun bundler — a solana bundler for creating and launching tokens on pump.fun. Multi-wallet pumpfun bundler (pump.fun bundler) with vanity address generation, Jito/Lil Jito bundle execution, and atomic one-block launches. Solana bundler for pump.fun.

About this pumpfun bundler (pump.fun bundler)

Pumpfun bundler · Pump.fun bundler · Solana bundler for pump.fun. This pumpfun bundler (pump.fun bundler) creates tokens and executes multi-wallet buys in a single block via Jito/Lil Jito. Use this solana bundler for pump.fun token launches.

🚀 Features

  • Multi-Wallet Bundling: Pumpfun bundler distributes SOL across multiple wallets and executes coordinated token purchases
  • Vanity Address Generation: Generate custom token addresses with specific suffixes (e.g., ending with "pump")
  • Dual Bundle Execution: Support for both Jito and Lil Jito bundle services for MEV protection
  • Address Lookup Tables (LUT): Optimizes transaction size and reduces fees
  • Flexible Configuration: Support for both multi-wallet and single-wallet bundling modes
  • Automatic Retry Logic: Built-in retry mechanisms for RPC and bundle execution failures
  • Token Metadata: Full support for token metadata including images, descriptions, and social links

📋 Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • Solana CLI (optional, for advanced users)
  • Sufficient SOL balance for:
    • Token creation fees
    • Distribution to bundler wallets
    • Jito tips
    • Transaction fees

🛠️ Installation

  1. Clone the repository:
git clone <repository-url>
cd pump.fun-bundler
  1. Install dependencies:
npm install
# or
yarn install
  1. Create a .env file in the root directory with the following variables:
# Required Configuration
PRIVATE_KEY=your_main_wallet_private_key_in_base58
RPC_ENDPOINT=https://your-solana-rpc-endpoint
RPC_WEBSOCKET_ENDPOINT=wss://your-solana-websocket-endpoint

# Bundle Execution Configuration
LIL_JIT_MODE=true
LIL_JIT_ENDPOINT=https://your-lil-jit-endpoint
LIL_JIT_WEBSOCKET_ENDPOINT=wss://your-lil-jit-websocket-endpoint

# Token Configuration
TOKEN_NAME=Your Token Name
TOKEN_SYMBOL=SYMBOL
TOKEN_SHOW_NAME=Display Name
DESCRIPTION=Your token description
TOKEN_CREATE_ON=Launch Date
TWITTER=https://twitter.com/yourhandle
TELEGRAM=https://t.me/yourchannel
WEBSITE=https://yourwebsite.com
FILE=./image/your_token_image.jpg

# Bundling Configuration
SWAP_AMOUNT=0.1
DISTRIBUTION_WALLETNUM=10
JITO_FEE=0.001
VANITY_MODE=false

# Single Wallet Mode (for oneWalletBundle.ts)
BUYER_WALLET=buyer_wallet_private_key_in_base58
BUYER_AMOUNT=0.5

🎯 Usage

Multi-Wallet Bundling (Recommended)

Run the pumpfun bundler (main script):

npm start

This will:

  1. Generate or use a vanity address (if enabled)
  2. Create the token with metadata
  3. Distribute SOL to multiple wallets
  4. Create and populate an Address Lookup Table
  5. Execute coordinated buy transactions via Jito bundles

Single Wallet Mode

For simpler operations with a single buyer wallet:

npm run single

Additional Scripts

  • Close LUT: npm run close - Closes the Address Lookup Table
  • Gather Funds: npm run gather - Collects funds from bundler wallets
  • Check Status: npm run status - Checks the status of transactions

🔀 Choosing Between Jito and Lil Jito

This solana bundler (pumpfun bundler) supports two bundle execution services:

Jito Mode (Default)

  • Configuration: Set LIL_JIT_MODE=false in .env
  • Features:
    • Multi-regional endpoint submission (NY, Tokyo)
    • Automatic failover between endpoints
    • Well-established service with high reliability
    • Requires JITO_FEE for tipping
  • Best for: Production deployments requiring maximum redundancy

Lil Jito Mode

  • Configuration: Set LIL_JIT_MODE=true in .env
  • Features:
    • Single endpoint configuration
    • Simplified setup process
    • Alternative bundle execution service
    • May offer different performance characteristics
  • Best for: Testing alternative execution paths or when Jito is congested

Recommendation: Start with Jito mode (default) for most use cases. Switch to Lil Jito if you experience persistent issues with standard Jito or want to test alternative execution.

⚙️ Configuration Options

Token Settings

  • TOKEN_NAME: The official name of your token
  • TOKEN_SYMBOL: Token symbol (usually 3-5 characters)
  • TOKEN_SHOW_NAME: Display name shown in wallets
  • DESCRIPTION: Token description
  • FILE: Path to token image (supports JPG, PNG)
  • Social links: Twitter, Telegram, Website

Bundling Settings

  • SWAP_AMOUNT: SOL amount per wallet for purchasing (in SOL)
  • DISTRIBUTION_WALLETNUM: Number of wallets to create and use
  • JITO_FEE: Jito tip amount (in SOL)
  • VANITY_MODE: Enable/disable vanity address generation

Bundle Execution Settings

  • LIL_JIT_MODE: Toggle between Lil Jito (true) and standard Jito (false) bundle execution
  • LIL_JIT_ENDPOINT: Lil Jito RPC endpoint for bundle submission
  • LIL_JIT_WEBSOCKET_ENDPOINT: Lil Jito WebSocket endpoint for real-time updates

RPC Configuration

  • Use high-performance RPC endpoints for better success rates
  • Recommended providers: Helius, QuickNode, Alchemy
  • Ensure WebSocket support for real-time updates

🔧 Technical Details

Architecture

  • Token Creation: Pumpfun bundler uses pump.fun SDK for token deployment
  • Wallet Distribution: Creates multiple keypairs and distributes SOL
  • LUT Management: Optimizes transaction size using Address Lookup Tables
  • Bundle Execution: Dual support for Jito and Lil Jito bundle services
    • Jito: Sends bundles to multiple regional Jito endpoints for redundancy
    • Lil Jito: Alternative bundle service with simplified endpoint configuration
  • Retry Logic: Automatic retries for failed operations

Transaction Flow

  1. Token creation transaction
  2. SOL distribution to bundler wallets
  3. LUT creation and population
  4. Coordinated buy transactions in bundles
  5. Bundle submission (via Jito or Lil Jito based on configuration)

🚨 Troubleshooting

Common Issues

RPC Errors

Error: RPC endpoint failed

Solutions:

  • Use a premium RPC provider with higher rate limits
  • Implement RPC endpoint rotation
  • Check network connectivity
  • Reduce concurrent requests

Bundle Submission Failures

Error: Jito/Lil Jito bundle submission failed

Solutions:

  • For Jito Mode (LIL_JIT_MODE=false):
    • Increase Jito tip amount (JITO_FEE)
    • Multiple regional endpoints are tried automatically
    • Check transaction simulation results
  • For Lil Jito Mode (LIL_JIT_MODE=true):
    • Verify LIL_JIT_ENDPOINT is correct and accessible
    • Check endpoint availability and rate limits
    • Switch to standard Jito mode if issues persist
  • General Solutions:
    • Reduce bundle size
    • Verify transaction signatures are valid
    • Check network congestion

Insufficient Balance

Error: Main wallet balance is not enough

Solutions:

  • Calculate required SOL: (SWAP_AMOUNT + 0.01) * DISTRIBUTION_WALLETNUM + 0.04
  • Add more SOL to your main wallet
  • Reduce DISTRIBUTION_WALLETNUM or SWAP_AMOUNT

Transaction Simulation Failures

Solutions:

  • Reduce compute unit limits
  • Optimize transaction size
  • Check token metadata validity
  • Verify wallet permissions

Performance Optimization

  1. RPC Optimization:

    • Use dedicated RPC endpoints
    • Implement connection pooling
    • Monitor rate limits

  2. Transaction Optimization:

    • Use Address Lookup Tables effectively
    • Optimize compute unit allocation
    • Batch operations when possible

  3. Bundle Execution Optimization:

    • Jito Mode:
      • Use appropriate tip amounts
      • Automatic multi-endpoint submission for redundancy
      • Monitor bundle success rates
    • Lil Jito Mode:
      • Simpler endpoint configuration
      • May offer faster execution in some cases
      • Test both modes to determine best performance

📁 Project Structure

├── constants/          # Configuration constants
├── executor/          # Transaction execution logic
│   ├── jito.ts       # Jito bundle execution
│   ├── liljito.ts    # Lil Jito bundle execution
│   └── legacy.ts     # Legacy transaction execution
├── keys/             # Generated wallet keys and data
├── src/              # Core functionality
│   ├── main.ts       # Main bundling logic
│   ├── metadata.ts   # Token metadata handling
│   ├── uploadToIpfs.ts # IPFS upload functionality
│   └── vanity.ts     # Vanity address generation
├── utils/            # Utility functions
├── image/            # Token images
├── index.ts          # Main entry point
├── oneWalletBundle.ts # Single wallet mode
└── package.json      # Dependencies and scripts

🔐 Security Considerations

  • Private Keys: Store private keys securely and never commit them to version control
  • RPC Endpoints: Use trusted RPC providers to prevent data interception
  • Environment Variables: Use .env files and ensure they're in .gitignore
  • Wallet Management: Consider using hardware wallets for main operations

📊 Monitoring and Analytics

The bundler provides detailed logging for:

  • Transaction signatures and confirmations
  • Wallet creation and distribution
  • LUT creation and population
  • Jito bundle submissions
  • Error tracking and retry attempts

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

⚠️ Disclaimer

This software is for educational and research purposes. Users are responsible for:

  • Compliance with local regulations
  • Proper tax reporting
  • Understanding the risks of cryptocurrency trading
  • Securing their private keys and funds

📄 License

ISC License - see LICENSE file for details

🆘 Support

For issues and questions:

  1. Check the troubleshooting section
  2. Review the logs for specific error messages
  3. Ensure all environment variables are properly set
  4. Verify sufficient SOL balance and RPC connectivity

Keywords (SEO)

  • Pumpfun bundler – Pumpfun bundler for pump.fun: multi-wallet solana bundler, vanity addresses, Jito/Lil Jito.
  • Pump.fun bundler – Pump.fun bundler (pumpfun bundler) for pump.fun token launches; same as pumpfun bundler.
  • Solana bundler – Solana bundler for pump.fun token launches; atomic multi-wallet buys in one block.

Note: This pumpfun bundler / pump.fun bundler (solana bundler for pump.fun) is designed for pump.fun token launches. Always test with small amounts first and understand the risks involved in cryptocurrency operations.

About

Multi-wallet bundler for Solana token launches on pump.fun/pumpfun, bonk.fun/bonkfun, letsbonk, and bags.fm. Atomic execution with Jito bundles and Raydium SDK v2. MEV-protected trading bot with dual Jito/Lil Jito support.Solana bundler · Pumpfun bundler · Pump.fun bundler · Bonkfun bundler · Bonk.fun bundler.

pump.fun

Topics

bundler token-launch pumpfun token-launcher bundler-bot pumpfun-pumpswap-migration pumpfun-mayhem-trading-bot pumpfun-bundler-trading-bot

Resources

Readme

Security policy

Security policy
Activity

Stars

52 stars

Watchers

7 watching

Forks

8 forks
Report repository

Contributors

Languages