 hailin
|
3783c5a91b
|
feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11)
严格遵循 08-区块链生态基础设施开发指南.md，实现全部 12 个生态组件：
### 1. Blockscout 区块浏览器 (:4000)
- docker-compose.explorer.yml: Blockscout + PostgreSQL 16 + Redis 7 + Smart Contract Verifier
- 4 个自定义 Elixir 模块: 券NFT详情页、合规标签、发行人档案、CBS池视图
### 2. 企业API服务 — enterprise-api (NestJS, :3020)
- 4层认证体系: Public(gx_pub_) / Institutional(gx_inst_) / Regulatory(gx_reg_) / Internal(gx_internal_)
- ApiKeyGuard + MtlsGuard 双重认证, RequireApiTier 装饰器
- 8个业务模块: blocks, transactions, address, coupon, stats, rpc, export, regulatory
- WebSocket 事件网关 (/v1/ws/events), 合约 ABI 集成 (ethers v6)
### 3. MPC钱包服务 — wallet-service (NestJS, :3021)
- 2-of-3 阈值签名 (us-east/sg/cold-storage HSM 分片)
- 用户钱包 (手机号→链地址映射)、机构钱包 (mint/deposit/trade + 多签)
- 治理钱包 (Gnosis Safe 5签名人, 3/5常规 4/5紧急阈值, 提案生命周期)
### 4. Gas代付中继 — gas-relayer (NestJS, :3022)
- EIP-712 类型化数据签名验证 (verifyTypedData)
- Redis 原子 Nonce 管理 (INCR), 用户级重放保护 (SADD/SISMEMBER)
- 熔断器: 50 tx/min/user, 60s TTL 速率计数
- Gas 记账: 按用户 HINCRBY 追踪, 全局统计
### 5. 测试网水龙头 — faucet-service (NestJS, :3023)
- 每地址每24h: 100 GNX (native transfer) + 10,000 test USDC (MockUSDC.mint)
- Redis SETEX 冷却追踪, ThrottlerModule 10 req/min 全局限流
### 6. 跨链桥监控 — bridge-monitor (Go/Gin, :3024)
- Axelar 桥定期对账 (默认5分钟间隔)
- 偏差 > 0.01% 自动触发紧急暂停 + Webhook 告警 (Slack/PagerDuty)
- Prometheus metrics: TVL, locked/minted, discrepancy, reconciliation count
### 7. 链监控 — chain-monitor (Prometheus + Grafana + AlertManager)
- Prometheus: 抓取 CometBFT(26660) + EVM(6065) + 全部生态服务 + node-exporter
- 14 条告警规则: 共识/EVM/存储/网络/中继器/桥/业务 7 大类
- AlertManager: warning→Slack(4h), critical→PagerDuty(30m)
- Grafana: 12 面板仪表盘 (区块高度/出块时间/验证者/TX吞吐/内存池/中继余额/券铸造/桥TVL等)
### 8. 开发者SDK — 三端覆盖
- **JS SDK** (genex-sdk-js): GenexClient + CouponModule + BlockModule + EventModule(WebSocket自动重连)
- **Go SDK** (genex-sdk-go): ethclient 封装, SubscribeFilterLogs/SubscribeNewHead 事件订阅
- **Dart SDK** (genex-sdk-dart): JsonRpcClient(HTTP+批量) + WebSocketClient(eth_subscribe)
- 7 模型类, ABI 编码工具, 合约地址配置, GNX 余额格式化
### 9. 归档节点 — archive-node.toml
- pruning = "nothing" 全历史状态保留
- debug/trace API 开启, 8192MB block cache
- snapshot-interval = 1000 供新节点快速同步
### 10. 合约安全CI — GitHub Actions
- contract-security.yml: Foundry Tests + Slither (crytic/slither-action) + Mythril + Blockscout 合约验证
- chain-ci.yml: Go build/test/lint + NestJS matrix build (4服务) + Dart analyze
### 11. Docker Compose 更新
- ecosystem profile 集成: enterprise-api, wallet-service, gas-relayer, faucet, bridge-monitor, archive node
- `docker compose --profile ecosystem up -d` 一键启动全部生态服务
### 端口分配
3020=企业API, 3021=钱包, 3022=Gas中继, 3023=水龙头, 3024=桥监控
4000=Blockscout, 9090=Prometheus, 3030=Grafana, 8600=归档节点EVM
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-02-15 18:03:04 -08:00 |