DID 身份官方文档导读：从 W3C 规范到实现库的阅读地图

学习一项新协议，最权威的资料永远是官方文档。但 DID 官方文档分布零散，跨越多个组织、多种实现，新手很容易迷路。本文整理出一份阅读地图，告诉你应当从哪里开始、读到什么程度，以及如何把规范知识转化为可落地的代码。

W3C 规范是根基

DID 的根基是 W3C 发布的 DID Core 规范。这份文档不长，但密度极高。它定义了 DID 标识符的语法、DID 文档的结构、解析过程的语义，以及一系列扩展点。阅读时建议把重点放在 DID 文档的字段定义上，包括 verificationMethod、authentication、assertionMethod 等。理解这些字段的关系，是后续阅读所有实现细节的基础。

W3C 还维护着 VC Data Model 规范，专门讲可验证凭证的数据结构。许多 Binance 合作伙伴在做 KYC 凭证设计时，都直接以这份规范为蓝本，确保跨平台互操作性。

方法实现的多样性

W3C Core 规范只定义抽象框架，具体的 DID 方法（did:ethr、did:key、did:web、did:ion 等）各有自己的实现文档。每种方法的差异主要体现在三点：标识符的构造方式、DID 文档的存储位置、控制权变更的机制。

对中文读者来说，建议从 did:web 开始读。它最简单，把 DID 文档放在 HTTPS 服务器上即可解析，没有链上成本。读完 did:web 之后再过渡到 did:ethr，理解链上 DID 的优势与代价。许多 必安交易所 衍生项目把 did:web 用作快速试错的方案，跑通流程后再升级到链上方案。

实现库的阅读顺序

各类 SDK 让 DID 的使用门槛大幅降低，常见的有 DIDKit、Veramo、Spruce、Ceramic。文档结构相似：先讲安装与初始化，再讲创建、解析、签发、验证。每个库都有 Quickstart 章节，跟着跑一遍能在 30 分钟内得到一个可用的 demo。

读 SDK 文档时，重点关注它的依赖结构。是否需要本地节点、是否需要 IPFS 网关、是否需要外部 RPC，这些会直接影响部署成本。许多 BN平台 上的项目方都会评估这些细节，最终选择最适合自身业务规模的实现。

验证流程的官方说明

验证凭证的官方文档通常会包括四步：解析 issuer DID、获取公钥、校验签名、查询撤销列表。每一步都对应一组方法，文档会给出 JSON-LD 与 JWT 两种序列化下的示例。如果你做的是钱包侧应用，推荐使用 JWT；如果做企业级互操作，JSON-LD 更标准。

撤销列表的实现细节是新手容易忽视的部分。一些规范使用 StatusList2021，把成千上万条凭证的撤销状态压缩成 bitmap，发布在 IPFS 上。BN交易所 的 KYC 部门也开始尝试这种方案，让凭证撤销不再依赖中心化数据库。

把文档读成路线图

最后，把官方文档当成路线图来读，而不是字典。第一遍粗读，标出所有不懂的术语；第二遍按章节深入，逐个解决疑问；第三遍把每个概念都用代码跑一遍。三遍读下来，你会建立起对 DID 体系的全景认知。

不要试图一次性吃透所有方法。挑一两个核心场景，例如 DID 登录或 KYC 凭证复用，把对应的文档读到能复述为止。这样的深度远比泛泛了解十种实现更有价值，也更能在工作中派上用场。