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

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

版本：1\.7\.0
npm 元数据更新时间：2026-11-05T21:16:46.045Z
中文译文更新时间：2026-11-09T18:24:34.383Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：124 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-09-01T18:40:18.244Z
- 最新版本发布：2026-11-05T21:16:45.871Z
- 近 30 天下载量：1958（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

BitGo 钱包网关签名驱动程序

## 安装

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

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

## README

# BitGo 签名驱动程序

使用 BitGo TSS MPC 保管钱包 API 签名和检索 Canton 交易的驱动程序, 执行 `SigningDriverInterface` 从 `@canton-network/core-signing-lib`。 。 。 .

## 如何运作

BitGo 标志 Canton 通过其 MPC TSS 协议同步进行交易 :

1.  **密钥创建** – BitGo 保管钱包按州方创建(`POST /api/v2/{coin}/wallet`) (中文(简体) ). 回来的 `Key` 携带 BitGo 钱包 ID 为 `id` (稳定的路由标识符)和 Ed25519 从钱包密钥链中衍生出来的公钥 `m/0` 作为 `publicKey` (用于州政党分配和指纹生成).
2.  **签名请求** - Canton交易作为电文签名请求提交(`POST /api/v2/wallet/{walletId}/msgrequests`返回 a `txRequestId` 立即获得状态 `pending`。 。 。 .
3.  **投票** 钱包网关民调 `getTransaction(txRequestId)` 直至 `status === 'signed'`。Ed25519签名和Canton签名人的指纹取自签名的tx请求回复.

## 全权证书

1.  签名到 [位移](https://app.bitgo.com/) (或 [BitGo 测试](https://app.bitgo-test.com/) (原始内容存档于2018-10-21). for testnet.
2.  创建一个 **长寿访问托肯** 内 _用户设置 – 开发者选项 – 访问托肯_。选择您使用大小写所需的范围(至少是钱包管理和交易签名).
3.  请注意你 **企业编号** 从 _设置-企业_。这是钱包创建所需的.

## 钱包网关配置

在钱包网关配置中配置非机密值 。 列名 `bitgo` 下级 `signingProviders` 在 :

| 网关配置字段 | 需求 | 说明 |
| --- | --- | --- |
| `signingProviders.bitgo.baseUrl` | 没有 | API 基础 URL. 默认为 `https://app.bitgo.com` (prod) (英语). 使用 `https://app.bitgo-test.com` 为测试网. |
| `signingProviders.bitgo.enterpriseId` | 没有 | BitGo企业ID. 所需经费 `createKey`。启用重启安全 `getTransaction` 通过企业 tx 请求端点返回. |
| `signingProviders.bitgo.coin` | 没有 | 广州硬币识别码. 自动检测 : `tcanton` 页:1 `bitgo-test.com` URL( URL) , (中文), `canton` 用于其他所有项目(工具、代理、自定义 URL). |
| `signingProviders.bitgo.accessTokenEnv` | 没有 | 持有访问符的环境变量名称 。 默认为 `BITGO_ACCESS_TOKEN`。符号值留在环境中. |

若为 `signingProviders` 钱包网关使用遗留的发现 读取 `BITGO_ACCESS_TOKEN`, (中文(简体) ), `BITGO_API_URL`, (中文(简体) ), `BITGO_ENTERPRISE_ID`,以及 `BITGO_COIN` 从 环境。 非秘密变量被忽略一次 `signingProviders` 已存在.

## 交易状态生命周期

BitGo 签名是同步的——MPC TSS协议需要多个内部回合才能产生签名. 驱动程序将 BitGo 状态映射到 Canton `SigningStatus`数字 :

| BitGo 状态 | 州地位 | 页:1 |
| --- | --- | --- |
| `initialized`, (中文(简体) ), `pendingApproval`, (中文(简体) ), `pendingDelivery`, (中文(简体) ), `pendingUserSignature`, (中文(简体) ), `pendingUserCommitment`, (中文(简体) ), `pendingUserRShare`, (中文(简体) ), `pendingUserGShare`, (中文(简体) ), `readyToSend` | `pending` | MPC 回合进行中 |
| `messages[0].state === 'signed'` | `signed` | 信件级别状态优先 – 签名完成, 即使 tx 请求仍在 `pendingDelivery` |
| `delivered`, (中文(简体) ), `signed` | `signed` |  |
| `canceled`, (中文(简体) ), `rejected` | `rejected` |  |
| `failed` | `failed` |  |

## 恢复复原能力

驱动程序为快速查询保留内存( Q)`txRequestId → walletId`, (中文(简体) ), `publicKey ↔ walletId`) (中文(简体) ). 如果进程重新启动,这些缓存是空的. 交易通过 BitGo 企业 tx 请求端点回收( 需要) `BITGO_ENTERPRISE_ID`) (中文(简体) ). 公共密钥在不缓存时通过 BitGo 钱包和密钥链端点按要求解决每个钱包.

## 发展

```bash
pnpm build                                                   # compile
pnpm nx test @canton-network/core-signing-bitgo              # run tests
pnpm nx test @canton-network/core-signing-bitgo -c coverage  # with coverage report
```

## 常见问题

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

BitGo 钱包网关签名驱动程序

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

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

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

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

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

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

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

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

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

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

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

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