Your 24/7 On-Chain Security Analyst

ChainSage Documentation

🚀 Quick Start

ChainSage is an AI-powered blockchain security platform that detects risks, exploits, and market manipulations in real-time across DeFi protocols and NFT collections.

Live Demo | Get Started | API Docs

---

📋 Table of Contents

1. Overview

2. Vision & Mission

3. Product Roadmap

4. Features by Wave

5. Technical Architecture

6. User Guides

7. API Documentation

8. Team

9. Contributing

---

Overview

What is ChainSage?

ChainSage acts as your personal blockchain security analyst, monitoring thousands of transactions, smart contracts, and market movements every second to detect threats before they cause losses.

Try ChainSage now: https://chainsage-app.vercel.app/

Key Benefits

• Real-time Detection: Identify risks within minutes, not hours

• AI-Powered Analysis: Advanced pattern recognition for subtle threats

• Multi-Chain Support: Monitor across Ethereum, Polygon, BSC, and Base

• Predictive Intelligence: Move from reactive to proactive security

• Custom Alerts: Get notified exactly when and how you want

Who Uses ChainSage?

• DeFi Traders & Investors - Detect risks before losses occur

• NFT Collectors & Founders - Early warnings on scams and rug pulls

• Security Analysts - Actionable intelligence without manual research

• Institutions & DAOs - Automated monitoring of on-chain exposure

---

Vision & Mission

Our Vision

To become the definitive early warning system for blockchain security, protecting millions in digital assets through intelligent automation.

Why ChainSage Exists

On-chain markets move at breakneck speed. A single exploit or whale move can cause millions in losses within minutes. Manual monitoring is not only slow but misses subtle patterns like:

• Liquidity drains

• Flash loan attacks

• Coordinated floor sweeps

• Governance exploits

• Rug pull patterns

How 0g Network Enables This

• Scalable Data Indexing: Pull and process blockchain activity with near-zero latency

• Distributed AI Hosting: Low-cost, high-availability analytics without centralized bottlenecks

• Event-Triggered Pipelines: Instant reaction to on-chain events vs. batch processing

---

Product Roadmap

Our development follows a systematic 6-wave approach, each building upon the previous to create a comprehensive security platform.

Wave 1: MVP → Wave 2: AI Detection → Wave 3: Alerts → Wave 4: Analytics → Wave 5: Predictive → Wave 6: Launch

Timeline Overview

• Wave 1-2: 2025 (Foundation & AI)

• Wave 3-4: 2025 (Alerts & Analytics)

• Wave 5-6: 2025 (Predictive & Launch)

---

Features by Wave

Wave 1: MVP - Real-Time Data Foundation

Goal: Build the foundation for monitoring blockchain activity

Core Features:

• Real-time monitoring of blockchain networks, DeFi protocols, and NFT collections

• Basic risk detection & alerts (Low, Medium, High severity)

• Live risk feed dashboard with filtering capabilities

• One-click watchlist for addresses and contracts

• Manual search for addresses and contracts

Key Metrics Displayed:

• Active Alerts: 138 (+4.1%)

• High Severity Alerts: 9 (+1)

• Monitored Assets: 68

Team Responsibilities:

• East: Basic frontend dashboard & data display

• Amity: API integration for live blockchain feeds

• Oscar: Backend server to process and serve data

---

Wave 2: AI-Powered Risk Detection

Goal: Add intelligence to raw data

Core Features:

• AI model classification (Normal, Suspicious, Risky)

• Colored severity tags with intelligent scoring

• Alert detail pop-ups with AI risk analysis

• Detection of common DeFi exploits & rug patterns

• Unusual wallet activity highlighting

• Subscribe button for Telegram/Email/Discord alerts

Risk Scoring System:

• Dynamic AI-powered risk assessment

• Visual risk score bars (Drop → Medium → High)

• Detailed risk explanations for each alert

Team Responsibilities:

• Oscar: Backend AI pipeline with pre-trained models

• Amity: Smart contract monitoring hooks

• East: Visual risk indicators in UI

---

Wave 3: Customizable Alerts

Goal: Give users complete control over monitoring

Core Features:

• Comprehensive watchlists for tokens, wallets, and NFT collections

• Custom risk threshold settings (Low to High slider)

• Multi-channel alerts: Email, Telegram, Discord

• Filtered alert feed with real-time updates

