Eagle-AS0/Defi-Security-BlockDAG

# 🔐 DeFi 安全层 — BlockDAG Hackathon 项目 欢迎使用 **DeFi Security - BlockDAG**，这是一个实时、AI 驱动的模块化安全层，旨在保护去中心化金融 协议免受欺诈、闪电贷攻击和其他智能合约漏洞的影响。该系统专为 **BlockDAG Hackathon** 构建，结合了异常检测和智能合约防护机制，为 DeFi 应用提供即插即用的保护。 ## 📌 项目概述与目的 在快速发展的 DeFi 领域，安全漏洞继续构成重大风险。本项目引入了一个模块化、可编程的 AI 驱动的 middleware，用于实时检测、预防和响应威胁。通过结合智能合约、oracles 和 AI 异常检测，旨在保护保险库、流动性池和协议的完整性。 ## 🚀 目标 为 DeFi 协议构建一个**可编程、即插即用的 middleware**，使其能够： - 使用 AI 检测欺诈和异常行为 - 监控保险库和流动性事件 - 防止重入、闪电贷和管理员滥用 - 包含熔断机制和链上治理机制 ## 🧱 架构概述 ### 1. 智能合约防护机制 - 使用 **Solidity** 编写 - 作为用户与协议保险库之间的 middleware - 功能特点： - 重入保护 - 保险库访问控制 - 针对敏感操作的管理员时间锁 ### 2. 链上监控 Oracle - 兼容 Chainlink 的自定义 oracle - 追踪关键指标： - 交易频率 - 流动性池深度 - 钱包交互类型 - 将实时数据流传输至链下分析引擎 ### 3. AI 驱动的异常检测 - 使用 **Python**、**Flask** 和 **scikit-learn** 构建 - 使用的模型包括： - Isolation Forest - One-Class SVM - 检测： - 交易量激增 - 异常提款时间 - 混淆的合约调用 ### 4. 日志、警报与治理 - **日志存储在 IPFS 上**，以实现防篡改的审计跟踪 - 通过 WalletConnect 实时向 Web3 钱包发送**警报** - **React dashboard** 显示： - 协议风险指数 - 活动警报 - 保险库状态 ## 🛠 技术栈 | 层级 | 技术栈 | | --------------- | ------------------------------------ | | 智能合约 | Solidity, Hardhat | | Oracles | Chainlink, The Graph | | 后端 (AI) | Python, Flask, Web3.py, scikit-learn | | 前端 | React.js, Ethers.js | | 通知 | MetaMask, WalletConnect | | 日志 | IPFS | ## 📁 项目结构 ``` . ├── contracts/ # Solidity contracts: Guard, Vault, Oracle, Token ├── frontend/ # React app files: app.js, index.html, style.css ├── ai-backend/ # Flask backend: app.py, train_model.py, predict.py ├── artifacts/, build-info/ # Compiled contract files ├── features.csv # Extracted features for training ├── model.pkl # Trained ML model ├── test_monitor.py # AI anomaly monitor ├── server.js # Optional Node.js server for API layer ├── requirements.txt # Python dependencies └── README.md # Project documentation (this file) ``` ## 💻 安装说明 ``` # 克隆 repository git clone https://github.com/Eagle-AS0/Defi-Security-BlockDAG.git cd Defi-Security-BlockDAG # 安装 Python 依赖 cd ai-backend pip install -r requirements.txt # 编译 smart contracts cd ../contracts npx hardhat compile # 启动 frontend（示例） cd ../frontend npm install npm start ``` ## ▶️ 使用说明 1. 启动后端 Flask 应用以启用 AI 监控： ``` python app.py ``` 2. 通过 Hardhat 部署智能合约： ``` npx hardhat run scripts/deploy.js --network localhost ``` 3. 通过 `http://localhost:3000` 访问 React dashboard 4. 通过 MetaMask 与 Vault 智能合约进行交互，并查看实时警报 5. 查看存储在 IPFS 上的日志并动态监控风险评分 ## ✅ 核心功能 - 模块化防护智能合约 - 实时 oracle 监控 - 基于实时 AI 的欺诈检测 - 基于 IPFS 的日志存储 - MetaMask/WalletConnect 治理警报 - 全栈集成（Solidity + Python + React） ## 📊 演示 Dashboard