0xGavana/defiscanner
GitHub: 0xGavana/defiscanner
一款基于 Python 构建的命令行 DeFi 协议综合风险扫描器，覆盖合约安全、TVL 异常监控、漏洞特征匹配、治理风险与流动性分析五大维度。
Stars: 3 | Forks: 0
# DeFi Scanner 🔍
**基于 CLI 的 DeFi 协议风险扫描器** — 智能合约分析、TVL 监控、漏洞检测、治理风险评估以及流动性分析。
使用 Python、Click 和 Rich 构建，提供精致的终端体验。
## 功能
- **Contract Scanner** — 检测代理模式（EIP-1967）、selfdestruct 操作码、delegatecall 用法以及升级机制
- **TVL Scanner** — 监控总锁仓量以发现异常情况：突然下跌 >20%，巨鲸集中度 >30%
- **Exploit Scanner** — 匹配已知的漏洞特征：reentrancy 模式、闪电贷攻击、价格操纵
- **Governance Scanner** — 分析法定人数阈值、timelock 持续时间、multisig 配置、投票权集中度
- **Liquidity Scanner** — 计算无常损失，检测低流动性陷阱，分析池深度和滑点
## 安装
```
git clone https://github.com/0xGavana/defiscanner.git
cd defiscanner
pip install -r requirements.txt
pip install -e .
```
## 用法
### 扫描合约
```
defiscanner scan 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984
defiscanner scan 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 --network ethereum
```
### 监控协议
```
defiscanner monitor --protocol uniswap
defiscanner monitor --protocol aave --interval 300
```
### 生成报告
```
defiscanner report 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 --format json
defiscanner report 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 --format csv
```
### 检查警报
```
defiscanner alerts --severity high
defiscanner alerts --protocol aave --last 24h
```
## 示例输出
```
╭─────────────────────────────────────────────╮
│ 🔍 DeFi Scanner — Risk Report │
├─────────────────────────────────────────────┤
│ Contract: 0x1f9840a85d5aF5bf1D1762F9... │
│ Network: Ethereum Mainnet │
│ Scanned: 2026-05-22 14:30:00 UTC │
╰─────────────────────────────────────────────╯
┌─────────────────────┬────────┬──────────────┐
│ Module │ Score │ Status │
├─────────────────────┼────────┼──────────────┤
│ Contract Security │ 82/100 │ 🟡 Medium │
│ TVL Stability │ 91/100 │ 🟢 Low │
│ Exploit Risk │ 75/100 │ 🟡 Medium │
│ Governance │ 88/100 │ 🟢 Low │
│ Liquidity │ 69/100 │ 🔴 High │
├─────────────────────┼────────┼──────────────┤
│ OVERALL RISK SCORE │ 81/100 │ 🟡 Medium │
└─────────────────────┴────────┴──────────────┘
```
## 架构
```
defiscanner/
├── cli.py # Click CLI with subcommands
├── scanners/
│ ├── contract_scanner.py # Bytecode & proxy analysis
│ ├── tvl_scanner.py # TVL anomaly detection
│ ├── exploit_scanner.py # Exploit pattern matching
│ ├── governance_scanner.py # Governance risk analysis
│ └── liquidity_scanner.py # Liquidity & IL analysis
├── core/
│ ├── config.py # Settings & API configuration
│ ├── blockchain.py # Web3 connection helpers
│ └── report.py # Rich console & export
└── data/
└── known_exploits.json # Exploit signature database
```
## 配置
创建 `~/.defiscanner/config.yaml`：
```
rpc_url: "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
etherscan_api_key: "YOUR_KEY"
default_network: ethereum
alert_threshold: 0.2
```
## 许可证
MIT 许可证 — 详见 [LICENSE](LICENSE)
标签：DeFi, Python, 区块链, 无后门, 智能合约分析, 逆向工具, 风险扫描