/HotWalletClaimer

Looking to optimize your earnings with HOT tokens on the Near Protocol? How about Wave on SUI? Tree on BSC? Or Vertus on Ton? This Python script simplifies the process by monitoring your account status within popular Telegram apps, ensuring rewards are claimed at the correct time.

Primary LanguagePythonMIT LicenseMIT

Telegram Claim Assistant - Mine HOT & More!

Currently supporting 15 crypto-based games and increasing weekly - automate claims and stay informed about their status.

Hello, Fellow Crypto Game Enthusiasts! If you find the scripts useful and would like to support our ongoing development, consider subscribing to our Patreon, or treat us to a cup of coffee ☕ as a token of appreciation—both options are just $5. You can also support us at no cost by subscribing to and watching our YouTube channel, where we share more content and insights. Discover some humorous uses for the channel and more reasons to give a little back here.

Want to learn more about the Telegram Claim Bot? Our blog posts are FREE to read on Patreon!

  • Community Member Contributes 2 More Games!: SimpleTap & PixelTap join the club. read more
  • Thanks to @jbr1989 & BNB-Mine Cold!: Coding updates and the reintroduction of Mine Cold. read more
  • Hold Wallet - Diamond Hands joins the party: A new mining-based game on the BNB network. read more

Clever Claiming - How to Use a Virtual Browser and Python Script to Maximize Rewards 24/7

Many popular Telegram apps require frequent logins to maximize rewards. This Python script utilizes Selenium and a virtual web browser to mimic human-like interaction with the games without using programmatically triggered API calls, which might arouse suspicion. Designed to run on your local computer or VPS, it automates the claim process by monitoring your account status within the app and claiming rewards at the most opportune moments. It operates fully automatically when properly configured, with an optional random timer offset to further emulate human behavior.

For example, consider the cryptocurrency "HOT" on the Near Protocol. Mining occurs through the "@HereWalletBot" - a Telegram-based, Web3-enabled app on the NEAR Protocol blockchain. To maximize rewards, users must regularly visit to claim tokens. This script tracks the time until the storage pot fills and initiates a claim when it's full. If the storage is not full, it calculates the time until completion and waits for the optimal moment—adjusted by your preferred random offset—to claim, thereby minimizing network load and reducing gas fees.

Similarly, you can automate interactions with "Ocean" on SUI, "Vertus" on TON, "Oxygen" on Polygon, and both "Cold" and "Tree" on BSC using their respective Telegram bots. Each bot allows users to claim tokens and manage their rewards efficiently by automating the timing of claims, ensuring that you maximize your mining potential while minimizing transaction costs. The script also supports "Seed," which is not associated with a specific blockchain but still offers reward opportunities through automated claims.

We aim to expand this script to include other projects suggested by our users in the coming weeks and months. However, we do not endorse any projects, some of which may take time and effort to mine but ultimately might yield little to no real-world value and may try to upsell additional features or incur gas fees. As always, doing your own research is essential in cryptocurrency.

🎥 Step-by-Step Video Walkthrough 🎬

Watch along while I perform each step, from server setup, downloading and installing the script, configuring the options, and initiating your automated claims with the Video Walkthrough.

Quick Start Install via Docker (best option for non-technical users)

Using Docker simplifies the setup for non-technical users, by "containerizing" the application and its dependencies, keeping it separate from your main operating system, and ensuring a consistent environment across different architectures (X86/ARM64) and operating systems (Linux-based/Windows). This approach eliminates issues related to dependency management and version conflicts.

Install Docker Desktop on your PC or CLI Docker on a VPS and then type the following commands into a terminal. Refer to the DOCKER.md or video walkthrough for full details.

Run a Container with the Script and Dependencies from the Latest Image (with automatic restart set)

docker run -d --name telegram-claim-bot --restart unless-stopped thebrumby/telegram-claim-bot

Enter the Container To Interact with the Script - Add New Game Accounts, Monitor for Errors etc

