# @binance-chain/javascript-sdk 中文文档

规范地址：https://npmcn.com/package/%40binance-chain/javascript-sdk/

版本：4\.2\.2
npm 元数据更新时间：2023-12-01T02:16:35.979Z
中文译文更新时间：2026-11-08T02:58:37.750Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40binance-chain/javascript-sdk
原文对照：https://npmcn.com/package/%40binance-chain/javascript-sdk/?lang=original

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

- 包体积（解压后）：540 kB，125 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：39 个
- 首次发布：2019-02-18T06:58:29.246Z
- 最新版本发布：2023-12-01T02:16:35.787Z
- 近 30 天下载量：8319（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：63（近 12 个月 0 个）

## 中文简介

BNB灯塔链JavaScript SDK允许浏览器和Node.js客户端与BNB灯塔链交互. 它包括下列核心组成部分.

## 安装

```sh
npm install @binance-chain/javascript-sdk
```

也可以使用：`pnpm add @binance-chain/javascript-sdk`、`yarn add @binance-chain/javascript-sdk`、`bun add @binance-chain/javascript-sdk`

## README

BNB 灯塔链 JavaScript SDK 允许浏览器和 Node.js 客户端交互 与BNB灯塔链。 它包括下列核心组成部分.

-   **密码** - 核心密码功能.
-   **氨基** - 说吧 [氨基](https://github.com/binance-chain/docs-site/blob/master/docs/encoding.md) (protobuf-like) 交易的编码和解码.
-   **客户端** - 实施BNB灯塔链交易类型,例如: 转让和贸易.
-   **账户** - 管理“账户”和钱包,包括种子和 加密的元相生成.
-   **分类账** - 通过HID、U2F和Web BLE(蓝牙)支持Ledger Nano S/X.
-   **转写c** - 节点RPC客户端.
-   **交易** - 交易类,建立和签署.

可以在我们 [文档](https://github.com/binance-chain/javascript-sdk/blob/master/docs/README.md) 页面.

## 安装

狦 **别** 需要节点的编辑器支持 :

```bash
$ npm i @binance-chain/javascript-sdk --no-optional
# Or:
$ yarn add @binance-chain/javascript-sdk --no-optional
```

狦 **需求** 用 Node.js 编辑器支持 :

```bash
$ npm i @binance-chain/javascript-sdk
# Or:
$ yarn add @binance-chain/javascript-sdk
```

### 先决条件

-   **视窗用户 :** 请安装 [窗口建设工具](https://www.npmjs.com/package/windows-build-tools) 先说.
    
-   **麦克用户 :** 确保安装 XCode 命令行工具 : `xcode-select --install`。 。 。 .
    
-   **Linux 用户 :** 注意Ubuntu Xenial和较新的分布 建议,特别是在使用Travis或其他CI系统时。 你也许需要 为 USB 支持而在您的系统中安装一些 dev 软件包 。 打开 基于 Debian 的分布( 如 Ubuntu ) 您应该用这个安装 命令 :
    
    ```bash
    $ sudo apt-get install libudev-dev libusb-dev usbutils
    ```
    

### 使用 Web 软件包

我们经常看到Webpack 建造失败 与SDK 由于 `usb` 依赖性, 但是在您的 Webpack 配置中添加此内容应该能够修正:

```js
module.exports = {
  plugins: [new webpack.IgnorePlugin(/^usb$/)],
}
```

## 测试

所有新代码的修改都应包括单位测试. 你可以进行测试 带有以下命令:

```bash
$ yarn test
```

对 Ledger 硬件钱包集成的测试有自己的套件运行 在节点和浏览器中:

```bash
$ yarn test:ledger
$ yarn test:ledger:browser
```

## 捐款

欢迎向BNB灯塔链JavaScript SDK捐款。 请确保 您已经用本地客户端测试了更改并添加了单位测试 保护您的代码.

## 常见问题

### @binance-chain/javascript-sdk 是什么？

BNB灯塔链JavaScript SDK允许浏览器和Node\.js客户端与BNB灯塔链交互\. 它包括下列核心组成部分\.

### 如何安装 @binance-chain/javascript-sdk？

在项目目录运行 npm install @binance-chain/javascript-sdk，或使用 pnpm add / yarn add / bun add。

### @binance-chain/javascript-sdk 支持 TypeScript 吗？

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

### @binance-chain/javascript-sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @binance-chain/javascript-sdk 可以商用吗？

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

### @binance-chain/javascript-sdk 的下载量有多少？

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

### @binance-chain/javascript-sdk 还在维护吗？

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