Skip to content

imthegoodboy/ChainGuard

Repository files navigation

ChainGuard AI

AI-Powered Smart Contract Security Guardian built on Polygon

ChainGuard AI

Overview

ChainGuard AI is an autonomous AI-powered smart contract security platform that provides real-time vulnerability detection and continuous monitoring for smart contracts on the Polygon network. We make enterprise-grade security accessible to every developer at a fraction of traditional audit costs.

The Problem: $3.8B lost annually to smart contract exploits. Traditional audits cost $50K+ and take weeks.

Our Solution: AI-powered security scans in seconds for $49/month. Real-time monitoring. Plain English recommendations.

Key Features

🛡️ Pre-Deployment Shield

  • Upload Solidity files or paste GitHub URLs
  • AI analyzes code in 2-3 seconds
  • Detects 50+ vulnerability types
  • Plain English explanations
  • Actionable fix recommendations

👁️ Live Guardian Mode (Pro)

  • 24/7 contract monitoring
  • Real-time threat detection
  • Instant security alerts
  • Anomaly detection
  • Optional auto-pause functionality

🌐 Community Defense Network

  • Network learns from every attack
  • Instant protection updates for all users
  • Collective security intelligence
  • Zero-day threat sharing

⚡ Why Polygon?

  • Ultra-Low Fees: $0.01 transactions vs. $50+ on Ethereum
  • Lightning Fast: 2-second block times
  • Scalable: Monitor thousands of contracts
  • EVM Compatible: Works with existing tools

Quick Start

Prerequisites

  • Node.js 18+
  • MetaMask wallet
  • Polygon network access

Usage

For Users

  1. Sign Up: Create a free account (5 free scans included)
  2. Scan Contract: Upload .sol file or paste GitHub URL
  3. Review Results: Get instant security report with risk score
  4. Fix Issues: Follow plain English recommendations
  5. Deploy Safely: Re-scan to verify fixes

For Pro Users

  1. Connect Wallet: Link MetaMask to your account
  2. Upgrade: Subscribe for $49/month in MATIC
  3. Monitor Contracts: Add deployed contracts for 24/7 monitoring
  4. Get Alerts: Receive real-time security notifications

Architecture

Tech Stack

  • Frontend: React 18 + TypeScript + Tailwind CSS
  • Backend: Supabase (PostgreSQL + Auth)
  • Blockchain: Polygon (ethers.js v6)
  • AI/ML: Pattern matching + behavioral analysis

Database Schema

  • profiles: User accounts and subscription tiers
  • contract_scans: Scan history and results
  • monitored_contracts: Live monitoring configurations
  • security_alerts: Real-time threat notifications
  • payments: Transaction records

Pricing

Free Tier

  • 5 pre-deployment scans
  • Basic vulnerability detection
  • Plain English recommendations

Pro - $49/month

  • Unlimited scans
  • Live monitoring (3 contracts)
  • Real-time alerts
  • Advanced AI detection

Enterprise - Custom

  • Unlimited everything
  • Dedicated AI model
  • Custom integrations
  • 24/7 priority support

Vulnerability Detection

ChainGuard AI detects:

  • ✅ Reentrancy attacks
  • ✅ Integer overflow/underflow
  • ✅ Gas limit issues
  • ✅ Access control flaws
  • ✅ Timestamp dependence
  • ✅ Delegate call risks
  • ✅ Self-destruct vulnerabilities
  • ✅ tx.origin authentication
  • ✅ Unchecked external calls
  • ✅ And 40+ more patterns

Documentation

For comprehensive documentation, see CHAINGUARD_AI_DOCUMENTATION.md

Topics covered:

  • Complete feature guide
  • How it works (technical deep dive)
  • Business model
  • User flows
  • Security & privacy
  • Competitive advantages
  • Future roadmap

Security

Data Protection

  • Row Level Security (RLS) on all database tables
  • Users can only access their own data
  • No storage of private keys or seed phrases
  • Passwords hashed with bcrypt

Blockchain Security

  • Non-custodial wallet connection
  • User approves all transactions
  • Read-only contract monitoring
  • Transparent on-chain operations

Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Roadmap

Current (Q1 2024)

  • Core scanning engine
  • User authentication
  • Wallet connection
  • Free tier (5 scans)
  • Pro tier ($49/month)

Next (Q2 2024)

  • Live monitoring launch
  • Real-time alerts
  • Discord/Slack integration
  • API access

Future

  • Neural network-based detection
  • Multi-chain support
  • CI/CD integration
  • DAO governance token

WaveHack Feature Updates

  • Added a global light/dark theme toggle in the navigation bar, with preference persisted using local storage and Tailwind CSS dark mode for a more polished UI.
  • Enhanced the Smart Contract Scanner page with a Download JSON action so users can export detailed vulnerability reports for audits and documentation.
  • Added an interactive severity filter on scan results (All / Critical / High / Medium / Low) so users can focus on the most important issues first.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ for the Polygon community

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published