# @dfinity/ic-pub-key 中文文档

规范地址：https://npmcn.com/package/%40dfinity/ic-pub-key/

版本：1\.0\.2
npm 元数据更新时间：2026-10-05T08:12:58.501Z
中文译文更新时间：2026-11-12T05:32:37.816Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40dfinity/ic-pub-key
原文对照：https://npmcn.com/package/%40dfinity/ic-pub-key/?lang=original
项目主页：https://github.com/dfinity/ic-pub-key#readme
源码仓库：https://github.com/dfinity/ic-pub-key

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

- 包体积（解压后）：6.1 MB，53 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：8 个
- 首次发布：2025-07-01T15:44:22.492Z
- 最新版本发布：2026-05-21T09:19:25.933Z
- 近 30 天下载量：4501（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 6 个）

## 中文简介

用于为互联网上使用的门槛签名计划获取公钥的图书馆

## 安装

```sh
npm install @dfinity/ic-pub-key
```

也可以使用：`pnpm add @dfinity/ic-pub-key`、`yarn add @dfinity/ic-pub-key`、`bun add @dfinity/ic-pub-key`

## README

# IC 公钥

用于使用ICP公钥工作的TypeScript库.

互联网 计算机 Protcol 支持几个阈值签名方案 包括ECDSA, Ed25519,和BIP340 Schnorr. 在这些方案中,各种用户 公共密钥来源于一个主密钥,该密钥在 a 中的节点之间分割 子网络. 这种推导可在线进行,使用 `ecdsa_public_key` 财务报告和审定财务报表 `schnorr_public_key` 但因为没有秘密 也可以在线下进行.

此库包含此衍生的 TypeScript 执行, 允许 键由前端应用程序生成而无需调用 IC.

您可以在其中找到相同功能的 Rust 执行 [`ic_secp256k1`](https://docs.rs/ic-secp256k1/) 财务报告和审定财务报表 [`ic_ed25519`](https://docs.rs/ic-ed25519/) 货箱.

# 使用量

## `npm`

```
npm install @dfinity/ic-pub-key
```

## 命令行

从另一把公用钥匙取出:

```
npx @dfinity/ic-pub-key derive ecdsa secp256k1 --pubkey 02b84ff3f88329a887657d0309bd1a1af9e37601e5d1a535d6fe7d42e37f79f40a --chaincode 212891bc032f28d369bacf39dc369feb516eced9a3d83498246aead1546f8cd1 --derivationpath fee/fie/foo/fum
```

命令行还包括与 [串联符号](https://github.com/dfinity/chain-fusion-signer)例如,在链式聚变符号上获取一个主电站的Ethereum地址:

```
npx @dfinity/ic-pub-key signer eth address -u nggqm-p5ozz-i5hfv-bejmq-2gtow-4dtqw-vjatn-4b4yw-s5mzs-i46su-6ae
```

或者在链状核聚变标志上 获得主网地址:

```
npx @dfinity/ic-pub-key signer btc address -u nggqm-p5ozz-i5hfv-bejmq-2gtow-4dtqw-vjatn-4b4yw-s5mzs-i46su-6ae -n mainnet
```

## 常见问题

### @dfinity/ic-pub-key 是什么？

用于为互联网上使用的门槛签名计划获取公钥的图书馆

### 如何安装 @dfinity/ic-pub-key？

在项目目录运行 npm install @dfinity/ic-pub-key，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ic-pub-key，可以用 npx ic-pub-key 直接运行。

### @dfinity/ic-pub-key 支持 TypeScript 吗？

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

### @dfinity/ic-pub-key 支持 ESM 还是 CommonJS？

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

### @dfinity/ic-pub-key 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dfinity/ic-pub-key 可以商用吗？

@dfinity/ic-pub-key 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dfinity/ic-pub-key 的下载量有多少？

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

### @dfinity/ic-pub-key 还在维护吗？

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