Somnia Auto — Automation bot for Somnia Network EVM-compatible blockchain testnet with faucet claiming, token transfers, smart contract deployment, transaction batching, multi-account management, proxy support, and Rich CLI for high-throughput metaverse blockchain interaction
##
:####: ##
:###### ##
##: :#
## .####. ## #:##: ##.#### #### :####
###: .######. ######## ####### #### ######
:#####: ### ### ##.##.## ### :## ## #: :##
.#####: ##. .## ## ## ## ## ## ## :#####
:### ## ## ## ## ## ## ## ## .#######
## ##. .## ## ## ## ## ## ## ## . ##
#:. :## ### ### ## ## ## ## ## ## ##: ###
#######: .######. ## ## ## ## ## ######## ########
.#####: .####. ## ## ## ## ## ######## ###.##
Retrodrop automation bot for Somnia Network — multi-threaded campaigns, faucet, swaps, Quills messaging, NFT minting, social linking.
Features • Getting Started • Configuration • Usage • FAQ
| Resource | URL |
|---|---|
| Somnia Network | https://somnia.network/ |
| Documentation | https://docs.somnia.network/ |
| Testnet / Faucet | https://testnet.somnia.network/ |
| Block Explorer | https://browser.somnia.network/ |
| Data Streams | https://datastreams.somnia.network/ |
| Blog | https://blog.somnia.network/ |
| Discord | https://discord.com/invite/somnia |
|
|
- Python 3.11.1 to 3.11.6
- pip (latest recommended)
- Somnia-compatible private keys (EVM format)
- Optional: Proxies, Twitter API tokens, Discord tokens
# Clone the repository
git clone https://github.com/Dcurig/Somnia-Auto
cd Somnia-Auto
# Install dependencies
pip install -r requirements.txt| Package | Version | Purpose |
|---|---|---|
| rich | ≥13.7.0 | Rich CLI, panels, tables |
| PyYAML | ≥6.0 | Config parsing |
| requests | ≥2.28.0 | HTTP requests |
Edit config.yaml in the project root. Example with realistic values:
# Somnia-Auto Configuration
SETTINGS:
THREADS: 4
ATTEMPTS: 5
ACCOUNTS_RANGE: [0, 0] # [0, 0] = all wallets
EXACT_ACCOUNTS_TO_USE: []
SHUFFLE_WALLETS: true
PAUSE_BETWEEN_ATTEMPTS: [3, 10]
PAUSE_BETWEEN_SWAPS: [3, 10]
SOMNIA_NETWORK:
SOMNIA_SWAPS:
BALANCE_PERCENT_TO_SWAP: [5, 10]
NUMBER_OF_SWAPS: [1, 2]
SOMNIA_TOKEN_SENDER:
BALANCE_PERCENT_TO_SEND: [1.5, 3]
NUMBER_OF_SENDS: [1, 1]
SEND_ALL_TO_DEVS_CHANCE: 50
SOMNIA_CAMPAIGNS:
REPLACE_FAILED_TWITTER_ACCOUNT: false
DISCORD_INVITER:
INVITE_LINK: "https://discord.gg/your-invite"Place private keys in data/private_keys.txt, proxies in data/proxies.txt (format: http://user:pass@ip:port), and optional tokens in data/twitter_tokens.txt and data/discord_tokens.txt.
Windows: Double-click run.bat or run:
python main.pyCLI menu mockup:
┌─────────────────────────────────────────────────────────────────┐
│ Main Menu │
├───┬─────────────────────────────┬───────────────────────────────┤
│ # │ Action │ Description │
├───┼─────────────────────────────┼───────────────────────────────┤
│ 1 │ Install Dependencies │ pip install -r requirements │
│ 2 │ Settings │ Edit config.yaml │
│ 3 │ Configure Tasks │ Edit tasks.py presets │
│ 4 │ Data Management │ Manage keys, proxies, tokens │
│ 5 │ Run Bot │ Launch Somnia-Auto automation │
│ 6 │ About │ Project info & hashtags │
│ 0 │ Exit │ Exit the application │
└───┴─────────────────────────────┴───────────────────────────────┘
Select option [0]: 5
Somnia-Auto/
├── main.py # Entry point, Rich CLI menu
├── tasks.py # Task presets (CAMPAIGNS, FAUCET, etc.)
├── config.yaml # Threads, attempts, Somnia settings
├── requirements.txt # Python dependencies
├── run.bat # Windows launcher
├── about/
│ ├── hashtags.txt # Project hashtags
│ └── somnia_about.txt # Project description
├── data/
│ ├── private_keys.txt
│ ├── proxies.txt
│ ├── twitter_tokens.txt
│ ├── discord_tokens.txt
│ └── random_message_quills.txt
└── src/
├── modules/
└── utils/
What is Somnia Network?
Somnia is a high-performance EVM-compatible Layer 1 blockchain for gaming, metaverses, and real-time applications. It targets 1M+ TPS, sub-second finality, and sub-cent fees. Mainnet launched September 2025.
Which Python version is required?
Python 3.11.1 through 3.11.6 is recommended. The bot uses Rich for the CLI and PyYAML for config parsing.
How do I add wallets?
Add Somnia-compatible private keys (0x-prefixed or raw hex) to data/private_keys.txt, one per line. Use the main menu → Data Management to edit.
What task presets are available?
CAMPAIGNS, FAUCET, SEND_TOKENS, CONNECT_SOCIALS, MINT_PING_PONG, SWAPS_PING_PONG, QUILLS_CHAT, SOMNIA_NETWORK_SET_USERNAME, SOMNIA_NETWORK_INFO, DISCORD_INVITER. Configure via menu option 3 or by editing tasks.py.
Do I need proxies?
Proxies are optional but recommended for multi-account farming. Use format http://user:pass@ip:port in data/proxies.txt.
Where can I get testnet tokens?
Use the Somnia faucet at https://testnet.somnia.network/ or request tokens in Discord (#dev-chat, tag @emma_odia).
Is this safe for mainnet?
This bot is intended for educational and testnet use only. Use at your own risk. Never expose private keys. Respect platform ToS and applicable laws.
This software is provided for educational and testnet purposes only. Use responsibly and at your own risk. The authors are not responsible for any loss of funds, account bans, or violations of platform terms of service. Always comply with applicable laws and Somnia Network policies.
Support: @jackthedevv
Donations (ETH): 0x7F3a8E4c1D6f9A5e0B3d7C8a2F4e6D1b9C5a0312
If this project helped you, consider giving it a ⭐