跳到主要内容

DID 文档管理

每个 blocklet 都由一个去中心化标识符（DID）来标识，该标识符与一个 DID 文档相关联。此文档包含关键的元数据，例如公钥和服务端点，允许其他服务安全地发现您的 blocklet 并与之交互。虽然 Blocklet Server 通常会自动管理此文档，但在某些情况下需要手动更新。

本节介绍如何使用 CLI 管理您的 blocklet 的 DID 文档。

更新 DID 文档

blocklet document update 命令允许您手动刷新并重新发布特定 blocklet 的 DID 文档。这对于确保链上信息与您的 blocklet 当前配置完全同步非常有用。

用法

command

bash
blocklet document update <appId>

参数

参数描述
appId要更新的 blocklet 的 DID。

示例

运行该命令将触发更新过程，在与节点通信时会显示一个加载动画。

bash
blocklet document update z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2

成功完成后，您将看到一条确认消息：

bash
✔ 正在更新...
✔ 成功更新 z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2 的 did 文档！

如果找不到具有指定 appId 的 blocklet，该命令将失败并显示错误：

bash
✖ 更新 blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2 的 did 文档失败，错误：未找到 Blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2

常见用例

您可能需要在以下场景中使用此命令：

  • 配置更改后：如果您手动更改了影响 blocklet 面向公众的端点或元数据的设置，运行此命令可确保这些更改反映在 DID 文档中。
  • 故障排除：当遇到 DID 解析、身份验证或服务发现问题时，强制更新可以帮助排除同步问题。
  • 状态重新同步：在服务器迁移或从备份恢复后，确保链上 DID 文档是 blocklet 当前状态的精确表示。