gcx/blockchain/README.md

3.5 KiB
Raw Permalink Blame History

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