{"id":40574628,"url":"https://github.com/onchainmee/nadfun-bundler","last_synced_at":"2026-01-21T02:02:31.460Z","repository":{"id":277621624,"uuid":"933012657","full_name":"OnChainMee/nadfun-bundler","owner":"OnChainMee","description":"The Nad.fun Volume \u0026 Bundler Comprehensive Bot is a powerful tool designed to automate trading activities on the Nad.fun platform (Monad Network). With a suite of customizable modes for buying, selling, and wallet management, this bot provides a fully automated solution for generating volume, bundling transactions, executing trades, and managing wa","archived":false,"fork":false,"pushed_at":"2025-11-26T05:13:47.000Z","size":279,"stargazers_count":58,"open_issues_count":0,"forks_count":15,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-01-17T09:28:19.158Z","etag":null,"topics":["bot","bundler","monad","nadfun","nadfun-bundler","nadfun-sdk","ts"],"latest_commit_sha":null,"homepage":"https://t.me/rust_devv","language":"JavaScript","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/OnChainMee.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-15T00:12:58.000Z","updated_at":"2025-12-15T18:30:00.000Z","dependencies_parsed_at":"2025-02-15T01:21:08.985Z","dependency_job_id":"fe4d3e28-e1b5-45e1-8b22-c80f1b484dc3","html_url":"https://github.com/OnChainMee/nadfun-bundler","commit_stats":null,"previous_names":["t-rustdev/pump.fun-raydium-volume-bundler-total","t-rustdev/solana-pumpfun-raydium-volume-bundler-bot","2-rust/solana-pumpfun-raydium-volume-bundler-bot","2-rust/nadfun-bundler","onchainmee/nadfun-bundler"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/OnChainMee/nadfun-bundler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OnChainMee%2Fnadfun-bundler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OnChainMee%2Fnadfun-bundler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OnChainMee%2Fnadfun-bundler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OnChainMee%2Fnadfun-bundler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OnChainMee","download_url":"https://codeload.github.com/OnChainMee/nadfun-bundler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OnChainMee%2Fnadfun-bundler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28622472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T23:49:58.628Z","status":"online","status_checked_at":"2026-01-21T02:00:08.227Z","response_time":86,"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":["bot","bundler","monad","nadfun","nadfun-bundler","nadfun-sdk","ts"],"created_at":"2026-01-21T02:02:30.370Z","updated_at":"2026-01-21T02:02:31.447Z","avatar_url":"https://github.com/OnChainMee.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Nad.fun Volume \u0026 Bundler Comprehensive Bot\n\n## Overview\n\nThe **Nad.fun Volume \u0026 Bundler Comprehensive Bot** is a powerful tool designed to automate trading activities on the Nad.fun platform (Monad Network). With a suite of customizable modes for buying, selling, and wallet management, this bot provides a fully automated solution for generating volume, bundling transactions, executing trades, and managing wallets for optimizing token activities.\n\nBuilt using **Node.js** and **ethers.js**, the bot supports advanced functionality such as transaction bundling, MEV protection, and enables quick and efficient token purchases and sales across multiple wallets on the Monad blockchain.\n\n\n## Architecture Diagram\n\n```mermaid\ngraph TD\n    A[npm start] --\u003e B[Interactive Menu]\n    B --\u003e C[Mode Selection]\n    \n    C --\u003e D[Buy Modes]\n    C --\u003e E[Sell Modes]\n    C --\u003e F[Wallet Management]\n    C --\u003e G[Transfer Modes]\n    \n    D --\u003e D1[Bundle Buy]\n    D --\u003e D2[Auto Volume]\n    D --\u003e D3[Human Mode]\n    \n    E --\u003e E1[Sell All Bundle]\n    E --\u003e E2[Single Wallet Sell]\n    E --\u003e E3[Cleanup Mode]\n    \n    F --\u003e F1[Gen Wallets]\n    F --\u003e F2[Check Balances]\n    F --\u003e F3[Set Buy Amounts]\n    \n    G --\u003e G1[Send MON to Wallets]\n    G --\u003e G2[Return MON to Main]\n    \n    D1 --\u003e H[Transaction Bundler]\n    D2 --\u003e H\n    D3 --\u003e H\n    E1 --\u003e H\n    E2 --\u003e H\n    E3 --\u003e H\n    G1 --\u003e H\n    G2 --\u003e H\n    \n    H --\u003e I[Nonce Management]\n    I --\u003e J[Sequential Execution]\n    J --\u003e K[Monad Network]\n    K --\u003e L[Nad.fun Contracts]\n    \n    M[config.json] --\u003e B\n    M --\u003e H\n    \n    N[Wallets Storage] --\u003e B\n    \n    style A fill:#e1f5ff\n    style B fill:#fff4e1\n    style H fill:#ffe1f5\n    style K fill:#e1ffe1\n    style M fill:#f5e1ff\n```\n\n## Features\n\n- **Multiple Buying Modes**: Includes modes for generating volume, monitoring new launches, and human-like trading patterns\n- **Selling Modes**: Includes bulk sell, single wallet sell, and cleanup modes to manage your token holdings effectively\n- **Wallet Management**: Create and manage EVM wallets, check balances (MON and tokens)\n- **Transfer Modes**: Efficiently transfer MON between wallets and consolidate balances\n- **Transaction Bundling**: Execute multiple transactions efficiently with proper nonce management\n- **Custom Configurations**: Adjustable settings for delays, slippage, buy/sell amounts, and more\n- **Nad.fun Integration**: Full support for nad.fun bonding curve and DEX contracts\n\n## Prerequisites\n\nTo run the **Nad.fun Volume Bot**, ensure you have the following:\n\n- **Node.js** (v18+): [Download Node.js](https://nodejs.org)\n- **npm**: The Node.js package manager, which comes pre-installed with Node.js\n- **RPC URL**: Required to connect to Monad network (testnet or mainnet)\n- **Wallet Private Key**: Private key for your main wallet (for distributing MON to sub-wallets)\n\n## Installation\n\n### Step 1: Install Node.js\n\nEnsure that **Node.js** is installed on your system. If not, download and install it from the official website:\n\n- [Download Node.js](https://nodejs.org)\n\n### Step 2: Clone or Navigate to the Repository\n\n```bash\ncd nadfun-bundler\n```\n\n### Step 3: Install Dependencies\n\n```bash\nnpm install\n```\n\n## Configuration\n\nThe bot is highly configurable, allowing you to modify various settings in the `config.json` file. Below is a detailed guide for configuring the bot to suit your needs.\n\n### `config.json`\n\nThe configuration file contains key parameters that define the bot's behavior. Here is a breakdown of each parameter:\n\n```json\n{\n    \"rpc\": \"https://monad-testnet.rpc.url\",  // RPC endpoint for Monad network\n    \"ws\": \"wss://monad-testnet.ws.url\",      // WebSocket endpoint (optional)\n    \"chainId\": 10143,                         // Monad Testnet chain ID\n    \"delay\": 5000,                            // Delay in milliseconds between actions\n    \"slippage\": 0.05,                         // Slippage tolerance (0.05 = 5%)\n    \"minBuy\": 0.0001,                         // Minimum buy amount in MON\n    \"maxBuy\": 0.1,                            // Maximum buy amount in MON\n    \"microBuyAmount\": 0.0001,                 // Small amount for micro buys\n    \"gasPrice\": null,                         // Gas price in gwei (null = auto)\n    \"gasLimit\": 300000,                       // Gas limit per transaction\n    \"maxWalletsPerBundle\": null,              // Max wallets per bundle (null = unlimited)\n    \"sender\": \"YOUR_PRIVATE_KEY_HERE\",        // Private key of main wallet\n    \"devWallet\": \"\",                          // Address to monitor for new launches\n    \"useBundle\": true,                        // Use transaction bundling\n    \"contracts\": {\n        \"bondingCurveRouter\": \"0x6F6B8F1a20703309951a5127c45B49b1CD981A22\",\n        \"bondingCurve\": \"0xA7283d07812a02AFB7C09B60f8896bCEA3F90aCE\",\n        \"dexRouter\": \"0x0B79d71AE99528D1dB24A4148b5f4F865cc2b137\",\n        \"dexFactory\": \"0x6B5F564339DbAD6b780249827f2198a841FEB7F3\",\n        \"wmon\": \"0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A\",\n        \"lens\": \"0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea\"\n    }\n}\n```\n\n### Important Configuration Notes\n\n- **RPC URL**: You need a Monad RPC endpoint. For testnet, check Monad documentation.\n- **Private Key**: Never commit your private key to version control. Keep it secure.\n- **Contract Addresses**: These are the official nad.fun contract addresses. Update if they change.\n\n## Available Modes\n\n### 1. Buy Modes\n\n#### Bundle Buy (Nad.fun)\nGenerates volume by bundling buy transactions across multiple wallets. Enter the token address (CA) and delay between transactions. The bot will create buy transactions for wallets with randomized amounts between minBuy and maxBuy.\n\n**Bundle Size**: By default, processes ALL wallets. Set `maxWalletsPerBundle` in config.json to limit (recommended: 10-50 wallets). See `BUNDLE_LIMITS.md` for details.\n\n#### Auto Volume\nMonitors the dev wallet address (configured in config.json) and automatically executes trades when a new token is launched. This mode performs a Buy-Buy-Sell cycle until all wallets have completed their actions.\n\n#### Human Mode\nManually initiated mode that performs a Buy-Buy-Sell cycle with randomized delays. Each wallet buys twice with random delays, then sells a percentage of tokens. This simulates human-like trading behavior.\n\n### 2. Sell Modes\n\n#### Sell All (Bundle)\nBundles all wallets and sells a specified percentage of tokens from each wallet. Useful for quick exits or taking profits.\n\n#### Single Wallet Sell\nPrompts for a token address and wallet selection. The bot will sell 100% of tokens from the selected wallet.\n\n#### Cleanup Mode\nSells all Nad.fun tokens from all wallets. This mode requires manual token specification (full automatic cleanup coming soon).\n\n### 3. Wallet Modes\n\n#### Gen Wallets\nGenerates a specified number of EVM wallets, storing them securely in the `/keypairs` folder along with the `wallets.txt` file.\n\n#### Check Balances\nChecks MON and token balances for all wallets. Optionally specify a token address to check token balances.\n\n#### Set Buy Amounts\nConfigure custom buy amounts for different wallets (coming soon).\n\n### 4. Transfer Modes\n\n#### Send MON to Volume Wallets\nTransfers MON from the main wallet (sender address in config) to all sub-wallets. You can specify an amount per wallet or let it auto-calculate.\n\n#### Return MON to Main Wallet\nSends MON from all sub-wallets back to the main wallet, leaving a small reserve (0.0009 MON) in each wallet for gas.\n\n## Usage\n\n### Starting the Bot\n\n```bash\nnpm start\n```\n\nThis will launch the interactive menu system where you can select different modes and options.\n\n### Example Workflow\n\n1. **Generate Wallets**: Go to Wallets menu → Gen Wallets → Enter number of wallets\n2. **Fund Wallets**: Go to Transfer menu → Send MON to Volume Wallets\n3. **Buy Tokens**: Go to Buy Modes → Bundle Buy → Enter token address and delay\n4. **Check Balances**: Go to Wallets menu → Check Balances → Enter token address\n5. **Sell Tokens**: Go to Sell Modes → Sell All → Enter token address and percentage\n\n## Key Differences from Solana Version\n\n- **Network**: Monad (EVM) instead of Solana\n- **Transactions**: EVM transactions instead of Solana transactions\n- **Bundling**: Sequential transaction bundling instead of JITO bundles\n- **Native Token**: MON instead of SOL\n- **Token Standard**: ERC-20 instead of SPL tokens\n- **Wallet Format**: Ethereum-style wallets instead of Solana keypairs\n\n## Token Creation Percentage Issue\n\nWhen users create tokens on nad.fun, they hold a percentage of tokens. The bot includes functionality to handle this by buying tokens from the bonding curve, which reduces the creator's percentage. See `src/nadfun/handleCreatorTokens.js` for details.\n\n## Contract Addresses\n\nAll contract addresses are from the official nad.fun documentation:\n\n- **Bonding Curve Router**: `0x6F6B8F1a20703309951a5127c45B49b1CD981A22`\n- **Bonding Curve**: `0xA7283d07812a02AFB7C09B60f8896bCEA3F90aCE`\n- **DEX Router**: `0x0B79d71AE99528D1dB24A4148b5f4F865cc2b137`\n- **DEX Factory**: `0x6B5F564339DbAD6b780249827f2198a841FEB7F3`\n- **WMON**: `0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A`\n- **Lens**: `0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea`\n\n## Security Notes\n\n- **Private Keys**: Never share your private keys or commit them to version control\n- **Testnet First**: Always test on testnet before using mainnet\n- **Gas Fees**: Monitor gas prices and adjust gasLimit/gasPrice in config if needed\n- **Slippage**: Set appropriate slippage tolerance based on market conditions\n- **Wallet Backups**: Regular backups of your wallets.txt and keypairs folder\n\n## Troubleshooting\n\n### Common Issues\n\n1. **\"No wallets found\"**: Generate wallets first using the Wallets menu\n2. **\"Insufficient balance\"**: Fund your wallets using the Transfer menu\n3. **Transaction failures**: Check gas prices, slippage settings, and network connectivity\n4. **\"Token not listed\"**: Verify the token address is correct and the token is on nad.fun bonding curve\n\n## Development\n\nThe bot is built with:\n- **Node.js** (ES Modules)\n- **ethers.js** (v6) for blockchain interactions\n- **chalk** for colored console output\n\n## Contributing\n\nContributions are welcome! Please ensure all code follows the existing style and includes proper error handling.\n\n## License\n\nISC License\n\n## Disclaimer\n\nThis bot is for educational and research purposes. Trading cryptocurrencies involves risk. Use at your own risk. The authors are not responsible for any financial losses.\n\n## Support\n\nFor issues and questions, please check the codebase or create an issue in the repository.\n\n## Connect\n [Telegram](https://t.me/rust_devv)\n [X](https://x.com/t_rustdev_)\n\n---\n\n**Note**: This is an updated version converted from the Solana pump.fun bundler to work with Nad.fun on Monad network. Some features from the original version may be simplified or removed for EVM compatibility.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonchainmee%2Fnadfun-bundler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonchainmee%2Fnadfun-bundler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonchainmee%2Fnadfun-bundler/lists"}