gcx/blockchain
hailin 9fdb5acaa8 feat(chain): 添加 init-fullnode.sh — 非创世节点初始化脚本
全节点只需: genexd init + 复制 genesis.json + 配置 peers
区块数据通过 P2P 从创世节点同步,不需要重新执行 genesis 初始化

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 08:50:20 -08:00
..
.github/workflows fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
bridge-monitor feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
chain-monitor feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
enterprise-api fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
explorer feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
faucet-service feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
gas-relayer feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
genex-chain fix(chain): 恢复 create_empty_blocks=true, 稳定 1s/块 2026-02-20 08:37:31 -08:00
genex-contracts feat: ERC-1155 同质化券系统 + denom统一为agnx (18位EVM标准) 2026-02-15 22:34:30 -08:00
genex-sdk-dart fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
genex-sdk-go fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
genex-sdk-js fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
README.md feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
deploy.sh feat: 新增 deploy.sh 部署管理脚本体系 — 后端主控+12服务独立+区块链 2026-02-19 17:13:09 -08:00
docker-compose.explorer.yml feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
docker-compose.yml fix(deploy): 服务器部署修复 — 全栈编译运行通过 2026-02-20 05:29:33 -08:00
init-fullnode.sh feat(chain): 添加 init-fullnode.sh — 非创世节点初始化脚本 2026-02-20 08:50:20 -08:00
init-genesis.sh fix(chain): 恢复 timeout_commit sed 命令, 确保 1s 出块 2026-02-20 08:48:04 -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 小时时间锁
  • 不可升级的安全红线: 券类型标记、所有权记录、转售计数器