Ledger® Live Wallet – Getting Started
Welcome to the developer guide for the Ledger Live Wallet. This document is intended to walk you through how to get started integrating with the Ledger/Live/Wallet ecosystem via the Ledger Live application — often referred to simply as the ledger live wallet. Whether you're building a dApp, integrating a new blockchain, or adding wallet support, this guide will serve as your launchpad.
1. What is the Ledger Live Wallet?
The ledger live wallet is a unified user interface that allows users to manage their crypto assets securely via hardware wallets from Ledger and software interfaces. When you integrate with the Ledger Live Wallet, you give users access to your blockchain, your token, or your service through their trusted environment.
From the Developer Portal you can access the integration paths for device apps, for your blockchain to be supported inside the Ledger/Live/Wallet, and for live apps / dApps to connect to users’ wallets. For example, the Wallet API is documented in the Developer Portal. :contentReference[oaicite:2]{index=2}
2. Why integrate with Ledger Live Wallet?
- Access to a large and security-minded user base via the Ledger Live Wallet.
- Compatibility with Ledger hardware devices and software via the ledger live wallet ecosystem.
- Enhanced trust and security: by building for the Ledger/Live/Wallet, you leverage strong standards, audits and infrastructure.
- Support for multi-chain, tokens, staking, DeFi and more — via the ledger live wallet environment. :contentReference[oaicite:3]{index=3}
3. Getting Started: Setup & Requirements
Before diving into code, make sure you meet the following prerequisites to integrate with the Ledger Live Wallet or the Ledger/Live/Wallet ecosystem.
Technical Requirements
- Node.js version 18.x.x or compatible. :contentReference[oaicite:4]{index=4}
- pnpm@8.x.x (or comparable package manager) for working with the monorepos. :contentReference[oaicite:5]{index=5}
- Access to development hardware (a supported Ledger device) if you plan to test device-apps for the ledger live wallet. :contentReference[oaicite:6]{index=6}
- Familiarity with TypeScript, React / React Native (for UI integration) if you’re building for the Ledger Live Wallet. :contentReference[oaicite:7]{index=7}
Repository & Monorepo Setup
To work with local development of the Ledger Live Wallet codebase:
- Clone the “ledger-live” repository (for example:
git clone https://github.com/LedgerHQ/ledger-live) to your workspace. :contentReference[oaicite:8]{index=8}
- Install dependencies via
pnpm i (or equivalent). :contentReference[oaicite:9]{index=9}
- If you’re working with the Wallet API module (for the ledger live wallet integration), link the local packages. For example: update
package.json entries to point to local paths to @ledgerhq/wallet-api-client. :contentReference[oaicite:10]{index=10}
- Run the development server (e.g.,
pnpm dev) or pnpm dev:lld to start the ledger live wallet environment locally. :contentReference[oaicite:11]{index=11}
4. Integration Paths
There are multiple different integration paths you might take depending on whether you are:
- Adding support for a new blockchain in the Ledger Live Wallet (i.e., enabling a blockchain’s accounts to show up inside the ledger live wallet
- Developing a device app for a Ledger hardware wallet and integrating it so that the Ledger/Live/Wallet ecosystem can support that coin/module. :contentReference[oaicite:13]{index=13}
- Building a Live App / dApp that interacts with users via the ledger live wallet and uses the Wallet API or Services Kit. :contentReference[oaicite:14]{index=14}
Blockchain Integration
If you wish to add your blockchain or token to the Ledger Live Wallet, follow these high-level steps:
- Fill out the integration application form (found in the Developer Portal). :contentReference[oaicite:15]{index=15}
- Ensure you support required languages/tools (TypeScript, RxJS, etc.) and have access to RPC nodes / data indexers. :contentReference[oaicite:16]{index=16}
- Develop the coin-module, ensure compatibility with the ledger live wallet codebase, test thoroughly.
- Submit for review and integrate with the Ledger/Live/Wallet ecosystem so users can manage your blockchain assets in their ledger live wallet app.
Wallet API / Live App Integration
If you are building a Live App that interacts with the user via the Ledger Live Wallet (for example a DeFi interface or plugin), then you’ll make use of the Wallet API / Services Kit Client:
- The Wallet API allows you to handle wallet interactions (account info, signing, capabilities) inside the ledger live wallet. :contentReference[oaicite:17]{index=17}
- The Services Kit Client library enables Live Apps to communicate with Ledger hardware wallets via the Ledger Live Wallet environment. :contentReference[oaicite:18]{index=18}
- Follow the documentation for method handlers such as
wallet.capabilities, wallet.info, wallet.userId. :contentReference[oaicite:19]{index=19}
- Test with local development, link dependencies, and simulate typical user flows to ensure compatibility with the Ledger/Live/Wallet ecosystem. :contentReference[oaicite:20]{index=20}
5. Best Practices & Security Considerations
When working with the Ledger Live Wallet, keep the following in mind:
- Always ensure compliance with the security audit requirements if you are developing device apps for the ledger live wallet. :contentReference[oaicite:21]{index=21}
- Respect the user interface guidelines and documentation style when submitting your app or module into the Ledger/Live/Wallet ecosystem. :contentReference[oaicite:22]{index=22}
- Keep your dependencies up to date, follow upgrade paths documented in the Developer Portal for the ledger live wallet integration. :contentReference[oaicite:23]{index=23}
- Test across desktop (Windows/macOS/Linux) and mobile (iOS/Android) if your integration touches the Ledger Live Wallet app. :contentReference[oaicite:24]{index=24}
- Ensure user flows are clear, especially when prompting for hardware wallet confirmations, address validation, transaction review — because users interacting via the ledger live wallet will expect clear UI and the highest security standards.
6. Deploying and Submitting Your Integration
Once development and testing are complete for your integration with the Ledger Live Wallet, you can proceed to submission:
- Prepare all documentation as required (user-guide, APDU flows, error codes) for your device app or blockchain module. :contentReference[oaicite:25]{index=25}
- Submit your integration via the Developer Portal’s submission workflow. The submission will be reviewed by the Ledger team for compatibility with the ledger live wallet ecosystem.
- Once approved, your coin, module, or live app will be published and integrated into the Ledger/Live/Wallet environment, enabling users of the ledger live wallet app to see and use your service.
7. Frequently Asked Questions (FAQ)
- Q: What exactly is the Ledger Live Wallet?
A: The ledger live wallet is a software application (desktop & mobile) provided by Ledger that allows users to manage their crypto assets securely via Ledger hardware wallets and software interfaces. It is part of the broader Ledger/Live/Wallet ecosystem. :contentReference[oaicite:27]{index=27}
- Q: Can I add support for my blockchain to the Ledger Live Wallet?
A: Yes — you can integrate your blockchain into the ledger live wallet. You’ll need to fill out the integration application form, satisfy technical requirements, and follow the guide “Adding your blockchain to Ledger Live”. :contentReference[oaicite:28]{index=28}
- Q: What is the Wallet API for the Ledger Live Wallet?
A: The Wallet API allows Live Apps and service providers to interact with the ledger live wallet environment: retrieving wallet info, sending transactions, signing messages, and more. It supports JSON-RPC methods such as wallet.capabilities, wallet.info. :contentReference[oaicite:29]{index=29}
li>Q: Do I need a hardware device to test for the Ledger Live Wallet?
A: For full integration especially of device apps, yes you will need a supported Ledger hardware wallet and must satisfy security audit requirements to publish into the ledger live wallet ecosystem. :contentReference[oaicite:30]{index=30}
- Q: Which platforms are supported by the Ledger Live Wallet?
A: The ledger live wallet app supports desktop (Windows, macOS, Linux) and mobile (iOS, Android). When integrating, ensure your flows work across these platforms. :contentReference[oaicite:31]{index=31}
Conclusion
If you follow this guide, you’ll be well on your way to integrating with the Ledger Live Wallet, tapping into a robust, secure platform for crypto asset management. Whether your goal is to support a new blockchain, build an app for the ledger live wallet, or enable dApps via the Ledger/Live/Wallet ecosystem, you now have a solid foundation.
Visit the Ledger Developer Portal for detailed API specs, integration guides and tooling to help you build. Good luck, and welcome to the ledger live wallet ecosystem!