Skip to Content
We're improving our docs. Share your experience and help shape what comes next.

Companion wallet

A companion wallet is a desktop or web application, built and maintained by you, that is fully compatible with your device app and lets your users manage assets on your chain. It acts as the host-side counterpart to the device app: the device app handles the secure signing on the Ledger signer, while the companion wallet provides the user interface for constructing and broadcasting transactions.

A companion wallet is required as part of your device app submission. Ledger reviewers verify that the wallet meets the requirements below before your app is published.

Requirements

Address verification on device

The companion wallet must give users a way to verify a receive address directly on their Ledger signer. This is a core security feature: it lets users confirm that the address shown in the software matches the address derived on the secure hardware, protecting against address-substitution attacks.

The verification flow typically works as follows:

  1. The user navigates to the “Receive” screen in the companion wallet.
  2. The wallet requests the address from the device app via APDU.
  3. The device app displays the address on the signer’s screen and waits for the user to confirm.
  4. The companion wallet shows the same address and marks it as device-verified.

The companion wallet must display an affiliate link to Ledger next to the “Connect with Ledger” option. This link directs new users to purchase a Ledger device if they do not already own one.

Desktop platform support

The companion wallet must run on Windows, macOS, and Linux. Web applications accessed through a modern browser are acceptable, provided they meet the other requirements.

  • Security requirements — derivation-path constraints and APDU security rules your device app must satisfy
  • Submission process — the full submission checklist and review steps
  • UI flow video — the screen recording required alongside the companion wallet deliverable
Last updated on
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.