gcx/blockchain

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）

快速开始

合约开发

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

链开发

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