• Notification preferences and timing controls

Alert Management:

• Categorized watchlists (Tokens, Wallets, NFT Collections)

• Granular risk threshold controls

• Real-time filtered feed showing relevant alerts only

• Multi-platform notification delivery

Team Responsibilities:

• East: Alert preference UI and notification settings

• Oscar: Notification service backend architecture

• Amity: Custom subscription logic for blockchain events

---

Wave 4: Deep Analytics & Reports

Goal: Make insights actionable with comprehensive analysis

Core Features:

• Historical risk analysis and trend identification

• AI-generated daily digest of top risks

• Risk frequency and exploit type trend charts

• Comprehensive whale movement analysis

• Cross-protocol risk correlation tracking

Analytics Components:

• Daily Digest: AI-generated summaries (e.g., "Uniswap V3 had elevated risk activity yesterday")

• Risk Over Time: Historical trend visualization

• Exploit Frequency: Flash loan, reentrancy, and phishing attack tracking

• Whale Movements: Large transaction monitoring and analysis

Team Responsibilities:

• East: Analytics dashboard UI and data visualization

• Oscar: Data aggregation & summarization backend

• Amity: Database optimization for complex historical queries

---

Wave 5: Advanced AI & Predictive Insights

Goal: Move from reactive to predictive intelligence

Core Features:

• Advanced risk prediction modeling (42% upcoming risks shown)

• Cross-chain pattern recognition and correlation

• Natural language querying ("Which NFT collections are most at risk?")

• Predictive risk trend analysis

• Cross-project vulnerability correlation

Predictive Capabilities:

• Risk Prediction: This Week vs Next Week forecasting

• Cross-Chain Patterns: Multi-blockchain threat correlation

• Related Projects: Vulnerability pattern matching across protocols

• Natural Queries: Conversational risk analysis interface

Team Responsibilities:

• Oscar: AI model training & inference systems

• Amity: Cross-chain monitoring and data correlation

• East: Conversational query interface development

---

Wave 6: Full-Scale Launch & Integrations

Goal: Transform ChainSage into a publicly accessible platform

Core Features:

• Public user authentication and account management

• Tiered pricing plans (Free, Pro, Enterprise)

• Developer API access with comprehensive documentation

• Strategic partnerships with wallets and DApps

• Embedded risk detection for third-party platforms

Launch Components:

• User onboarding and authentication system

• Subscription and billing management

• Public API with rate limiting and documentation

• Integration SDKs for wallet and DApp partners

• Enterprise-grade SLA and support

Team Responsibilities:

• East: User authentication, pricing plans, and account management UI

• Amity: API design, documentation, and external integrations

• Oscar: Backend scaling, deployment, and infrastructure optimization

---

Technical Architecture

System Overview

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Blockchain    │    │    ChainSage     │    │      Users      │
│   Networks      │───▶│   AI Pipeline    │───▶│   Dashboard     │
│                 │    │                  │    │   & Alerts      │
└─────────────────┘    └──────────────────┘    └─────────────────┘

Key Components

Data Ingestion Layer:

• Blockchain APIs: Etherscan, Moralis, Covalent, Reservoir

• Real-time WebSocket connections

• Multi-chain data normalization

AI Processing Engine:

• Anomaly detection models

• Pattern recognition algorithms

• Risk scoring and classification

• Predictive modeling pipeline

0g Network Integration:

• Scalable data indexing

• Distributed AI model hosting

• Event-triggered processing pipelines

Frontend Architecture:

• React-based dashboard

• Real-time data visualization

• Responsive design for mobile/desktop

• Dark theme optimized for monitoring

---

User Guides

Getting Started

1. Access the Dashboard

   • Navigate to ChainSage Platform

   • View the real-time risk feed immediately

   • No registration required for basic monitoring

2. Understanding Risk Levels

   • High (Red): Immediate attention required - potential exploits or major risks

   • Medium (Yellow): Monitor closely - suspicious activity detected

   • Low (Green): Informational - notable but non-critical events

3. Setting Up Monitoring

   • Add wallets, tokens, or NFT collections to your watchlist

   • Configure risk thresholds based on your risk tolerance

   • Enable notifications via Email, Telegram, or Discord

Dashboard Navigation

Main Sections:

• Dashboard: Real-time risk feed and key metrics

• Alerts: Customizable alert management

