This repository contains a collection of Python scripts designed to automate various tasks on the Monad Testnet, including staking, swapping, deploying contracts, and sending transactions. The scripts are integrated with a central main.py file for easy navigation and execution, supporting multiple private keys and a user-friendly CLI interface.
- Multi-Account Support: Reads private keys from
pvkey.txtto perform actions across multiple accounts. - Colorful CLI: Uses
coloramafor visually appealing output with colored text and borders. - Asynchronous Execution: Built with
asynciofor efficient blockchain interactions (where applicable). - Error Handling: Comprehensive error catching for blockchain transactions and RPC issues.
- Description: Acts as the central hub to select and run other scripts.
- Features:
- Interactive menu with language selection (Vietnamese/English).
- Supports running multiple scripts (
kitsu.py,bean.py,uniswap.py,deploy.py,sendtx.py,ambient.py,rubic.py,mono.py,apriori.py,bebop.py,izumi.py,magma.py,bima.py,lilchogstars.py,naddomains.py). - Clean console interface with colorful banners and borders.
- Usage: Run
python main.pyand choose a script from the menu.
- Description: Automates staking and unstaking MON tokens on the Kitsu Staking contract.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random staking amounts (0.01-0.05 MON).
- Random delays (1-3 minutes) between actions.
- Stake and unstake cycles with detailed transaction logging.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles.
- Description: Automates swapping between MON and tokens (USDC, USDT, BEAN, JAI) on Bean Swap.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random swaps (MON → Token or Token → MON).
- Configurable cycles and random delays (1-3 minutes).
- Balance checking before and after swaps.
- Detailed transaction logs with Tx Hash and explorer links.
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input cycles.
- Description: Automates swapping between MON and tokens (DAC, USDT, WETH, MUK, USDC, CHOG) on Uniswap V2.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random swaps (MON → Token or Token → MON).
- Configurable cycles and random delays (1-3 minutes).
- Balance checking before and after swaps.
- Detailed transaction logs with Tx Hash and explorer links.
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input cycles.
- Description: Deploys a simple Counter contract to Monad Testnet.
- Features:
- Supports multiple private keys from
pvkey.txt. - User input for contract name and symbol (e.g., "Thog Token", "THOG").
- Configurable deployment cycles with random delays (4-6 seconds).
- Displays contract address and Tx Hash after deployment.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input cycles, then enter name and symbol for each deployment.
- Description: Sends MON transactions to random addresses or addresses from a file.
- Features:
- Supports multiple private keys from
pvkey.txt. - Two modes:
- Send to random addresses (user-defined transaction count).
- Send to addresses from
address.txt.
- Configurable MON amount (default 0.000001, max 999).
- Random delays (1-3 seconds) between transactions.
- Detailed logs including sender, receiver, amount, gas, block, and balance.
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input transaction count, amount, and mode.
- Description: Automates token swapping on the Ambient DEX.
- Features:
- Random Swap: Performs random swaps between USDC, USDT, and WETH with customizable amounts.
- Manual Swap: Allows users to select source/destination tokens and input amounts.
- Balance Checking: Displays MON and token balances (USDC, USDT, WETH).
- Retry Mechanism: Retries failed transactions up to 3 times with a 5-second delay for RPC errors.
- Extended Deadline: Swap transactions have a 1-hour deadline to avoid "Swap Deadline" errors.
- Interactive Menu: Offers a CLI menu to choose between Random Swap, Manual Swap, or Exit.
- Usage: Select from
main.pymenu, choose Random/Manual mode, and follow prompts.
- Description: Automates swapping MON to USDT via the Rubic router.
- Features:
- Supports multiple private keys from
pvkey.txt. - Configurable swap cycles with a fixed amount (0.01 MON).
- Wraps MON to WMON, swaps WMON to USDT, then unwraps remaining WMON to MON.
- Random delays (1-3 minutes) between cycles and accounts.
- Transaction tracking with Tx Hash and explorer links.
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles.
- Description: Sends predefined transactions to the Monorail contract.
- Features:
- Supports multiple private keys from
pvkey.txt. - Sends 0.1 MON transactions with custom data.
- Gas Estimation: Falls back to 500,000 if estimation fails.
- Explorer Links: Provides transaction links for tracking.
- Random delays (1-3 minutes) between accounts.
- Supports multiple private keys from
- Usage: Select from
main.pymenu, runs automatically for all accounts.
- Description: Automates staking, unstaking, and claiming MON on the Apriori Staking contract.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random staking amounts (0.01-0.05 MON).
- Configurable cycles with random delays (1-3 minutes) between actions.
- Stake → Unstake → Claim sequence with API check for claimable status.
- Detailed transaction logging with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles.
- Description: Wraps MON to WMON and unwraps WMON back to MON via the Bebop contract (synchronous version).
- Features:
- Supports multiple private keys from
pvkey.txt. - User-defined MON amounts (0.01-0.05) for wrapping/unwrapping.
- Configurable cycles with random delays (1-3 minutes).
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles and MON amount.
- Description: Wraps MON to WMON and unwraps WMON back to MON via the Izumi contract (asynchronous version).
- Features:
- Supports multiple private keys from
pvkey.txt. - Random wrap/unwrap amounts (0.01-0.05 MON).
- Configurable cycles with random delays (1-3 minutes).
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles.
- Description: Automates staking MON and unstaking gMON on the Magma contract.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random staking amounts (0.01-0.05 MON).
- Configurable cycles with random delays (1-3 minutes) between stake/unstake.
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input number of cycles.
- Description: Automates depositing bmBTC into the Bima contract on Monad Testnet.
- Features:
- Supports multiple private keys from
pvkey.txt. - Random deposit amounts (0.01-0.05 bmBTC).
- Random delays (1-3 minutes) between actions.
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, runs automatically for all accounts.
- Description: Automates minting Lil Chogstars NFTs on Monad Testnet.
- Features:
- Supports multiple private keys from
pvkey.txt. - Free NFT minting or random amounts if fees apply.
- Random delays (1-3 minutes) between actions.
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, runs automatically for all accounts.
- Description: Automates NAD domain registration on Monad Testnet.
- Features:
- Supports multiple private keys from
pvkey.txt. - Registers random domains (6-12 characters) or user-defined names.
- Registration fees: 1 MON (3 characters), 0.3 MON (4 characters), 0.1 MON (5+ characters).
- Checks MON balance and domain availability via API.
- Random delays (10-30 seconds) between accounts.
- Transaction tracking with Tx Hash and explorer links.
- Bilingual output (Vietnamese/English).
- Supports multiple private keys from
- Usage: Select from
main.pymenu, input domain name (or leave blank for random).
- Python Version: Python 3.7 or higher (recommended 3.9 or 3.10 due to
asynciousage). - Installer:
pip(Python package installer).
- Clone this repository:
- Open cmd or Shell, then run the command:
git clone https://github.com/thog9/Monad-testnet.gitcd Monad-testnet- Install Dependencies:
- Open cmd or Shell, then run the command:
pip install -r requirements.txt- Prepare Input Files:
- Open the
pvkey.txt: Add your private keys (one per line) in the root directory.
nano pvkey.txt - Open the
address.txt(optional): Add recipient addresses (one per line) forsendtx.py.
nano address.txt - Run:
- Open cmd or Shell, then run command:
python main.py- Choose a language (Vietnamese/English).
-
Connection Errors: Ensure
pvkey.txtexists and contains valid private keys. Check internet connectivity and RPC URL responsiveness (https://testnet-rpc.monad.xyz/). -
Library Errors: Verify all required libraries are installed (
pip list). -
Transaction Failures: Check Tx Hash on Monad Testnet Explorer for detailed error messages (e.g., "Swap Deadline", insufficient balance).
-
API Errors in
apriori.py: Ensure the API endpointhttps://liquid-staking-backend-prod-b332fbe9ccfe.herokuapp.com/is accessible.
├── main.py # Main menu script
├── scripts/ # Directory containing all automation scripts
│ ├── kitsu.py # Kitsu Staking automation
│ ├── bean.py # Bean Swap automation
│ ├── uniswap.py # Uniswap Swap automation
│ ├── deploy.py # Contract deployment automation
│ ├── sendtx.py # Transaction sending automation
│ ├── ambient.py # Ambient Swap automation
│ ├── rubic.py # Rubic Swap automation
│ ├── mono.py # Monorail Transaction automation
│ ├── apriori.py # Apriori Staking automation
│ ├── bebop.py # Bebop Wrap/Unwrap automation (synchronous)
│ ├── izumi.py # Izumi Wrap/Unwrap automation (asynchronous)
│ ├── magma.py # Magma Staking automation
│ ├── bima.py # Bima Deposit automation
│ ├── lilchogstars.py # Lil Chogstars NFT minting automation
│ ├── naddomains.py # NAD Domain registration automation
├── pvkey.txt # Private keys file (create manually)
├── address.txt # Recipient addresses file (optional for sendtx.py)
└── README.md # +_-