gcx/blockchain/genex-sdk-dart
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
..
lib fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 2026-02-15 22:05:52 -08:00
pubspec.yaml feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 2026-02-15 18:03:04 -08:00