• Search: Manual lookup of addresses and contracts

• Monitoring: Watchlist and filter management

• Settings: Account and notification preferences

Risk Feed Features:

• Color-coded severity indicators

• Timestamp tracking for all events

• Detailed descriptions with actionable insights

• One-click access to blockchain explorers

Setting Up Alerts

1. Create Watchlists

   • Navigate to the Alerts section

   • Add tokens, wallets, or NFT collections

   • Organize by categories for easy management

2. Configure Thresholds

   • Set risk sensitivity (Low to High)

   • Choose notification channels

   • Set frequency preferences

3. Manage Notifications

   • Test alert delivery

   • Adjust timing and frequency

   • Filter by severity or asset type

---

API Documentation

Authentication

All API requests require authentication via API key:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.chainsage.io/v1/alerts

Core Endpoints

Get Real-time Alerts

GET /v1/alerts

Parameters:

• severity: Filter by risk level (high, medium, low)

• network: Blockchain network (ethereum, polygon, bsc, base)

• limit: Number of results (max 100)

Response:

{
  "alerts": [
    {
      "id": "alert_123",
      "severity": "high", 
      "description": "Smart Contract Exploit Alert",
      "asset": "0x7d...1294",
      "network": "ethereum",
      "timestamp": "2025-01-15T10:30:00Z",
      "risk_score": 85
    }
  ]
}

Add to Watchlist

POST /v1/watchlist

Body:

{
  "address": "0x1234...",
  "type": "wallet|contract|nft_collection",
  "network": "ethereum",
  "risk_threshold": "medium"
}

Get Historical Analytics

GET /v1/analytics/trends

Parameters:

• timeframe: Time period (24h, 7d, 30d)

• metric: Type of analysis (exploits, whale_movements, nft_volatility)

Rate Limits

• Free Tier: 100 requests/hour

• Pro Tier: 1,000 requests/hour

• Enterprise: Custom limits

Webhooks

Configure webhooks to receive real-time alerts:

{
  "url": "https://your-domain.com/webhook",
  "events": ["high_risk_alert", "whale_movement"],
  "secret": "your_webhook_secret"
}

---

Team

Core Development Team

You - Project Lead & Strategist

• Project coordination and team management

• Documentation oversight and submission compliance

• Strategic planning and milestone tracking

• Quality assurance and deliverable coordination

East - Frontend Development

• Dashboard UI/UX design and implementation

• User authentication and account management

• Alert interface and visualization systems

Amity - Blockchain Integration

• API integration for live blockchain feeds

• Smart contract monitoring and analysis

• Cross-chain data correlation and processing

Oscar - Backend & AI Engineering

• AI pipeline development and model training

• Backend architecture and data processing

• Notification systems and API development

Contribution Opportunities

We welcome contributions in:

• Security research and threat intelligence

• UI/UX improvements and feedback

• API integrations and tooling

• Documentation and tutorials

---

Contributing

Development Setup

1. Clone the Repository

    git clone https://github.com/chainsage/chainsage
    cd chainsage
   

2. Install Dependencies

    npm install
    # or
    yarn install
   

3. Environment Configuration

    cp .env.example .env
    # Configure your API keys and database connections
   

4. Start Development Server

    npm run dev
   

Contribution Guidelines

• Follow our coding standards and style guide

• Include tests for all new features

• Update documentation for API changes

• Submit detailed pull requests with clear descriptions

Reporting Issues

• Use GitHub issues for bug reports

• Include reproduction steps and environment details

• Security vulnerabilities should be reported privately

---

Support & Community

Get Help

• Documentation: Complete guides and API reference

• Discord Community: Real-time chat and support (coming Soon)

• GitHub Issues: Bug reports and feature requests

• Email Support: (coming Soon)

Platform Access

• Main Application: https://chainsage-app.vercel.app/

• Github Repository: https://github.com/orgs/Teamerz1111

• Landing Page: https://chainsage-landing.onrender.com/

Stay Updated

• Twitter: https://x.com/Adam_shelbie - Latest updates and alerts

• Blog: In-depth security analysis and platform updates

• Newsletter: Weekly digest of blockchain security trends (coming soon)

---

License

ChainSage is released under the MIT License. See LICENSE file for details.

---

Built with ❤️ by the ChainSage team. Protecting the future of decentralized finance.