Skip to Content
📢 Breaking change: Applications using LedgerJS for transport implementation should migrate to the Device Management Kit (DMK). Learn more.
DocumentationLedger Wallet ProviderRequirements

Requirements

This page lists the environment requirements for @ledgerhq/ledger-wallet-provider. The SDK communicates directly with Ledger hardware signers over USB (Web HID API) and Bluetooth (Web Bluetooth API), so it requires a browser environment where those APIs are available. It cannot run in Node.js or any server-side environment.

Platform requirements

  • ES2020+ support
  • Modern bundler (Vite, Webpack 5+, etc.)
  • Browser environment (no Node.js server-side execution)
  • Web HID API support (for USB connections)
  • Web Bluetooth API support (for Bluetooth connections)

Mobile browsers are not supported because Web HID and Web Bluetooth APIs are not available on iOS or Android.

Browser support

  • Desktop: Chrome 89+, Firefox 89+, Safari 14.1+, Edge 89+
  • Mobile: Not supported (Web HID and Web Bluetooth APIs are not available)

Package manager

On v2 (SDK 2.x.x+), the family packages (@ledgerhq/ledger-wallet-provider-evm, @ledgerhq/ledger-wallet-provider-solana) declare rxjs, xstate, purify-ts, @ledgerhq/device-management-kit, and @ledgerhq/ledger-wallet-provider-core as peer dependencies so they share a single instance with the main package.

  • npm 7+, pnpm, Yarn Berry (v2+) — peer dependencies are installed automatically.
  • Yarn 1 (Classic) — peer dependencies are not installed automatically; add them explicitly to your package.json.

See also

  • Get started — install the SDK and initialize the provider
  • Configuration — full list of initialization options
Last updated on
Package AttestationAPI Reference
Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Stax, Ledger Flex, Ledger Nano, Ledger Nano S, Ledger OS, Ledger Wallet, [LEDGER] (logo), [L] (logo) are trademarks owned by Ledger SAS.