Nezar-Alhammadi/Vigil-AI
GitHub: Nezar-Alhammadi/Vigil-AI
一个多源智能合约源码采集 CLI 工具，集成 Slither 静态分析，为 Web3 安全审计提供统一的扫描入口。
Stars: 1 | Forks: 0
# Vigil-AI
Vigil-AI 是一个用于从以下来源收集智能合约源码的 CLI 工具：
- 本地路径
- GitHub 仓库
- 链上已验证的合约地址
目前主要侧重于源码加载和扫描输入的准备。
## 环境要求
- Python 3.10+
- Git（用于 `--url` 扫描）
- Slither（通过 `requirements.txt` 安装）
## 本地运行
```
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate
pip install -r requirements.txt
python src/cli.py --help
```
示例：
```
python src/cli.py scan --path ./contracts
python src/cli.py scan --url https://github.com/OpenZeppelin/openzeppelin-contracts
python src/cli.py scan --address 0x0000000000000000000000000000000000000000 --chain ethereum
```
## 使用 Docker 运行
构建镜像：
```
docker build -t vigil-ai .
```
显示帮助：
```
docker run --rm vigil-ai --help
```
扫描本地文件夹（挂载你的合约文件夹）：
```
docker run --rm -v "${PWD}:/work" vigil-ai scan --path /work/contracts
```
Windows PowerShell 变体：
```
docker run --rm -v "${PWD}:/work" vigil-ai scan --path /work/contracts
```
扫描 GitHub 仓库：
```
docker run --rm vigil-ai scan --url https://github.com/OpenZeppelin/openzeppelin-contracts
```
扫描链上地址：
```
docker run --rm vigil-ai scan --address 0x0000000000000000000000000000000000000000 --chain ethereum
```
## 注意事项
- `src/ai_engine` 和 `src/auditor` 仍然是占位符。
- 每次 `scan` 现在会在加载合约后自动运行 Slither。
标签：CLI 工具, DeFi 安全, Docker, GitHub 扫描, Python, Slither, SOC Prime, Web3 安全, 云安全监控, 人工智能, 代码安全, 以太坊, 区块链, 安全防御评估, 对称加密, 开发工具, 文档结构分析, 无后门, 智能合约审计, 源码分析, 漏洞枚举, 用户模式Hook绕过, 网络安全研究, 自动化审计, 请求拦截, 逆向工具, 链上分析, 防御性安全, 静态分析