# @canton-network/core-signing-blockdaemon 中文文档

规范地址：https://npmcn.com/package/%40canton-network/core-signing-blockdaemon/

版本：1\.17\.0
npm 元数据更新时间：2026-11-05T21:16:46.152Z
中文译文更新时间：2026-11-09T17:19:30.684Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40canton-network/core-signing-blockdaemon
原文对照：https://npmcn.com/package/%40canton-network/core-signing-blockdaemon/?lang=original
项目主页：https://github.com/canton-network/wallet/tree/main/core/signing-blockdaemon#readme
源码仓库：https://github.com/canton-network/wallet

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：77.3 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-12-29T15:08:02.267Z
- 最新版本发布：2026-11-05T21:16:45.932Z
- 近 30 天下载量：2141（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：52（近 12 个月 52 个）

## 中文简介

Blockdaemon 的钱包网关签名驱动程序

## 安装

```sh
npm install @canton-network/core-signing-blockdaemon
```

也可以使用：`pnpm add @canton-network/core-signing-blockdaemon`、`yarn add @canton-network/core-signing-blockdaemon`、`bun add @canton-network/core-signing-blockdaemon`

## README

# @ canton- network/ 核心签名- 屏蔽

此软件包提供了一个签名驱动程序,用于将钱包网关与 [布洛克达蒙](https://blockdaemon.com/)它执行 `SigningDriverInterface` 定义 `@canton-network/core-signing-lib`,允许钱包网关使用 Blockdaemon 的基础设施管理密钥并签名交易.

## 安装

这个软件包是钱包网关(Wallet Gateway monorepo)的一部分,一般作为工作空间依赖性安装.

```bash
pnpm add @canton-network/core-signing-blockdaemon
```

## 使用量

这个 `BlockdaemonSigningDriver` 在钱包网关的签名架构内使用 它需要一个包含 `baseUrl` 财务报告和审定财务报表 `apiKey` 为Blockdaemon服务.

### 初始化

```typescript
import BlockdaemonSigningDriver, {
    BlockdaemonConfig,
} from '@canton-network/core-signing-blockdaemon'

const config: BlockdaemonConfig = {
    baseUrl: 'https://api.blockdaemon.com/...', // Replace with actual Blockdaemon API URL
    apiKey: 'your-api-key',
}

const driver = new BlockdaemonSigningDriver(config)
```

### 特征

驱动程序支持以下操作:

-   **密钥管理**数字 :
    -   `createKey`: 在 Blockdaemon 上创建一对新密钥 .
    -   `getKeys`:获取可用的密钥列表.
-   **签名**数字 :
    -   `signTransaction`:使用指定的密钥签名交易.
-   **交易监测**数字 :
    -   `getTransaction`:获取特定交易的状况和细节.
    -   `getTransactions`:获取基于交易ID或公钥的交易列表.
-   **配置**数字 :
    -   `getConfiguration`: 返回当前配置( 隐藏敏感机密) .
    -   `setConfiguration`:在运行时更新驱动程序配置.

### 一体化

这个驱动程序是要注册到 `SigningController` 用于管理多个签名提供者的钱包网关.

```typescript
// Example integration (conceptual)
import { SigningController } from '@canton-network/core-signing-internal' // or similar

const signingController = new SigningController()
signingController.registerDriver(driver)
```

## 配置

司机接受一个 `BlockdaemonConfig` 对象 :

| 财产 | 类型 | 说明 |
| :-- | :-- | :-- |
| `baseUrl` | `string` | Blockdaemon 签名 API 的基础 URL . |
| `apiKey` | `string` | 用于认证的 API 密钥 . |

### 钱包网关配置

当运行钱包网关( Remote) 时, 在 网关配置. 列名 `blockdaemon` 下级 `signingProviders` 选择提供者 用于:

-   `signingProviders.blockdaemon.baseUrl`: Blockdaemon API 的基础 URL. 默认为 `http://localhost:5080/api/cwp/canton`。 。 。 .
-   `signingProviders.blockdaemon.caip2`: CAIP-2网络标识符. 默认为 `canton:testnet`。 。 。 .
-   `signingProviders.blockdaemon.apiKeyEnv`: 持有 API 键的环境变量名称。 默认为 `BLOCKDAEMON_API_KEY`。 。 。 .

API 密钥值停留在该环境变量中,从未被存储在配置文件中 .

若为 `signingProviders` 删去, `BLOCKDAEMON_API_KEY`, (中文(简体) ), `BLOCKDAEMON_API_URL`,以及 `BLOCKDAEMON_CAIP2` 从环境读取。 非秘密变量被忽略一次 `signingProviders` 已存在.

示例用法:

```json
{
    "signingProviders": {
        "blockdaemon": {
            "baseUrl": "https://api.blockdaemon.com/...",
            "caip2": "canton:testnet",
            "apiKeyEnv": "BLOCKDAEMON_API_KEY"
        }
    }
}
```

## 许可证

阿帕奇 - 2.0

## 常见问题

### @canton-network/core-signing-blockdaemon 是什么？

Blockdaemon 的钱包网关签名驱动程序

### 如何安装 @canton-network/core-signing-blockdaemon？

在项目目录运行 npm install @canton-network/core-signing-blockdaemon，或使用 pnpm add / yarn add / bun add。

### @canton-network/core-signing-blockdaemon 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @canton-network/core-signing-blockdaemon 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @canton-network/core-signing-blockdaemon 可以商用吗？

@canton-network/core-signing-blockdaemon 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @canton-network/core-signing-blockdaemon 的下载量有多少？

根据 npm 官方下载统计，@canton-network/core-signing-blockdaemon 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,141 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @canton-network/core-signing-blockdaemon 还在维护吗？

最新版本 1\.17\.0 发布于 2026/11/06（3 天前）；至今共发布 52 个版本，其中过去 12 个月发布了 52 个；首次发布于 2025/12/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。