☞ The renaming of “Ledger Live” to “Ledger Wallet” and
“wallet” (in the hardware sense) to “signer” is still in progress.
This page may contain legacy references that will be updated.

DApp Browser v3 migration

We are in the process of deprecating the dApp Browser live-app v1 and v2.

Ledger Wallet will now support injecting a compatible provider in the webview.

Deprecations

GitHub - LedgerHQ/iframe-provider
GitHub - LedgerHQ/eth-dapp-browser
params field in the manifest used by Ledger Wallet (replaced by the dapp field)

Changes

Ledger Wallet will now inject the needed provider in the WebView directly avoiding the need for an iframe like the eth-dapp-browser

The new provider is EIP 6963 compliant if there is a need for it but you can also use the injected window.ethereum

The provider exposes a boolean provider.isLedgerLive to inform when you are in the Ledger Wallet environment, in that case we expect the dApp to auto connect using this provider, thus improving the user experience and avoid unnecessary clicks

Manifest for dApps can now use the url field directly instead of params.dappUrl and must use the dapp field instead of the params for the provider, networks and nanoApp fields

Ledger Wallet supported versions

Desktop: 2.79
Mobile: Next release

Manifest examples

{
  "id": "metamask-test-dapp",
  "name": "Metamask Test dApp",
  "private": false,
  "url": "https://metamask.github.io/test-dapp/",
  "dapp": {
    "networks": [
      {
        "currency": "ethereum",
        "chainID": 1,
        "nodeURL": "https://eth-dapps.api.live.ledger.com"
      },
      {
        "currency": "bsc",
        "chainID": 56,
        "nodeURL": "https://bsc-dataseed.binance.org/"
      },
      {
        "currency": "polygon",
        "chainID": 137,
        "nodeURL": "https://polygon-mainnet.g.alchemy.com/v2/[your-key]"
      },
      {
        "currency": "arbitrum",
        "chainID": 42161,
        "nodeURL": "https://arb1.arbitrum.io/rpc"
      },
      {
        "currency": "optimism",
        "chainID": 10,
        "nodeURL": "https://mainnet.optimism.io"
      }
    ]
  },
  "homepageUrl": "https://metamask.github.io/test-dapp/",
  "icon": "https://cdn.live.ledger.com/icons/platform/1inch.png",
  "platforms": ["android", "ios", "desktop"],
  "apiVersion": "^2.0.0",
  "manifestVersion": "1",
  "branch": "stable",
  "categories": ["tools"],
  "currencies": ["ethereum", "bsc", "polygon", "arbitrum", "optimism"],
  "content": {
    "shortDescription": {
      "en": "Metamask Test dApp"
    },
    "description": {
      "en": "Metamask Test dApp"
    }
  },
  "permissions": [],
  "domains": ["https://"],
  "visibility": "complete"
}

{
  "id": "1inch-local",
  "name": "1inch",
  "private": false,
  "url": "https://app.1inch.io/",
  "dapp": {
    "nanoApp": "1inch",
    "networks": [
      {
        "currency": "ethereum",
        "chainID": 1,
        "nodeURL": "https://eth-dapps.api.live.ledger.com"
      },
      {
        "currency": "bsc",
        "chainID": 56,
        "nodeURL": "https://bsc-dataseed.binance.org/"
      },
      {
        "currency": "polygon",
        "chainID": 137,
        "nodeURL": "https://polygon-mainnet.g.alchemy.com/v2/[your-key]"
      },
      {
        "currency": "arbitrum",
        "chainID": 42161,
        "nodeURL": "https://arb1.arbitrum.io/rpc"
      },
      {
        "currency": "optimism",
        "chainID": 10,
        "nodeURL": "https://mainnet.optimism.io"
      }
    ]
  },
  "homepageUrl": "https://1inch.io/",
  "icon": "https://cdn.live.ledger.com/icons/platform/1inch.png",
  "platforms": ["android", "desktop"],
  "apiVersion": "^2.0.0",
  "manifestVersion": "1",
  "branch": "stable",
  "categories": ["swap"],
  "currencies": ["ethereum", "bsc", "polygon", "arbitrum", "optimism"],
  "content": {
    "shortDescription": {
      "en": "Exchange crypto via a Defi/DEX aggregator on Ethereum mainnet, BSC or Polygon"
    },
    "description": {
      "en": "Exchange crypto via a Defi/DEX aggregator on Ethereum mainnet, BSC or Polygon"
    }
  },
  "permissions": [],
  "domains": ["https://"],
  "visibility": "complete"
}

Write a plugin for Clear Signing DApp Example