132 lines
3.5 KiB
Markdown
132 lines
3.5 KiB
Markdown
# Genex Chain — 区块链模块
|
||
|
||
> 自建 EVM 兼容应用链 + 智能合约体系
|
||
|
||
## 架构
|
||
|
||
```
|
||
blockchain/
|
||
├── genex-chain/ # Cosmos SDK 应用链（Go）
|
||
│ ├── cmd/genexd/ # 链节点二进制
|
||
│ ├── app/ # Application 配置
|
||
│ ├── x/evm/ # 自定义 EVM 模块
|
||
│ │ ├── keeper/ # Gas 费覆盖（平台补贴）
|
||
│ │ └── ante/ # 链级合规拦截
|
||
│ ├── config/ # 节点/创世配置
|
||
│ └── scripts/ # 初始化脚本
|
||
│
|
||
└── genex-contracts/ # Solidity 智能合约（Foundry）
|
||
├── src/ # 9 个核心合约
|
||
├── test/ # 10 个测试文件
|
||
└── script/ # 部署脚本
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
| 组件 | 技术 | 说明 |
|
||
|------|------|------|
|
||
| 链框架 | Cosmos SDK v0.50 | 模块化，200+ 生产链验证 |
|
||
| 共识引擎 | CometBFT | 即时终结性，≤1s 出块 |
|
||
| EVM 模块 | cosmos/evm | 完全 EVM 兼容，Apache 2.0 |
|
||
| 合约框架 | Foundry (Solidity 0.8.20) | 测试 + 部署 + 验证 |
|
||
| 跨链 | IBC + Axelar | Cosmos 生态 + Ethereum 桥接 |
|
||
|
||
## 智能合约系统（9 合约）
|
||
|
||
| 合约 | 功能 |
|
||
|------|------|
|
||
| CouponFactory | 券发行工厂（Utility/Security 双轨） |
|
||
| Coupon | ERC-721 券 NFT（不可转让限制 + 转售计数） |
|
||
| Settlement | 原子交换结算（多稳定币 + 价格验证） |
|
||
| Redemption | 兑付合约（销毁 + 门店验证） |
|
||
| Compliance | 合规（OFAC + Travel Rule + KYC 差异化） |
|
||
| Treasury | 资金托管（保障资金 + Escrow） |
|
||
| Governance | 治理（3/5 多签 + 48h 时间锁 + 回滚） |
|
||
| ExchangeRateOracle | 汇率预言机（Chainlink 集成） |
|
||
| CouponBackedSecurity | CBS 资产证券化 |
|
||
|
||
## 链设计参数
|
||
|
||
| 参数 | 值 |
|
||
|------|-----|
|
||
| Chain ID | 8888 |
|
||
| 出块时间 | ≤ 1 秒 |
|
||
| TPS | ≥ 5,000 |
|
||
| Gas 策略 | 平台全额补贴（min_gas_price = 0） |
|
||
| 原生代币 | GNX (1B 总供应量) |
|
||
| 共识 | CometBFT PoS |
|
||
| EVM 兼容 | 完全兼容（Solidity, Hardhat, MetaMask） |
|
||
|
||
## 快速开始
|
||
|
||
### 合约开发
|
||
|
||
```bash
|
||
cd blockchain/genex-contracts
|
||
|
||
# 安装依赖
|
||
forge install OpenZeppelin/openzeppelin-contracts
|
||
forge install OpenZeppelin/openzeppelin-contracts-upgradeable
|
||
|
||
# 编译
|
||
forge build
|
||
|
||
# 测试
|
||
forge test -vvv
|
||
|
||
# 部署到本地
|
||
forge script script/Deploy.s.sol --rpc-url http://localhost:8545 --broadcast
|
||
```
|
||
|
||
### 链开发
|
||
|
||
```bash
|
||
cd blockchain/genex-chain
|
||
|
||
# 编译
|
||
make build
|
||
|
||
# 初始化本地测试链
|
||
make init-local
|
||
|
||
# 启动
|
||
make start
|
||
```
|
||
|
||
### MetaMask 配置
|
||
|
||
| 设置 | 值 |
|
||
|------|-----|
|
||
| Network Name | Genex Chain |
|
||
| RPC URL | http://localhost:8545 |
|
||
| Chain ID | 8888 |
|
||
| Currency Symbol | GNX |
|
||
|
||
## GNX 代币分配
|
||
|
||
```
|
||
总供应量: 1,000,000,000 GNX
|
||
├── 40% 平台运营/Gas 补贴
|
||
├── 20% 团队与顾问（4年释放，1年锁定）
|
||
├── 15% 生态基金
|
||
├── 15% 融资预留
|
||
└── 10% 社区 DAO 治理
|
||
```
|
||
|
||
## 验证节点架构
|
||
|
||
```
|
||
生产网络（最少 5 个验证节点）:
|
||
Genex 创世节点 x3 — US(2) + SG(1)
|
||
机构验证节点 x4+ — 持牌金融机构
|
||
监管观察节点 x3 — FinCEN / MAS / FCA（只读）
|
||
```
|
||
|
||
## 安全规范
|
||
|
||
- 所有合约上线前通过第三方安全审计
|
||
- Transparent Proxy 部署（可升级）
|
||
- 升级需 3/5 多签 + 48 小时时间锁
|
||
- 紧急通道: 4/5 多签 + 4 小时时间锁
|
||
- 不可升级的安全红线: 券类型标记、所有权记录、转售计数器
|