IMPORTANT: Clone from https://github.com/ThanhNguyxn/SheerID-Verification-Tool Thank bro ThanhNguyxn. You are the best

🎓 SheerID Verification Bot (TypeScript)

A powerful, modular Telegram bot for automating Student, Teacher, and Military verifications via SheerID. Built with TypeScript, Grammy, and Bun.

🚀 Features

• Multi-Service Support:

  • 🎵 Spotify Premium Student (/spotify)
  • 🎬 YouTube Premium Student (/youtube)
  • 🤖 Google One AI Premium (Gemini) (/gemini)
  • ⚡ Bolt.new Teacher Discount (/boltnew)
  • 🏫 ChatGPT Plus K12 Teacher (/k12) - Auto-pass supported
  • 🧠 Perplexity Pro Student (/perplexity) - Groningen Bypass
  • 🎨 Canva for Education (/canva) - Document Generator
  • 🪖 ChatGPT Plus Veterans (/veterans) - API Integration

• Advanced Verification:

  • 📄 Document Generation: Auto-generates Transcripts, ID Cards, and Employment Certificates.
  • 🛡️ Anti-Detect: Random User-Agents, TLS Fingerprinting (via HttpClient), and Proxy Rotation.
  • 🔄 Auto-Recovery: Automatically generates fresh Verification IDs if the link is expired or burned.
  • 📊 Statistics: Tracks success rates per University/Organization.

---

🛠️ Prerequisites

• Bun (v1.0 or higher)
• Python 3.10+ (For TLS Fingerprint Service)
• Telegram Bot Token (from @BotFather)
• Proxies (Recommended): Residential proxies for proxies.txt.

---

⚡ Quick Start

1. Install Dependencies

   bun install

2. Setup Python TLS Service (Required for Anti-Detect) The bot uses a Python microservice to spoof Chrome TLS fingerprints.

   cd python_service
   
   # Create and activate virtual environment (Recommended)
   python3 -m venv venv
   source venv/bin/activate
   
   # Install dependencies
   pip install -r requirements.txt
   
   # Run the server
   python3 -m uvicorn tls_server:app --port 8000

3. Configure Environment Create a .env file in the root directory:

   # Required
   TELEGRAM_BOT_TOKEN="your_telegram_bot_token_here"
   
   # Optional
   CHATGPT_ACCESS_TOKEN="your_access_token_here"  # For /veterans command
   PROXY_URL="http://user:pass@host:port"         # Global proxy fallback

4. Setup Proxies Add your proxies to proxies.txt (one per line):

   http://user:pass@host:port
   http://user:pass@host2:port
   

5. Run the Bot

   # Development (Watch mode)
   bun run dev
   
   # Production
   bun start

---

🤖 Bot Commands

Command	Usage	Description
/start	/start	Show the main menu.
/spotify	/spotify <url>	Verify Spotify Student.
/youtube	/youtube <url>	Verify YouTube Student.
/gemini	/gemini <url>	Verify Gemini Advanced (US Only).
/boltnew	/boltnew <url>	Verify Bolt.new Teacher.
/k12	/k12 <url>	Verify ChatGPT K12 Teacher.
/perplexity	/perplexity <url>	Verify Perplexity Pro (Dutch Bypass).
/canva	/canva	Generate Canva Teacher ID (Manual Upload).
/veterans	/veterans	Verify ChatGPT Veterans (No URL needed).
/stats	/stats	View success rates and top universities.
/help	/help	Show detailed usage instructions.

---

⚙️ Architecture & Flow

graph TD
    User((User)) -->|Sends Command| Bot[TelegramBot]
    
    Bot -->|Parses URL| Service[VerificationService]
    
    subgraph Verifiers
        Service -->|/spotify, /youtube| SV[StudentVerifier]
        Service -->|/boltnew| TV[TeacherVerifier]
        Service -->|/k12| KV[K12Verifier]
        Service -->|/perplexity| PV[PerplexityVerifier]
        Service -->|/veterans| VV[VeteransVerifier]
        Service -->|/canva| CV[CanvaVerifier]
    end
    
    subgraph Core
        SV & TV & KV & PV & VV -->|Requests| Http[HttpClient]
        Http -->|Rotates| Proxy[Proxy Manager]
        Http -->|Sets| UA[User-Agent / Fingerprint]
        
        SV & TV & CV -->|Generates| Doc[DocumentGenerator]
        Doc -->|Canvas API| Image[ID Card / Transcript]
    end
    
    Http -->|API Calls| SheerID[SheerID API]
    Doc -->|Uploads| S3[SheerID S3 Bucket]
    
    SheerID -->|Response| Bot
    Bot -->|Success Message| User

Loading

---

📂 Project Structure

by_ts/
├── src/
│   ├── bot/                # Telegram Bot Handlers
│   │   ├── TelegramBot.ts
│   │   └── HelpMessages.ts # Detailed Usage Guides
│   ├── core/               # Core Utilities
│   │   ├── HttpClient.ts   # Fetch wrapper with Proxies/AntiDetect
│   │   ├── AntiDetect.ts   # Headers & Fingerprinting
│   │   └── DocumentGenerator.ts # Image Generation (Canvas)
│   ├── data/               # Static Data
│   │   ├── universities.ts # University list with weights
│   │   └── names.ts        # Random Identity Generator
│   ├── services/           # Business Logic
│   │   └── VerificationService.ts
│   ├── verifiers/          # Logic for specific services
│   │   ├── StudentVerifier.ts
│   │   ├── TeacherVerifier.ts
│   │   ├── PerplexityVerifier.ts
│   │   ├── VeteransVerifier.ts
│   │   └── ...
│   ├── config.ts           # Constants & API Config
│   └── index.ts            # Entry Point
├── proxies.txt             # Proxy List
├── stats.json              # Persistent Statistics
├── package.json            # Dependencies & Scripts
└── tsconfig.json           # TypeScript Config

⚠️ Important Notes

1. Proxies: High-quality Residential Proxies (US/UK/NL depending on service) are strongly recommended to avoid fraudRulesReject.
2. VPN:
   • Perplexity: Requires Netherlands VPN/Proxy.
   • Others: Generally require US VPN/Proxy.
3. Veterans: Requires a valid CHATGPT_ACCESS_TOKEN either in .env or passed as an argument.

🤝 Contributing

This project is for educational purposes. Pull requests are welcome to add new verifiers or improve success rates.

---

❓ Troubleshooting

Python externally-managed-environment Error

If you see this error when installing requirements:

error: externally-managed-environment
× This environment is externally managed

It means your OS requires a virtual environment. The Quick Start guide uses venv to handle this. Ensure you run:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt