tgbot-zksync-farm

Welcome my dear shareholders to my guide on how to build a telegram bot to automate the boring process of airdrop farming.

To build this tool, you have to follow these steps, it would be preferrable if you had a bit of experience with python and development environment.

With the next updates, I will start to make it more and more user friendly.

For the moment, the basic workflow is this

1. You fund some wallets with ETH
2. You bridge to ZKSync
3. You swap ETH to WETH or USDC
4. Every couple days, you run the bot in python (from PC), go to the bot on telegram, the bot generate a list of tx for every wallet and stores them in a json file.
5. If you like the transactions, you click the "Execute" button, or generate new paths.

I know I know, running with python from PC and then going to telegram looks redundant, but it's ok for the moment, and we don't want to upload the private keys to a server for the moment!

You can leave python running as long as you want, even days, and the bot will continue to wait for commands.

Prerequisites

In this first alpha stage, this application is still not able to swap ETH but just WETH <-> USDC, so be sure to

1. Fund one or more wallets from a CEX to Ethereum mainnet
2. Do at least 1 tx on Ethereum
3. Bridge the funds to ZKSync (I suggest Orbiter Bridge)
4. Swap all the ETH to WETH or USDC, except for like $25 for gas fees

Now let's move to Telegram Bot setup

Telegram Instructions

1. Search for @BotFather on Telegram
2. /newbot -> give it a name and a handle

You will get a token like this, save it

3. /mybots -> select your bot -> edit bot -> edit commands
4. digit this generate_farm_paths - Generate swap paths for all wallets
5. With the latest update I added 2 more commands to swap everything to WETH or USDC, so now you can write:

generate_farm_paths - Generate swap paths for all wallets
swap_to_weth - Swap everything to WETH
swap_to_usdc - Swap everything to USDC

You're done with telegram, let's move to Python

Python Instructions

1. Download all files of this repository

2. Create a new python project with a development environments (I use PyCharm)

3. Install the packages in the requirements.txt:

   • Go to the project folder > right click > terminal
   • pip install -r requirements.txt

4. Create in the same folder a file called .env, populate it with the telegram bot token, the etherscan api key and your wallets. You should have something like this (I censored everything ofc)

5. Run the main.py file with python, let it run until you're done with the farming

(ATTENTION, THE BOT WON'T WORK IF PYTHON IS NOT RUNNING)

How it works

main.py

This file basically just run the bot in 'polling' mode (waiting for commands)

config.py

Load the bot info from .env

accounts_info.py

Load accounts info starting from the private keys (address, current balances of eth/weth/usdc)

web3_functions.py

Defines the functions to get the allowance of a token, set approval and get balances (allowance/approval will help with future updates)

odos_router.py

Defines the functions to setup and execute a swap function on Odos (using their official API)

random_farm_generator.py

Contains a function called suggest_tx(). Starting from WETH and USDC, takes the one with higher balance and generates a random transaction with volume > 75% of the balance (to maximize volume). With future updates you will have more granularity on this.

generate_paths.py

Define the generate_farm_paths telegram command, invoke the suggest_tx() to generate transactions for every user, divided randomly in a 30 minutes window (you can edit time editind the variable sleep_times)