🚀 Pump.Fun Token Bundler

Production-ready pump.fun token launcher and trading suite built in Rust

✨ Features

✅ Atomic Create + Buy - No frontrun risk (single transaction)
✅ Concurrent Alt Buys - Maximum speed bundle execution
✅ Auto IPFS Upload - Local images uploaded automatically
✅ Vanity Addresses - Auto-generates "pump" suffix
✅ Live Trading Manager - Real-time UI for quick trades
✅ Market Cap Tracking - Accurate bonding curve math
✅ P&L Tracking - Per-wallet profit/loss analysis
✅ Balance Pre-Check - Verify funds before execution
✅ Cost Preview - See exact SOL requirements
✅ Separate Slippage - 25% buy / 50% sell for guaranteed exits
✅ WebSocket Confirms - Instant transaction feedback
✅ 3x Retry Logic - Exponential backoff on failures
✅ Anti-Bubble - Staggered sells with random delays
✅ Creator Fees - Check accumulated dev fees

🎯 Quick Start

1. Prerequisites

# Install Rust (if not installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Verify
rustc --version  # Should show 1.70+

2. Build

cd pumpfun-rs
cargo build --release

3. Configure

# Copy example configs
cp .env.example .env
cp config.example.json config.json

# Edit with your details
nano config.json

4. Run

cargo run --release

📖 Documentation

COMPLETE_GUIDE.md - Full documentation (start here!)
IPFS_UPLOAD_GUIDE.md - Detailed IPFS instructions
IPFS_QUICKSTART.md - Quick IPFS reference
USAGE_GUIDE.md - Feature-by-feature guide

⚡ Quick Example

Config File

{
  "name": "My Token",
  "symbol": "MTK",
  "description": "My awesome token",
  "image_path": "/home/user/token.png",
  "dev_private_key": [198,213,117,...],
  "dev_buy_amount": 0.5,
  "buyer_wallets": [
    {
      "name": "buyer1",
      "private_key": [6,7,8,...],
      "buy_amount": 0.1
    }
  ]
}

Launch Output

📤 Uploading image to IPFS...
✅ Image uploaded! https://ipfs.io/ipfs/QmX...

🔍 Generating vanity address ending in 'pump'...
✅ Token Mint: 9piZniQsNFz...pump

🚀 Creating token...
✅ Token created and dev bought!
   View: https://pump.fun/9piZniQsNFz...pump

💰 Alt wallet buys (concurrent)...
✅ All buys complete! Success rate: 100%

📊 Market Cap: 51.2 SOL
   Graduation Progress: 0.75%

🎛️ Main Menu

1.  🚀 Instant Bundle Launch       - Create + buy in one flow
2.  📝 Create Config Wizard        - Interactive setup
3.  📂 Load & Launch from Config   - Use existing config
4.  💰 Buy with Alt Wallets        - Bundle buy existing token
5.  💸 Sell Tokens                 - Quick sell from wallet
6.  🔥 Dump All Wallets            - Sell from all config wallets
7.  📊 Live Token Manager          - Real-time trading UI
8.  📈 View Bonding Curve          - Check token stats
9.  👛 Manage Wallets              - Generate/fund wallets
10. 🎯 Bulk Generate & Fund        - Create multiple wallets
11. ⏱️  Staggered Sell             - Anti-detection selling
12. 📋 Transaction Dashboard       - View success/fail stats
13. 🚪 Exit

🔥 Live Token Manager

Real-time trading interface with instant actions:

📊 BONDING CURVE STATUS
────────────────────────────────────────────
Market Cap:           51.2 SOL (~$7,680)
Graduation Progress:  ██░░░░░░░░ 1.46%
────────────────────────────────────────────

ACTIONS:
1. 💰 Quick Buy
2. 💸 Quick Sell
3. 📊 Refresh Bonding Curve
4. 🔥 Dump All Config Wallets
5. ⏱️  Staggered Sell
6. 💼 Check Creator Fees
7. 🚪 Exit (Show P&L)

