VigilBot

VigilBot is a sophisticated, full-stack blockchain-based trading bot detection and analytics platform that leverages cutting-edge Web3 technologies to identify, classify, and monitor automated trading activities on decentralized exchanges in real-time. The system combines smart contract technology, oracle price feeds, and advanced behavioral analysis to create a comprehensive bot detection ecosystem.

What This Project Does: VigilBot monitors blockchain transactions and analyzes trading patterns to detect three categories of traders:

Human Traders (Score 0-39): Regular users with natural trading patterns Good Bots (Score 40-59): Beneficial automated traders like market makers and arbitrage bots that provide liquidity Bad Bots (Score 60-100): Malicious bots engaged in front-running, wash trading, and market manipulation Core Capabilities: Real-time Bot Detection Engine Monitors blockchain events continuously using Ethereum event listeners Analyzes reaction times between Pyth Network price updates and trade executions Detects ultra-fast reactions (<1 second) indicative of automated trading Identifies repetitive patterns, high-frequency trading, and suspicious timing Smart Contract Integration BotDetectorWithPyth Contract deployed on Ethereum Sepolia testnet at 0x2cC7fD19b0953a1C8E5eea66AbAB89977A4619e2 Stores immutable on-chain evidence of bot behavior Integrates Pyth Network oracle for verifiable price data Implements role-based access control (Admin, Bot Analyzer) Blocks bad bots from executing trades on-chain Maintains separate registries for good and bad bots Pyth Network Integration Real-time price streaming via Hermes WebSocket API Sub-second price updates for BTC/USD, ETH/USD, SOL/USD Cryptographically signed price proofs stored on-chain Enables precise reaction time calculations Multi-Page Frontend Application

1. Cover Page ( CoverPage.tsx )

Landing page with animated features showcase Displays platform statistics (10K+ transactions analyzed, 95.8% accuracy) Shows technology stack and network information Entry points to dashboard and payment pages 2. Payment Page ( PaymentPage.tsx )

Three-tier subscription system: Basic Access: Free (1 month) - Full dashboard access Standard Access: 0.12 ETH (3 months) - Priority support Pro Access: 0.45 ETH (12 months) - Advanced analytics + API access MetaMask wallet integration for payments Real-time ETH/USD price conversion via CoinGecko API Secure on-chain payment processing to address 0x76D7D56fb21A6969E1F07B722e3c63E2c80a7cB1 Supabase integration for subscription management 3. Main Dashboard ( Dashboard.tsx )

Live Market Data: Real-time cryptocurrency prices with Pyth Network feeds Bot Detection Overview: Summary of detected good/bad bots User Analytics: Personal trading statistics and bot score Bot Detection Scan: Manual address scanning functionality Detected Bots Tables: Separate views for good and bad bots Wallet Integration: Connect/disconnect MetaMask, copy address functionality Subscription Status: Display active tier and expiration 4. Admin Dashboard ( AdminDashboard.tsx )

Admin Panel: Flag/unflag bots, manage detection settings Bot Summary Statistics: Total counts, risk levels, liquidity metrics Bot Management Tables: Detailed views with filtering and sorting Bulk Operations: Flag multiple pending bots simultaneously Evidence Review: View on-chain proof and reaction times 5. Additional Pages:

Analytics Page: Historical data visualization and trend analysis Profile Page: User account management and settings Settings Page: Customize notifications and preferences Bot Detection Algorithm Scoring System (0-100 points):

Ultra-Fast Reaction (+30 pts): Trade within 1 second of price update High Frequency (+20 pts): >10 trades per hour Repetitive Patterns (+15 pts): Similar amounts, regular intervals Price Movement Timing (+20 pts): Trades clustered around volatility Liquidity Provision (-20 pts): Market-making behavior (good bot indicator) Evidence Storage:

Reaction time in milliseconds Price at trade execution (from Pyth) Trade timestamp vs. price publish time Bot category classification Liquidity provided (for good bots)

Blockchain Layer Solidity 0.8.19: Smart contract development Hardhat v2.26.3: Development environment and testing framework Ethers.js v5.7.2: Blockchain interaction library Pyth Network SDK: Oracle integration for price feeds Ethereum Sepolia Testnet: Deployment network (Chain ID: 11155111) Infura: RPC provider for blockchain connectivity Backend (Node.js + Express) Express 5.1.0: Web framework with ES modules Pyth Hermes Client v2.0.0: Real-time price feed streaming WebSocket (ws): Bidirectional real-time communication Winston 3.18.3: Structured logging with file rotation Morgan 1.10.1: HTTP request logging CORS: Cross-origin resource sharing dotenv: Environment variable management Frontend (React + TypeScript + Vite) React 18.3: UI framework with hooks TypeScript: Type-safe development Vite: Lightning-fast build tool with HMR (Hot Module Replacement) TailwindCSS: Utility-first CSS framework for modern styling Ethers.js v6.x: Ethereum wallet integration Lucide React: Beautiful icon library (1000+ icons) React Router: Client-side routing Supabase Client: Backend-as-a-Service integration Recharts: Data visualization and charting Pyth + Smart Contract: Partner Technologies: Contract imports Pyth SDK interfaces Stores Pyth contract address on deployment Calls pyth.updatePriceFeeds() with signed price data Retrieves verified prices with pyth.getPriceNoOlderThan() Hardhat + Pyth:

Mock Pyth contract for local testing Test price update mechanisms Verify gas costs of Pyth integration Deploy to Sepolia with real Pyth oracle Backend + Pyth:

Hermes client for HTTP price queries WebSocket for real-time price streaming Price caching to reduce API calls Broadcast prices to multiple frontend clients One of the biggest benefit of using hardhat is easy debugging using console.log and also gas optimization tests.