跳到主要内容

在安装启动流程中获得 DID Space 的 endpoint

概览

概览

如果您希望在应用安装启动时,就确定将所有数据存储到某个特定的 DID Space(通常是 Owner DID Space)上,那么本教程将能够满足您的需求。

通过这种连接 DID Spaces 的方式,最典型的应用莫过于 NFT Maker。NFT Maker 在安装启动流程中连接到 DID Spaces,获取到 Owner DID Space 的端点,之后在整个 NFT Maker 平台上产生的 NFT 都会存储在这块 DID Space 上。

先决条件

  • 确保你已经有自己的 DID Space 可供调试,如果还没有可以参考 获得 DID Space 获得。
  • 您的应用在配置文件 blocklet.yml 中将 capabilities.didSpace 设置为 requiredOnSetup,这表示应用在安装时必须连接 DID Spaces 服务。

操作流程

Owner 连接 DID Space

在应用首次启动时的流程中,系统将要求您连接 DID Spaces 服务。请您选择要连接的 DID Space:

image.png

连接成功之后,点击继续,已完成安装.

image.png

应用读取用户的 DID Space endpoint

此时,你的应用在运行的状态下可以通过环境变量 BLOCKLET_APP_SPACE_ENDPOINT 读取到 DID Space 的 endpoint,它的值形如:

javascript
console.log(process.env.BLOCKLET_APP_SPACE_ENDPOINT);
// 输出形如: https://space.team.arcblock.io/app/api/space/zNKhe8jwgNZX2z7ZUfwNddNECxSe3wyg7VtS/app/zNKfEK9actwBeLhfVvc9U1p1CqVWxtivVxo6/object/

在获得 DID Space endpoint 之后,你的应用将可以在这个 DID Space 上进行数据的读写,可参考: Using @blocklet/did-space-js to read and write DID Space.