# @exodus/bip39 中文文档

规范地址：https://npmcn.com/package/%40exodus/bip39/

版本：1\.1\.1
npm 元数据更新时间：2026-10-09T20:37:57.400Z
中文译文更新时间：2026-11-14T03:52:00.283Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40exodus/bip39
原文对照：https://npmcn.com/package/%40exodus/bip39/?lang=original
项目主页：https://github.com/ExodusMovement/exodus/tree/master/libs/libraries/bip39
源码仓库：https://github.com/ExodusMovement/exodus

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

- 包体积（解压后）：35.6 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2025-06-04T22:23:22.917Z
- 最新版本发布：2026-10-09T20:37:57.224Z
- 近 30 天下载量：44620（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 3 个）

## 中文简介

BIP39单元

## 安装

```sh
npm install @exodus/bip39
```

也可以使用：`pnpm add @exodus/bip39`、`yarn add @exodus/bip39`、`bun add @exodus/bip39`

## README

# `@exodus/bip39`

Java 脚本执行 [比特币 BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki): 用于生成决定性密钥的Mnemonic 代码

这个库更喜欢本土的网络crypto,所以所有的方法都是Aync.

前款 : [https://github.com/bitcoinjs/bip39 (英语)](https://github.com/bitcoinjs/bip39)

## 安装

```bash
npm install @exodus/bip39
```

## 输入大小

-   **128 位数** - 12个字
-   **160 位点** · 15个字
-   **192 位数** \* 18个字
-   **224个比特** - 21个字
-   **256 位数** \* 24个字

## API 参考

### `generateMnemonic({ bitsize, wordlist = english })`

以给定比特大小生成随机元音.

**参数:**

-   `bitsize` (数字):以位数表示的Entropy大小. 一定是128、160、192、224或256
-   `wordlist` (阵列,可选): 要使用的单词列表 。 默认为英语单词列表

**回返情况:** 答应我 生成的元音短语

### `mnemonicToSeed({ mnemonic, password, validate, wordlist, format })`

将元音转换为种子,用于密钥衍生.

**参数:**

-   `mnemonic` (弦):元音短语
-   `password` (字符串,可选):可选密码句. 默认为空字符串
-   `validate` (布尔,可选): 是否验证元音 。 默认为真
-   `wordlist` (阵列,可选): 用于验证的单词列表 。 默认为英语单词列表
-   `format` (字符串,可选):输出格式-"int8","buffer",或"hex". 默认为“ int8 ”

**回返情况:** 承诺 < Uint8Array > 缓冲 > - 指定格式的种子

### `mnemonicToEntropy({ mnemonic, wordlist, format })`

将一个元音转换回原来的正元.

**参数:**

-   `mnemonic` (弦):元音短语
-   `wordlist` (阵列,可选): 要使用的单词列表 。 默认为英语单词列表
-   `format` (字符串,可选):输出格式 - "int8","buffer","hex",或"null". 默认为“ int8 ”

**回返情况:** 承诺<Uint8 Array}<Buffer}}\\\\ turnell> - 指定格式的 en

### `entropyToMnemonic({ entropy, wordlist })`

将 Entropy 转换为 mnemonic 短语 .

**参数:**

-   `entropy` (Uint8 Array): en字节. 必须是 16, 20, 24, 28, 或 32 字节
-   `wordlist` (阵列,可选): 要使用的单词列表 。 默认为英语单词列表

**回返情况:** 答应我 记忆短语

### `mnemonicIsInvalid({ mnemonic, wordlist })`

> \[尖叫声\] 仔细阅读! 此返回 `true` 如果记忆是 _无效_

**参数:**

-   `mnemonic` (字符串):用于验证的元音短语
-   `wordlist` (阵列,可选): 要使用的单词列表 。 默认为英语单词列表

**回返情况:** 承诺 - 无效的为真, 无效的为假

### `wordlistHasWord({ word, wordlist })`

检查单词列表中是否存在单词 .

**参数:**

-   `word` (字符串):要检查的词
-   `wordlist` (阵列,可选): 单词要检查 。 默认为英语单词列表

**回返情况:** boolean - 如果单词列表中存在单词则为真

## 单词列表

图书馆默认带有英文单词. 对于其他语言,你需要自己提供.

## 常见问题

### @exodus/bip39 是什么？

BIP39单元

### 如何安装 @exodus/bip39？

在项目目录运行 npm install @exodus/bip39，或使用 pnpm add / yarn add / bun add。

### @exodus/bip39 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/exodus\_\_bip39 是否存在。

### @exodus/bip39 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @exodus/bip39 可以商用吗？

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

### @exodus/bip39 的下载量有多少？

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

### @exodus/bip39 还在维护吗？

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