Automated Referral Bot with Tor Anonymity

This script automates the process of creating accounts and applying a referral code for a Supabase-backed service. It leverages the Tor network to anonymize requests to bypass potential rate-limiting, and uses Cloudflare Email Routing and Mail.tm for dynamic and temporary email handling.

Disclaimer: 📜 This script is intended for educational and research purposes only. Automating account creation may violate the terms of service of the targeted platform. The user is solely responsible for their actions and must use this tool ethically and in accordance with all applicable laws and terms of service.

---

Features

• Tor Integration: Automatically routes all HTTP requests through the Tor network for anonymity.
• IP Rotation: Requests a new Tor IP address for each iteration to avoid IP-based blocking.
• Dynamic Email Routing: Uses the Cloudflare API to create email routing rules on the fly.
• Temporary Inboxes: Creates temporary email accounts with Mail.tm to receive verification OTPs.
• Automated OTP Handling: Monitors the temporary inbox, extracts the 6-digit OTP, and uses it for account verification.
• Secure Configuration: Loads all sensitive API keys and tokens from a local .env file to keep them out of the codebase.

---

Prerequisites

Before you begin, ensure you have the following installed:

1. Python 3.8+
2. The Tor Service: The script needs the Tor service running in the background.
   • On Debian/Ubuntu: sudo apt-get update && sudo apt-get install tor
   • On macOS (Homebrew): brew install tor
   • On Windows: Download the Tor Expert Bundle and run tor.exe.

---

⚙️ Setup and Installation

1. Clone the Repository

git clone [https://github.com/Omkumar2003/bitcoinRewardBot/](https://github.com/Omkumar2003/bitcoinRewardBot/)
cd your-repo-name

2. Install Python Dependencies

Install all the required libraries from the requirements.txt file.

pip install -r requirements.txt

3. Configure the Tor Service

For the script to control Tor (i.e., request new IPs), you must enable its control port.

• Find your torrc configuration file (e.g., /etc/tor/torrc on Linux).
• Add or uncomment the following lines:

  ControlPort 9051
  CookieAuthentication 1
  

• Restart the Tor service: sudo systemctl restart tor

4. Configure Your Secrets

All API keys and secrets are managed in a .env file.

• Make a copy of the example file:

  cp .env.example .env

• Now, open the .env file with a text editor and fill in your actual values.
  • CLOUDFLARE_API_TOKEN: Your Cloudflare API token with DNS and Email Routing permissions.
  • CLOUDFLARE_ZONE_ID: The ID of the zone (domain) you are using in Cloudflare.
  • CLOUDFLARE_DOMAIN: The domain name you are using (e.g., example.com).
  • SUPABASE_API_KEY: The public anon key for your Supabase project.
  • REFERRAL_CODE: The referral code you want to apply.

Important: The .gitignore file is already configured to prevent your .env file from being uploaded to GitHub.

---

▶️ How to Run

1. Start the Tor service if it's not already running.
2. Run the Python script from your terminal:

   python main.py

The script will first ask you to verify a destination email address in your Cloudflare settings. It will then proceed with the main loop, creating accounts and applying your referral code for the number of iterations specified in the script.