How to update your dApp for Ledger Live
This guide shows you how to adapt your dApp to detect Ledger Live environment and optimize the user experience.
One of the most useful features of this dApp Browser is to be able to log-in automatically from a Ledger Live Ethereum account, therefore obviating the step to manually “Connect a Wallet”.
Step 1: Detect Ledger Live connection
Check if your dApp is running in Ledger Live by detecting the isLedgerLive boolean:
// Check the injected provider
if (window.ethereum?.isLedgerLive) {
// User is in Ledger Live - enable auto-connection
} else {
// Show standard wallet connection options
}
// Or via EIP-6963
const providers = window.evmproviders;
const ledgerProvider = providers?.find(p => p.info.isLedgerLive);Step 2: Handle gas fees
Submit transactions with optional gas fees:
- With gas fees set: Ledger Live uses your specified gas fees
- Without gas fees set: Ledger Live shows low/medium/high gas fee options based on current estimates
Step 3: Optimize user experience
Handle disconnection properly
Test your logout/disconnect functionality:
- Users may be automatically logged back in via Ledger Live
- Or redirected to standard wallet provider selection
Ensure network compatibility
Support these networks (Ledger Live compatible):
- Mainnets: Ethereum, BSC, Arbitrum, Optimism, Base, Fantom, Polygon
- Testnet: Sepolia (requires Developer mode enabled)
Remove third-party references
- Remove references to external services not in Ledger’s ecosystem
- You can redirect to Ledger Live Buy or Swap services
Make it responsive
Ensure your dApp works on:
- Desktop screens
- Mobile screens
What’s next
After updating your dApp, you will need to:
- Write a manifest - Create a manifest file containing your dApp’s metadata, supported networks, permissions, and configuration settings to integrate it into Ledger Live’s Discover section.
- Write a plugin - Develop a plugin for clear signing if your dApp has complex smart contract interactions that need human-readable transaction details (requires Ledger approval and security audit).
