# @avalabs/hw-app-avalanche 中文文档

规范地址：https://npmcn.com/package/%40avalabs/hw-app-avalanche/

版本：2\.1\.0
npm 元数据更新时间：2026-09-16T12:41:15.797Z
中文译文更新时间：2026-11-07T07:34:21.998Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40avalabs/hw-app-avalanche
原文对照：https://npmcn.com/package/%40avalabs/hw-app-avalanche/?lang=original
项目主页：https://github.com/ava-labs/ledger-avalanche-js
源码仓库：https://github.com/ava-labs/ledger-avalanche-js

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

- 包体积（解压后）：307 kB，34 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：rxjs 7\.8\.2，@ledgerhq/device-management-kit ^1\.9\.0
- 首次发布：2022-10-10T17:40:29.475Z
- 最新版本发布：2026-09-16T12:41:15.437Z
- 近 30 天下载量：2484（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 3 个）

## 中文简介

Avalanche App的节点API (Ledger Nano S/X/S+)

## 安装

```sh
npm install @avalabs/hw-app-avalanche
```

也可以使用：`pnpm add @avalabs/hw-app-avalanche`、`yarn add @avalabs/hw-app-avalanche`、`bun add @avalabs/hw-app-avalanche`

## README

# @zandax/ ledger- avalanche- app

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![npm version](https://badge.fury.io/js/%40zondax%2Fledger-avalanche-app.svg)](https://badge.fury.io/js/%40zondax%2Fledger-avalanche-app)

这个软件包提供了一个基本的客户端库,可以与运行在Ledger Nano S/X中的Avalanche App通信

我们建议使用 npmjs 软件包来接收更新/修正 .

## 使用量

通过 Ledger 连接 [设备管理套件](https://developers.ledger.com/docs/device-interaction/getting-started) 并交出SDK a `DMKTransport` (从) `@zondax/ledger-js`) (中文(简体) ). 只使用X/P链方法 c-Chain(EVM)方法也需要后面的DMK会话,因为 他们被 `@ledgerhq/device-signer-kit-ethereum`数字 :

```ts
import { DeviceManagementKitBuilder } from "@ledgerhq/device-management-kit";
import { DMKTransport } from "@zondax/ledger-js";
import AvalancheApp from "@zondax/ledger-avalanche-app";

const dmk = new DeviceManagementKitBuilder()
  .addTransport(/* web-hid, node-hid... */)
  .build();
const sessionId = await dmk.connect({
  device,
  sessionRefresherOptions: { isRefresherDisabled: true },
});

const app = new AvalancheApp(new DMKTransport(dmk, sessionId), {
  dmk,
  sessionId,
});

await app.getAddressAndPubKey("m/44'/9000'/0'/0/0", true, "avax"); // X/P chain
await app.signEVMTransaction("m/44'/60'/0'/0/0", rawTxHex); // C chain
await app.signPersonalMessage("m/44'/60'/0'/0/0", messageHex); // C chain, EIP-191
```

`signPersonalMessage` 是C-Chan的例外:它通过 运输,所以它的工作 没有DMK的会话。 以十六进制方式传递消息字节; 应用程序添加 页:1 `\x19Ethereum Signed Message:\n` 前缀本身。 它需要同样的参数和返回 同样的 `{ v, r, s }` 作为 `hw-app-eth`是因为 `signPersonalMessage`,有两个不同之处:

-   路径必须有3到5个级别(例如:. `m/44'/60'/0'/0/0`(三); `hw-app-eth` 接受任何深度.
-   空信件是签名而不是拒绝的.

SDK 发送前不检查消息大小 。 应用程序拒绝一个信息太 巨型的,在它被完全发送之后.

任何带有 hw- transport- stype 的天体 `send(cla, ins, p1, p2, data?, statusList?)` 还是 做为第一个论点, 但堕落 `@ledgerhq/hw-transport` 软件包停止 2026年9月参与反对莱德格的服务.

## 页:1

使用 `yarn install` 避免问题.

## 释放

推向主分支,自动发布. 发行版本基于承诺承诺信息.

## 常见问题

### @avalabs/hw-app-avalanche 是什么？

Avalanche App的节点API \(Ledger Nano S/X/S\+\)

### 如何安装 @avalabs/hw-app-avalanche？

在项目目录运行 npm install @avalabs/hw-app-avalanche，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（7\.8\.2）、@ledgerhq/device-management-kit（^1\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @avalabs/hw-app-avalanche 支持 TypeScript 吗？

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

### @avalabs/hw-app-avalanche 支持 ESM 还是 CommonJS？

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

### @avalabs/hw-app-avalanche 可以商用吗？

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

### @avalabs/hw-app-avalanche 的下载量有多少？

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

### @avalabs/hw-app-avalanche 还在维护吗？

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