docker exec -it telegram-claim-bot /bin/bash

Once Inside the Container - To launch a game:

./launch.sh

To see the status of all your accounts, delete processes, and see PM2 logs on one page:

./launch.sh status

For more details on status, check out its STATUS.md guide.

You can type exit or CTRL+D to leave the container, which will remain running until stopped. You may use the docker exec command above to re-enter the container as often as needed.

Windows 10 & 11 Alternative Installation - Utilize WSL2:

You can check out the WINDOWS.md guide or check out this video for further instructions.

Stand-alone Linux Installation (best option for technically-minded users):

To create a stand-alone (non-Docker) version, follow the instructions at LINUX.md or watch the video walkthrough. This method is compatible with Ubuntu-style operating systems and tested on Ubuntu 20.04 - 24.04.

Games/apps currently working with this script:

Note: All these scripts assume you have already manually started your selected game, completed any one-time screens that require reading, and made at least 1 claim manually - ensuring you have coins for Gas Fee if necessary

Game Command Description Working
./launch.sh hot Launch HOT on Near Protocol: @herewalletbot
./launch.sh vertus Launch Vertus on TON: @Vertus_App_bot
./launch.sh tree Launch Tree on BNB Wallet: @treeminebot
./launch.sh wave Launch Wave Wallet on Sui: @waveonsuibot
./launch.sh seed Launch Seed App - Mine Seed: @seed_coin_bot
./launch.sh oxygen Mine Oxygen: @oxygenminerbot
./launch.sh oxygen-autoupgrade Auto-upgrade spends your tokens to increase mining speed
./launch.sh hexacore Mine Hexacoin: @HexacoinBot
./launch.sh hexacore-autoupgrade Auto-upgrade spends your tokens to increase mining speed
./launch.sh pocketfi Mine Switch: @pocketfi_bot
./launch.sh blum Launch Blum on Telegram: @blum_bot
./launch.sh time-farm Launch Time Farm on Telegram: @TimeFarmCryptoBot
./launch.sh lumcity Launch Lum City on Telegram: @LumCity_bot
./launch.sh lumcity-autoupgrade Auto-upgrade spends your tokens to increase mining speed
./launch.sh diamond Launch Diamond Hands on Telegram: @holdwallet_bot
./launch.sh cold Launch Cold on Telegram: @Newcoldwallet_bot
./launch.sh pixeltap Launch PixelTap on Telegram: @pixelversexyzbot
./launch.sh simpletap Launch SimpleTap on Telegram: @Simple_Tap_Bot
./launch.sh fuel Launch $Fuel on Telegram: @fueljetton_bot
`./launch.sh fuel-autoupgrade Auto-upgrade spends your tokens to increase mining speed
./launch.sh gamee Launch Gamee on Telegram: @gamee

💻 TIP: Each session while in wait status uses around 30mb of memory and virtually no CPU load. During the Claim or Login phases, however, each session requires approximately 450 MB of memory and utilizes a larger portion of your CPU resources. The concurrent claims setting (default value 1) limits the number of active claims to prevent hardware overload. Assess your hardware's capacity to determine how many simultaneous sessions it can handle, and adjust the maximum number accordingly by following the Usage Notes. Even with a maximum of one allowed claim session, claiming on multiple wallets is easily possible; additional claims just queue until a claim session slot becomes available.

Step-by-Step Video Walkthrough YouTube Link Video Length
Introduction: Play2Earn - Automating Claims in Telegram Games with Python - Hot, Cold, Vertus, and Tree
Dive into the exciting world of Play2Earn games as we explore automation techniques using Python. This video provides a comprehensive walkthrough on how to set up automated claims for games such as Hot, Cold, Vertus, and Tree. Learn how to efficiently manage game rewards and maximize your earnings with our step-by-step guide. Play2Earn: Automating Claims in Telegram Games with Python - Hot, Cold, Vertus, and Tree
Watch Video
03:38
Windows Guide: Experience the Simplicity of Docker
Explore how to use Docker, a powerful tool for rolling out software such as our automation script. This guide is tailored for Windows users, providing a straightforward approach to setting up and using Docker for efficient software deployment. Windows Guide: Experience the Simplicity of Docker
Watch Video
10:09
Step 2a: Setting Up an Amazon VPS for Automated Crypto Claiming Scripts
Setting up a virtual private server (VPS) on Amazon Web Services is easier than you think! This tutorial covers everything from creating your VPS to configuring it for automated crypto claiming scripts. Whether you're managing Hot, Cold, Vertus, or Tree, these strategies will help streamline your operations and enhance your mining efficiency. Setting Up an Amazon VPS for Automated Crypto Claiming Scripts
Watch Video
03:57
Step 2b: Setting Up Ubuntu on Windows Using WSL for Crypto Automation
Learn how to integrate Ubuntu with Windows using the Windows Subsystem for Linux (WSL) for enhanced crypto automation capabilities. This guide will take you through the installation and setup process, showing you how to prepare your system for automating claims in games like Hot, Cold, Vertus, and Tree. Setting Up Ubuntu on Windows Using WSL for Crypto Automation
Watch Video
03:47
Step 3: Installing the Python Script and Configuring Automated Claims
Master the setup of automated claiming scripts in this detailed tutorial. We walk you through the installation of necessary Python scripts and show you how to configure them for efficient operation across various games such as Hot, Cold, Vertus, and Tree. This video is perfect for anyone looking to automate their gameplay and claiming process. Installing the Python Script and Configuring Automated Claims
Watch Video
06:37
Step 4: Setting Up Telegram Accounts: QR Codes and One-Time Passwords
Setting up Telegram accounts for mining games doesn't have to be complex. This guide demonstrates the use of QR codes and one-time passwords to access games like Hot, Cold, Vertus, and Tree. Follow along to learn how to secure and optimize your game accounts for maximum productivity and ease of use. Setting Up Telegram Accounts: QR Codes and One-Time Passwords
Watch Video
03:45
Mining Hot on Near Protocol - Wallet Setup and Automated Claiming Guide
This tutorial focuses on setting up a wallet and automating claims for the Hot game on the Near Protocol blockchain. We'll show you the crucial steps to ensure your wallet is properly configured and automated to claim rewards efficiently. Whether you're a beginner or an experienced miner, these insights will help you make the most of your mining efforts. Mining Hot on Near Protocol - Wallet Setup and Automated Claiming Guide
Watch Video
05:42
Automating Tree Mining with BNB Wallet: Setup and Claims Guide
Automate your Tree mining efforts using the BNB Wallet with this straightforward guide. Discover the essential steps for setting up your wallet, initiating claims, and optimizing the process to ensure continuous mining success. This video will equip you with the tools and knowledge needed to effectively manage and automate your mining operations. Automating Tree Mining with BNB Wallet: Setup and Claims Guide
Watch Video
03:04

Addional Process Manager 2 PM2 commands you may find useful.

  • View all PM2 managed processes:
    pm2 list
  • View logs for a specific session (Replace HOT:Wallet1 with the actual name):
    pm2 log HOT:Wallet1
  • To remove a managed wallet:
    pm2 delete HOT:Wallet1
  • Save configuration if you add or delete processes:
    pm2 save

V3.0.3 Release Notes.

Usage Instructions

After executing the script with ./launch.sh, you will be prompted to update settings and configure the session:

Update Settings

  • If you choose "yes" to update settings when prompted, you can review and possibly update the following settings:
    • forceClaim: Choose to force a claim the first time the script runs, regardless of whether the wallet is full.
    • debugIsOn: Activate debugging to save screenshots locally; default is off.
    • hideSensitiveInput: Ensures sensitive information like phone numbers and seed phrases remain hidden; default is ON.
    • screenshotQRCode: Prefer to log in via QR code; the alternative is manual login via phone number and OTP.
    • maxSessions: Set the maximum number of concurrent claim sessions; additional wallets will wait for an available slot.
    • verboseLevel: Adjust the verbosity of console messages; options range from 1 (minimal) to 3 (all messages).
    • forceNewSession: Forces a new login, useful if the existing session encounters errors.
    • lowestClaimOffset and highestClaimOffset: Define the range for randomized claim timing relative to when the pot is filled.
      • Examples of Random Claim Timing based on Claim Offset:
        • -30, -15: Early claims randomly between 30 and 15 minutes before the pot is full.
        • 30, 60: Late claims randomly 30 minutes to 1 hour after the pot is full.
        • -15, 15: Random claims within a 15-minute window either side of the pot being filled.

Session Name Configuration

  • Sessions are auto-named numerically in the format "Wallet1", or can be customized to your own choice. Reusing a name attempts to resume that session.

Telegram Login: Saved Account Options

  • If the script detects you have a saved Telegram session, you can choose it from a numbered list.
  • If you prefer to log into a new account, selecting 'n' proceeds to a new Telegram login. The default method is to log in by scanning a QR Code screenshot.
  • Should the QR Code method be unsuccessful, or if you disable it in settings, follow the OTP login procedure outlined below.

Telegram OTP login: Country Name and Phone Number for Telegram

  • Enter your Country Name as displayed on Telegram's login page or accept the default, which is auto-detected based on your IP.

Telegram OTO login: One-Time Password (OTP)

  • Enter the OTP sent to your registered Telegram account.

Telegram login: Two-factor authentication (2FA)

  • If 2FA is enabled on your Telegram account, enter your 2FA password following the QR code scan or OTP entry.

Game login: Seed Phrase Input for HereWalletBot Login

  • If your selected game requires a seed phrase to log in, carefully input your 12-word seed phrase, ensuring correct spacing without any punctuation or numbers.
  • Alternatively, if the game's login is based on the Telegram account, ensure you are logging into the correct account.

Final options once the PM2 session is configured.

  • Select "a" or press to automatically add the session to PM2.
  • Select "e" to exit to the Command Line Interface without adding to PM2
  • Select "y" to continue and attempt to make a claim.

Remember to check and adjust your settings upon startup to optimize the script's performance to your server's capabilities.

After following these steps, if all inputs are correctly entered, and assuming no flooding block is in place, you'll be successfully logged into Telegram and your chosen game.

Security Considerations for HotWalletClaimer Usage

💡 Communication: The only external communication is with the Telegram Web App, which occurs over HTTPS, providing a secure channel.

⚠️ Your seed phrase and Telegram login details are not stored or transmitted by this script, except during the unavoidable one-time login process. As of version v1.3.4, the Google Chrome session is now saved into the selenium folder, as of v.1.3.6 there is also a duplicate of the session in ./HotWalletBot/backups - if this information were to become compromised, it would allow a suitably experienced individual to access your account.

💡 Debugging: Enabling debug mode captures the whole process as screenshots, excluding the seed phrase entry step. These images are stored locally to assist you in the event of errors and are not otherwise transmitted or uploaded in any way.

Security Best Practice:

💡 Private Devices: Only use this script on private, secure machines or Virtual Private Servers that only you can access.

⚠️ Caution with Seed Phrases: Be very cautious with accounts of significant value. Consider the effect of any unintended loss should your seed phrase become compromised.

💡 Awareness and Discretion: Understand the security trade-offs of using this automation tool or any other third-party tools. Your vigilance is crucial in safeguarding your information.

Disclaimer:

Use of HotWalletClaimer is at your own risk. While we are confident that the script neither transmits nor stores your sensitive data, it is essential to acknowledge that devices can become compromised through viruses or other malicious software. The developers of HotWalletClaimer exclude any liability for potential security breaches or financial losses. It is your responsibility to safeguard your digital security. Always prioritize protecting your accounts and sensitive information.