gcx/blockchain
hailin 0ea869ac46 fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service
基于08-区块链生态基础设施开发指南的全面审计,修复以下问题:

## SDK 补全(对齐指南 §7.2-7.4)

- **JS SDK**: 新增 SettlementModule (settlement.ts),实现 executeSwap() 合约交互
  和 onSwapExecuted() 事件监听,补齐指南 §7.2 要求的 settlement 模块
- **Go SDK**: 新增 ExecuteSwap() 函数 (settlement.go),完整实现 ABI 编码 → nonce
  获取 → gas 估算 → 签名 → 广播 → receipt 等链上交易全流程
- **Dart SDK**: 新增统一事件订阅接口 subscribeEvents(EventFilter),匹配指南 §7.4
  规范;新增 EventFilter 模型类,支持 newHeads/logs 两种订阅类型

## Enterprise API 加固(对齐指南 §3.2/§3.4)

- 新增 TierThrottlerGuard 分层限流守卫,按 API tier 区分速率限制:
  public 60/min, institutional 600/min, regulatory/internal unlimited
- WebSocket 网关增加完整认证:API Key 通过 query param 或 header 传递,
  最低要求 institutional 级别,未认证连接自动拒绝

## 删除无用的 wallet-service(架构纠正)

- 删除 blockchain/wallet-service/ 整个目录(13个文件,875行代码)
  该服务架构设计有误:钱包操作(用户钱包、机构操作、治理多签)已由现有
  后端微服务处理(user-service:3001、issuer-service:3002、trading-service:3003、
  clearing-service:3004),无需在 blockchain/ 目录下另建独立服务
- docker-compose.yml: 移除 wallet-service 服务定义和端口 3021 映射
- chain-ci.yml: 从 NestJS 生态服务 CI matrix 中移除 wallet-service
- 08-指南: 删除第4节(钱包体系 §4.1-4.3),移除部署清单中 MPC签名服务:3021,
  更新生态全景图,章节重新编号 (12→11章)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 22:05:52 -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 feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
genex-contracts feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -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
docker-compose.explorer.yml feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00
docker-compose.yml fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -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 小时时间锁
  • 不可升级的安全红线: 券类型标记、所有权记录、转售计数器