# benchmark-scripts

**Repository Path**: szu_yq/benchmark-scripts

## Basic Information

- **Project Name**: benchmark-scripts
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-11
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 区块链测试环境套件

本目录包含了完整的区块链测试环境，涵盖了共识测试、权限测试、IPFS测试和API测试等多个方面，为区块链系统的全面测试提供了完整的解决方案。

## 🏗️ 目录结构

```
benchmark-scripts/
├── consensus-test-environment/     # 共识测试环境
│   └── poa-test-3nodes/          # 3节点POA共识测试
├── permission-test-environment/    # 权限测试环境
├── ipfs-docker-test-environment/  # IPFS Docker测试环境
├── api-test-environment/          # API测试环境 (新增)
│   ├── scripts/                   # 部署脚本
│   │   ├── 01_compile_contracts.sh    # 合约编译脚本
│   │   ├── 02_deploy_contracts.sh     # 合约部署脚本
│   │   └── 03_generate_code.sh        # 代码生成脚本
│   └── performance-tests/         # 性能测试套件
│       ├── data/                  # 测试数据
│       ├── scripts/               # 测试脚本
│       ├── reports/               # 测试报告
│       ├── logs/                  # 测试日志
│       └── config/                # 配置文件
└── README.md                      # 本文档
```

## 🎯 核心功能

### 1. 共识测试环境
- **POA共识测试**: 3节点Proof of Authority共识机制测试
- **网络配置**: 支持自定义链ID和端口配置
- **节点管理**: 完整的节点启动和管理脚本
- **性能监控**: 共识性能和网络稳定性测试

### 2. 权限测试环境
- **权限控制测试**: 区块链权限管理功能测试
- **角色管理**: 不同角色和权限的测试场景
- **访问控制**: 智能合约访问控制测试
- **安全验证**: 权限系统的安全性测试

### 3. IPFS测试环境
- **分布式存储测试**: IPFS网络功能测试
- **Docker部署**: 基于Docker的IPFS节点部署
- **数据同步**: IPFS网络数据同步测试
- **性能评估**: IPFS存储和检索性能测试

### 4. API测试环境 (新增)
- **存证合约测试**: 区块链数据存证功能测试
- **积分系统测试**: 大规模积分系统性能测试
- **合约部署**: 自动化合约编译和部署
- **性能基准**: 全面的性能测试和基准测试

## 🚀 快速开始

### 选择测试环境

根据你的测试需求选择合适的测试环境：

#### 共识测试
```bash
cd consensus-test-environment/poa-test-3nodes
# 查看详细说明
cat README.md
```

#### 权限测试
```bash
cd permission-test-environment
# 查看详细说明
cat README.md
```

#### IPFS测试
```bash
cd ipfs-docker-test-environment
# 查看详细说明
cat README.md
```

#### API测试 (推荐新手)
```bash
cd api-test-environment
# 查看详细说明
cat README.md
```

### API测试环境快速开始

API测试环境是最新添加的测试套件，专门针对存证合约和积分系统合约：

```bash
# 进入API测试环境
cd api-test-environment

# 1. 部署合约
cd scripts
./01_compile_contracts.sh
./02_deploy_contracts.sh -k <private_key> -e <endpoint> -c <chain_id>
./03_generate_code.sh

# 2. 运行性能测试
cd ../performance-tests
python3 run_tests.py
```

## 📊 测试特性对比

| 测试环境 | 主要功能 | 适用场景 | 复杂度 |
|---------|---------|---------|--------|
| 共识测试 | 共识机制、网络稳定性 | 区块链网络测试 | 中等 |
| 权限测试 | 权限控制、安全验证 | 安全功能测试 | 中等 |
| IPFS测试 | 分布式存储、数据同步 | 存储功能测试 | 中等 |
| API测试 | 智能合约、性能测试 | 应用功能测试 | 低-中等 |

## 🎯 重点推荐

### 存证合约测试
- **功能验证**: 测试区块链存证的基本功能
- **性能测试**: 批量存证操作性能测试
- **数据完整性**: 验证存证数据的不可篡改性
- **应用场景**: 电子证据存储、数据完整性验证

### 积分系统合约测试
- **大规模测试**: 支持1000万账户的批量操作
- **性能优化**: 自动优化批次大小和Gas消耗
- **功能完整**: 包括Mint、转账、查询等全方位测试
- **应用场景**: 用户积分系统、奖励机制、代币管理

## ⚙️ 环境要求

### 基础要求
- **操作系统**: Linux (推荐 Ubuntu 18.04+)
- **内存**: 至少 16GB RAM
- **存储**: 至少 50GB 可用空间
- **网络**: 稳定的网络连接

### 软件依赖
- **Docker**: 用于IPFS测试环境
- **Node.js**: 用于智能合约测试
- **Python3**: 用于性能测试脚本
- **Go**: 用于共识测试环境

## 🔧 配置说明

### 网络配置
- **本地测试**: `http://localhost:8545`
- **测试网络**: 支持自定义RPC端点
- **链ID**: 可配置不同网络的链ID

### 测试参数
- **快速测试**: 小规模测试，5-10分钟完成
- **完整测试**: 大规模测试，2-4小时完成
- **自定义测试**: 根据需求调整测试参数

## 📈 测试报告

每个测试环境都会生成详细的测试报告：

- **性能指标**: TPS、延迟、Gas消耗等
- **功能验证**: 各项功能的测试结果
- **错误统计**: 失败操作的数量和原因
- **优化建议**: 基于测试结果的改进建议

## 🐛 故障排除

### 常见问题
1. **环境配置**: 检查依赖安装和配置
2. **网络连接**: 验证网络配置和防火墙设置
3. **权限问题**: 确保脚本有执行权限
4. **资源不足**: 检查内存和存储空间

### 获取帮助
- **文档**: 查看各子目录的README文件
- **日志**: 检查测试过程中的详细日志
- **配置**: 参考配置文件中的参数说明

## 📞 技术支持

- **文档**: 各测试环境都有详细的README文档
- **示例**: 提供完整的测试示例和配置
- **脚本**: 自动化测试脚本，简化测试流程
- **报告**: 自动生成详细的测试报告

## 🎉 开始测试

现在你可以开始使用这个强大的区块链测试套件了！建议从API测试环境开始，熟悉基本流程后再尝试其他测试环境。

每个测试环境都经过精心设计，提供了完整的测试解决方案，帮助你全面验证区块链系统的各项功能。