{"id":30186975,"url":"https://github.com/cicere/bonkfun-bundler","last_synced_at":"2025-10-12T17:24:22.115Z","repository":{"id":306748292,"uuid":"1027097037","full_name":"cicere/BonkFun-Bundler","owner":"cicere","description":"A bundler for letsbonk.fun . Multiple launch and sell modes. Using JITO.","archived":false,"fork":false,"pushed_at":"2025-07-27T10:34:59.000Z","size":77,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T15:39:10.637Z","etag":null,"topics":["bonkbot","bonkfun","bonkfun-bundler","letsbonk","letsbonk-bundler","letsbonkfun"],"latest_commit_sha":null,"homepage":"https://solana-scripts.com","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/cicere.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":"2025-07-27T10:01:12.000Z","updated_at":"2025-07-28T13:33:04.000Z","dependencies_parsed_at":"2025-07-27T12:08:16.653Z","dependency_job_id":"aecdc200-93aa-41d3-b9a4-1440986dc397","html_url":"https://github.com/cicere/BonkFun-Bundler","commit_stats":null,"previous_names":["cicere/bonkfun-bundler"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cicere/BonkFun-Bundler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicere%2FBonkFun-Bundler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicere%2FBonkFun-Bundler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicere%2FBonkFun-Bundler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicere%2FBonkFun-Bundler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cicere","download_url":"https://codeload.github.com/cicere/BonkFun-Bundler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicere%2FBonkFun-Bundler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279012187,"owners_count":26085079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bonkbot","bonkfun","bonkfun-bundler","letsbonk","letsbonk-bundler","letsbonkfun"],"created_at":"2025-08-12T15:23:48.987Z","updated_at":"2025-10-12T17:24:22.098Z","avatar_url":"https://github.com/cicere.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bonkfun Bundler - Advanced Token Bundler for letsbonk.fun\n\n[![Node](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)\n[![Solana](https://img.shields.io/badge/Solana-Web3.js-purple.svg)](https://www.npmjs.com/package/@solana/web3.js)\n\nThe **Bonkfun Bundler** is a professional, automated token bundling solution specifically designed for [letsbonk.fun](https://letsbonk.fun/) - the new meta of Solana launches. This comprehensive tool allows you to deploy a token on bonk in 3 different modes, and sell with up to 6 modes.\n\nDiscord: https://discord.gg/solana-scripts\n\nTelegram: https://t.me/benorizz0\n\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Key Features](#key-features)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage Guide](#usage-guide)\n  - [Token Launch Strategies](#token-launch-strategies)\n  - [Wallet Management](#wallet-management)\n  - [Trading Operations](#trading-operations)\n  - [Exit Strategies](#exit-strategies)\n- [Advanced Features](#advanced-features)\n- [API Reference](#api-reference)\n- [Security Considerations](#security-considerations)\n- [Performance Optimization](#performance-optimization)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [Community](#community)\n\n## Overview\n\nThe **letsbonk bundler** revolutionizes token operations on bonk.fun by providing a unified, automated solution for token creators. Unlike manual processes that are time-consuming and error-prone, this bonk bundler automates every aspect of token management while maintaining security and efficiency.\n\n### Why Choose Bonkfun Bundler?\n\n- **Automation**: Complete automation of token creation, distribution, and management\n- **MEV Protection**: All operations utilize Jito bundles for maximum extractable value protection\n- **Multi-Wallet Coordination**: Seamlessly manage operations across multiple wallets\n- **Professional Features**: Enterprise-grade features for serious token operations\n- **Solana Optimized**: Built specifically for Solana's architecture and bonk.fun's requirements\n\n## Key Features\n\n### 🚀 Token Creation \u0026 Launch\n\nThe bonkfun bundler provides sophisticated token creation capabilities:\n\n#### Vanity Address Generation\n- Generate token addresses ending with custom suffixes (e.g., \"bonk\")\n- Utilizes native `solana-keygen grind` for maximum performance\n- Multi-threaded operation using all available CPU cores\n- Configurable timeouts and retry mechanisms\n- Probability-based time estimates for user expectations\n\n#### Metadata Management\n- Automated metadata creation and upload\n- Support for all bonk.fun required fields:\n  - Token name and symbol\n  - Description and display name\n  - Social links (Twitter, Telegram, Website)\n  - Token image upload and processing\n- IPFS integration for decentralized storage\n\n#### Launch Modes\n\n1. **Jito Bundler Mode**\n   - Atomic transaction bundles for MEV protection\n   - All operations in a single, protected bundle\n   - Maximum 5 transactions per bundle optimization\n   - Priority fee configuration\n\n2. **Delayed Bundle Mode**\n   - Sequential transaction execution\n   - Configurable delays between operations\n   - Pattern avoidance for stealth launches\n   - Random delay generation for organic appearance\n\n3. **Snipe Mode**\n   - Buy existing tokens without creation\n   - Rapid execution for time-sensitive opportunities\n   - Integrated with real-time monitoring\n\n### 💼 Advanced Wallet Management\n\nThe letsbonk bundler includes a comprehensive wallet management system:\n\n#### Wallet Generation\n- Bulk wallet creation (up to 20 wallets)\n- Secure keypair generation and storage\n- Automatic wallet naming and organization\n- Export/Import functionality for backup\n\n#### SOL Distribution\n- Intelligent SOL distribution algorithms\n- Equal distribution across all wallets\n- Reserve amount configuration for main wallet\n- Gas optimization for distribution transactions\n- Real-time balance monitoring\n\n#### Wallet Operations\n- Batch operations across all wallets\n- Individual wallet management\n- Balance consolidation features\n- Transaction history tracking\n\n### 📊 Trading Strategies\n\nThe bonkfun bundler implements multiple trading strategies:\n\n#### Buy Operations\n- Coordinated buys from multiple wallets\n- Configurable buy amounts per wallet\n- Slippage protection (default 50%)\n- Priority fee optimization\n- Transaction confirmation monitoring\n\n#### Sell Strategies\n\n1. **Sell All Mode**\n   - Simultaneous sells from all wallets\n   - Jito bundle protection\n   - Maximum bundle efficiency\n\n2. **Dev Dump Mode**\n   - Transfer all tokens to main wallet\n   - Single large sell transaction\n   - Minimize transaction fees\n\n3. **Delayed Sell Mode**\n   - Individual wallet sells with delays\n   - Pattern avoidance algorithms\n   - Configurable delay ranges\n\n\n## Installation\n\n### Prerequisites\n\n- Node.js \u003e= 16.0.0\n- npm or yarn package manager\n- Solana CLI tools (for vanity address generation)\n- Valid RPC endpoint access\n\n### Step-by-Step Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/cicere/bonkfun-bundler.git\n   cd bonkfun-bundler\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. **Install Solana CLI tools** (for vanity address feature)\n   ```bash\n   sh -c \"$(curl -sSfL https://release.solana.com/stable/install)\"\n   ```\n\n4. **Configure environment**\n   ```bash\n   cp .env.example .env\n   ```\n\n5. **Edit .env file**\n   ```env\n   RPC=https://your-rpc-endpoint.com\n   SECRET_KEY=your-main-wallet-private-key\n   API_KEY=your-license-key\n   DEBUG=false\n   ```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Required | Default |\n|----------|-------------|----------|---------|\n| `RPC` | Solana RPC endpoint URL | Yes | - |\n| `SECRET_KEY` | Main wallet private key | Yes | - |\n| `API_KEY` | License key for activation | Yes | - |\n| `DEBUG` | Enable debug logging | No | false |\n\n### Token Metadata Configuration\n\nCreate a `tokenMetadata.json` file:\n\n```json\n{\n  \"tokenName\": \"Your Token Name\",\n  \"tokenSymbol\": \"SYMBOL\",\n  \"description\": \"Token description\",\n  \"tokenShowName\": \"Display Name\",\n  \"twitter\": \"https://x.com/yourhandle\",\n  \"telegram\": \"https://t.me/yourgroup\",\n  \"website\": \"https://yourwebsite.com\",\n  \"file\": \"token-image.jpg\",\n  \"jitoTipAmtInput\": \"0.01\"\n}\n```\n\n### Wallet Configuration\n\nThe bonkfun bundler supports flexible wallet configurations:\n\n- **Maximum Wallets**: 20 (configurable)\n- **Minimum SOL per Wallet**: 0.01 SOL\n- **Distribution Options**: Equal, Custom, Percentage-based\n\n## Usage Guide\n\n### Starting the Bundler\n\n```bash\n# Using npm\nnpm start\n\n# Using yarn\nyarn start\n\n# Using ts-node directly\nnpx ts-node main.ts\n```\n\n### Main Menu Navigation\n\nUpon starting, you'll see the professional interface:\n\n```\n  ____   ____  _   _ _  __  _____ _   _ _   _ \n |  _ \\ / __ \\| \\ | | |/ / |  ___| | | | \\ | |\n | |_) | |  | |  \\| | ' /  | |_  | | | |  \\| |\n |  _ \u003c| |  | | . ` |  \u003c   |  _| | |_| | . ` |\n | |_) | |__| | |\\  | . \\ _| |   |  _  | |\\  |\n |____/ \\____/|_| \\_|_|\\_(_)_|   |_| |_|_| \\_|\n\n═══════════════════════════════════════════════════\n  solana-scripts.com\n  discord.gg/solana-scripts\n═══════════════════════════════════════════════════\n\n  Main Wallet\n  ──────────────────────────────────────────────────\n  Address: 5kYJ8n6N...9mKQPaUX\n  Balance: 10.5420 SOL\n\n  Menu Options\n  ──────────────────────────────────────────────────\n\n  [1] Wallet Management\n      └─ Generate and manage multiple wallets\n\n  [2] Launch UI\n      └─ Launch tokens with various strategies\n\n  [3] Sell UI\n      └─ Sell tokens and retrieve funds\n\n  ──────────────────────────────────────────────────\n  [exit] Quit application\n\n  Select option: \n```\n\n### Token Launch Strategies\n\n#### 1. Jito Bundler Launch\n\nThe most secure launch method using MEV protection:\n\n```typescript\n// Automatic process flow:\n1. Vanity address generation (optional)\n2. Token metadata creation\n3. Token creation transaction\n4. Multi-wallet buy transactions\n5. All bundled in single Jito bundle\n```\n\n**Configuration Options:**\n- Vanity address: Yes/No\n- Buy amount per wallet: 0.01 - 10 SOL\n- Jito tip amount: 0.0001 - 0.1 SOL\n\n#### 2. Delayed Bundle Launch\n\nFor organic-looking launches:\n\n```typescript\n// Sequential execution with delays:\n1. Token creation\n2. Wait random delay (5-30 seconds)\n3. First wallet buy\n4. Wait random delay\n5. Continue for all wallets\n```\n\n**Delay Configuration:**\n- Minimum delay: 5 seconds\n- Maximum delay: 30 seconds\n- Random distribution\n\n#### 3. Snipe Existing Token\n\nFor buying already launched tokens:\n\n```typescript\n// Rapid execution mode:\n1. Input token address\n2. Configure buy amounts\n3. Execute coordinated buys\n4. Monitor confirmation\n```\n\n### Wallet Management\n\n#### Creating New Wallets\n\n1. Select \"Wallet Management\" from main menu\n2. Choose \"Generate Wallets\"\n3. Enter number of wallets (1-20)\n4. Wallets are automatically generated and saved\n\n#### Distributing SOL\n\n1. Select \"Distribute SOL\"\n2. Enter total amount to distribute\n3. Choose distribution method:\n   - Equal: Divides equally among all wallets\n   - Custom: Set specific amounts per wallet\n4. Confirm and execute distribution\n\n#### Viewing Wallet Information\n\nThe wallet manager displays:\n- Wallet addresses (truncated for security)\n- SOL balances\n- Token balances\n- Recent transaction history\n\n### Trading Operations\n\n#### Buy Configuration\n\n```json\n{\n  \"buyAmount\": 0.1,\n  \"slippage\": 50,\n  \"priorityFee\": 0.0001,\n  \"confirmations\": \"confirmed\"\n}\n```\n\n#### Monitoring Transactions\n\nThe bundler provides real-time feedback:\n- Transaction signatures\n- Confirmation status\n- Success/failure notifications\n- Balance updates\n\n### Exit Strategies\n\n#### 1. Sell All Tokens\n\nExecutes coordinated sells across all wallets:\n\n```bash\nPreparing sell transactions...\n✓ Wallet 1: 1000 TOKENS ready\n✓ Wallet 2: 1000 TOKENS ready\n...\nBundling 5 transactions...\n✓ Bundle submitted: 5xKp9N...\n```\n\n#### 2. Dev Dump Strategy\n\nConsolidates before selling:\n\n```bash\nTransferring tokens to main wallet...\n✓ Transfer from Wallet 1: 2xNp4K...\n✓ Transfer from Wallet 2: 3mKL9X...\n...\nExecuting final sell...\n✓ Sold 5000 TOKENS: 7yHN3P...\n```\n\n#### 3. SOL Recovery\n\nCloses token accounts and recovers rent:\n\n```bash\nRetrieving SOL from token accounts...\n✓ Closed account: AtokenAddress1...\n✓ Closed account: AtokenAddress2...\n...\nTotal recovered: 0.05 SOL\n```\n\n## Advanced Features\n\n### Vanity Address Generation\n\nThe bonkfun bundler includes state-of-the-art vanity address generation:\n\n#### Technical Implementation\n\n```typescript\n// Native solana-keygen integration\nconst generateVanityAddress = async (pattern: string) =\u003e {\n  // Utilizes all CPU cores\n  // Implements retry logic\n  // Provides time estimates\n  // Handles Windows/Linux/Mac compatibility\n};\n```\n\n#### Performance Metrics\n\n- **2-character suffix**: ~5-30 seconds\n- **3-character suffix**: ~30 seconds - 2 minutes  \n- **4-character suffix**: ~1-10 minutes\n\n### Transaction Optimization\n\n#### Bundle Optimization\n\nThe bundler intelligently groups transactions:\n\n```typescript\n// Maximum efficiency algorithm\nconst optimizeBundle = (transactions: Transaction[]) =\u003e {\n  // Groups up to 5 transactions\n  // Calculates optimal fees\n  // Minimizes total cost\n  // Maximizes success rate\n};\n```\n\n#### Priority Fee Management\n\nDynamic fee calculation based on:\n- Network congestion\n- Transaction urgency\n- Bundle size\n- Historical success rates\n\n### Error Handling \u0026 Recovery\n\nComprehensive error handling ensures reliability:\n\n1. **Transaction Failures**\n   - Automatic retry with exponential backoff\n   - Alternative RPC endpoint fallback\n   - Detailed error logging\n\n2. **Network Issues**\n   - Connection pooling\n   - Timeout management\n   - Graceful degradation\n\n3. **Wallet Errors**\n   - Balance verification\n   - Insufficient funds warnings\n   - Account validation\n\n## API Reference\n\n### Core Modules\n\n#### BonkfunSDK\n\n```typescript\ninterface BonkfunSDK {\n  createToken(metadata: TokenMetadata): Promise\u003cTransaction\u003e;\n  buyToken(mint: PublicKey, amount: number): Promise\u003cTransaction\u003e;\n  sellToken(mint: PublicKey, amount: number): Promise\u003cTransaction\u003e;\n  getTokenInfo(mint: PublicKey): Promise\u003cTokenInfo\u003e;\n}\n```\n\n#### WalletManager\n\n```typescript\nclass WalletManager {\n  generateWallets(count: number): Keypair[];\n  distributeSOL(amount: number, method: DistributionMethod): Promise\u003cvoid\u003e;\n  getBalances(): Promise\u003cWalletBalance[]\u003e;\n  exportWallets(): WalletExport;\n  importWallets(data: WalletExport): void;\n}\n```\n\n#### LaunchManager\n\n```typescript\nclass LaunchManager {\n  launchWithJito(config: LaunchConfig): Promise\u003cLaunchResult\u003e;\n  launchWithDelay(config: LaunchConfig): Promise\u003cLaunchResult\u003e;\n  snipeToken(mint: PublicKey, config: SnipeConfig): Promise\u003cSnipeResult\u003e;\n}\n```\n\n### Configuration Types\n\n```typescript\ninterface TokenMetadata {\n  tokenName: string;\n  tokenSymbol: string;\n  description: string;\n  tokenShowName: string;\n  twitter: string;\n  telegram: string;\n  website: string;\n  file: string;\n}\n\ninterface LaunchConfig {\n  metadata: TokenMetadata;\n  buyAmounts: number[];\n  jitoTip: number;\n  useVanity: boolean;\n}\n```\n\n## Security Considerations\n\n### Private Key Management\n\n- **Never share your private keys**\n- Store keys in environment variables\n- Use encrypted storage for production\n- Implement key rotation policies\n\n### Transaction Security\n\n- All sensitive operations use Jito bundles\n- Implements slippage protection\n- Validates all addresses before operations\n- Monitors for suspicious activity\n\n### Best Practices\n\n1. **Use a dedicated wallet** for bundler operations\n2. **Keep minimal SOL** in operational wallets\n3. **Regular backups** of wallet configurations\n4. **Monitor transactions** for anomalies\n5. **Update regularly** for security patches\n\n## Performance Optimization\n\n### System Requirements\n\n- **CPU**: Multi-core recommended for vanity generation\n- **RAM**: 4GB minimum, 8GB recommended\n- **Network**: Stable connection with low latency\n- **Storage**: 500MB free space\n\n### Optimization Tips\n\n1. **RPC Endpoint Selection**\n   - Use premium RPC services for reliability\n   - Configure multiple endpoints for fallback\n   - Monitor RPC performance metrics\n\n2. **Transaction Batching**\n   - Group related operations\n   - Utilize maximum bundle size (5 transactions)\n   - Optimize fee structures\n\n3. **Wallet Management**\n   - Maintain optimal wallet count (10-15)\n   - Regular consolidation of small balances\n   - Efficient SOL distribution\n\n## Troubleshooting\n\n### Common Issues\n\n#### \"Vanity address generation timeout\"\n- Increase timeout for longer patterns\n- Verify Solana CLI tools installation\n- Check CPU availability\n\n#### \"Transaction failed\"\n- Verify RPC endpoint status\n- Check wallet balances\n- Review slippage settings\n- Increase priority fees\n\n#### \"Bundle submission error\"\n- Confirm Jito endpoint availability\n- Verify tip amount is sufficient\n- Check bundle size limits\n\n### Debug Mode\n\nEnable detailed logging:\n\n```env\nDEBUG=true\n```\n\nDebug output includes:\n- Transaction construction details\n- RPC communication logs\n- Bundle composition information\n- Timing metrics\n\n## Contributing\n\nWe welcome contributions to the bonkfun bundler project!\n\n### Development Setup\n\n1. Fork the repository\n2. Create a feature branch\n3. Install development dependencies\n4. Run tests: `npm test`\n5. Submit pull request\n\n### Code Style\n\n- TypeScript strict mode\n- ESLint configuration\n- Prettier formatting\n- Comprehensive comments\n\n\n\n\n### Community\n- Discord: [discord.gg/solana-scripts](https://discord.gg/solana-scripts)\n- Twitter: [@benoriz0](https://x.com/benoriz0)\n- Telegram: [t.me/benorizz0](https://t.me/benorizz0)\n\n\n---\n\n**Disclaimer**: The bonkfun bundler is a powerful tool designed for legitimate token operations on [letsbonk.fun](https://letsbonk.fun/). Users are responsible for compliance with all applicable laws and platform terms of service. The developers assume no liability for misuse of this software.\n\n---\n\n*Built with ❤️ for the Solana community by [solana-scripts.com](https://solana-scripts.com)* \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcicere%2Fbonkfun-bundler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcicere%2Fbonkfun-bundler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcicere%2Fbonkfun-bundler/lists"}