gcx/blockchain
hailin a1293e8445 feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成
区块链核心 (blockchain/genex-chain/):
- app.go: 真实 Cosmos SDK BaseApp, 20+ 模块注册 (auth/bank/staking/evm/feemarket/erc20/ibc...)
- genesis.go: EVM/FeeMarket/Mint 创世状态, NoBaseFee=true (Gas补贴)
- compliance_integration.go: ComplianceAnteHandler 桥接到 SDK ante 链
  TX → OFAC/TravelRule/Structuring 拦截 → cosmos/evm AnteHandler → Mempool
- cmd/genexd/: 完整 CLI (init/start/keys/query/tx + EVM JSON-RPC/WS)
- x/evm/ante/: 链级合规拦截 (OFAC + Travel Rule ≥$3k + Structuring 24h检测), 18 tests
- x/evm/keeper/: Gas 费覆盖 (平台补贴 + EIP-1559 预留), 13 tests

智能合约 (blockchain/genex-contracts/):
- 9 合约: CouponFactory, Coupon(ERC-721), Settlement, Redemption,
  Compliance, Treasury, Governance, ExchangeRateOracle, CouponBackedSecurity
- 3 接口: ICoupon, ICompliance, IChainlinkPriceFeed
- Deploy.s.sol: Transparent Proxy 部署 + 角色授权
- 102/102 Foundry tests (含 fuzz + 集成)

链参数: Bech32=genex, Denom=agnx(18d), EVM ChainID=8888, ≤1s出块
部署: Docker 6节点 (3创世+2机构+1监管), docker-compose.yml

修复:
- ComplianceAnteHandler 集成到真实 Cosmos SDK ante handler 链 (§6/§16)
- init-testnet.sh denom 从 ugnx 修正为 agnx + 18位精度金额 (§13)

指南符合性: 06-区块链开发指南.md 21节中17节完全符合, 4节偏差已修复/标注

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 23:40:37 -08:00
..
genex-chain feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
genex-contracts feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
README.md feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
docker-compose.yml feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00

README.md

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