An advanced automation bot for Intuition Testnet operations including faucet claiming and bridge transactions between Intuition and Base Sepolia networks.
- 💰 Faucet Bot: Automated testnet token claiming with Vercel challenge bypass (only pc windows )
- 🌉 Bridge Bot: Bidirectional bridge operations (Intuition ↔ Base Sepolia)
- 🔐 Multi-Wallet Support: Process multiple wallets from private keys file
- 🎯 Smart Transaction Management: Round-robin wallet usage and customizable delays
- 📊 Real-time Monitoring: Live transaction tracking with detailed logs
- ⚡ Enhanced Browser Automation: System Chrome with anti-detection features
- ⚡ FAUCET: Ones Per IP Soon Adding Proxy Support For More Faucet Claims /each 24 hours
- Node.js 18+ installed
- Google Chrome browser installed
- Virtual Display (for headless environments)
- Private keys for testnet wallets
-
Clone the repository
git clone https://github.com/Ansh7473/IntuitionTestnet-BOT.git cd IntuitionTestnet-BOT -
Install dependencies
npm install puppeteer ethers readline fs
-
Setup virtual display (for Linux/headless environments)
node Intuition.js
-
Create private keys file
touch private_keys.txt
Add your wallet private keys to private_keys.txt (one per line):
# Example private_keys.txt
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba
# Add more wallets as needed
⚠️ Security Warning: Never share your private keys or commit them to version control!
The bot supports these networks:
- Intuition Testnet (Chain ID: 13579)
- Base Sepolia (Chain ID: 84532)
node intuition.js🎯 OPERATION MENU
─────────────────────────
1. 💰 Run Faucet Bot
2. 🌉 Run Bridge Bot
3. 🚪 Exit
─────────────────────────
The faucet bot automatically:
- ✅ Launches headless Chrome browser
- ✅ Bypasses Vercel protection challenges
- ✅ Claims testnet tokens for all wallets
- ✅ Handles rate limiting (24-hour cooldown)
- ✅ Provides detailed transaction logs
[ 02:15:30 WIB ] | 🚀 Launching browser...
[ 02:15:32 WIB ] | ✅ Browser setup complete
[ 02:15:35 WIB ] | ✅ _vcrcs cookie detected
[ 02:15:36 WIB ] | 💰 Processing wallet 1/3: 0x1234...abcd
[ 02:15:38 WIB ] | ✅ Faucet request successful!
The bridge bot supports:
- Intuition → Base Sepolia (withdrawEth)
- Base Sepolia → Intuition (createRetryableTicket)
- Random Direction (automatically selects)
- Amount: Specify ETH amount to bridge (e.g., 0.001)
- Transactions: Number of bridge transactions to execute
- Delay: Min/max seconds between transactions
- Direction: Choose bridge direction or random
🌉 BRIDGE CONFIGURATION
──────────────────────────────
Select bridge direction:
1. Intuition → Base Sepolia (withdrawEth)
2. Base Sepolia → Intuition (createRetryableTicket)
3. Random direction
Choose direction (1-3): 1
Enter amount to bridge (ETH, e.g., 0.001): 0.0001
Number of bridge transactions: 5
Min delay between transactions (seconds): 3
Max delay between transactions (seconds): 7
[ 02:18:42 WIB ] | 🌉 Processing transaction 1/5: 0x1234...abcd
[ 02:18:42 WIB ] | 🔄 Bridging 0.0001 ETH from Intuition → Base Sepolia
[ 02:18:42 WIB ] | 💰 Intuition balance: 0.1919 ETH
[ 02:18:43 WIB ] | ⛽ Estimating gas...
[ 02:18:45 WIB ] | 📋 Transaction Hash: 0x6a49c7b3967c...
[ 02:18:46 WIB ] | ✅ Bridge transaction confirmed! Block: 619199
BRIDGE_CONFIG = {
INTUITION_RPC_URL: "https://testnet.rpc.intuition.systems/http",
BASE_SEPOLIA_RPC_URL: "https://base-sepolia.rpc.dev.caldera.xyz/",
TTRUST_CONTRACT_ADDRESS: "0xA54b4E6e356b963Ee00d1C947f478d9194a1a210",
ARB_SYS_ADDRESS: "0x0000000000000000000000000000000000000064",
INBOX_ADDRESS: "0xBd983e1350263d1BE5DE4AEB8b1704A0Ea0be350"
}- Headless Mode: Enabled for server environments
- Anti-Detection: Enhanced stealth features
- Virtual Display: DISPLAY=:99 for headless operation
- System Chrome: Uses
/usr/bin/google-chrome
- Processes wallets in round-robin fashion
- Supports unlimited transactions per session
- Automatic wallet cycling for multiple transactions
- Rate Limiting: Handles 24-hour faucet cooldowns
- Gas Estimation: Automatic with fallback values
- Transaction Retries: Built-in retry logic
- Balance Checking: Pre-transaction validation
- Private Key Protection: Local file storage only
- Anti-Detection: Advanced browser fingerprint masking
- Session Management: Automatic cookie handling
- Error Logging: Detailed failure analysis
- Chain ID: 13579
- Token: tTRUST (TRUST)
- RPC: https://testnet.rpc.intuition.systems/http
- Explorer: https://testnet.explorer.intuition.systems/
- Faucet: https://testnet.hub.intuition.systems/
- Chain ID: 84532
- Token: tTRUST
- RPC: https://base-sepolia.rpc.dev.caldera.xyz/
- Explorer: https://sepolia.basescan.org/
-
Browser Launch Failed
# Ensure virtual display is running Xvfb :99 -screen 0 1920x1080x24 & export DISPLAY=:99
-
Transaction Failures
- Check wallet balances
- Increase delay between transactions
- Verify network connectivity
-
Gas Estimation Errors
- Bot uses fallback gas limits
- Ensure sufficient ETH for gas fees
-
Rate Limiting
- Faucet has 24-hour cooldown
- Bridge has no rate limits
- Optimal Delays: Use 5-10 seconds between bridge transactions
- Batch Size: Process 10-20 transactions per session
- Network Timing: Avoid peak hours for better success rates
- Wallet Management: Use dedicated testnet wallets
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
This tool is for testnet use only. Never use with mainnet private keys or real funds. The developers are not responsible for any loss of funds or misuse of this software.
- Intuition Website: https://intuition.systems/
- Testnet Hub: https://testnet.hub.intuition.systems/
- Bridge Portal: https://testnet.bridge.intuition.systems/
- Documentation: https://docs.intuition.systems/
- Issues: Create an issue on GitHub
- Discussions: Use GitHub Discussions
- Updates: Watch the repository for updates
Made with ❤️ for the Intuition Testnet Community
🚀 Star this repo if you find it helpful!