EasyStark 🚀

Script for various tasks in the StarkNet network

Requirements

Features

Feature	Supported
Balance checker	✅
Transfer ETH and other tokens from one wallet to another	✅
Wallet generator

Settings

Option	Description
NODE_URL	URL of the StarkNet node to interact with.
CHAIN_ID	Identifier of the StarkNet network (e.g., MAINNET).
ETH_CONTRACT_ADDRESS	Contract address of the ETH token on StarkNet.
CUSTOM_CONTRACT_ADDRESSES	Dictionary containing custom token addresses and their decimals (e.g., STRK, USDC).
FEE_BUFFER	Buffer amount in ETH reserved to cover transaction fees.
ADDRESSES_FILE	File path containing wallet addresses.
PRIVATE_KEYS_FILE	File path containing private keys corresponding to the addresses.
RECIPIENTS_FILE	File path containing recipient addresses for transfers.
OUTPUT_BALANCES_FILE	Output file path to save wallet balances in Excel format.
OUTPUT_TRANSACTIONS_FILE	Output file path to save transaction details in Excel format.
DELAY_RANGE	Range (in seconds) for random delays between transactions.
TOKEN_TO_TRANSFER	Token symbol to be transferred (e.g., ETH, STRK, USDC).
USE_ALL_BALANCE	True/False indicating whether to transfer the entire available balance.
TRANSFER_AMOUNT_RANGE	Range of transfer amounts (in ETH). Ignored if USE_ALL_BALANCE is True.

How to install 📚

Before you begin, make sure you have meet the requirements. It's really IMPORTANT, without these requiremenets, you can NOT install our script.

Linux manual installation

git clone https://github.com/Dellenoam/EasyStark.git
cd EasyStark
python3 -m venv .venv
source .venv/bin/activate
pip install poetry
poetry install --only main

Windows manual installation

git clone https://github.com/Dellenoam/EasyStark.git
cd EasyStark
python -m venv .venv
.venv\Scripts\activate
pip install poetry
poetry install --only main

Configuration

You can configure the script by editing the config.py file. To learn more about options, see the settings.

How to import wallets

To import wallets into the script, you need to insert addresses of wallets into addresses.txt (starknet requires), private keys into private_keys.txt and recipients address into recipients.txt

Run the script

Let's run the script!

Using start.bat

You can run the script using start.bat script, just execute it.

Manually

Before running the script, you ALWAYS need to activate the virtual environment and check for updates.

# Linux
source .venv\bin\activate
# Windows
.venv\Scripts\activate

# Linux/Windows
git pull

To run the script, use python3 main.py on Linux or python main.py on Windows.