# 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 小时时间锁
- 不可升级的安全红线: 券类型标记、所有权记录、转售计数器
