GetGrassBot

A CLI tool for automating Grass network operations. Supports account generation, farming (WebSocket bandwidth sharing), account checking, points checking, network score checking, reward claiming, email verification, and email change requests.

Features

• Account Generation -- Bulk-register Grass accounts with CAPTCHA solving via CapMonster
• Farming -- Connect accounts to the Grass network via WebSocket proxies
• Account Checker -- Validate account credentials
• Points Checker -- Retrieve epoch earnings for each account
• Network Score Checker -- Check IP scores for active devices
• Reward Claimer -- Automatically claim available rewards
• Email Verifier -- IMAP-based email verification (Outlook OAuth2)
• Email Change -- Request email changes on accounts

Prerequisites

• Go 1.20+
• A CapMonster API key (for account generation and farming login)
• Residential proxies (recommended)

Installation

git clone https://github.com/YOUR_USERNAME/GetGrassBot.git
cd GetGrassBot/GetGrass
go mod download

Configuration

1. Copy the example config files:

cd cli/settings
cp settings.example.json settings.json
cp proxies.example.txt proxies.txt
cp Tasks.example.csv Tasks.csv
cp tools.example.csv tools.csv
cp emails.example.txt emails.txt

2. Edit settings.json with your CapMonster API key, Discord webhook URL, and referral code.

3. Add your proxies to proxies.txt (one per line, format: ip:port:user:pass).

4. For farming, populate Tasks.csv with accounts:

email,password,proxy,deviceid
[email protected],password123,1.2.3.4:8080:user:pass,

Device IDs are auto-generated on first run if left blank.

5. For checking/claiming, populate tools.csv:

[email protected],password123,1.2.3.4:8080:user:pass

Environment Variables (optional, for Discord OAuth gate)

export DISCORD_CLIENT_ID="your_client_id"
export DISCORD_CLIENT_SECRET="your_client_secret"
export DISCORD_SERVER_ID="your_server_id"

Usage

cd GetGrass/cli
go run .

The interactive menu offers:

1. Gen Accounts
2. Farm
3. Check Accounts
4. Check Points
5. Check Network Scores
6. Update Settings
7. Claim Rewards

Project Structure

GetGrass/
  cli/              # CLI entry point and menu logic
    settings/       # Config files (gitignored, examples provided)
  internal/         # Shared libraries (tasks, sessions, files, colors, IMAP)
  modules/          # Feature modules
    farmer/         # WebSocket farming
    gen/            # Account registration
    checker/        # Account validation
    pointschecker/  # Points retrieval
    networkscorechecker/  # IP score checking
    autoclaimer/    # Reward claiming
    verifier/       # IMAP email verification
    emailchangerequest/   # Email change requests

Disclaimer

This tool is provided for educational and research purposes. Automated interaction with Grass may violate their Terms of Service. Use responsibly and at your own risk. The authors are not responsible for any consequences of using this software.