使用 @blocklet/did-space-js 读写 DID Space
概览#
应用在大多数情况下希望能够读写用户在 DID Spaces 上的数据。一旦获取了 DID Space 的 endpoint，只需集成 @blocklet/did-space-js SDK，即可轻松实现对 DID Space 的读写操作。
先决条件#
- 您已经清楚如何在您的应用中引导用户连接 DID Spaces，并成功获取 DID Space endpoint，可以参考：
代码示例#
你可以本地使用 blocklet create 命令创建一个集成了 DID Spaces 的待办事项列表模板，也可以参考代码仓库 https://github.com/blocklet/create-blocklet/tree/main/packages/create-app/templates/todo-list-example 。
╰─➤ blocklet create
blocklet create v1.16.37-beta-20250108-010153-e4bcd256
Need to install the following packages:
create-blocklet@0.9.14
Ok to proceed? (y) y
(node:82979) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
(Use `node --trace-deprecation ...` to show where the warning was created)
Powered By
_ ____ _ _
/ \ _ __ ___| __ )| | ___ ___| | __
/ _ \ | '__/ __| _ \| |/ _ \ / __| |/ /
/ ___ \| | | (__| |_) | | (_) | (__| <
/_/ \_\_| \___|____/|_|\___/ \___|_|\_\
Create Blocklet v0.9.14
✔ Project name: … todo-list
? Choose one or more blocklet templates: ›
Instructions:
↑/↓: Highlight option
←/→/[space]: Toggle selection
[a,b,c]/delete: Filter choices
enter/return: Complete answer
Filtered results for: Enter something to filter
◯ [dapp] react + express.js
◯ [dapp] react + express + typescript
◯ [dapp: did-wallet] Full stack app (react.js + express.js) with DID Wallet integration
◉ [dapp: todo-list] react + express + typescript + DID Spaces // select did spaces template
◯ [dapp: did-connect] Full stack app (react.js + express.js) with DID Connect integration
◯ [dapp] solid + express.js
◯ [dapp] vue3 + express.js
◯ [dapp] svelte + express.js
◯ [static] react
◯ [static] solidjs操作流程#
安装 @blocklet/did-space-js#
yarn add @blocklet/did-space-js
// pnpm install @blocklet/did-space-js
// npm install @blocklet/did-space-js写入数据#
通过以下代码，您可以将数据写入用户的 DID Space 中：
const { SpaceClient, PutObjectCommand } = require('@blocklet/did-space-js');
const spaceClient = new SpaceClient({
endpoint,
wallet,
});
await spaceClient.send(
new PutObjectCommand({
key: 'test.txt',
data: 'hello world!',
})
);数据写入成功后，您可以在 DID Space 上进入应用的组件（z8iZmWXt56EZqA5Y2VcmUX6qFhZaj5w7pFQx9）根目录，查看刚才写入的数据：
读取数据#
通过以下代码，你可以从 DID Space 读取用户的数据：
const { SpaceClient, GetObjectCommand } = require('@blocklet/did-space-js');
const spaceClient = new SpaceClient({
endpoint, // DID Space endpoint
wallet, // Blocklet Wallet
});
const { data } = await spaceClient.send(
new GetObjectCommand({
key: 'test.txt',
})
);
console.log(await streamToString(data)); // 'hello world!'数据读取成功之后，会返回一个 data 对象，你可以通过 data 对象获取数据。
删除数据#
通过以下代码，你可以从 DID Space 删除用户的数据：
const { SpaceClient, DeleteObjectCommand } = require('@blocklet/did-space-js');
const spaceClient = new SpaceClient({
endpoint,
wallet,
});
await spaceClient.send(
new DeleteObjectCommand({
key: 'test.txt',
})
);如果你想了解 API 的更多用法，请参考：