TurnKey Auto Bot Airdrop — CLI automation for TurnKey testnet airdrop tasks with multi-wallet support, configurable execution delays, transaction export reports, Sepolia network integration, batch processing, and Rich terminal interface for Web3 wallet infrastructure testing
______ __ __ ____ ____ __ _ ___ __ __ ____ __ __ ______ ___ ____ ___ ______
| || | || \ | \ | |/ ] / _]| | | / || | || | / \ | \ / \ | |
| || | || D )| _ || ' / / [_ | | | _____ | o || | || || | _____ | o )| || |
|_| |_|| | || / | | || \ | _]| ~ || || || | ||_| |_|| O || || || O ||_| |_|
| | | : || \ | | || \| [_ |___, ||_____|| _ || : | | | | ||_____|| O || | | |
| | | || . \| | || . || || | | | || | | | | | | || | | |
|__| \__,_||__|\_||__|__||__|\_||_____||____/ |__|__| \__,_| |__| \___/ |_____| \___/ |__|
CLI automation for TurnKey testnet airdrop tasks — multi-wallet support, configurable delays, export reports.
Features • Getting Started • Configuration • Usage • FAQ
| Resource | URL |
|---|---|
| TurnKey Website | https://turnkey.com |
| TurnKey Documentation | https://docs.turnkey.com |
| TurnKey Dashboard | https://app.turnkey.com |
| Demo Embedded Wallet | https://wallet.tx.xyz |
| Sepolia Testnet Explorer | https://sepolia.etherscan.io |
| Sepolia Faucet (Alchemy) | https://www.alchemy.com/faucets/ethereum-sepolia |
|
Automation
|
Infrastructure
|
|
|
- Python 3.10+
- pip (Python package manager)
Option 1 — Quick start
git clone <repository-url>
cd "TurnKey Auto Bot - Airdrop"
pip install -r requirements.txt
python main.pyOption 2 — From menu
python main.py
# Select [1] Install Dependencies| Package | Version | Purpose |
|---|---|---|
| colorama | >=0.4.6 | ANSI color support on Windows CMD |
| requests | >=2.31.0 | HTTP requests for RPC/API calls |
Configuration is stored in config.json (created via Settings menu or manually).
Example config.json:
{
"rpc_url": "https://ethereum-sepolia-rpc.publicnode.com",
"delay_min": 5,
"delay_max": 15,
"wallets_path": "wallets.txt",
"max_retries": 3
}| Field | Type | Description |
|---|---|---|
rpc_url |
string | Ethereum Sepolia RPC endpoint (leave empty for default) |
delay_min |
int | Minimum delay between actions (seconds) |
delay_max |
int | Maximum delay between actions (seconds) |
wallets_path |
string | Path to wallet file (relative or absolute) |
max_retries |
int | Max retry attempts on failure |
Tip: Use a public Sepolia RPC (e.g.
https://rpc.sepolia.org) or Alchemy/Infura for reliability.
Example wallets.txt:
# One address per line (private key or address depending on implementation)
0x1234567890abcdef1234567890abcdef12345678
0xabcdef1234567890abcdef1234567890abcdef
Start the bot:
python main.pyCLI menu mockup:
╔════════════════════════════════════════╗
║ MAIN MENU ║
╠════════════════════════════════════════╣
║ [1] Install Dependencies ║
║ [2] Settings ║
║ [3] About ║
║ [4] Load Wallets ║
║ [5] Run Bot ║
║ [6] Export Results ║
║ [0] Exit ║
╚════════════════════════════════════════╝
► Enter option number (0-6):
Typical workflow:
- [1] Install Dependencies — first-time setup
- [2] Settings — configure RPC URL, delays, wallets path
- [4] Load Wallets — load from
wallets.txt - [5] Run Bot — execute airdrop cycle
- [6] Export Results — save report to
exports/
TurnKey Auto Bot - Airdrop/
├── main.py # Entry point, CLI menu, cyberpunk UI
├── config.json # Runtime config (created via Settings)
├── wallets.txt # Wallet list (one per line)
├── requirements.txt # Python dependencies
├── Insiders.md # Internal documentation
├── src/
│ ├── __init__.py # Package init
│ ├── bot.py # Bot logic, wallet loading, cycle execution
│ ├── settings.py # config.json load/save, Settings UI
│ └── export.py # Export results to exports/
└── exports/ # Generated reports (report_YYYYMMDD_HHMMSS.txt)
What is TurnKey?
TurnKey is a secure wallet infrastructure platform. Its testnet (Ethereum Sepolia) offers airdrop opportunities for users who participate in protocol interactions. This bot automates transaction cycles to streamline participation.
Do I need real ETH?
No. Use Sepolia testnet ETH only. Get free Sepolia ETH from faucets (e.g. Alchemy, Sepolia Faucet). Never use mainnet funds for testing.
How do I add wallets?
Create or edit wallets.txt in the project root. Add one wallet address (or private key, depending on your setup) per line. Lines starting with # are ignored. Then use Load Wallets from the menu.
Where are results exported?
Reports are saved to exports/ as report_YYYYMMDD_HHMMSS.txt. Use Export Results from the menu after running the bot.
How do I increase the wallet batch size?
The bot processes wallets sequentially with built-in rate limiting to avoid API throttling. Batch size and delay intervals are configurable in src/bot.py.
Is this affiliated with TurnKey?
No. This is an independent community tool for educational and testnet purposes. Not officially endorsed or affiliated with TurnKey.
Security: should I share my private keys?
Never. Use testnet-only wallets. Keep .env and wallets.txt out of version control. This tool is for testing; never expose mainnet keys.
This software is provided for educational and testnet use only. Use at your own risk. The authors are not responsible for any loss of funds. Always verify you are on Sepolia testnet. This project is not affiliated with, endorsed by, or connected to TurnKey or any official TurnKey entity.
If this project helped you, consider starring the repo.
ETH donation: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1