Mhmda1998/hok-al
GitHub: Mhmda1998/hok-al
一款支持多链网络的智能合约安全审计平台，可自动检测 Solidity 合约中的十余种常见安全漏洞并生成详细报告。
Stars: 0 | Forks: 0
# 🚀 HOK Al - Smart Contract Auditor
**Web3 平台：Smart Contract 审计、全球认证与加密货币分析**
[English](#english) | [العربية](#arabic)
[功能](#features) | [安装说明](#installation) | [使用方法](#usage) | [文档](#documentation) | [贡献](#contributing)
## 📖 概述
HOK Al 是一款综合性的 Smart Contract Auditor，可检测安全漏洞并分析多个区块链网络上的智能合约。它采用现代 Web 技术构建，提供具有双语界面（阿拉伯语和英语）的实时安全分析。
### ✨ 主要功能
- 🔍 **多网络支持**：Ethereum、BSC、Polygon、Arbitrum、Optimism、Fantom、Avalanche、Solana
- 🛡️ **全面的漏洞检测**：10 多项安全检查
- 🌐 **双语界面**：支持阿拉伯语和英语
- ⚡ **实时分析**：即时获取结果
- 📊 **详细报告**：全面的安全报告
- 🎨 **现代化 UI**：美观且响应式的界面
- 🔧 **易于使用**：简单直观的工作流程
- 📝 **开源**：MIT License
## 🌍 English
### 🚀 快速入门
```
# Clone the repository
git clone https://github.com/Mhmda1998/hok-al.git
cd hok-al
# 安装依赖
npm install
# 启动 server
npm start
# 在浏览器中打开
open http://localhost:3000
```
### 📝 使用方法
1. **选择网络**：从 8 个受支持的区块链网络中进行选择
2. **粘贴合约代码**：输入您的 Solidity smart contract 代码
3. **点击分析**：获取即时安全分析
4. **查看报告**：审查详细的漏洞报告
### 📊 支持的漏洞
| 漏洞 | 严重程度 | 描述 |
|--------------|----------|-------------|
| Reentrancy | 高 | 潜在的重入攻击 |
| Integer Overflow/Underflow | 高 | 整数溢出/下溢风险 |
| Unchecked External Call | 中 | 未经验证的外部调用 |
| Access Control Issues | 高 | 未经授权的访问风险 |
| TxOrigin Attack | 高 | Txorigin 攻击漏洞 |
| Delegatecall Risk | 中 | Delegatecall 安全风险 |
| Txvalue Attack | 高 | Txvalue 攻击漏洞 |
| Timestamp Dependency | 中 | 时间戳依赖问题 |
| Visibility Issues | 低 | 可见性问题 |
| Gas Optimization | 低 | Gas 优化机会 |
### 🌐 支持的网络
- **Ethereum** (Mainnet, Testnet)
- **BSC** (Binance Smart Chain)
- **Polygon** (Matic)
- **Arbitrum** (Layer 2)
- **Optimism** (Layer 2)
- **Fantom** (Fast & Low Gas)
- **Avalanche** (High Performance)
- **Solana** (High Speed)
## 🌍 العربية
### 🚀 快速开始
```
# Clone the repository
git clone https://github.com/Mhmda1998/hok-al.git
cd hok-al
# 安装 dependencies
npm install
# 运行 server
npm start
# 打开浏览器
open http://localhost:3000
```
### 📝 用法
1. **اختر الشبكة**: اختر من 8 شبكات بلوك تشين مدعومة
2. **أدخل كود العقود**: أدخل كود العقود الذكية بلغة Solidity
3. **انقر على فحص**: احصل على تحليل أمني فوري
4. **عرض التقرير**: راجع تقرير الثغرات التفصيلي
### 📊 支持的 vulnerabilities
| الثغرة | الخطورة | الوصف |
|--------|---------|--------|
| Reentrancy | عالية | ثغرة هجوم إعادة الدخول المحتملة |
| Integer Overflow/Underflow | عالية | مخاطر تجاوز أو تحتاج الأعداد الصحيحة |
| Unchecked External Call | متوسطة | استدعاء خارجي بدون فحص |
| Access Control Issues | عالية | مخاطر الوصول غير المصرح به |
| TxOrigin Attack | عالية | ثغرة هجوم TxOrigin |
| Delegatecall Risk | متوسطة | مخاطر Delegatecall الأمنية |
| Txvalue Attack | عالية | ثغرة هجوم Txvalue |
| Timestamp Dependency | متوسطة | مشكلة اعتماد الطابع الزمني |
| Visibility Issues | منخفضة | مشاكل الرؤية |
| Gas Optimization | منخفضة | فرص تحسين الغاز |
### 🌐 支持的 networks
- **Ethereum** (Mainnet, Testnet)
- **BSC** (Binance Smart Chain)
- **Polygon** (Matic)
- **Arbitrum** (Layer 2)
- **Optimism** (Layer 2)
- **Fantom** (سريع ومنخفض الغاز)
- **Avalanche** (أداء عالي)
- **Solana** (سرعة عالية)
## 🛠️ 安装说明
### 前置条件
- Node.js 18 或更高版本
- npm 或 yarn
- Git
### 依赖项
```
{
"dependencies": {
"solc": "^0.8.0",
"ethers": "^6.0.0",
"express": "^4.18.0",
"cors": "^2.8.5"
},
"devDependencies": {
"nodemon": "^2.0.0"
}
}
```
## 📚 文档
### API Endpoints
- `POST /api/analyze` - 分析智能合约
- `GET /api/networks` - 获取支持的网络
- `GET /api/vulnerabilities` - 获取漏洞类型
- `GET /api/health` - 健康检查
### 项目结构
```
hok-al/
├── server.js # Main server file
├── public/
│ └── index.html # Web interface
├── package.json # Dependencies
├── README.md # This file
├── LICENSE # MIT License
└── CONTRIBUTING.md # Contributing guidelines
```
## 📄 许可证
本项目基于 MIT License 授权 - 详情请参阅 [LICENSE](LICENSE) 文件。
## 📞 支持
- 📧 电子邮件：support@hok-al.com
- 🐛 问题反馈：[GitHub Issues](https://github.com/Mhmda1998/hok-al/issues)
- 💬 讨论交流：[GitHub Discussions](https://github.com/Mhmda1998/hok-al/discussions)标签：GNU通用公共许可证, MITM代理, Node.js, Solidity, Web3, 区块链, 智能合约审计, 自定义脚本