{"id":22870587,"url":"https://github.com/enlomy/pumpfun-bundler","last_synced_at":"2026-02-03T04:04:37.829Z","repository":{"id":265085812,"uuid":"895042390","full_name":"enlomy/pumpfun-bundler","owner":"enlomy","description":"pumpfun bundler: pumpfun bundler is a bundler on pumpfun","archived":false,"fork":false,"pushed_at":"2025-03-28T10:04:01.000Z","size":73,"stargazers_count":23,"open_issues_count":0,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-21T20:04:12.776Z","etag":null,"topics":["bundler","fun","pump","pump-fun","pumpfun"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/enlomy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-27T13:07:14.000Z","updated_at":"2025-06-17T16:06:50.000Z","dependencies_parsed_at":"2024-12-22T15:11:01.210Z","dependency_job_id":"d8294945-4135-4e9d-9ac4-cd0ec4a44234","html_url":"https://github.com/enlomy/pumpfun-bundler","commit_stats":null,"previous_names":["enlomy/pump-fun-bundler","enlomy/pump.fun-bundler","enlomy/pumpfun-bundler"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/enlomy/pumpfun-bundler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enlomy%2Fpumpfun-bundler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enlomy%2Fpumpfun-bundler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enlomy%2Fpumpfun-bundler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enlomy%2Fpumpfun-bundler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/enlomy","download_url":"https://codeload.github.com/enlomy/pumpfun-bundler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enlomy%2Fpumpfun-bundler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29032017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T02:28:16.591Z","status":"ssl_error","status_checked_at":"2026-02-03T02:27:48.904Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bundler","fun","pump","pump-fun","pumpfun"],"created_at":"2024-12-13T13:15:11.836Z","updated_at":"2026-02-03T04:04:37.819Z","avatar_url":"https://github.com/enlomy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pump.fun Bundler\n\nA sophisticated Solana token bundler designed to create and launch tokens on pump.fun with advanced features including multi-wallet bundling, vanity address generation, and Jito MEV protection.\n\n## 🚀 Features\n\n- **Multi-Wallet Bundling**: Distributes SOL across multiple wallets and executes coordinated token purchases\n- **Vanity Address Generation**: Generate custom token addresses with specific suffixes (e.g., ending with \"pump\")\n- **Jito MEV Protection**: Uses Jito bundles for MEV protection and transaction ordering\n- **Address Lookup Tables (LUT)**: Optimizes transaction size and reduces fees\n- **Flexible Configuration**: Support for both multi-wallet and single-wallet bundling modes\n- **Automatic Retry Logic**: Built-in retry mechanisms for RPC and Jito failures\n- **Token Metadata**: Full support for token metadata including images, descriptions, and social links\n\n## 📋 Prerequisites\n\n- Node.js (v16 or higher)\n- npm or yarn\n- Solana CLI (optional, for advanced users)\n- Sufficient SOL balance for:\n  - Token creation fees\n  - Distribution to bundler wallets\n  - Jito tips\n  - Transaction fees\n\n## 🛠️ Installation\n\n1. Clone the repository:\n```bash\ngit clone \u003crepository-url\u003e\ncd pump.fun-bundler\n```\n\n2. Install dependencies:\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Create a `.env` file in the root directory with the following variables:\n\n```env\n# Required Configuration\nPRIVATE_KEY=your_main_wallet_private_key_in_base58\nRPC_ENDPOINT=https://your-solana-rpc-endpoint\nRPC_WEBSOCKET_ENDPOINT=wss://your-solana-websocket-endpoint\n\n# Token Configuration\nTOKEN_NAME=Your Token Name\nTOKEN_SYMBOL=SYMBOL\nTOKEN_SHOW_NAME=Display Name\nDESCRIPTION=Your token description\nTOKEN_CREATE_ON=Launch Date\nTWITTER=https://twitter.com/yourhandle\nTELEGRAM=https://t.me/yourchannel\nWEBSITE=https://yourwebsite.com\nFILE=./image/your_token_image.jpg\n\n# Bundling Configuration\nSWAP_AMOUNT=0.1\nDISTRIBUTION_WALLETNUM=10\nJITO_FEE=0.001\nVANITY_MODE=false\n\n# Single Wallet Mode (for oneWalletBundle.ts)\nBUYER_WALLET=buyer_wallet_private_key_in_base58\nBUYER_AMOUNT=0.5\n```\n\n## 🎯 Usage\n\n### Multi-Wallet Bundling (Recommended)\n\nRun the main bundler script:\n```bash\nnpm start\n```\n\nThis will:\n1. Generate or use a vanity address (if enabled)\n2. Create the token with metadata\n3. Distribute SOL to multiple wallets\n4. Create and populate an Address Lookup Table\n5. Execute coordinated buy transactions via Jito bundles\n\n### Single Wallet Mode\n\nFor simpler operations with a single buyer wallet:\n```bash\nnpm run single\n```\n\n### Additional Scripts\n\n- **Close LUT**: `npm run close` - Closes the Address Lookup Table\n- **Gather Funds**: `npm run gather` - Collects funds from bundler wallets\n- **Check Status**: `npm run status` - Checks the status of transactions\n\n## ⚙️ Configuration Options\n\n### Token Settings\n- `TOKEN_NAME`: The official name of your token\n- `TOKEN_SYMBOL`: Token symbol (usually 3-5 characters)\n- `TOKEN_SHOW_NAME`: Display name shown in wallets\n- `DESCRIPTION`: Token description\n- `FILE`: Path to token image (supports JPG, PNG)\n- Social links: Twitter, Telegram, Website\n\n### Bundling Settings\n- `SWAP_AMOUNT`: SOL amount per wallet for purchasing (in SOL)\n- `DISTRIBUTION_WALLETNUM`: Number of wallets to create and use\n- `JITO_FEE`: Jito tip amount (in SOL)\n- `VANITY_MODE`: Enable/disable vanity address generation\n\n### RPC Configuration\n- Use high-performance RPC endpoints for better success rates\n- Recommended providers: Helius, QuickNode, Alchemy\n- Ensure WebSocket support for real-time updates\n\n## 🔧 Technical Details\n\n### Architecture\n- **Token Creation**: Uses pump.fun SDK for token deployment\n- **Wallet Distribution**: Creates multiple keypairs and distributes SOL\n- **LUT Management**: Optimizes transaction size using Address Lookup Tables\n- **Jito Integration**: Sends bundles to multiple Jito endpoints for redundancy\n- **Retry Logic**: Automatic retries for failed operations\n\n### Transaction Flow\n1. Token creation transaction\n2. SOL distribution to bundler wallets\n3. LUT creation and population\n4. Coordinated buy transactions in bundles\n5. Jito bundle submission\n\n## 🚨 Troubleshooting\n\n### Common Issues\n\n#### RPC Errors\n```\nError: RPC endpoint failed\n```\n**Solutions:**\n- Use a premium RPC provider with higher rate limits\n- Implement RPC endpoint rotation\n- Check network connectivity\n- Reduce concurrent requests\n\n#### Jito Failures\n```\nError: Jito bundle submission failed\n```\n**Solutions:**\n- Increase Jito tip amount\n- Try different Jito endpoints\n- Reduce bundle size\n- Check transaction simulation results\n\n#### Insufficient Balance\n```\nError: Main wallet balance is not enough\n```\n**Solutions:**\n- Calculate required SOL: `(SWAP_AMOUNT + 0.01) * DISTRIBUTION_WALLETNUM + 0.04`\n- Add more SOL to your main wallet\n- Reduce `DISTRIBUTION_WALLETNUM` or `SWAP_AMOUNT`\n\n#### Transaction Simulation Failures\n**Solutions:**\n- Reduce compute unit limits\n- Optimize transaction size\n- Check token metadata validity\n- Verify wallet permissions\n\n### Performance Optimization\n\n1. **RPC Optimization**:\n   - Use dedicated RPC endpoints\n   - Implement connection pooling\n   - Monitor rate limits\n\n2. **Transaction Optimization**:\n   - Use Address Lookup Tables effectively\n   - Optimize compute unit allocation\n   - Batch operations when possible\n\n3. **Jito Optimization**:\n   - Use appropriate tip amounts\n   - Submit to multiple endpoints\n   - Monitor bundle success rates\n\n## 📁 Project Structure\n\n```\n├── constants/          # Configuration constants\n├── executor/          # Transaction execution logic\n│   ├── jito.ts       # Jito bundle execution\n│   └── legacy.ts     # Legacy transaction execution\n├── keys/             # Generated wallet keys and data\n├── src/              # Core functionality\n│   ├── main.ts       # Main bundling logic\n│   ├── metadata.ts   # Token metadata handling\n│   ├── uploadToIpfs.ts # IPFS upload functionality\n│   └── vanity.ts     # Vanity address generation\n├── utils/            # Utility functions\n├── image/            # Token images\n├── index.ts          # Main entry point\n├── oneWalletBundle.ts # Single wallet mode\n└── package.json      # Dependencies and scripts\n```\n\n## 🔐 Security Considerations\n\n- **Private Keys**: Store private keys securely and never commit them to version control\n- **RPC Endpoints**: Use trusted RPC providers to prevent data interception\n- **Environment Variables**: Use `.env` files and ensure they're in `.gitignore`\n- **Wallet Management**: Consider using hardware wallets for main operations\n\n## 📊 Monitoring and Analytics\n\nThe bundler provides detailed logging for:\n- Transaction signatures and confirmations\n- Wallet creation and distribution\n- LUT creation and population\n- Jito bundle submissions\n- Error tracking and retry attempts\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## ⚠️ Disclaimer\n\nThis software is for educational and research purposes. Users are responsible for:\n- Compliance with local regulations\n- Proper tax reporting\n- Understanding the risks of cryptocurrency trading\n- Securing their private keys and funds\n\n## 📄 License\n\nISC License - see LICENSE file for details\n\n## 🆘 Support\n\nFor issues and questions:\n1. Check the troubleshooting section\n2. Review the logs for specific error messages\n3. Ensure all environment variables are properly set\n4. Verify sufficient SOL balance and RPC connectivity\n\n---\n\n**Note**: This bundler is designed for pump.fun token launches. Always test with small amounts first and understand the risks involved in cryptocurrency operations.\n\n## 🍵 Tip\n\n### If you are intereseted in my projects, please 🔗fork or give me ⭐star\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenlomy%2Fpumpfun-bundler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fenlomy%2Fpumpfun-bundler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenlomy%2Fpumpfun-bundler/lists"}