StarLabs Tempo Bot 🚀

A powerful automation tool for Tempo Network Testnet with faucet claiming and token transfers.

🌟 Features

Core Functionality

• ✨ Multi-threaded processing - Run multiple accounts simultaneously
• 🔄 Automatic retries with configurable attempts
• 🔐 Proxy support for enhanced security
• 📊 Account range selection and exact account filtering
• 🎲 Random pauses between operations
• 🔔 Telegram logging integration
• 📝 Database task tracking with SQLite storage
• 🧩 Modular task system with flexible configurations

Tempo Network Operations

• Faucet Claiming:

  • Automatic faucet claiming via WebSocket RPC
  • Receives AlphaUSD, BetaUSD, ThetaUSD tokens
  • Balance verification after claim

• Token Sender:

  • Random token selection (AlphaUSD, BetaUSD, ThetaUSD)
  • Send to random addresses or between your wallets
  • Configurable percentage of balance to send
  • Gas optimization and transaction tracking

• Balance Monitoring:

  • Check all token balances
  • Detailed logging of token amounts

📋 Requirements

• Python 3.11.x
• Private keys for Ethereum wallets
• Proxies for enhanced security
• (Optional) Telegram bot token for logging

🚀 Installation

1. Clone the repository:

git clone https://github.com/0xStarLabs/StarLabs-Tempo.git
cd StarLabs-Tempo

2. Install dependencies:

pip install -r requirements.txt

3. Configure your settings in config.yaml
4. Add your private keys to data/private_keys.txt
5. Add proxies to data/proxies.txt

📁 Project Structure

StarLabs-Tempo/
├── data/
│   ├── accounts.db            # SQLite database for task tracking
│   ├── private_keys.txt       # Ethereum wallet private keys
│   └── proxies.txt            # Proxy addresses
├── src/
│   ├── model/
│   │   ├── database/          # Database management
│   │   ├── tempo/             # Tempo network integration
│   │   │   ├── instance.py    # Faucet & token operations
│   │   │   └── constants.py   # Token addresses & ABIs
│   │   ├── onchain/           # Blockchain operations
│   │   └── help/              # Helper modules (stats)
│   └── utils/                 # Utility functions and configurations
├── 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. Main Settings (config.yaml)

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: [1, 1]  # Random pause between retries
  PAUSE_BETWEEN_SWAPS: [3, 10]    # Random pause between swaps
  RANDOM_PAUSE_BETWEEN_ACCOUNTS: [1, 1]  # Pause between accounts
  RANDOM_PAUSE_BETWEEN_ACTIONS: [1, 1]   # Pause between actions
  RANDOM_INITIALIZATION_PAUSE: [1, 1]    # Pause before account start

TOKEN_SENDER:
  SEND_TOKENS_TO_MY_WALLETS: false  # Send to own wallets or random addresses
  PERCENT_OF_BALANCE_TO_SEND: [5, 10]  # Percent of balance to send

RPCS:
  TEMPO: ["https://rpc.testnet.tempo.xyz"]

OTHERS:
  SKIP_SSL_VERIFICATION: true
  USE_PROXY_FOR_RPC: true

3. Telegram Logging (Optional)

SETTINGS:
  SEND_TELEGRAM_LOGS: false
  TELEGRAM_BOT_TOKEN: "your_bot_token"
  TELEGRAM_USERS_IDS: [your_user_id]

🎮 Usage

Run the Bot

python main.py

Menu Options

1. ⭐️ Start farming - Run selected tasks
2. 🔧 Edit config - Open configuration editor
3. 💾 Database actions - Manage task database
4. 👋 Exit - Close the bot

Database Management

• Create/Reset Database - Initialize new database with tasks
• Generate Tasks for Completed Wallets - Add new tasks to finished wallets
• Show Database Contents - View current database status
• Regenerate Tasks for All - Reset all wallet tasks
• Add New Wallets - Import wallets from files

🔧 Available Tasks

Faucet

• faucet - Claim tokens from Tempo faucet:
  • Connects via WebSocket to Tempo RPC
  • Claims AlphaUSD, BetaUSD, ThetaUSD tokens
  • Displays balances after claiming

Token Sender

• token_sender - Send random tokens:
  • Randomly selects one of the available tokens
  • Sends configurable percentage of balance
  • Can send to random addresses or your own wallets

📝 Task Configuration

Edit tasks.py to select which modules to run:

# Available task presets
TASKS = ["FAUCET", "TOKEN_SENDER"]

FAUCET = ["faucet"]
TOKEN_SENDER = ["token_sender"]

Task Syntax

# Sequential execution
TASKS = ["FAUCET", "TOKEN_SENDER"]

# Create custom task combinations
CUSTOM_TASK = [
    "faucet",
    ("faucet", "token_sender"),  # Both in random order
    ["faucet", "token_sender"],  # Choose one randomly
]

Task Flow Examples

# Simple faucet claim
TASKS = ["FAUCET"]

# Faucet + Token sending
TASKS = ["FAUCET", "TOKEN_SENDER"]

# Custom flow
CUSTOM_FLOW = [
    "faucet",
    "token_sender",
]

💱 Supported Tokens

Token	Address	Decimals
AlphaUSD	0x20c0000000000000000000000000000000000001	6
BetaUSD	0x20c0000000000000000000000000000000000002	6
ThetaUSD	0x20c0000000000000000000000000000000000003	6

🔐 Security Features

• Proxy support for all operations
• SSL verification control
• Error handling with retry mechanisms
• Random address generation for token transfers
• Optional wallet linking (send between own wallets)

⚠️ Important Notes

1. Proxies Required: All operations require proxies
2. Rate Limits: Respect network rate limits to avoid issues
3. Token Sender: By default sends to random addresses (safer for wallet isolation)
4. Configuration: Test with small account ranges first
5. Gas: Ensure sufficient native balance for transaction fees

🔗 Network Info

• Network: Tempo Testnet
• Chain ID: 42429
• RPC: https://rpc.testnet.tempo.xyz
• Explorer: https://explore.tempo.xyz

📜 License

MIT License

⚠️ Disclaimer

This tool is for educational and research purposes only. Use at your own risk and in accordance with Tempo Network's terms of service.

🆘 Support

For support and updates, join our community:

• Telegram Channel: @StarLabsTech
• Telegram Chat: @StarLabsChat
• GitHub: 0xStarLabs

---

Made with ❤️ by StarLabs Team