📊 Key Metrics

Metric	Value
Transaction Cost	~0.0043 SOL per tx
Success Rate	>95% with retries
Vanity Generation	2-5 minutes average
Confirmation Time	<3 seconds (WebSocket)
Buy Slippage	25% (bundle-safe)
Sell Slippage	50% (guaranteed exit)

🎨 Image Handling

Auto-Upload to IPFS

Option 1: Local File

{
  "image_path": "/home/user/my-token.png"
}

→ Automatically uploads to IPFS

Option 2: IPFS URL

{
  "image_path": "https://ipfs.io/ipfs/QmX..."
}

→ Uses URL directly

Optional: Pinata API (Faster)

# .env
PINATA_API_KEY=your_key
PINATA_API_SECRET=your_secret

Image Requirements:

Format: PNG, JPG, GIF
Size: 800x800px (square)
Max: 5MB
Path: Absolute (not relative)

💰 Trading Strategies

Quick Scalp

Buy:  Launch (< 10 SOL MC)
Sell: 2-3x (20-30 SOL MC)
Time: 5-30 minutes
Risk: Medium

Hold for Migration

Buy:  Launch
Sell: Near graduation (80+ SOL)
Time: Hours to days
Risk: High

Bundler Exit

Dev:  Exit at 2-5x
Alts: Staggered sells
Time: 15-60 minutes
Risk: Low

🔒 Security

✅ DO

Use fresh wallets per launch
Test with small amounts first
Keep private keys encrypted
Use premium RPC for reliability
Back up all keys securely

❌ DON'T

Commit keys to git
Reuse dev wallets
Share .env files
Leave large amounts in hot wallets
Skip testing on small amounts

⚙️ Configuration

Environment (.env)

# RPC
RPC_URL=https://api.mainnet-beta.solana.com

# Priority Fees
PRIORITY_FEE_UNIT_LIMIT=80000
PRIORITY_FEE_UNIT_PRICE=300
JITO_TIP_LAMPORTS=4000

# Slippage
SLIPPAGE_BPS=2500              # 25% buys
SELL_SLIPPAGE_BPS=5000         # 50% sells

# Retry
MAX_RETRIES=3
RETRY_INITIAL_DELAY_MS=500

# IPFS (Optional)
PINATA_API_KEY=
PINATA_API_SECRET=

Config File (config.json)

{
  "name": "Token Name",
  "symbol": "SYMBOL",
  "description": "Description",
  "image_path": "/path/to/image.png",
  "twitter": "@handle",
  "telegram": "t.me/group",
  "website": "https://site.com",
  "dev_private_key": [1,2,3,...,64],
  "dev_buy_amount": 0.5,
  "buyer_wallets": [...]
}

🛠️ Building from Source

Requirements

Rust 1.70+
Cargo
4GB RAM
Stable internet

Build Steps

# Clone
git clone <repo-url>
cd pumpfun-rs

# Build (development)
cargo build

# Build (production)
cargo build --release

# Test
cargo test

# Run
cargo run --release

🐛 Troubleshooting

Common Issues

Image not found

# Use absolute path
realpath image.png

IPFS upload failed

# Add Pinata keys to .env or upload manually

Insufficient balance

# Add 10% buffer to required amounts

Slippage exceeded

# Increase SLIPPAGE_BPS in .env

Transaction failed

# Automatic retry (3x) usually resolves
# Use premium RPC for better success rate

See COMPLETE_GUIDE.md for detailed troubleshooting.

📈 Success Tips

Test first - Use small amounts initially
Premium RPC - Use Helius/QuickNode for reliability
Pinata API - Faster IPFS uploads
Buffer funds - Add 10% extra for fees
Stagger sells - Use anti-detection features
Monitor market - Use Live Manager for real-time data

📚 Architecture

Core Components

