This Python script simplifies claiming the cryptocurrency HOT, using the "HereWalletBot" app, a free-to-use application on Telegram that is also Web3 enabled on the NEAR Protocol blockchain. The app requires frequent logins to claim HOT tokens if you intend to accumulate the maximum rewards. This script automates the claim process, attempting to claim immediately after the wallet is full. Should the wallet not be filled, it calculates the time until completion and waits to claim, optimizing network usage and lowering your Gas Fees.

💡 TIP: While you cannot register more than one wallet to a single Telegram user account, this script enables you to manage multiple pre-existing HereWallet accounts using just one Telegram account by initiating multiple individual sessions. For straightforward setup, consider using SCREEN (refer to the quick start guide below). For more advanced users, PM2 is recommended.

If you find this script useful, please consider buying me a coffee. You can join the HereWallet game using this link. If you'd like to support me, use this link to make me your referrer, which helps me earn extra tokens. Thanks in advance for any support!

For detailed instructions on setting up your environment using Windows Subsystem for Linux 2 (WSL2), please refer to our Windows Setup section.

Copy and paste the Quick Start command block into your terminal (or follow the manual steps below if you prefer).

sudo apt install -y git || true && git clone https://github.com/thebrumby/HotWalletBot.git && cd HotWalletBot && chmod +x install.sh && ./install.sh

Start your first session with screen -S first_session. If you are not in the HotWalletBot directory, you must cd HotWalletBot. Execute the Python script using python3 claim.py, then follow the Usage Notes to set up the session and automate the claiming process. Pressing CTRL+A+D simultaneously will leave this session running in the background. screen -r first_session will resume the session for you to check on progress, or for errors. If you wish to start the Python script without the CLI setup and go straight into an existing session, use python3 claim.py 1. Note: 1 is the default session name for the first session, if you changed it, replace "[1]" with the exact Session Name you specified when setting this session up.

If you have a second account, from the command line (not within the first Screen), start another session with screen -S second_session and execute the Python script python3 claim.py. You may now run another instance of python3 claim.py to log into the second account. You can exit Screen and leave the script unattended by pressing CTRL+A+D. screen -r second_session will resume the session for you to check on progress, or for errors. If you wish to start the Python script without the CLI setup and go straight into an existing session, use python3 claim.py 2. Note: 2 is the default session name for the second session, if you changed it, replace "[2]" with the exact Session Name you specified when setting this session up.

💡 Tip: Each active claim session requires approximately 450 MB of memory and consumes a portion of CPU resources during login or when making a claim. 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. Claiming on multiple wallets is still possible with only one allowed claim session; other pending claims will simply queue until the current session is completed.

See a walkthrough of all the steps, from server setup to installing the script, on YouTube.

1. Install Python & PIP:

   sudo apt update
   sudo apt install -y python3 python3-pip
   python3 --version   

2. Download & Install the Chrome .deb package:

   sudo apt install -y wget
   wget -O /tmp/chrome.deb https://mirror.cs.uchicago.edu/google-chrome/pool/main/g/google-chrome-stable/google-chrome-stable_114.0.5735.198-1_amd64.deb
   sudo apt install -y /tmp/chrome.deb
   rm /tmp/chrome.deb   

3. Download & Install Chromedriver:

   sudo apt install -y unzip
   wget https://chromedriver.storage.googleapis.com/114.0.5735.90/chromedriver_linux64.zip
   unzip chromedriver_linux64.zip
   rm chromedriver_linux64.zip
   sudo mv chromedriver /usr/local/bin/
   sudo chmod +x /usr/local/bin/chromedriver
   chromedriver --version   

4. Clone this repository:

   sudo apt install -y git
   git clone https://github.com/thebrumby/HotWalletBot.git   

5. Switch to the repository directory:

   cd HotWalletBot   

6. Install the dependencies:

   pip install selenium Pillow   

After executing the script with python3 claim.py, you will be prompted to update settings and configure the session:

1. Update Settings:
   • Decide if you want to update script parameters. If you choose "y", you'll be prompted review/update the following:
     • forceClaim: Force a claim the first time the script runs, even if the wallet isn't full, or wait until full.
     • debugIsOn: Activate debugging to save screenshots to your filesystem; default is off.
     • hideSensitiveInput: Hide sensitive input such as phone numbers and seed phrases; default is ON.
     • screenshotQRCode: Log in by QR code; default is true, the alternative is by phone number and OTP.
     • maxSessions: Defines the number of simultaneous claim sessions permitted. Even if only one session is allowed at a time, you can manage multiple wallets. Additional wallets will queue and wait for an available claim session slot.
     • verboseLevel: Control verbosity of console messages; ranges from 1 (minimal), 2 (main steps) 3 (all messages).
     • forceNewSession: Overwrite an existing session and force a new login. Requires repeating both Telegram log-in & seed words entry - useful if an existing session has errors.
2. Session Name Configuration:
   • Auto-assigns a numeric value or accepts a custom session name. Reusing a name will attempt to resume that session.
3. Login Options:
   • The default is using scanning a QR Code screenshot. If that doesn't work, or you choose otherwise, follow the OTP login method in steps 4. & 5.
