@avalabs/hw-app-avalanche

中文文档
2.1.0发布于 2026/09/16Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2484

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

中文使用文档
文档目录3 节
  1. 使用量
  2. 页:1
  3. 释放

@zandax/ ledger- avalanche- app

License npm version

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

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

使用量

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

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 共发布 28 个版本,首次发布于 2022/10/11;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.0latest2026/09/161 个月前
2.0.02026/09/111 个月前
1.1.32026/08/122 个月前
1.1.12025/10/011.1 年前
1.1.02025/08/291.2 年前
1.0.22025/03/041.7 年前

其他发布通道:alpha → 0.1.0。

关于 @avalabs/hw-app-avalanche 的常见问题

@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 和提交记录判断。