src/lib.rs - Main SDK with PumpFun client
src/main.rs - CLI interface and launcher
src/vanity.rs - Vanity address generation
src/ipfs_upload.rs - IPFS image upload
src/market_cap.rs - Bonding curve math
src/pnl_tracker.rs - P&L tracking
src/websocket_confirmer.rs - Real-time confirms
src/retry.rs - Transaction retry logic
src/anti_bubble.rs - Anti-detection features

Transaction Flow

1. Load Config
2. Check Balances
3. Preview Costs
4. Upload Image (if local)
5. Generate Vanity Address (ends in "pump")
6. Create + Dev Buy (atomic transaction)
7. Alt Buys (concurrent via tokio::spawn)
8. Confirmation (WebSocket real-time)
9. Success Dashboard

🤝 Contributing

Contributions welcome! This is a community project.

Fork the repository
Create feature branch (git checkout -b feature/amazing)
Commit changes (git commit -m 'Add feature')
Push to branch (git push origin feature/amazing)
Open Pull Request

📄 License

Dual licensed under:

MIT License
Apache License 2.0

Choose the license that best fits your needs.

⚠️ Disclaimer

IMPORTANT:

This software is provided "as is" without warranty
Trading cryptocurrency is risky - you can lose money
Only risk capital you can afford to lose
No guarantees of profit
Always test with small amounts first
Not financial advice - DYOR

Security:

Review all code before using
Never commit private keys
Use secure, malware-free computers
Keep encrypted backups

Legal:

You are responsible for legal compliance
Consult legal/financial advisors
Token creation may have tax implications

🔗 Resources

Pump.fun: https://pump.fun
Solana Docs: https://docs.solana.com
Pinata (IPFS): https://pinata.cloud
Helius (RPC): https://helius.dev

📞 Support

Documentation: See COMPLETE_GUIDE.md
Issues: Open GitHub issue
Community: Join Solana/pump.fun Discord

🎉 Quick Command Reference

# Build
cargo build --release

# Run
cargo run --release

# Test
cargo test

# Clean
cargo clean

# Format
cargo fmt

# Lint
cargo clippy

Made with ❤️ for the Solana community

⚡ Built for speed. Engineered for reliability. Designed for profits. 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 82 Commits
.github/workflows		.github/workflows
.vscode		.vscode
examples		examples
scripts		scripts
src		src
tests		tests
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
COMPLETE_GUIDE.md		COMPLETE_GUIDE.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
IPFS_QUICKSTART.md		IPFS_QUICKSTART.md
IPFS_UPLOAD_GUIDE.md		IPFS_UPLOAD_GUIDE.md
LICENSE-APACHE		LICENSE-APACHE
LICENSE-MIT		LICENSE-MIT
QUICKREF.md		QUICKREF.md
README.md		README.md
RUSTDOC.md		RUSTDOC.md
USAGE_GUIDE.md		USAGE_GUIDE.md
config.example.json		config.example.json

Folders and files

Latest commit

History

Repository files navigation

🚀 Pump.Fun Token Bundler

✨ Features

🎯 Quick Start

1. Prerequisites

2. Build

3. Configure

4. Run

📖 Documentation

⚡ Quick Example

Config File

Launch Output

🎛️ Main Menu

🔥 Live Token Manager

📊 Key Metrics

🎨 Image Handling

Auto-Upload to IPFS

💰 Trading Strategies

Quick Scalp

Hold for Migration

Bundler Exit

🔒 Security

✅ DO

❌ DON'T

⚙️ Configuration

Environment (.env)

Config File (config.json)

🛠️ Building from Source

Requirements

Build Steps

🐛 Troubleshooting

Common Issues

📈 Success Tips

📚 Architecture

Core Components

Transaction Flow

🤝 Contributing

📄 License

⚠️ Disclaimer

🔗 Resources

📞 Support

🎉 Quick Command Reference

About

Resources

License

Licenses found

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages