SENTINELAI

SentinelAI: Autonomous Web3 Risk Guardian
What is it?
SentinelAI is a next-generation, autonomous security infrastructure designed to protect Web3 users and protocols from real-time on-chain threats. It combines a Deterministic Risk Engine with Automated Smart Contract Guards to provide a "fail-safe" layer for digital assets. Unlike passive monitoring tools that simply alert you after a hack, SentinelAI actively intervenes on-chain to neutralize threats before they result in loss.
What problem does it solve?
The current Web3 security landscape relies heavily on "Post-Mortem" analysis—users only realize they've been attacked after their wallet is drained. Major pain points include:

1. Approval Exploits: Users often have "infinite approvals" given to decentralized apps that can be maliciously exploited.
2. Reactive Security: Human reaction time is too slow to stop a programmed drainer or a flash-loan attack.
3. Complex Risk Assessment: Most users cannot distinguish between a safe contract interaction and a sophisticated phishing attempt.
   How does it work?
   SentinelAI operates through a three-tier architecture:
4. Surveillance & Analysis (The Brain):
5. The system monitors incoming transaction signals—such as wallet velocity, contract reputation scores, and approval percentages. It utilizes a FastAPI-based risk engine to calculate a real-time Asset Safety Index.
6. Chainlink Integration (The Oracle):
7. It leverages Chainlink Price Feeds to monitor market volatility and ensure that emergency locks or liquidations are triggered based on accurate, tamper-proof market data. This ensures the system doesn't "hallucinate" risk during periods of normal market movement.
8. Automated On-Chain Guard (The Shield):
9. When a risk score crosses a user-defined threshold (e.g., 75%), the system utilizes the GuardianVault smart contract to:
   • Emergency Lock: Immediately pauses all outgoing transfers from the protected wallet.
   • Revoke Approvals: Automatically identifies and revokes high-risk token approvals.
   • Blacklist: Flags malicious contracts across the network to protect other SentinelAI users.
10. Verifiable Execution:
11. Every risk decision is recorded as a "Snapshot" with verifiable logs, providing users with a clear audit trail of why an automated action was taken and the proof of the underlying risk signals.
    Summary
    SentinelAI transforms Web3 security from a notification system to an actuation system, ensuring that even if you are offline, your assets remain under the protection of a high-speed, deterministic guardian.

SentinelAI is engineered using a modern, high-performance stack that bridges real-time risk analysis with on-chain execution.

1. Core Architecture (The Brain)
   FastAPI (Python 3.12): A self-contained, high-performance backend deployed as a Vercel Serverless Function. It serves as the "Deterministic Risk Engine," processing wallet signals (velocity, reputation, approvals) to calculate real-time risk scores.
   Pydantic: Used for strict data validation of incoming telemetry and risk signals, ensuring the engine never processes malformed data.
2. Blockchain Layer (The Shield)
   Solidity (0.8.20): Robust smart contracts (GuardianVault.sol and SentinelGuardian.sol) deployed on the Sepolia Testnet.
   Chainlink Data Feeds: Integrated into the contracts to pull tamper-proof ETH/USD price data. This ensures that risk evaluations involving asset value and liquidations are accurate and decentralized.
   OpenZeppelin: Provides the industry-standard security foundations for AccessControl, Ownable, and emergency ReentrancyGuard logic.
3. Frontend & Experience (The Cockpit)
   React 19 + TypeScript: A type-safe, component-driven UI built for high reliability and speed.
   Vite: Next-generation build tool chosen for lightning-fast HMR and optimized production bundling.
   Wagmi & Viem: The primary Web3 hooks and utilities used for wallet connection, contract interaction, and real-time transaction tracking across the EVM.
   Framer Motion: Powers the sophisticated "Liquid UI" animations, including the dynamic Risk Gauge and the Surveillance Terminal.
   Lucide React: Provides the high-fidelity iconography for the professional "Web3 Guardian" aesthetic.
4. Deployment & DevOps
   Vercel: Hosts the entire monorepo, managing the routing between the React frontend at / and the FastAPI serverless functions at /api/*.
   Automated Pipeline: Every push to the main branch triggers a multi-stage build that compiles the TypeScript frontend and validates the Python dependencies simultaneously.