每個 blocklet 都由一個去中心化識別碼（DID）進行識別，此識別碼與一個 DID 文件相關聯。該文件包含關鍵的元資料，例如公鑰和服務端點，讓其他服務能夠安全地發現您的 blocklet 並與之互動。雖然 Blocklet Server 通常會自動管理此文件，但在某些情況下，手動更新是必要的。
本節將說明如何使用 CLI 來管理您的 blocklet 的 DID 文件。
更新 DID 文件
blocklet document update 指令可讓您手動更新並重新發布特定 blocklet 的 DID 文件。這有助於確保鏈上資訊與您 blocklet 的當前設定完全同步。
用法
command
blocklet document update <appId>參數
| 參數 | 說明 |
|---|---|
appId | 要更新的 blocklet 的 DID。 |
範例
執行此指令將觸發更新程序，在與節點通訊時會顯示一個轉動的圖示。
blocklet document update z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2成功完成後，您將看到一則確認訊息：
✔ 更新中...
✔ 成功更新 z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2 的 did 文件！如果找不到具有指定 appId 的 blocklet，此指令將會失敗並顯示錯誤訊息：
✖ 更新 blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2 的 did 文件失敗，錯誤：找不到 Blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2常見用例
您可能在以下情況需要使用此指令：
- 更改設定後：如果您手動更改了影響 blocklet 公開端點或元資料的設定，執行此指令可確保這些變更反映在 DID 文件中。
- 疑難排解：當遇到 DID 解析、身份驗證或服務發現等問題時，強制更新有助於排除同步問題。
- 狀態重新同步：在伺服器遷移或從備份還原後，確保鏈上 DID 文件能精確地代表 blocklet 的當前狀態。