Terminus(Olares)LarePass 身份钱包深度解析:DID、Olares ID 与可验证凭证的管理体系
Terminus(Olares)LarePass 身份钱包深度解析:DID、Olares ID 与可验证凭证的管理体系
本文基于 Terminus 开源仓库中的概念文档 Identity Wallet App,系统讲解 Olares 生态中数字身份钱包(Identity Wallet)的定位与能力边界:LarePass 如何承载去中心化标识符(DID)、Olares ID 与可验证凭证(VC)的全生命周期管理,以及 Mnemonic 备份、多 DID 管理、VC 签发与出示等核心机制。读完本文,你将理解 Olares 身份体系的三层结构(Mnemonic → DID → Olares ID),并能对照仓库源码确认其密钥派生与 VC 交互的真实实现路径。
一、为什么需要数字身份钱包
数字身份钱包(Digital Identity Wallet)是自主权身份(Self-Sovereign Identity,SSI)生态中的基础工具:它让用户在没有中心化机构参与身份认证与数据共享的前提下,自行管理 DID、凭证以及与数字服务的交互。
在 Olares(Terminus 项目所构建的分布式自托管操作系统)中,这一角色由 LarePass 承担。LarePass 是 Olares 的官方身份钱包客户端,基于 Olares ID 提供以下核心能力:
- 安全地生成与托管 DID 的密钥材料;
- 创建、绑定、备份和恢复 Olares ID;
- 在多台设备(iOS / Android / 桌面 / Chrome 扩展)之间同步身份;
- 管理绑定在 Olares ID 上的可验证凭证,支持签名、验证、发现与出示。
LarePass 目前提供多端客户端:iOS、Android、macOS、Windows、Linux(Beta,仅支持 x86_64 图形桌面环境)以及 Chrome 浏览器扩展,详见 Download LarePass。
二、Olares ID:把 DID 变得"可用"
2.1 Olares ID 的结构与域类型
Olares ID 是 Olares 生态中身份与信任的基础,其格式与邮箱一致,由本地名(local name)与域(domain)两部分组成,例如 alice123@olares.com 中 alice123 是本地名,olares.com 是域。本地名在同一域内唯一,且用户名部分要求 8–24 个字符。
Olares 中定义了三种域类型:
| 域类型 | 用途 | 约束 |
|---|---|---|
| Individual domain | 个人使用,类似个人邮箱 | 个人用户默认使用 olares.com 域 |
| Organizational domain | 组织使用,类似企业邮箱 | 域名长度 2–24 字符;用户加入组织后可申请该域下的 Olares ID,离开组织时管理员可吊销 |
| Entity domain | 无法归入个人或组织的应用及其他实体 | — |
绑定 Olares ID 后,系统会自动派生一组个人域名,例如 Olares ID 为 alice123@olares.com 时会分配 alice123.olares.com(个人主页)、desktop.alice123.olares.com(桌面入口)、files.alice123.olares.com(文件应用入口),且 Olares 域自带免费 HTTPS 证书。这些规则详见 Olares ID。
2.2 账号的三个阶段
wallet.md 提到"用户创建 Olares 账号时会先生成 DID,再绑定到新的 Olares ID",这一过程对应账号系统的阶段模型(见 Olares account system):
- DID 阶段(未绑定 Olares ID):本地已生成 Mnemonic、私钥与 DID,但尚无 Olares ID。此阶段可以导出/备份 Mnemonic、在 Olares Space 中申请组织域名,但还不能把账号导入其他 LarePass 客户端。
- 已绑定 Olares ID:系统把 Olares ID 与 DID 的绑定关系记录到区块链上。此时可以导出 Mnemonic 将账号导入其他设备,实现跨应用统一认证,并可在 Olares Space 中请求、激活 Olares。
- 已绑定 Olares:账号关联到具体设备,获得对系统资源监控等完整生态能力。
三、密钥与 DID 的源码级实现
3.1 从 Mnemonic 到 DID 的派生链
概念文档 DID 给出的派生序列为:
Mnemonic → Private Key → Public Key → DID
仓库中的 CLI 引导(wizard)模块完整实现了这条链路,核心文件是 did_key_utils.go:
- Mnemonic 生成:
GenerateMnemonic()通过bip39.NewEntropy(128)生成 128 位熵,再转换为 12 词 助记词(did_key_utils.go)。这就是文档中反复强调"12-word mnemonic phrase"的来源。 - HD 钱包推导:
NewHDWalletFromMnemonic()先用bip39.IsMnemonicValid校验助记词,再以bip39.NewSeed生成 64 字节种子;getMasterNode()按 BIP32 规则以"ed25519 seed"为 HMAC-SHA512 的 key 对种子求哈希,前 32 字节作为 Ed25519 私钥种子、后 32 字节作为 chain code(did_key_utils.go)。 - DID:key 构造:
createDIDFromPublicKey()将 Ed25519 multicodec 标识(0xed,ED25519_CODEC_ID常量)与公钥拼接后经 base58btc 编码,最终生成did:key:z<编码结果>形式的 DID(did_key_utils.go)。 - JWK 封装:
GetPrivateJWKTrustWalletCore()把公私钥封装为 OKP/Ed25519 的 JWK(ALG: EdDSA),其KID形如<did>#z<multicodec 编码的公钥>,用于后续的 JWS 签名(did_key_utils.go)。
对外暴露的便捷入口 GetDID(mnemonic)、GetPrivateJWK(mnemonic)、GetPublicJWK(mnemonic) 表明:只要持有 Mnemonic,即可在任何一端(移动端、桌面端、CLI)确定性重建同一套 DID 与密钥——这正是"跨设备导入账号只需 12 个单词"的底层原理。
3.2 账号激活时的绑定流程
auth.go 中的 UserBindTerminus() 展示了 Mnemonic 如何在设备绑定场景中使用:
- 以 Mnemonic 与 Olares 名称初始化全局存储(
InitializeGlobalStores),由 Mnemonic 恢复 DID; - 通过 BFL 网关完成第一因子认证(
auth.FirstFactor)获取会话 token; - 走 SSI 认证(
AuthTypeSSI+AuthPurposeSignup); - 用
globalUserStore.SignJWS()对{name, did, domain, time}载荷做签名; - 携带 DID、Mnemonic(作为 master password)、JWS、token 调用
app.Signup()完成注册,服务端返回 MFA 种子并保存在本地 UserStore,供后续两步验证使用(auth.go)。
从源码结构看,MFA 种子与 Mnemonic 的本地安全存储,对应了 多因子认证 中"LarePass 生成一次性验证码"的设计。
四、Olares ID 管理:创建、备份与多身份
wallet.md 列出的 Olares ID 管理功能在仓库文档中均有落地细节:
4.1 快速创建 vs 高级创建
- 快速创建(Quick creation):直接选取一个满足 8–24 字符规则且可用的名称,不做 VC 绑定,速度最快;
- 高级创建(Advanced creation):通过可验证凭证把已受信任的现实身份(如邮箱账号)与 Olares ID 建立密码学关联。流程是:通过 OAuth 提供方完成用户鉴权 → 在社交身份与 Olares DID 之间创建密码学链接。目前验证通道为 Google OAuth(文档中亦提及通过 Gmail Issuer 服务完成 VC 绑定)。
前端实现印证了这一流程。google.ts 中 googleLogin() 依次执行:
- 从 SSI store 拉取
Google的ClientSchema(get_application_schema('Google')),其中包含manifest与application_verifiable_credential; - 调用原生插件
LarePassSocialLogin完成 Google 登录(scope 为email),取得idToken; - 用
getSubmitApplicationJWS()以用户 DID 和私钥 JWK 对 manifest、VC 类型与idToken构造 JWS; - 将 JWS(可选附加 domain)POST 到
/get_google_info/,服务端返回verifiableCredentials[0],即最终绑定到该 DID 的 Google 类型 VC。
4.2 Mnemonic 备份/导入:账号恢复的唯一路径
12 词 Mnemonic 是恢复 Olares ID 的唯一手段。Back up mnemonic phrase 说明:
- 首次导出时会被要求设置 LarePass 本地密码(仅用于解锁本机 LarePass 服务,同设备多个 Olares ID 共享一个本地密码,不同设备相互独立),并可启用指纹/人脸等生物识别解锁;
- 备份路径为 Settings > LarePass settings > Safety > Mnemonic phrase,查看需输入本地密码,官方强烈建议离线抄写而非使用剪贴板;
- 丢失 Mnemonic 的后果是失去 DID 与 Olares ID 的所有权以及 Vault 数据的访问权;
- 在设备端删除账号前必须先完成 Mnemonic 备份,LarePass 会阻止未备份账号的删除(见 Manage accounts in LarePass)。
导入侧,无论移动端、桌面端还是 Chrome 扩展,操作路径一致:头像 → Switch account → Add account → Import account → 输入 12 词 Mnemonic(manage-accounts.md)。桌面端与 Chrome 扩展也可从此入口管理、删除账号。
4.3 多 DID / 多 Olares ID 管理
LarePass 支持在单一客户端内托管多个 DID/Olares ID,并随时通过 Switch account 页面切换。移动端可从主界面左上角头像或创建账号过程中右上角图标进入切换页;桌面端从左上角头像进入;Chrome 扩展则在右下角头像处选择。同一设备上多个 Olares ID 共享一个本地密码这一约束,意味着本地密码一旦遗忘会影响该设备上全部身份,应妥善保管。
五、VC 管理:Issuer、Holder、Verifier 三角色模型
wallet.md 指出,LarePass 让用户管理绑定在 Olares ID 上的 VC,并通过**签名(signing)、验证(verification)、发现(discovery)、出示(presentation)**四类过程与 VC 交互。其背后的角色与流程定义在 Verifiable Credential:
- Issuer(签发方):对主体做出断言(claims)并创建 VC 发送给持有者。例如 Gmail Issuer 服务就是 Google 邮箱类 VC 的签发方。
- Holder(持有者):持有并出示 VC 的实体,即使用 LarePass 保管凭证的用户。
- Verifier(验证方):通过 Presentation Definition 声明所需凭证、并对出示做验签的一方。
完整的验证过程包含六个步骤:Issuer 在 DID Registry 注册 → Holder 向 Issuer 提交签发申请 → Issuer 签发 VC → Holder 安全存入钱包 → Holder 把封装 VC 的 Verifiable Presentation(VP) 发给 Verifier → Verifier 通过 DID Registry 校验 VC 与 VP 的签名,完成验证。注意:VC 本身不上链,上链的是 DID 与 Olares ID 的绑定关系。
5.1 前端与 VC/DID 服务端的真实接口
ssi.ts 中的 Pinia store 暴露了 LarePass 与身份服务端通信的全部端点,可以视为钱包"发现与出示"能力的接口清单:
| 方法 | 端点 | 职责 |
|---|---|---|
pre_did_register(jws) |
POST /create_local |
本地 DID 注册(DID 阶段) |
get_name_by_did(did) |
GET /get_name_by_did/<did> |
按 DID 反查名称 |
resolve_did(did) |
GET /1.0/identifiers/<did> |
解析 DID 文档 |
resolve_name(name) |
GET /1.0/name/<name> |
按名称(@ 替换为 .)解析 |
get_application_schema(type) |
GET /get_application_schema/<type> |
获取某 VC 类型的签发 schema |
get_application_response(id) |
GET /get_application_response/<id> |
轮询 VC 签发结果 |
get_presentation_definition(type) |
GET /get_presentation_definition/<type> |
获取出示定义(Verifier 侧要求) |
submit_presentation(jws, address, domain) |
POST /submit_presentation |
提交签名的 Verifiable Presentation |
join_organization(jws) |
POST /olaresid/join_org |
以 JWS 申请加入组织域 |
其中 didInstance() 与 vcInstance() 分别指向 DID 网关与 VC 服务,二者按用户语言/区域(cn / en 等)从 GolbalHost.DID_GATE_URL、GolbalHost.VC 选择端点(ssi.ts),并统一注入 User-Agent 头。从源码结构看,submit_presentation 的 address 参数即 Verifier 的地址,与 vc.md 中"Holder 向 Verifier 发送 VP"的描述一一对应。
六、安全边界与设计约束
结合 wallet.md 及其引用的周边文档,LarePass 身份钱包的安全模型可以归纳为几条硬约束:
- 私钥永不离开钱包:DID 派生与 JWS 签名都在客户端完成(如
GetPrivateJWK、SignJWS),服务端只接收签名结果; - Mnemonic 是唯一恢复凭据:没有中心化"忘记密码"通道,因此系统强制"先备份、后删除";
- 本地密码 + 生物识别是设备侧的第二道门:查看 Mnemonic、解锁钱包操作都受其保护;
- VC 与 DID 分层:Olares ID 绑定关系上链保证可验证性,VC 本体保存在钱包中、按需出示,避免隐私数据全局公开。

