CBDC Wiki

主题

cbdc-chain · 概述 ​

仓库基本事实 ​

项值出处
类型Go monorepo，3 个独立 go.mod 模块cbdc-biz/go.mod、cbdc-stress/go.mod、tests/go.mod
主模块cbdc-biz，Go 1.26.3cbdc-biz/go.mod:1-3
顶层目录cbdc-biz/ cbdc-network/ cbdc-infra/ cbdc-stress/ docs/ open-docs/ scripts/ tests/仓库目录树

README 自述 ​

来源：README.md:13-14。

  1. Run network, see cbdc-network/README.md
  2. Run cbdc app, see cbdc-biz/README.md

README.md:42-62 描述三层架构：

  • 业务应用层（Biz）：实际目录 auditor / bizhub / endorser / institution / issuer（来自 cbdc-biz/app/；README.md:46 ASCII 图中的 Wholesale 在当前代码中无对应目录）
  • 区块链网络层（Network）：Orderer、Committer
  • 基础设施层（Infra）：Fabric CA（端口 7054）、KMS（端口 9200）

子项目快览 ​

目录用途来源
cbdc-biz/业务服务；实际 app/ 目录：auditor / bizhub / endorser / institution / issuercbdc-biz/app/（与 README.md:28-33 中的 core/ retail/ wholesale/ 描述不一致）
cbdc-network/Fabric-X 网络配置与部署cbdc-network/README.md、cbdc-network/Makefile
cbdc-infra/基础设施镜像：cbdc-tool（唯一子目录）+ cbdc-ca-server-kms（仅由 Makefile build-all/build-push 构建推送，无独立目录）cbdc-infra/Makefile:15,28-29
cbdc-stress/纯 Go 压测工具cbdc-stress/main.go、cbdc-stress/go.mod
docs/内部设计文档—
open-docs/公开 VitePress 文档open-docs/docs/.vitepress/
scripts/start-kms-system.sh / check-auditor-key.shscripts/
tests/独立 Go 模块 cbdc-chain-teststests/go.mod

与生态的位置 ​

来源：cbdc-biz/go.mod:16-18。

依赖版本（cbdc-biz/go.mod:16-18）：

依赖版本
github.com/hyperledger-labs/fabric-smart-clientv0.11.0
github.com/hyperledger-labs/fabric-token-sdkv0.11.0
github.com/hyperledger/fabric-cav1.5.16

replace（cbdc-biz/go.mod:309-315）仅固定四个 go.opentelemetry.io/otel/log 相关包到 Record-签名版本（v0.6.0 / v0.5.0），等待 FSC 上游补丁；无 fabric-token-sdk / fabric-smart-client 的 replace。

关键能力 ​

来源：实测代码 + 子项目 README。

  • 企业 CBDC 业务：实际 cbdc-biz/app/ 5 个目录 auditor / bizhub / endorser / institution / issuer。另含 cbdc-biz/cmd/rtgs-mock/ 用于 RTGS 模拟。
  • HSM 密钥管理：通过 sign-kms PKCS#11 接入；env SIGN_KMS_ENDPOINT / KMS_USER_PIN 等（cbdc-biz/.env.example）。
  • 审计 + 资产标记：实现在 cbdc-biz/pkg/common/auditor/、pkg/common/marked/、pkg/common/tx_selector/；BizHub ent schema 含 auditor_ruleset / asset_mark / tx_selector_group（cbdc-biz/app/bizhub/internal/data/ent/schema/）。
  • RTGS 集成：SWIFT MT298 + SMB；代码在 cbdc-biz/pkg/rtgs/（含 mt298/ 子包、smb_client.go、smb_pool.go）。
  • 可观测性：OpenTelemetry / Prometheus；通过 cbdc-biz/pkg/signet/、pkg/observability/、cbdc-biz/pkg/scheduler/。

下一步 ​

  • 架构 — 三层模型 + 5 个 Biz 应用 + Network 服务
  • 快速开始 — KMS / Network / Biz 三步启动
  • 模块详解 — cbdc-biz/ cbdc-network/ cbdc-infra/ cbdc-stress/
  • API 参考 — gRPC 服务 + CLI