hailin
/
gcx
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
254 Commits 1 Branch 0 Tags 38 MiB
Commit Graph

13 Commits

Author SHA1 Message Date
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
hailin 5f474c87b9 fix(chain): 恢复 timeout_commit sed 命令, 确保 1s 出块 
genexd init 生成的 config.toml 默认 timeout_commit=5s,
initCometConfig() 的代码设置仅在首次生成模板时生效,
不会覆盖已有 config.toml。必须通过 sed 显式修改。

验证结果: 40 blocks/30s = 0.75s/block ✓

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 08:48:04 -08:00
hailin 20d9e10d26 fix(chain): 恢复 create_empty_blocks=true, 稳定 1s/块 
cosmos/evm 链上 create_empty_blocks=false 无效:
EVM EndBlock 每次都改变 app hash → needProofBlock() 始终 true,
链照样出块，设 false 反而引入不稳定延迟 (官方已知问题 ethermint#308)

正确配置: timeout_commit=1s + create_empty_blocks=true
→ 稳定 ~1s/块 (有无交易均一致)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 08:37:31 -08:00
hailin 2cdd7eedcd fix(chain): 合理化出块参数 — 1s commit, 空块60s心跳 
出块参数 (对标 dYdX/Injective):
  - timeout_commit: 1s → 单验证者 ~0.75s/块, 多验证者 ~1.5-2s
  - create_empty_blocks: false + 60s heartbeat interval
  - skip_timeout_commit: false (防止空块风暴)

修复: skip_timeout_commit=true 与 create_empty_blocks=false 冲突,
EVM mempool 持续触发 TxsAvailable 导致空块无法停止。
保持 skip=false, 通过 1s timeout_commit 实现快速出块。

空闲时磁盘: ~1440 blocks/day ≈ 2 MB/day (vs 之前 2-3 GB/day)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 08:19:33 -08:00
hailin 8bd74566a7 feat(chain): GNX 代币经济模型 — 总量10亿, 5钱包分配 + 通胀控制 
代币分配 (总量 1,000,000,000 GNX):
  - validator   35% (3.5亿) — 验证者节点, stake 2.5亿
  - treasury    20% (2.0亿) — 平台运营/Gas Relayer补贴池
  - ecosystem   20% (2.0亿) — 生态发展/DApp激励
  - team        15% (1.5亿) — 团队&早期投资者
  - community   10% (1.0亿) — 社区治理/DAO储备

通胀参数:
  - 初始通胀率: 5%
  - 范围: 2%-7%
  - 目标staking比例: 50%

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 07:55:15 -08:00
hailin 23055c604c perf(chain): 禁用空块生产，防止磁盘快速耗尽 
问题: skip_timeout_commit=true 导致 ~44ms/块，无交易时
空块以 ~23块/秒 速度堆积，约 2-3 GB/天纯空块数据。

修复: create_empty_blocks = false
- 没有待处理交易时不出块
- 有交易提交时立即触发出块，延迟不受影响
- 彻底消除空块造成的磁盘浪费

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 07:50:14 -08:00
hailin d53203d56e perf(blockchain): 启用 Optimistic Execution + 共识参数调优 
性能优化三合一，预计提升单链吞吐 5-10 倍:

1. Optimistic Execution (SDK v0.53 内置):
   - 在 ProcessProposal 阶段预执行下一区块
   - FinalizeBlock 调用时直接复用预执行结果
   - 减少出块延迟约 30-50%

2. 共识参数调优 (init-genesis.sh):
   - timeout_commit: 5s → 1s
   - skip_timeout_commit: true (单节点收到自己投票后立即提交)
   - timeout_propose: 3s → 1.5s
   - timeout_prevote/precommit: 1s → 500ms
   - 实际出块时间预计 500-800ms

3. 存储和内存池调优:
   - IAVL cache: 781,250 → 2,000,000 节点 (适配 16 核 126GB 服务器)
   - Mempool size: 5,000 → 10,000 笔交易
   - Mempool cache: 10,000 → 20,000 (减少重复校验)

技术背景:
- 当前单链 200-800 TPS (串行执行)
- 优化后预计 1,000-3,000 TPS
- 未来 SDK v0.54 将内置 BlockSTM 并行执行 + IAVLx 存储优化
  (Cronos 团队贡献上游化)，届时可达 5,000+ TPS

文件变更:
- root.go: 添加 baseapp.SetOptimisticExecution()
- init-genesis.sh: 共识/存储/内存池参数调优
- go.mod/go.sum: go mod tidy 生成完整依赖

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 07:24:21 -08:00
hailin 0b1de382b0 fix(deploy): 服务器部署修复 — 全栈编译运行通过 
在内网服务器 (192.168.1.222) 首次部署时发现并修复的所有问题，
涉及 backend (12微服务)、blockchain (Cosmos SDK节点)、前端 (admin-web)。

## Backend 修复

### docker-compose.yml
- DB_PASSWORD: 从硬编码 `genex_dev_password` 改为 `${DB_PASSWORD}` 环境变量插值，
  所有13个服务统一从 .env 读取，避免密码不一致导致连接失败
- Kong 镜像: `kong:3.5-alpine` → `kong:3.5`，alpine 版本在 amd64 上缺少依赖
- chain-indexer: 环境变量名 `CHAIN_RPC_URL` → `RPC_URL` (与 Go 代码 getEnv 一致)
- chain-indexer: RPC 地址改为 `http://172.17.0.1:8545` (Docker bridge gateway，
  跨 docker-compose network 访问 blockchain 节点的 EVM JSON-RPC)
- chain-indexer: 补全缺失的 DB_HOST/DB_PORT/DB_USERNAME/DB_PASSWORD/DB_NAME

### ai-service
- ai.module.ts: 移除重复的 TypeOrmModule.forRootAsync — 该模块错误地使用了
  DB_USER/DB_PASS (默认 'genex'/'genex') 和独立数据库 genex_ai，与 app.module.ts
  中已有的 TypeOrmModule.forRoot 冲突，导致密码认证失败
- app.module.ts: 添加 ConfigModule.forRoot({ isGlobal: true })，因为
  JwtModule.registerAsync 依赖 ConfigService 注入

### 依赖补全
- user-service/package.json: 添加 kafkajs ^2.2.4 (Kafka 事件消费)
- admin-service/package.json: 添加 kafkajs ^2.2.4 (Kafka 事件消费)

## Blockchain 修复

### genex-chain/app.go — 修复 chainConfig panic
- 问题: NewGenexApp 被调用两次 (tempApp 注册编码 + 实际启动)，cosmos/evm 的
  SetChainConfig 在第二次调用时 panic: "chainConfig already set"
- 原因: 原代码 `if evmChainID == 0 { evmChainID = GenexEVMChainID }` 导致
  tempApp 也使用 8888，SetChainConfig 设置后，实际 app 再次设置时触发 panic
- 修复: 移除默认值回退，让 tempApp 使用 evmChainID=0 → DefaultEVMChainID(262144)，
  实际 app 从 app.toml 读取 8888 后可正常覆盖

### genex-chain/cmd/genexd/cmd/root.go
- 移除未使用的 banktypes import (编译错误)

### docker-compose.yml
- 添加 `command: ["start", "--chain-id", "genex-testnet-1"]` 到 x-genex-node 默认配置，
  否则 InitChain 时 chain-id 为空导致校验失败

### init-genesis.sh (新增)
- 创世初始化脚本: init → 补丁 genesis.json → 创建验证者 → gentx → collect-gentxs
- 将所有默认 denom (aatom) 替换为 agnx (GNX, 18 decimals EVM 兼容)
- 配置: evm_denom, bond_denom, mint_denom, gov min_deposit, bank denom_metadata
- 启用 JSON-RPC (0.0.0.0:8545/8546)、REST API、CORS
- 设置 evm-chain-id=8888

## 部署结果
- 20 个 Docker 容器全部运行 (4 基础设施 + 12 后端 + 1 区块链节点 + 1 前端 + 2 辅助)
- 区块链稳定出块 (height 80+)，EVM JSON-RPC 正常
- chain-indexer 实时索引区块 (lag=0)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 05:29:33 -08:00
hailin bc0d1e0876 feat: 新增 deploy.sh 部署管理脚本体系 — 后端主控+12服务独立+区块链 
参照 rwadurian 项目模式，为全栈系统创建统一的 deploy.sh 管理体系：

- backend/deploy.sh: 主控脚本 (up/down/restart/build/build-no-cache/health/infra-*/单服务操作)
- 12个服务独立 deploy.sh (build/rebuild/start/stop/restart/logs/health/shell/test)
- blockchain/deploy.sh: 节点+生态+合约+浏览器+监控全覆盖
- 更新 09-编译部署指南.md 新增第9章 deploy.sh 使用文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 17:13:09 -08:00
hailin 4c1d907df6 feat: ERC-1155 同质化券系统 + denom统一为agnx (18位EVM标准) 
新增ERC-1155双模式券系统(Utility Track专用):
- ICouponBatch接口 + CouponBatch核心合约(FACTORY/BURNER角色)
- Redemption1155兑付合约(余额/过期/门店/黑名单验证)
- CouponFactory新增mintBatch1155路由(上限100,000张O(1)铸造)
- Deploy.s.sol部署CouponBatch+Redemption1155+角色授权
- 46个新测试(CouponBatch 16 + Redemption1155 9 + Factory 11 + Integration 5 + fuzz)

Denom统一: ugnx(6位)→agnx(18位EVM标准), 金额×10^12

全量测试143/143通过，编译零错误。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 22:34:30 -08:00
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
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
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