# @ledgerhq/ledger-wallet-framework

> Framework for Ledger Wallet

Latest version **3.3.0** (published 2026-09-11) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @ledgerhq/ledger-wallet-framework
pnpm add @ledgerhq/ledger-wallet-framework
yarn add @ledgerhq/ledger-wallet-framework
bun add @ledgerhq/ledger-wallet-framework
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 3.3.0 |
| Published | 2026-09-11 |
| First published | 2026-03-14 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 21 |
| Unpacked size | 1.2 MB |
| Known vulnerabilities | 0 (+32 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 618 |
| Maintainers | phenry-ledger, sergii-shkolin, gbrahm-ledger, ldg-github-ci, vbouzon, ledger-releaser |
| Keywords | Ledger, LedgerWallet, Hardware Wallet |

## Links

- npm: https://www.npmjs.com/package/@ledgerhq/ledger-wallet-framework
- Repository: https://github.com/LedgerHQ/ledger-live
- Homepage: https://github.com/LedgerHQ/ledger-live/tree/develop/libs/ledger-wallet-framework
- Issues: https://github.com/LedgerHQ/ledger-live/issues
- npm.io page: https://npm.io/package/@ledgerhq/ledger-wallet-framework

## Dependencies (21)

- [zod](https://npm.io/package/zod.md) 4.3.6
- [rxjs](https://npm.io/package/rxjs.md) 7.8.2
- [uuid](https://npm.io/package/uuid.md) 11.1.0
- [axios](https://npm.io/package/axios.md) 1.13.5
- [eip55](https://npm.io/package/eip55.md) ^2.1.0
- [expect](https://npm.io/package/expect.md) 30.5.0
- [lodash](https://npm.io/package/lodash.md) 4.17.21
- [prando](https://npm.io/package/prando.md) ^6.0.1
- [invariant](https://npm.io/package/invariant.md) ^2.2.2
- [bip32-path](https://npm.io/package/bip32-path.md) ^0.4.2
- [imurmurhash](https://npm.io/package/imurmurhash.md) ^0.1.4
- [bignumber.js](https://npm.io/package/bignumber.js.md) ^9.1.2
- [@ledgerhq/logs](https://npm.io/package/@ledgerhq/logs.md) 6.19.0
- [@ledgerhq/devices](https://npm.io/package/@ledgerhq/devices.md) 8.17.0
- [@ledgerhq/live-env](https://npm.io/package/@ledgerhq/live-env.md) ^4.0.0
- [@ledgerhq/types-live](https://npm.io/package/@ledgerhq/types-live.md) ^6.123.0
- [@ledgerhq/live-config](https://npm.io/package/@ledgerhq/live-config.md) ^3.8.0
- [@ledgerhq/hw-transport](https://npm.io/package/@ledgerhq/hw-transport.md) ^6.35.7
- [@ledgerhq/live-network](https://npm.io/package/@ledgerhq/live-network.md) ^3.0.0
- [@ledgerhq/live-currency-format](https://npm.io/package/@ledgerhq/live-currency-format.md) ^0.15.0
- [@ledgerhq/coin-module-framework](https://npm.io/package/@ledgerhq/coin-module-framework.md) 8.4.0

## Recent versions

- 3.3.0 (latest) — 2026-09-11
- 3.3.0-nightly.20260912020511 (nightly) — 2026-09-12
- 3.3.0-nightly.20260911020507 — 2026-09-11
- 3.3.0-nightly.20260910020512 — 2026-09-10
- 3.3.0-nightly.20260909020514 — 2026-09-09
- 3.2.0-nightly.20260908020515 — 2026-09-08
- 3.2.0 — 2026-09-07
- 3.2.0-nightly.20260905020452 — 2026-09-05
- 3.2.0-nightly.20260904020502 — 2026-09-04
- 3.2.0-nightly.20260903021109 — 2026-09-03
- 3.2.0-nightly.20260902021544 — 2026-09-02
- 3.2.0-nightly.20260901020738 — 2026-09-01
- 3.2.0-nightly.20260829020445 — 2026-08-29
- 3.1.0-nightly.20260828043625 — 2026-08-28
- 3.1.0 — 2026-08-27
- … 185 more at https://npm.io/package/@ledgerhq/ledger-wallet-framework/versions

## README

# ledger-wallet-framework

> [!CAUTION]
> **Status: UNSTABLE** — Actively consolidating shared logic migrated out of `@ledgerhq/live-common`; API is in flux.

`@ledgerhq/ledger-wallet-framework` is the core wallet logic framework that consolidates shared infrastructure for coin implementations in Ledger Live. It was introduced to centralize concerns that previously lived in `ledger-live-common` or were duplicated across coin modules, extending and wrapping `@ledgerhq/coin-module-framework`.

## What it does

- Defines the **bridge interface** (account sync, transaction signing, broadcast) that all coin bridges implement
- Provides **account** utilities: account creation, balance aggregation, sub-account handling
- Implements **operation** parsing and merging logic shared across coin families
- Handles **transaction** building, fee estimation types, and status computation contracts
- Provides **derivation** path utilities and helpers
- Includes **NFT** data structures and helpers
- Provides **serialization** helpers for accounts and transactions (for persistence and inter-process communication)
- Exports **bot** testing infrastructure for automated wallet scenario tests
- Offers **mocks** for testing without a real device
- Includes a **sanction** checking integration and **tracking** event helpers

## Key exports / concepts

- `Bridge` types and base implementations (account bridge, currency bridge)
- `Account`, `SubAccount`, `TokenAccount` types and utilities
- `Operation` creation, merging, and pagination helpers
- `Transaction` base types and `TransactionStatus`
- `derivation` — BIP32/BIP44 path calculation per coin family
- `BotScenario` and test runner helpers
- `serialize` / `deserialize` for accounts

## Usage context

Used by all coin family implementations (`libs/coin-modules/*`, `libs/ledger-live-common`) and by the desktop/mobile apps indirectly through the coin bridge layer. It is the foundational dependency for anything that needs to interact with wallet state or hardware signing.

---
_Source: https://npm.io/package/@ledgerhq/ledger-wallet-framework · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
