@ledgerhq/ledger-wallet-framework

ledger-wallet-framework

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.