🎮 Fraction AI BOT - Automate Your Battles in Fraction AI

A fully automated bot for seamless battles in Fraction AI.

---

🚀 Key Features

✨ Auto Match Making – Join battles automatically, no manual effort needed.
💰 Multiple Wallet Support – Manage multiple Ethereum wallets effortlessly.
📊 User-Friendly Dashboard – A clean, intuitive, and interactive UI.
⚙️ Easy Setup & Configuration – Minimal setup with flexible settings.

---

✅ Pre-Run Checklist

🔹 Register at Fraction AI.
🔹 Create your agent.
🔹 Ensure you have enough Sepolia ETH.
🔹 Customize settings in config.json.

---

📂 Project Structure

Fraction-AI-Bot/
├── config.json      # Configuration file
├── data.txt         # Stores private keys (for test wallets only)
├── src/             # Source code of the bot
├── logs/            # Log files
├── package.json     # Node.js dependencies
└── README.md       # Documentation

---

🔧 System Requirements

Before installing FractionAI-BOT, make sure you have:

• ✅ Node.js v18+
• ✅ npm or yarn
• ✅ Ethereum Wallet with Sepolia ETH
• ✅ Git Installed (For Linux/macOS)

---

📥 Installation Guide

🐧 Linux/macOS Users

📌 Step 1: Clone the Repository

git clone https://github.com/rpchubs/Fraction-AI-Bot.git
cd Fraction-AI-Bot

📌 Step 2: Install Dependencies

npm install

📌 Step 3: Configure Wallets (Edit data.txt)

nano data.txt

Enter your private keys (one per line):

your_private_key

⚠️ Only use test wallets! Never use your main wallet.

📌 Step 4: Adjust Configuration (config.json)

nano config.json

Modify settings as needed:

{
  "useProxy": false,
  "antiCaptchaKey": "your-antiCaptcha-API-KEY",
  "twoCaptchaKey": "your-twoCaptcha-API-KEY",
  "defaultSolver": "anticaptcha or twocaptcha",
  "pollingInterval": 10,
  "retryDelay": 10000,
  "maxRetries": 3,
  "matchMode": "auto or manual",
  "fee": 0.1,
  "maxGames": 10
}

🔧 Configuration Details

Setting	Description
useProxy	Set to true to enable proxy support. Default is false.
antiCaptchaKey	API key for Anti-Captcha service (leave blank if not used).
twoCaptchaKey	API key for 2Captcha service (leave blank if not used).
defaultSolver	Choose between anticaptcha or twocaptcha for solving captchas.
pollingInterval	Interval (in seconds) for checking match status. Default is 10.
retryDelay	Delay (in milliseconds) before retrying a failed request. Default is 10000 (10s).
maxRetries	Maximum number of retries before giving up on an operation. Default is 3.
matchMode	Set to auto for automated matchmaking or manual for user input.
fee	Entry fee per match (e.g., 0.1 ETH).
maxGames	Maximum number of games the bot will play in a session.

Example Configurations:

• Standard Setup (No Proxy, Auto Matchmaking, Anti-Captcha):

{
  "useProxy": false,
  "antiCaptchaKey": "your-API-KEY",
  "defaultSolver": "anticaptcha",
  "matchMode": "auto",
  "fee": 0.1,
  "maxGames": 5
}

• Manual Mode with Proxy Enabled:

{
  "useProxy": true,
  "twoCaptchaKey": "your-API-KEY",
  "defaultSolver": "twocaptcha",
  "matchMode": "manual",
  "fee": 0.01,
  "maxGames": 3
}

📌 Step 5: Create a Screen Session (For Continuous Running)

screen -S fractionai-bot

📌 Step 6: Start the Bot

npm start

---

🖥️ Windows Users

📌 Step 1: Clone the Repository or Download as ZIP

• Option 1 (Recommended):

git clone https://github.com/rpchubs/Fraction-AI-Bot.git
cd Fraction-AI-Bot

• Option 2 (Download ZIP):
  1. Go to the repository: FractionAI-BOT GitHub
  2. Click on the Code button → Select Download ZIP
  3. Extract the ZIP file
  4. Open a terminal and navigate to the extracted folder:

cd path\to\extracted-folder

📌 Step 2: Install Dependencies

npm install

📌 Step 3: Configure Wallets (Edit data.txt)

Follow the same guidelines as in the Linux/macOS section.

📌 Step 4: Adjust Configuration (config.json)

Follow the same guidelines as in the Linux/macOS section.

📌 Step 5: Start the Bot

npm start

---

🔎 Checking Fractals for All Wallets

You can use the fetch-fractal.js script to check Fractal balance for all wallets stored in data.txt.

📌 Steps to Run fetch-fractal.js

🐧 Linux/macOS Users

node fetch-fractal.js

🖥️ Windows Users

node fetch-fractal.js

This script will:

• Load private keys from data.txt
• Optionally use proxies if enabled in proxies.txt
• Authenticate wallets
• Fetch Fractal balance for each wallet

---

🎮 Bot Controls

🛑 Press Q → Quit the bot.
🔄 Press R → Refresh the dashboard.
🧹 Press C → Clear the logs.

---

⚠️ Important Warnings

⚠️ Use at your own risk.
🔑 Only use test wallets – NEVER use your main wallet.
📖 Make sure you fully understand the bot’s functionality.

---

🔗 Useful Resources

📂 GitHub Repository: RPC Hubs
💬 Community Support: Telegram
📜 License: MIT License

---

💡 Need Help? Join our Telegram group for real-time support and discussions! 🚀