MCPcopy Index your code
hub / github.com/0xStarLabs/StarLabs-MegaETH

github.com/0xStarLabs/StarLabs-MegaETH @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
333 symbols 1,508 edges 68 files 132 documented · 40%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

StarLabs-MegaETH Bot 🚀

A powerful and flexible Ethereum Layer 2 automation tool with multiple features for MegaETH testnet activities.

TUTORIAL >>> star-labs.gitbook.io/star-labs/software/megaeth/ru <<< TUTORIAL >>> star-labs.gitbook.io/star-labs/software/megaeth/ru <<< TUTORIAL >>> star-labs.gitbook.io/star-labs/software/megaeth/ru <<<

🌟 Features

  • ✨ Multi-threaded processing
  • 🔄 Automatic retries with configurable attempts
  • 🔐 Proxy support
  • 📊 Account range selection
  • 🎲 Random pauses between operations
  • 🔔 Telegram logging integration
  • 📝 Detailed transaction tracking
  • 🧩 Modular task system

🎯 Available Actions:

  • Swaps:
  • Bebop Exchange Trading
  • GTE Exchange Trading
  • Faucets:
  • MegaETH Faucet
  • GTE Faucet
  • DeFi:
  • Teko Finance Staking
  • Applications:
  • Cap App (cUSD minting)
  • OnChain GM (NFT minting)
  • XL Meme (Meme token trading)

📋 Requirements

  • Python 3.11 or higher
  • Private keys for Ethereum wallets
  • (Optional) Proxies for enhanced security
  • Solvium API key for captcha solving
  • (Optional) Telegram bot token for logging

🚀 Installation

  1. Clone the repository:
git clone https://github.com/0xStarLabs/StarLabs-MegaETH.git
cd StarLabs-MegaETH
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure your settings in config.yaml
  2. Add your private keys to data/private_keys.txt
  3. (Optional) Add proxies to data/proxies.txt

📁 Project Structure

StarLabs-MegaETH/
├── data/
│   ├── private_keys.txt    # Ethereum wallet private keys
│   └── proxies.txt         # Proxy addresses (optional)
├── src/
│   ├── modules/            # Task-specific modules
│   └── utils/              # Helper utilities
├── config.yaml             # Main configuration file
└── tasks.py                # Task definitions

📝 Configuration

1. data files

  • private_keys.txt: One private key per line
  • proxies.txt: One proxy per line (format: http://user:pass@ip:port)

2. config.yaml Settings

SETTINGS:
  THREADS: 1                      # Number of parallel threads
  ATTEMPTS: 5                     # Retry attempts for failed actions
  ACCOUNTS_RANGE: [0, 0]          # Wallet range to use (default: all)
  EXACT_ACCOUNTS_TO_USE: []       # Specific wallets to use (default: all)
  SHUFFLE_WALLETS: true           # Randomize wallet processing order
  PAUSE_BETWEEN_ATTEMPTS: [3, 10] # Random pause between retries
  PAUSE_BETWEEN_SWAPS: [5, 30]    # Random pause between swap operations

3. Module Configurations

Swaps:

SWAPS:
  BEBOP:
    BALANCE_PERCENTAGE_TO_SWAP: [5, 10]  # Percentage range of balance to swap
    SWAP_ALL_TO_ETH: false                # Convert all tokens back to ETH

  GTE:
    BALANCE_PERCENTAGE_TO_SWAP: [5, 10]  # Percentage range of balance to swap
    SWAP_ALL_TO_ETH: true                # Convert all tokens back to ETH
    SWAPS_AMOUNT: [3, 5]                 # Number of swaps to perform

Staking:

STAKINGS:
  TEKO_FINANCE:
    CHANCE_FOR_MINT_TOKENS: 50           # Probability of minting tokens
    BALANCE_PERCENTAGE_TO_STAKE: [5, 10] # Percentage range to stake
    UNSTAKE: false                        # Enable unstaking

Minting:

MINTS:
  XL_MEME:
    BALANCE_PERCENTAGE_TO_BUY: [2, 5]    # Percentage of ETH to use for meme tokens
    CONTRACTS_TO_BUY: []                  # Specific token contracts to buy

🎮 Usage

Task Configuration

Edit tasks.py to select which modules to run:

TASKS = ["GTE_SWAPS"]  # Replace with your desired tasks

Available task presets: - FAUCET - Claim MegaETH tokens (captcha required) - CAP_APP - Mint cUSD - BEBOP - Trade on Bebop exchange - GTE_SWAPS - Trade on GTE exchange - TEKO_FINANCE - Stake on Teko Finance platform - ONCHAIN_GM - Mint GM NFTs - XL_MEME - Buy meme tokens - GTE_FAUCET - Claim tokens from GTE faucet

Custom Task Sequences

You can create custom task sequences combining different modules:

TASKS = ["MY_CUSTOM_TASK"]

MY_CUSTOM_TASK = [
    "faucet",                           # Run faucet first
    ("gte_swaps", "bebop"),             # Then run both in random order
    ["teko_finance", "xl_meme"],        # Then run only one randomly
]

Run the bot:

python main.py

📜 License

MIT License

⚠️ Disclaimer

This tool is for educational purposes only. Use at your own risk and in accordance with relevant terms of service.

Core symbols most depended-on inside this repo

sleep
called by 65
src/model/start.py
estimate_gas
called by 33
src/model/onchain/web3_custom.py
get_gas_params
called by 30
src/model/onchain/web3_custom.py
call
called by 28
src/model/projects/other/superboard/instance.py
get_balance
called by 14
src/model/onchain/web3_custom.py
from_wei
called by 13
src/model/onchain/constants.py
execute_transaction
called by 11
src/model/onchain/web3_custom.py
_get_wallet
called by 6
src/model/database/instance.py

Shape

Method 220
Class 61
Function 49
Route 3

Languages

Python100%

Modules by API surface

src/utils/config.py25 symbols
src/model/database/instance.py24 symbols
src/model/help/captcha.py22 symbols
src/utils/proxy_parser.py20 symbols
src/model/onchain/bridges/crusty_swap/instance.py19 symbols
src/model/onchain/constants.py18 symbols
src/model/onchain/web3_custom.py16 symbols
src/model/offchain/cex/instance.py15 symbols
src/utils/config_browser.py13 symbols
src/model/projects/swaps/gte.py11 symbols
src/model/projects/stakings/teko_finance.py11 symbols
src/model/projects/other/superboard/instance.py10 symbols

For agents

$ claude mcp add StarLabs-MegaETH \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact