各blockletは分散型識別子（DID）によって識別され、DIDドキュメントに関連付けられています。このドキュメントには、公開鍵やサービスエンドポイントなどの重要なメタデータが含まれており、他のサービスがあなたのblockletを安全に発見し、やり取りすることを可能にします。通常、Blocklet Serverがこのドキュメントを自動的に管理しますが、手動での更新が必要な場合もあります。
このセクションでは、CLIを使用してblockletのDIDドキュメントを管理する方法について説明します。
DIDドキュメントの更新
blocklet document updateコマンドを使用すると、特定のblockletのDIDドキュメントを手動で更新し、再公開できます。これは、オンチェーン情報がblockletの現在の設定と完全に同期していることを確認するのに役立ちます。
使用方法
command
blocklet document update <appId>引数
| Argument | Description |
|---|---|
appId | 更新するblockletのDID。 |
例
コマンドを実行すると更新プロセスが開始され、ノードとの通信中はスピナーが表示されます。
blocklet document update z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2正常に完了すると、次の確認メッセージが表示されます。
✔ 更新中...
✔ z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2のDIDドキュメントの更新に成功しました！指定されたappIdを持つblockletが見つからない場合、コマンドはエラーで失敗します。
✖ blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2のDIDドキュメントの更新に失敗しました、エラー：Blocklet z8ia12z3ySA1J5694T1aW3E8a3z3e1X9V3E2が見つかりません一般的なユースケース
次のようなシナリオでこのコマンドを使用する必要がある場合があります。
- 設定変更後: blockletの公開エンドポイントやメタデータに影響を与える設定を手動で変更した場合、このコマンドを実行して、それらの変更がDIDドキュメントに反映されるようにします。
- トラブルシューティング: DIDの解決、認証、またはサービスディスカバリーで問題が発生した場合、強制的に更新することで同期の問題を除外できます。
- 状態の再同期: サーバーの移行やバックアップからの復元後、オンチェーンのDIDドキュメントがblockletの現在の状態を正確に表していることを確認するため。