4. Country Name and Phone Number for Telegram:
   • Enter your Country Name as it appears on Telegram's login page or use the default based on your IP address.
5. One-Time Password (OTP):
   • Input the OTP sent to your Telegram account.
6. Two-Factor Authentication (2FA):
   • If your Telegram account has 2FA enabled, you'll be prompted to enter your password after scanning the QR code or entering the OTP. Input your 2FA password to continue the login process.
7. Seed Phrase Input for HereWallet Login:
   • Enter your 12-word seed phrase, ensuring it is spaced correctly without punctuation or numbers.
8. Exit & resume later (possibly in PM2) or Continue in the CLI script:
   • Choose to exit the script and save progress for later or continue to the claim function.

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 successfully logged into both Telegram and HereWallet.

Install PM2 manually, or use the install script packaged in the HotWalletBot directory. You will need to cd HotWalletBot if you are not already in the HotWalletBot directory:

sudo chmod +x install_pm2.sh && sudo ./install_pm2.sh

Before using PM2 to manage your wallet sessions, you should open the script with python3 claim.py and set up each wallet. After following the process to sign into Telegram and enter your seed phrase, you will be prompted if you want to exit before being handed over to the claim function. You can select 'n' to exit the script and resume the session with PM2 as outlined below.

• If you are on a linux/ubuntu machine, initialize PM2 with systemd to ensure your applications start on boot:
  • pm2 startup systemd (follow the on-screen prompt to enable resume on reboot if you are not superuser)
• Use the following command to add your Python script as a PM2 session. This example adds a PM2 session named firstWallet, which will try to load a saved claim.py session named 1:
  • pm2 start claim.py --name firstWallet -- 1
  • Note: If you named your session folder something else during setup, replace 1 with your actual Session name from claim.py.
• To add a second session, you can use a similar command with a different name and session identifier. This example adds a PM2 session named secondWallet, which will try to load a saved claim.py session named 2:
  • pm2 start claim.py --name secondWallet -- 2
  • Note: If you named your session folder something else during setup, replace 2 with your actual Session name from claim.py.
• After adding/updating your sessions, save them with the command below. This makes sure your session configuration persists through system reboots:
  • pm2 save
• To view the current list of processes managed by PM2:
  • pm2 list
• To see the output which would have been previously visible in the Screen console:
  • pm2 log firstWallet
• If you need to remove a wallet from PM2's management, you can delete it by its name:
  • pm2 delete firstWallet
• If you wish to stop using PM2 as a service, you can disable it with:
  • pm2 unstartup systemd

See a walkthrough of how to automate claims using PM, on YouTube.

Windows Subsystem for Linux (WSL2) allows you to run a GNU/Linux environment directly on Windows, unmodified, without the overhead of a traditional virtual machine or dualboot setup. This makes it an excellent choice for running this script in a Linux-like environment on Windows machines, as the commands and drivers detailed below can be utilized directly. Alternatively, watch the video below and consider using a cloud-based Linux server (12-month free trials are often available).

1. Open the Microsoft Store:

   • Click the Start menu and open the Microsoft Store. Search for "Ubuntu 22.04 LTS" and click on the install button. This will download and install the Ubuntu terminal environment.

2. Enable Windows Subsystem for Linux (WSL):

   • Before you can use Ubuntu, ensure that WSL is enabled and set up to use the newer WSL2 version. Open PowerShell as an administrator and run the following commands:

     dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

     This command enables the WSL feature. Restart your computer after this step to ensure changes take effect.

3. Set WSL2 as Your Default Version:

   • After your system restarts, open PowerShell again as an administrator and set WSL2 as the default version with this command:

     wsl --set-default-version 2

     If this is your first time setting up WSL, you might be prompted to update the WSL2 kernel. Follow the link provided in the PowerShell window to download and install the WSL2 kernel update package.

1. Start Ubuntu 22.04:

   • After installation, you can start Ubuntu by searching for "Ubuntu 22.04" in the Start menu and clicking on the app icon. The first launch will take a few minutes as it finalizes the setup.

2. Create a User Account and Password:

   • Upon first launch, you'll be prompted to enter a new username and password. This account will be your default user for Ubuntu and will have sudo (administrative) privileges.

1. Update Your System:

   • It's a good practice to update your package lists and upgrade the packages right after installation. In the Ubuntu terminal, run:

     sudo apt update && sudo apt upgrade

     This will ensure all your software is up to date.

• Now that you have Ubuntu set up, you can return to the Quick Start section at the top of the page for further instructions.

• Press Win + R to open the Run dialog box. Type shell:startup to open the Startup folder. Then, copy the windows_pm2_restart.bat file from your HotWalletBot directory into the Startup folder.

See a walkthrough of how to setup Ubuntu within Windows using WSL with our YouTube.

💡 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 with https://web.telegram.org/k/#@herewalletbot. As of version v1.3.4, the Google Chrome session is now saved into the ./HotWalletBot/selenium folder and in v.1.3.6 there is also a duplicate of the session in ./HotWalletBot/backups - if this information was 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.

💡 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.

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.