用PyLD构建去中心化身份应用：DID与可验证凭证完整实战教程

用PyLD构建去中心化身份应用DID与可验证凭证完整实战教程【免费下载链接】pyldJSON-LD processor written in Python项目地址: https://gitcode.com/gh_mirrors/py/pyld什么是PyLD为什么它能撑起去中心化身份应用 PyLD 是 Python 生态中最成熟的 JSON-LD 处理器也是构建去中心化身份DID与可验证凭证Verifiable Credential简称 VC应用的关键基础设施。DID 文档、可验证凭证、可验证表达VP这些 W3C 标准数据本质上都是一种 JSON-LD 文档。想要在 Python 项目中正确解析、扩展、签名验证它们就绕不开 PyLD 这个底层引擎。本篇教程将从零开始带你理解 DID 与可验证凭证的数据结构并手把手用 PyLD 完成凭证签发、规范化、哈希验证的完整闭环。全程面向新手即使你只写过基础的 Python也能跟着跑通。先搞懂三件事DID、VC、JSON-LD 的关系 在写代码之前先建立三个核心概念概念一句话解释示例DID去中心化标识符类似身份证号由你完全掌控did:key:z6Mk...DID 文档描述 DID 的公开信息含公钥、验证方法、服务端点JSON-LD 文档VC可验证凭证可被密码学验证的电子凭证如学位证、驾照JSON-LD 文档JSON-LD 的价值在于它把普通 JSON 数据接上语义网通过context把字段名映射到标准 URI。而PyLD 就是负责完成这套映射的翻译官——把人类易读的短字段翻译成机器可验证的完整 IRI为后续签名验证铺路。最快速的安装步骤一条 pip 命令搞定 ⚡PyLD 支持 Python 3.10 及以上版本安装非常简单pip install PyLD如果你需要远程加载上下文建议同时安装请求库PyLD 的文档加载器依赖它pip install PyLD[requests]安装完成后可以用一行代码验证环境是否就绪from pyld import jsonld print(jsonld.expand({context: https://www.w3.org/ns/did/v1, id: did:example:123})) 提示PyLD 的核心处理逻辑都集中在lib/pyld/jsonld.py后续你提到的所有 API 都能在这个文件里找到源码实现。用 PyLD 解析 DID 文档从压缩到展开 DID 文档通常以压缩compact形式存储字段是短名称。PyLD 的expand方法会把它们还原成完整 IRI这一步是后续一切验证的前提。来看一个真实场景——解析一份 DID 文档from pyld import jsonld did_doc { context: https://www.w3.org/ns/did/v1, id: did:example:123, verificationMethod: [{ id: did:example:123#keys-1, type: Ed25519VerificationKey2020, controller: did:example:123, publicKeyMultibase: z6Mk... }] } expanded jsonld.expand(did_doc) print(expanded)执行后verificationMethod会被展开为https://w3id.org/security#verificationMethodpublicKeyMultibase等字段也会被映射到标准定义。这正是可验证凭证验证时需要的规范化数据。可验证凭证的签发掌握normalize这个核心 API ✍️签发可验证凭证时一个重要问题是同一份凭证不同人解析可能得到略微不同的 JSON如何保证签名的唯一性答案就是RDF 规范化Canonicalization。PyLD 实现了 W3C 的 URDNA2015 算法通过normalize方法把凭证转成唯一的、规范化的 N-Quads 文本任何等价写法都会得到完全相同的结果vc { context: [ https://www.w3.org/2018/credentials/v1, https://www.w3.org/2018/credentials/examples/v1 ], id: http://example.edu/credentials/1872, type: [VerifiableCredential, UniversityDegreeCredential], issuer: did:example:issuer, issuanceDate: 2010-01-01T19:23:24Z, credentialSubject: { id: did:example:holder, degree: {type: BachelorDegree, name: 计算机科学} } } normalized jsonld.normalize( vc, {algorithm: URDNA2015, format: application/n-quads} ) print(normalized)规范化后的 N-Quads 文本就是签名的输入。你可以用任意密码学库如cryptography对其做摘要和签名然后把签名放进凭证的proof字段。验证时反向操作解析凭证 →normalize→ 验签。整个流程 PyLD 只负责数据规范化这一环职责清晰、代码可控。 相关源码规范化实现位于lib/pyld/canon.pyN-Quads 序列化位于lib/pyld/nquads.py。离线安全实践用 FrozenDocumentLoader 加载 DID 与 VC 上下文 真实应用中最常见的坑是凭证里的context指向公网 URL运行时需要联网拉取上下文一旦网络波动或 URL 失效验证就会失败。PyLD 内置了FrozenDocumentLoader它从本地白名单提供上下文完全不需要联网天然适合生产环境的离线验证与安全加固。更贴心的是PyLD 官方已经打包了 DID、VC 等高频上下文内置上下文 URL用途https://www.w3.org/ns/did/v1DID 文档https://www.w3.org/2018/credentials/v1可验证凭证 v1https://www.w3.org/ns/credentials/v2可验证凭证 v2https://w3id.org/security/v2安全术语proof 等使用方式非常简洁from pyld import jsonld, FrozenDocumentLoader loader FrozenDocumentLoader() # 使用内置上下文集合 jsonld.set_document_loader(loader) # 之后所有 expand / normalize 都不会发起网络请求 expanded jsonld.expand(vc)内置上下文的 JSON 文件就存放在lib/pyld/documentloader/frozen/bundled/目录下你可以直接查看甚至替换为自己的上下文。这种方式既保证了验证结果可复现也避免了供应链上的隐私泄露风险。完整实战流程从 DID 文档到可验证凭证验证 把前面所有知识点串起来一个标准的去中心化身份应用流程如下签发阶段构造 DID 文档与 VC →jsonld.normalize()规范化 → 对 N-Quads 做签名 → 写入proof字段传输阶段凭证以 JSON-LD 压缩格式传递体积小、易读验证阶段jsonld.expand()展开凭证 → 校验context完整 →normalize()再次规范化 → 用 DID 文档中的公钥验签安全加固全程使用FrozenDocumentLoader杜绝远程上下文注入风险新手最容易踩的 3 个坑 ️上下文不匹配签发和验证时context必须完全一致否则normalize结果不同、验签失败忘记展开直接对压缩形式做签名是不安全的务必先expand再normalize算法参数写错normalize必须指定algorithm: URDNA2015和format: application/n-quads这是 W3C 标准的默认组合总结PyLD 是通往 Web3 身份世界的钥匙 通过本篇教程你已经掌握了用 PyLD 构建去中心化身份应用的核心链路理解 JSON-LD → 安装 PyLD → 展开 DID 文档 → 规范化并签发可验证凭证 → 离线安全验证。PyLD 虽然只做数据处理这一件事但它处于 DID/VC 技术栈的底层是任何 Python 身份方案都绕不开的基石。后续你可以在此基础上集成密码学库实现完整签名或通过 PyLD 的frame、to_rdf等方法探索更多数据互操作场景。去中心化身份的旅程就从跑通上面的第一段normalize代码开始吧【免费下载链接】pyldJSON-LD processor written in Python项目地址: https://gitcode.com/gh_mirrors/py/pyld创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考