:从助记词到链上身份的自生成机制)
云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载去中心化标识符Decentralized IdentifierDID是 Olares 个人云操作系统身份体系的地基它无需任何中心化注册机构即可全球唯一、可验证地标识一个主体并在 Olares ID 中通过助记词 → 私钥 → 公钥 → DID 链上地址的自生成流程落地。本文以 docs/zh/developer/concepts/did.md 为核心脉络结合仓库中 cli/pkg/wizard/did_key_utils.go 与 cli/pkg/web5/dids 的源码实现完整讲清 DID 的结构定义、派生算法、实际应用与安全注意事项。DID 是什么自主、全球唯一、可验证的标识符去中心化标识符DID由 W3C DID Core 规范定义是一种自主管理self-sovereign、全球唯一且无需中心化注册即可验证的标识符。DID 可以指向任何主体——个人、组织、物品、数据模型或抽象实体具体指向什么由它的控制者Controller决定。DID 的核心目标是让个人与组织掌控自身身份信息并可在无需第三方介入的前提下选择性且安全地共享这些信息。在 Olares 中这一理念被进一步落到产品形态上Olares 以 DID 与区块链注册表为支柱构建了去中心化、可点对点直接交换信息与价值的自主权网络详见 docs/developer/concepts/self-sovereign-network.md。DID 的三段式结构一个完整 DID 由三部分组成组件说明DID URI 方案标识指明标识符的格式固定为didDID 方法标识指定用于创建 DID 的协议 / 方法如key、jwk、dht、web方法专属标识Method-Specific ID方法内部唯一标识以仓库中 Olares 实际生成的did:key:z...为例did是 URI 方案标识key是方法标识表示该 DID 由公钥本身直接派生无需链上注册即可离线解析z...是方法专属标识——一串以z开头的 Base58btc 编码字符串。从源码层面看cli/pkg/web5/dids/did/did.go 中的DID结构体完整建模了这段语法除了URI、Method、ID三个核心字段外还支持可选的参数Params、路径Path、查询Query与片段Fragment并严格遵循 W3C DID Core 的 ABNF 语法规则did.go 中的正则定义对任意 DID URI 进行解析。Parse函数会按^did:method:method-specific-id...的模式拆分输入解析失败时返回invalid DID URI错误。Olares ID 中 DID 的派生流程在 Olares ID 中DID 通过类似区块链地址的助记词算法自生成整个流程可以概括为一条单向链助记词 → 私钥 → 公钥 → DID 链上地址第一步助记词Mnemonic随机生成的 12 个英文单词用于派生私钥。它是一切身份密钥的种子也是账户跨设备迁移与恢复的唯一凭证。仓库实现位于 cli/pkg/wizard/did_key_utils.go 的GenerateMnemonic()通过 BIP39 标准生成 128 位熵再由熵生成 12 单词助记词。也就是说12 个单词对应 128 bit 随机熵保证全球唯一性与足够的暴力破解难度。// GenerateMnemonic generates new BIP39 mnemonic func GenerateMnemonic() string { // Generate 128 bits of entropy for 12-word mnemonic entropy, err : bip39.NewEntropy(128) ... mnemonic, err : bip39.NewMnemonic(entropy) ... return mnemonic }第二步私钥Private Key私钥由助记词派生需妥善保管它用于生成公钥与链上地址。泄露私钥等于交出整个身份的控制权。源码中NewHDWalletFromMnemonic 先用bip39.IsMnemonicValid校验助记词合法性再用bip39.NewSeed生成 64 字节种子随后 getMasterNode 以ed25519 seed作为 HMAC-SHA512 密钥对种子做 HMAC 运算取哈希前 32 字节作为私钥种子、后 32 字节作为链码——这正是 BIP32 分层确定性HD钱包主节点生成的实现方式模拟了 Trust Wallet Core 的行为。最终通过ed25519.NewKeyFromSeed得到完整的 Ed25519 私钥对。第三步公钥与链上地址公钥由私钥计算得出可公开分享链上地址用于 DID 注册。在 Olares 中这一步由 createDIDFromPublicKey 完成产出标准的did:key地址取 Ed25519 公钥32 字节将 multicodec 标识0xedEd25519 编解码器 ID常量定义见 did_key_utils.go用 varint 编码后与公钥拼接对拼接结果做 Base58btc 编码并加前缀z最终得到形如did:key:z6Mk...的链上地址。func createDIDFromPublicKey(publicKey ed25519.PublicKey) (string, error) { codecBytes : varint.ToUvarint(ED25519_CODEC_ID) idBytes : make([]byte, len(codecBytes)len(publicKey)) copy(idBytes, codecBytes) copy(idBytes[len(codecBytes):], publicKey) id : base58.Encode(idBytes) return fmt.Sprintf(did:key:z%s, id), nil }仓库还以GetDID、GetPrivateJWK、GetPublicJWK三个便捷函数分别暴露助记词 → DID 地址 / 私钥 JWK / 公钥 JWK的完整派生入口见 did_key_utils.go并生成带KID格式为did:key:z...#z...、ALG: EdDSA、CRV: Ed25519、KTY: OKP、USE: sig的标准 JWK 密钥对可直接用于 Web5 体系的签名与验证。从 Web5 SDK 看 DID 的创建、解析与文档结构除了向导侧的自生成实现Olares 还内置了一套完整的 Web5 DID 工具包cli/pkg/web5/dids按每种 DID 方法一个独立包 统一解析器的原则组织cli/pkg/web5/dids/didkey/didkey.go 的Create()默认使用LocalKeyManager与 Ed25519 算法生成密钥进而产出did:key及其 DID Document。通过函数式选项KeyManager、AlgorithmID可以替换密钥管理后端或算法cli/pkg/web5/dids/didkey/key.go 的KeyToID()与上述createDIDFromPublicKey采用完全一致的编解码约定multicodec0xed Base58btcz前缀cli/pkg/web5/dids/didcore/document.go 实现了 W3C DID Core 的全部数据结构包括Document、VerificationMethod、Service以及assertionMethod、authentication、capabilityDelegation、capabilityInvocation、keyAgreement五类验证用途。创建 DID 时createDocument会把公钥同时挂到前四类用途上供签名、登录认证、能力委托与调用使用cli/pkg/web5/dids/resolver.go 提供单例 DID 解析器Resolve()先按语法解析 URI再按方法分发到对应解析器对未注册的方法返回methodNotSupported语法错误返回invalidDid。DID 在 Olares 中的实际应用DID 不是停留在概念层的抽象而是贯穿用户初始化、签名认证与数据存储的关键标识用户密钥存储NewUserStore(mnemonic, terminusName)会从助记词一次性派生出 DID 与公私钥 JWK并保存在UserStore中见 cli/pkg/wizard/user_store.go此后GetDid()、GetPrivateJWK()供各业务模块直接取用签名与认证UserStore.SignJWS()将私钥导入LocalKeyManager重建BearerDID与 DID Document然后以 DID URI 作为 JWT 签发者Issuer调用 Web5 JWT 签名见 user_store.go实现真实密钥签名的 JWS 凭证——这是 Olares 中身份证明与授权的基础数据隔离用户的应用状态以 DID 为命名空间存储如 cli/pkg/wizard/app_state.go 中app-state-did的存储 ID 设计以及 cli/pkg/wizard/app.go 日志中account.did与 CLI 侧mv.id的一致性校验都表明 DID 是用户数据归属与校验的核心键链上注册与名称解析创建 Olares 用户前CLI 会通过 cli/cmd/ctl/settings/users/did_precheck.go 对userexample.olares.com形式的 Olares ID 做 DID 网关预检域名后缀为olares.cn走api.olares.cn/did否则走api.olares.com/did。若网关返回failed to resolve did则表明该身份尚未在区块链上成功解析注册见 did_precheck.go。Olares ID 与 DID 的关系DID 解决了去中心化网络中的身份难题但did:key:z6Mk...这种长串对人类而言难以记忆和使用。因此 Olares 在 DID 之上封装了Olares ID——一种类似邮箱地址的易记标识如alice123olares.com既保留了 DID 的密码学可验证性与去中心化特性又做到了人性化、易分享详见 docs/developer/concepts/olares-id.md。每个 Olares ID 都绑定一个 DID用户使用 Olares 创建账户的同时DID 即随之生成。账户在其生命周期内会经历未绑定与已绑定两个阶段——未绑定阶段已在本地产出助记词、私钥与 DID但尚无 Olares ID此时即可导出备份助记词并借助助记词在其他设备导入账户实现跨设备统一认证见 docs/developer/concepts/account.md。安全注意事项妥善保管私钥与助记词:::warning 重要 请务必妥善保管私钥与助记词避免泄露并确保可恢复性。 :::这条警告背后是两层现实约束不可逆性派生链是单向的助记词 → 私钥 → 公钥 → DID 地址但反向不可推导。丢失助记词意味着丢失私钥与整个身份而助记词泄露则意味着任何持有者都能重建私钥并冒充该身份去中心化的代价DID 体系没有中心化机构可以挂失或重置。与邮箱密码可找回不同DID 身份的恢复完全依赖助记词的妥善备份——这也是 Olares 账户体系将导出并备份助记词作为未绑定阶段首要操作的原因。实践中建议将助记词离线备份如抄写在纸上并妥善存放于安全位置切勿以明文形式存储于易失介质或通过网络传输并优先配合密码管理器或硬件钱包保管私钥材料。小结从 W3C 的三段式语法到 Olares 中12 词 BIP39 助记词 → HD 钱包派生 Ed25519 私钥 → multicodec Base58btc 编码生成did:key链上地址的完整实现DID 为 Olares 提供了自主、全球唯一、密码学可验证的身份基石。它与易记的 Olares ID 互为表里共同支撑起签名认证、用户数据隔离、链上注册解析等关键环节。理解这条派生链是深入理解 Olares 身份体系与去中心化网络设计的起点。延伸阅读仓库内DID 概念文档 与英文版 docs/developer/concepts/did.mdOlares ID 概念文档助记词派生实现Web5 DID 工具包说明DID 解析器 与 DID Document 数据结构赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐Olares DID Registry 解析基于区块链智能合约的去中心化身份注册机制Olares DID Registry 解析基于区块链智能合约的去中心化身份注册机制 在 OlaresTerminus的自主权身份体系中DID 生成之后云原生后端运维如何理解Diem域名系统区块链上的去中心化身份标识解决方案如何理解Diem域名系统区块链上的去中心化身份标识解决方案 Diem区块链的核心使命是构建一个全球信任的金融网络其中去中心化身份标识系统扮演着关键角色。Di区块链金融科技Olares ID 全解析Olares 生态去中心化身份体系的架构、结构与创建机制Olares ID 全解析Olares 生态去中心化身份体系的架构、结构与创建机制 Olares ID 是 Olares 个人云操作系统中身份与信任体系的地基云原生后端运维上一篇Repomix Explorer Skill 实战指南让 Claude Code 等 AI 助手用自然语言探索任意代码仓库下一篇像老乡鸡那样做笋子烧肉CookLikeHOC 菜谱还原与烧肉汁标准化解析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考