first commit

README.md

@@ -0,0 +1,131 @@
+# FISCO BCOS 合约开发项目
+
+## 项目简介
+
+这是一个基于 FISCO BCOS 区块链平台的 Java 开发项目，提供了与 FISCO BCOS 区块链交互的完整示例代码。项目包含账户管理、智能合约部署和调用等核心功能，适合作为 FISCO BCOS 应用开发的学习和实践基础。
+
+## 技术栈
+
+- **编程语言**: Java
+- **构建工具**: Gradle
+- **区块链平台**: FISCO BCOS
+- **核心依赖**:
+  - FISCO BCOS Java SDK 2.9.1
+  - SLF4J 日志框架
+
+## 主要功能
+
+### 1. 账户管理
+- **账户生成**: 支持生成 ECDSA 和国密 SM 两种加密类型的区块链账户
+- **PEM 格式**: 账户以 PEM 格式存储，包含私钥、公钥和地址信息
+- **账户加载**: 支持从 PEM 文件加载已有账户
+- **多账户管理**: 可批量生成和管理多个用户账户
+
+### 2. 智能合约交互
+- HelloWorld 智能合约示例
+- 合约部署和调用演示
+- 支持使用指定账户与合约交互
+
+### 3. 区块链节点连接
+- 配置化的节点连接管理
+- 支持多种加密类型（ECDSA / 国密 SM）
+- 证书和密钥管理
+
+## 项目结构
+
+```
+contract/
+├── account/              # 生成的账户文件目录 (PEM 格式)
+├── conf/                 # 配置文件目录
+├── fisco/                # FISCO BCOS 相关文件
+├── src/
+│   └── main/
+│       └── java/
+│           └── com/org/fisco/
+│               ├── AccountGenerator.java          # 账户生成工具
+│               ├── HelloWorld.java                # HelloWorld 合约示例
+│               ├── HelloWorldWithAccount.java     # 带账户的合约调用示例
+│               └── BcosSDKTest.java              # SDK 测试类
+├── build.gradle          # Gradle 构建配置
+└── README.md            # 项目说明文档
+```
+
+## 快速开始
+
+### 前置要求
+
+- JDK 8 或更高版本
+- Gradle 6.0 或更高版本
+- FISCO BCOS 区块链节点（运行中）
+
+### 安装与构建
+
+1. 克隆项目到本地
+2. 配置区块链节点连接信息（在 `conf` 目录下）
+3. 构建项目：
+   ```bash
+   ./gradlew build
+   ```
+
+### 运行账户生成工具
+
+```bash
+./gradlew run
+```
+
+该命令会运行 `AccountGenerator` 主类，自动生成示例账户并保存到 `account` 目录。
+
+生成的账户包括：
+- user_pem.pem
+- alice.pem
+- bob.pem
+- charlie.pem
+
+## 使用说明
+
+### 生成账户
+
+```java
+import com.org.fisco.AccountGenerator;
+import org.fisco.bcos.sdk.model.CryptoType;
+
+// 生成 ECDSA 类型账户
+AccountGenerator.generatePEMAccount("myAccount", CryptoType.ECDSA_TYPE);
+
+// 生成国密 SM 类型账户
+AccountGenerator.generatePEMAccount("myAccount", CryptoType.SM_TYPE);
+```
+
+### 加载账户
+
+```java
+// 从 PEM 文件加载账户
+CryptoKeyPair keyPair = AccountGenerator.loadPEMAccount("account/alice.pem", CryptoType.SM_TYPE);
+```
+
+## 配置说明
+
+项目配置文件位于 `conf` 目录，主要包括：
+- 节点连接配置
+- 证书文件
+- 群组配置
+- 加密类型配置
+
+## 开发环境
+
+- IDE: IntelliJ IDEA（推荐）
+- 操作系统: macOS / Linux / Windows
+- Java 版本: JDK 8+
+
+## 许可证
+
+本项目采用开源许可证发布。
+
+## 相关资源
+
+- [FISCO BCOS 官方文档](https://fisco-bcos-documentation.readthedocs.io/)
+- [FISCO BCOS Java SDK 文档](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/sdk/java_sdk/index.html)
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request 来改进这个项目。