CBDC Wiki

主题

组合性设计 ​

把 9 个外部包 + cbdc-chain 业务层看作零件，本节讲它们如何咬合成完整的 CBDC 系统。

严格基于代码

cbdc-chain/docs/（含 ARCHITECTURE.md / DEPLOYMENT_AND_SCALING.md / CAPACITY_PLAN_*.md / AUDIT_PERFORMANCE_PLAN.md / cbdc-central-integration-design.md 等）以及 cbdc-chain/docs/plans/ 已与代码脱节，本章节不引用任何 docs/ 内容作为事实依据。所有声明出自：

  • Go 源码（.go / .proto / .pb.go）
  • Makefile / Dockerfile / docker-compose*.yml
  • cbdc-biz/conf/<role>/core.yaml
  • .env.example / .env-example
  • go.mod、scripts/*.sh
  • 各子项目根 README.md（已交叉核对目录树）

章节导览 ​

章节内容
01 系统整体架构顶层目录树（实测）；5 个业务 app + rtgs-mock；端口实测；包归属；5 app 运营方与职责
02 信任与身份模型Fabric-CA + sign-ca + sign-kms 三件套；KMS namespace；env 注入；Fabric-X 链上 5 关卡；ConfigUpdate 时序；缺陷 + 加固清单
03 交易跨包全链路FSC View 注册图（实证 RegisterResponder）；bizhub 3 Worker；RTGS 流程
04 部署拓扑compose-*.yml 实际服务表；KMS / 网络 / 业务三段启动
05 数据流与状态视图链上 / FSC PG / Token SDK DB / BizHub 18 表 / Auditor 索引
06 关键设计取舍仅从代码可见的设计：rtgs-mock / Token Selector 双模 / Endorser Init 手动 / etc.
07 性能优化思路代码中可定位的调优旋钮、默认值、验证手段（cbdc-stress / pprof）；20 项可落地清单
08 扩容指南扩容矩阵、DB / 证书 / 机型三规则、单点故障清单、FAQ、配置文件索引
09 CA 与证书签发代码可定位的 CA / 证书签发事实（sign-ca + fabric-ca + KMS PKCS#11）
10 问题排查指南按症状定段：每段的逐字报错原文（可 grep 日志）+ 代码出处 + 排查动作；pp 漂移统一信号；容量问题升级信号
11 调用链路速查全部业务链路的函数级调用链：启动 / Transfer 同步异步 / Issue / Redeem / 钱包创建 / pp 部署 / 审计背书 / finality 四结局

引用约定 ​

  • cbdc-biz/conf/issuer/core.yaml:9 — 文件 + 行号
  • cbdc-biz/app/bizhub/cmd/bizhub/main.go:58 — 同
  • 包名（如 fabric-ca）链接到本 wiki 已写的包页
  • 应用名（如 cbdc-chain/apps/bizhub）链接到 cbdc-chain app 深度分析

相关阅读 ​