跳到主要内容

DID Space 前端组件库

XianLing
DID SpacesProduct ReleaseStorage

连接 DID Space 是 Blocklet 应用使用 DID Space 服务的第一步。为了让这一过程更加简单顺畅,我们提供了专门的组件库:@blocklet/did-space-react ,用于帮助开发者轻松实现 DID Space 的连接和展示。

概述

该组件库主要提供了:

  1. <DIDSpaceConnect> 组件:此组件允许您在页面上轻松创建一个连接 DID Space 的按钮。点击该按钮成功连接 DID Space 后,系统会返回一个 spaceGateway 对象,其中包含 DID Space 的名称、DID、站点 URL 等信息,开发者可以根据需要选择如何存储该对象。代码示例可参考 Demo。
  2. <DIDSpaceConnection> 组件:此组件用于展示已连接的 DID Space 的基本信息和连接状态。代码示例可参考 Demo。

演示案例

通过钱包连接 DID Space

以 Blocklet Server 控制面板为例,点击<DIDSpaceConnect> 组件提供的 Connect with DID Wallet 功能:

image.png

然后在钱包出示的 NFT 中选择目标 DID Space:

image.png

最后使用<DIDSpaceConnection> 组件显示已连接的 DID Space:

image.png

通过网关地址连接 DID Space

<DIDSpaceConnect> 组件还支持通过 DID Space 网关地址来发起定向连接,避免通过 DID Wallet 连接时从众多 NFT 中选择的麻烦。

首先点击 Connect using the DID Spaces gateway 功能:

image.png

然后输入 DID Space 网关地址(如果您不知道如何获取 DID Space 网关地址,可以参考教程):

image.png

连接过程中只会出示目标 DID Space 的 NFT:

image.png

最后完成连接,使用 <DIDSpaceConnection> 组件展示:

image.png

DID Space 连接状态说明

  • 已连接:绿色已连接状态表示该 DID Space 正常运行,可以进行备份、写入数据等操作:

image.png

  • 未连接:灰色未连接状态表示与该 DID Space 的连接已中断,需要重新连接:

image.png

  • 连接异常:红色异常状态表示该 DID Space 无法使用,用户需要关注并根据提示解决问题:

image.png

DID Space ​常见异常状态

  • 用量不足:对于有用量限制的 DID Space(如钱包账户默认创建的 DID Space),如果 DID Space 存储单元耗尽,会出现用量不足的提示:

image.png

  • 订阅过期:对于企业版付费的 DID Space,若订阅过期,则会提示订阅已过期:

image.png

  • 账单逾期:对于企业版付费的 DID Space,若存在逾期账单,则会提示账单逾期:

image.png

  • 版本不兼容:对于老版本的 DID Space,会提示用户进行升级,否则无法进行备份等操作:

image.png

  • CORS 拦截:若遇到 CORS 拦截错误,通常与 DID Space 的安全设置有关。具体解决方案请参考相关文档:

image.png

  • 网络错误:如果出现网络连接问题、服务器故障或目标 DID Space 服务不可用,系统将显示网络错误提示:

image.png

其它改进

应用启动流程

对于需要连接 DID Space 的应用,其安装流程已优化为使用最新的 DID Space 连接组件,更加方便:

image.png

控制面板

DID Spaces 升级为顶层菜单,管理员用户可以更方便地管理 DID Space 的连接。

其中 Backup 页签用于配置进行应用备份/还原的DID Spaces:

image.png

Storage 页签用于配置存储应用业务数据的 DID Spaces:

image.png

个人中心

Profile 页面已使用最新的 DID Space 组件支持会话级别的 DID Sapces 配置,用户可以更高效地管理个人连接:

image.png

会话管理

用户菜单现在会显示已连接的会话级别 DID Spaces,方便用户随时查看和切换:

image.png

参与 Bug Bounty 计划,帮助我们改进

如果您在使用过程中有任何需求、建议或问题,请访问 ArcBlock 社区进行反馈,我们将尽力帮助。您还可以参与我们的 Bug Bounty 计划,帮助我们改善 DID Spaces 的产品体验。

ArcBlock 202412 Bug Bounty

本页涉及

产品

  • DID Spaces renamed

    与一个 DID 关联的数据空间。可以建一个个人空间,也可以按某项任务所需的权限和数据模型接入一个应用。