How to update your dApp for Ledger Wallet
This guide shows you how to adapt your dApp to detect Ledger Wallet 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 Wallet Ethereum account, therefore obviating the step to manually “Connect a Wallet”.
Step 1: Detect Ledger Wallet connection
Check if your dApp is running in Ledger Wallet by detecting the isLedgerLive boolean:
// Check the injected provider
if (window.ethereum?.isLedgerLive) {
// User is in <Glossary word='Ledger Wallet'></Glossary> - 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 Wallet uses your specified gas fees
- Without gas fees set: Ledger Wallet 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 Wallet
- Or redirected to standard wallet provider selection
Ensure network compatibility
Support these networks (Ledger Wallet 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 Wallet 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 Wallet’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).
