> For the complete documentation index, see [llms.txt](https://star-labs.gitbook.io/star-labs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://star-labs.gitbook.io/star-labs/monad/eng.md).
# ENG
https\://github.com/0xStarLabs/StarLabs-Monad
## ⚙️ Installation
#### Requirements:
* Python version 3.11.6 or higher
#### Downloading:
1 | Clone a repository
```powershell
git clone https://github.com/0xStarLabs/StarLabs-Monad.git
```
```powershell
cd StarLabs-Monad
```
2 | Create and activate virtual environment (optional but recommended)
```
python -m venv venv
```
```
venv\Scripts\activate
```
\
3 | Install dependencies
```powershell
pip install -r requirements.txt
```
4 | Start
```
python main.py
```
## 📁 Preparation (data folder)
Here you can find all user's data necessary for work. \
\
private\_keys.txt - private keys from wallets. 1 line = 1 key. \
proxies.txt - proxies. 1 line = 1 proxy, or if there are less proxies than accounts, then they will be repeated one after another to be enough for all accounts. \
\ Proxy format is user:pass\@ip:port. ONLY HTTP proxies are supported. \
\
discord\_tokens.txt - tokens of discord accounts. Optional, used only with official faucet function.\
emails.txt - emails. Supported emails firstmail.tld or gmx. Needed only for ThirdWeb faucet.
## 📝 Config.yaml
Config is a file that stores all of the software settings. To edit the settings you need to run the bot, for that open up the console in the folder of your bot by writing the cmd in the path and pressing enter\
After that the console must show up. In it write the py main.py and press enter
The tool must start
To open the config enter it's number and press enter
this window should open up
THREADS - How many accounts to do simultaneously
ATTEMPTS - How many retries to do in case task fails
ACCOUNTS RANGE - you can specify the specific accounts you want to use, for example with 5 - 10 bot will only run accounts from 5 to 10
EXACT ACCOUNTS TO USE - you can specify the specific numbers of accounts like 5,10,12,92
PAUSE BETWEEN ATTEMPTS - pause between retries in case of a failed task\
RANDOM PAUSE BETWEEN ACCOUNTS - pause after one account finishes the job before starting the next one
RANDOM INITIALIZATION PAUSE - random pause before start of every account to make sure that all accounts will be started at different times
BROWSER PAUSE MULTIPLIER - you can multiply the browser wait time if the pages load to slow
TELEGRAN USERS IDS - ids of telegram accounts you want to send logs to
TELEGRAM BOT TOKEN - token of telegram bot that will send the logs to users
AMOUNT TO REFUEL - means the random range of eth that the bot will use to buy monad using the protocol
MINIMUM BALANCE TO REFUEL - means that all accounts with the monad balance higher than that will be skipped
BRIDGE ALL - means bridge all of the balance
BRIDGE ALL MAX AMOUNT - means the maximum balance you can let BRIDGE ALL bridge, this is kind of a safety measure in case one of the wallets will have a big balance
You can withdraw funds from CEX to your wallets using this software, to do so create api keys on the exchange and put them there\
passphrase - password from account or an api key
MAX WALLET BALANCE - all accounts with balance higher than that will be skipped.
### CHOOSING TASKS:
To switch the module, locate the file named `tasks.py` in the bot's folder. Open it using a code editor or a simple text editor. In this file, you'll find the variable `TASKS`, which looks like this:
TASKS is a list of presets, and a preset is a list of modules that the bot will execute.
Example of a preset containing a module
You can create your own preset by simply giving it any name, for example: As you can see, FAUCET is just the name of the preset, which can be anything, while inside it, there's a "faucet" module responsible for the module that runs this function
You can create your own preset just by typing random name and square brackets
Inside it, you can add the modules you want to use, for example, dusted:
Then, to run this preset, copy its name and paste it into TASKS:
In the preset, you can use different types of randomization. For example, square brackets indicate that the bot will choose one module from those inside them, in our case either dusted
( ) brackets indicate that the bot will execute all modules inside them, but in random order
You can create as many lines as you wish, just remember to use commas
## 💀 Faucet captcha settings
First of all you will need to register on the site and get a captcha solving key.
**You will need STICKY/STATIC proxies before you start setting up.**
Go to your proxy settings. \
We recommend using **shardproxy** - ****.
Follow the instructions in the screenshot. We recommend selecting European countries. \
***It is also necessary to select:*** \ **Session: sticky** \ **Protocol: HTTP** \ **TTL: 600 (how often we will change IP in seconds)** \ **Format: user:pass\@ip:port**\
\
\ THE NUMBER OF PROXY LINES SHOULD BE NOT LESS THAN THE NUMBER OF PRIVATE KEYS!!\ THE NUMBER OF PROXY LINES SHOULD BE NOT LESS THAN THE NUMBER OF PRIVATE KEYS!!\ THE NUMBER OF PROXY LINES SHOULD BE NOT LESS THAN THE NUMBER OF PRIVATE KEYS!!
**Now you can move on to customizing the captcha.**
1. Go to this site and register
2. Go to the recharge tab of and recharge your balance in a convenient way.\ **ATTENTION! MINIMUM DEPOSIT 1 USDT!**
3. After recharging go to and there you will be able to copy your API key as shown on the screenshot.
4.
```
```
5. Go to the config.yaml file and insert your API key. Example on the screenshot
6.
```
```
7. After that, in tasks.py you can select faucet and run the bot.
8.
```
```
