主题
fabric-token-sdk · 模块详解
本仓库 submodule：fabric-token-sdk/。路径相对该 submodule 根。
cmd/
来源：cmd/。
cmd/tokengen/
入口 cmd/tokengen/main.go（cobra 框架）。
| 子命令 | 注册位置 |
|---|---|
pp.GenCmd() | main.go:55 |
pp.UpdateCmd() | main.go:56 |
pp.UtilsCmd() | main.go:57 |
certfier.KeyPairGenCmd() | main.go:58 |
version.Cmd() | main.go:59 |
env 前缀：core（main.go:21）。
cmd/artifactgen/
入口 cmd/artifactgen/main.go。子命令由 gen.Cmd() 于 main.go:48 注册，CLI 命令名为 artifacts（cmd/artifactgen/gen/gen.go:53）。env 前缀：core（main.go:19）。
token/ 顶层
来源：token/。
| 路径 | 用途 |
|---|---|
token/core/fabtoken/v1/ | FabToken 驱动 |
token/core/zkatdlog/nogh/v1/ | ZKAT-DLOG 驱动（NOGH） |
token/core/common/ | 共享工具 + 编码 |
token/driver/ | 驱动接口定义 |
token/services/ | 高级服务层 |
token/sdk/ | 公共 API 入口（tms / vault / identity / network） |
token/token/ | 令牌数据模型 |
token/mock/ | 生成的 mock |
关键 struct / interface
| 类型 | 文件 | 行号 |
|---|---|---|
ManagementService | token/tms.go | 38 |
Token | token/token/token.go | 42 |
ID | token/token/token.go | 16 |
IssueAction | token/driver/action.go | 20 |
TransferAction | token/driver/action.go | 62 |
Output | token/driver/action.go | 50 |
TokensService | token/driver/tokens.go | 52 |
TokensUpgradeService | token/driver/tokens.go | 34 |
Request | token/request.go | 224 |
token/core/ 驱动子包
来源：token/core/。
token/core/fabtoken/v1/
| 子目录 | 用途 |
|---|---|
driver/ | Driver 实现 |
actions/ | Issue / Transfer / Redeem actions |
validator/ | 验证器 |
service.go:23 | Service 实现 |
issue.go / transfer.go | Issue / Transfer 逻辑 |
auditor.go:16 | AuditorService |
token/core/zkatdlog/nogh/v1/
| 子目录 | 用途 |
|---|---|
driver/ | Driver 实现 |
crypto/ | 密码学原语 |
validator/ | 验证器 |
issue/ / transfer/ | Issue / Transfer 逻辑 |
audit/ | Auditor |
NOGH = No Graph Hiding（目录名 nogh）。
token/services/
来源：token/services/。
| 子包 | 路径 |
|---|---|
| auditor | token/services/auditor/ |
| benchmark | token/services/benchmark/ |
| certifier | token/services/certifier/ |
| config | token/services/config/ |
| identity | token/services/identity/ |
| interop | token/services/interop/ |
| logging | token/services/logging/ |
| network | token/services/network/ |
| nfttx | token/services/nfttx/ |
| selector | token/services/selector/ |
| storage | token/services/storage/ |
| tokens | token/services/tokens/ |
| ttx | token/services/ttx/ |
| utils | token/services/utils/ |
integration/
| 路径 | 内容 |
|---|---|
integration/token/fungible/{fabtoken,dlog,dloghsm,dlogstress,dlogx,mixed,update}/ | 可替换令牌测试 |
integration/token/nft/{fabtoken,dlog}/ | NFT |
integration/token/dvp/{fabtoken,dlog}/ | Delivery vs Payment |
integration/token/interop/{fabtoken,dlog}/ | 跨链（HTLC） |
integration/nwo/ | 网络编排（基于 fabric-smart-client nwo） |
docs/
来源：docs/README.md、各文档。
WARNING
docs/ 已与代码脱节，仅作线索，结论以代码为准。
| 文件 | 内容 |
|---|---|
docs/README.md | 文档导航入口 |
docs/tokensdk.md | SDK 架构、关键概念（UTXO / TMS / Request / Action / Wallet） |
docs/tokenapi.md | Token API（数据模型 / TMS / Wallet Manager / Validator） |
docs/driverapi.md | 驱动接口规范 |
docs/services.md | 服务生态 |
docs/configuration.md | 配置说明 |
docs/token_sdk_usage.md | API 使用指南 |
docs/public_parameters.md | 公共参数生命周期 |
docs/upgradability.md | 升级机制 |
docs/evolution_summary.md | 版本演进总结 |
docs/drivers/fabtoken.md | FabToken 规范 + protobuf |
docs/drivers/dlogwogh.md | ZKAT-DLOG (NOGH) 规范 |
docs/services/ttx.md | TTX 服务与事务生命周期 |
docs/services/*.md | identity / network / storage / selector / interop 等 |
docs/development/*.md | 开发指南 |
Makefile target
详见 03-quickstart · Makefile target。
看代码推荐路径
README.md→ 项目定位 + 核心能力。docs/tokensdk.md→ 架构层 + Key Concepts。docs/tokenapi.md+token/tms.go:38→ TMS / Request 模型。token/driver/action.go:20-70+token/driver/tokens.go:34-52→ 驱动接口。token/core/fabtoken/v1/service.go:23+ 同目录的issue.go/transfer.go→ 最简驱动实现。token/core/zkatdlog/nogh/v1/→ 隐私驱动实现。integration/token/fungible/fabtoken/→ 最简业务示例。