https://github.com/mesamirh/openverse-bot
An automated bot for interacting with the OpenVerse platform to perform daily tasks, claim rewards, and manage multiple wallet accounts efficiently.
https://github.com/mesamirh/openverse-bot
airdrop nodejs script web3js
Last synced: 7 months ago
JSON representation
An automated bot for interacting with the OpenVerse platform to perform daily tasks, claim rewards, and manage multiple wallet accounts efficiently.
- Host: GitHub
- URL: https://github.com/mesamirh/openverse-bot
- Owner: mesamirh
- Created: 2025-06-26T17:20:10.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-01T16:42:25.000Z (7 months ago)
- Last Synced: 2025-07-01T17:42:55.424Z (7 months ago)
- Topics: airdrop, nodejs, script, web3js
- Language: JavaScript
- Homepage: https://launch.openverse.network/#/home?referral_code=TTK5I6LN
- Size: 5.86 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 OpenVerse Automation Bot
An automated bot for interacting with the OpenVerse platform to perform daily tasks, claim rewards, and manage multiple wallet accounts efficiently.
## ✨ Features
- **Multi-Wallet Support**: Process multiple crypto wallets simultaneously
- **Automated Daily Check-ins**: Automatically perform daily sign-ins to earn points
- **tBTG Token Claiming**: Automatically claim test BitGold (tBTG) tokens
- **Session Management**: Handles authentication and session cookies automatically
- **Real-time Status Display**: Beautiful console output with color-coded status updates
- **Error Handling**: Robust error handling with detailed logging
- **Referral Support**: Built-in referral code system
## 📋 Prerequisites
- Node.js (v16 or higher)
- npm or yarn package manager
- Valid Ethereum wallet private key(s)
## 🛠️ Installation
1. **Clone the repository**:
```bash
git clone https://github.com/mesamirh/OpenVerse-Bot.git
cd OpenVerse-Bot
```
2. **Install dependencies**:
```bash
npm install
```
3. **Configure environment variables**:
- Copy the `.env.example` file to `.env`
- Add your wallet private keys and referral code
## ⚙️ Configuration
Create a `.env` file in the root directory with the following variables:
```env
# Paste your wallet private key here.
# Do NOT include the '0x' prefix.
# If you have multiple keys, separate them with a comma, e.g., key1,key2
PRIVATE_KEYS=your_private_key_without_0x_prefix
# The referral code to use for new accounts.
REFERRAL_CODE=TTK5I6LN
```
### Important Security Notes:
- ⚠️ **Never share your private keys**
- ⚠️ **Keep your `.env` file secure and never commit it to version control**
- ⚠️ **Remove the `0x` prefix from your private keys**
- ⚠️ **Use comma separation for multiple private keys**
## 🚀 Usage
Run the bot with:
```bash
node bot.js
```
The bot will:
1. Load all configured wallet accounts
2. For each account:
- Authenticate with the OpenVerse platform
- Display initial account status (points, tBTG balance)
- Perform daily check-in
- Claim tBTG tokens
- Display final account status
3. Process all accounts with appropriate delays between operations
## 📊 Bot Activities
The bot performs the following automated tasks:
| Task | Description | Reward |
| ------------------ | ----------------------------- | ----------- |
| **Daily Check-in** | Signs in daily to earn points | Points |
| **tBTG Claiming** | Claims test BitGold tokens | tBTG tokens |
## 🎨 Console Output
The bot provides colorful, real-time console output showing:
- 🔒 Authentication status
- ✍️ Message signing progress
- ✅ Successful operations
- ⚠️ Warnings and already completed tasks
- ❌ Errors and failures
- 👤 Account status with points and token balances
## 📁 Project Structure
```
openverse-bot/
├── bot.js # Main bot application
├── package.json # Node.js dependencies and scripts
├── .env # Environment configuration (not tracked)
├── .gitignore # Git ignore rules
└── README.md # This file
```
## 🔧 Dependencies
- **ethers**: Ethereum wallet and signing functionality
- **axios**: HTTP client for API requests
- **axios-cookiejar-support**: Cookie jar support for session management
- **tough-cookie**: Cookie parsing and management
- **chalk**: Terminal text styling and colors
- **dotenv**: Environment variable management
## 🐛 Troubleshooting
### Common Issues:
1. **"No private keys found"**
- Ensure your `.env` file exists and contains valid `PRIVATE_KEYS`
- Check that private keys don't include the `0x` prefix
2. **Login failures**
- Verify your private keys are valid
- Check your internet connection
- Ensure the OpenVerse platform is accessible
3. **Module import errors**
- Run `npm install` to ensure all dependencies are installed
- Check Node.js version compatibility
## 🔐 Security Best Practices
1. **Never commit `.env` files** to version control
2. **Use separate wallets** for automation (don't use your main wallet)
3. **Keep private keys secure** and never share them
4. **Regularly update dependencies** for security patches
5. **Monitor bot activity** and stop if unusual behavior occurs