跳到主要内容

@arcblock/did

该软件包提供了一个 JavaScript 库,用于处理 ArcBlock 的去中心化身份(DID)协议。它允许你创建、管理和验证 DID,这对于在 OCAP 平台上构建应用程序至关重要。本节介绍了该库的基本功能。

要深入了解其底层原理,请参阅我们的核心概念。有关所有可用功能的详细分解,请参阅 API 参考

安装

首先,使用 npm 或你偏好的包管理器安装必要的包。

安装

bash
npm install @ocap/mcrypto @arcblock/did

快速入门

你可以轻松地从一个密钥生成一个新的 DID。该库会处理加密操作,以派生公钥,并根据指定的角色和加密类型构建相应的 DID 地址。

从密钥生成 DID

javascript
const Mcrypto = require('@ocap/mcrypto');
const { fromSecretKey } = require('@arcblock/did');

// 从 Mcrypto 解构所需的类型
const { types } = Mcrypto;

// 1. 生成一个新的 Ed25519 密钥对
const keyPair = Mcrypto.Signer.Ed25519.genKeyPair();

// 2. 从密钥生成 DID
// 我们指定角色、公钥类型和哈希算法
const didAddress = fromSecretKey(keyPair.secretKey, {
  role: types.RoleType.ROLE_APPLICATION,
  pk: types.KeyType.ED25519,
  hash: types.HashType.SHA3,
});

// 3. 完整的 DID 字符串包含 'abt:did:' 前缀
console.log(`Generated DID: abt:did:${didAddress}`);

这个例子演示了创建应用程序 DID 的基本工作流程。对于更高级的用例,例如从公钥创建 DID 或验证 DID 所有权,请参阅以下各节中的详细指南。

后续步骤

通过探索以下部分,更深入地了解 ArcBlock DID 的具体细节。