DocumentationLedger LiveDiscoverIntegration walkthroughsdApp BrowserWrite and load the manifest

Write and load the manifest

If you have followed instructions on the previous page, you should now be ready to interact with the dApp directly from Ledger Live interface to make sure all the basic features work as expected.

Your dApp will be ran inside the Ledger Live webview with an injected provider.

To test and integrate your application, you first need to write your application Manifest file. This file must contain some mandatory information, such as the app package names, the components, the permissions needed, the hardware and software features, etc.

Check and if necessary edit your manifest file as described below.

Load your Live App locally on desktop

To load your Live App locally, unlock the Developer mode in Ledger Live and add a local app.

Load your Live App locally on mobile (Android only)

Go to the Settings -> Developer section, and click on Load Platform Manifest you can copy your manifest here and load it.

Example of Manifest (JSON format) for the “Lido” application:

{
  "id": "lido",
  "name": "Lido",
  "url": "https://stake.lido.fi/?embed=true",
  "dapp": {
    "nanoApp": "Lido",
    "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/xxx"
      },
      {
        "currency": "arbitrum",
        "chainID": 42161,
        "nodeURL": "https://arb1.arbitrum.io/rpc"
      },
      {
        "currency": "optimism",
        "chainID": 10,
        "nodeURL": "https://mainnet.optimism.io"
      }
    ]
  },
  "homepageUrl": "https://lido.fi/",
  "icon": "https://cdn.live.ledger.com/icons/platform/lido.png",
  "platform": "all",
  "apiVersion": "^2.0.0",
  "manifestVersion": "2",
  "branch": "stable",
  "categories": ["staking", "defi"],
  "currencies": ["ethereum", "bsc", "polygon", "arbitrum", "optimism"],
  "content": {
    "shortDescription": {
      "en": "Stake your ETH with Lido to earn daily staking rewards."
    },
    "description": {
      "en": "Stake your ETH with Lido to earn daily staking rewards."
    }
  },
  "permissions": [],
  "domains": ["https://"]
}
Here is the list of the mandatory fields required in your Manifest file:
FieldDescriptionType
idThe identification of your application. Must be in lowercase.String
nameThe name of your application (“Lido” in this example).String
urlThe url of your dApp, either running locally or at the production versionString
dappnanoApp is the plugin needed to clear sign your dApp, if your dApp doesn’t require a plugin set the value to Ethereum

networks is the list of networks supported by your dApp, Ledger Live currently only support mainnet, BSC, arbitrum, optimism, base, fantom and Polygon, the nodeURL param will be set by Ledger in prod to use your node, for testing purposes, you can replace it with your own.
Object
homepageUrlThis for information only. It is is non-critial. For instance, “https://lido.fi/”.String
iconA link to the icon displayed in the Ledger Live Discover section.
Will be hosted on Ledger CDN before being released in production.
URL
platformTo set the platform (desktop, mobile, iOS, Android) on which your service is available.
By default, you should set the value to “all”.
String
apiVersionThe API version. By default “^2.0.0”.String
manifestVersionThe manifest version. By default should be “2”.String
branchThe specific branch used by Ledger to deploy the changes.
Can take the values stable experimental, debug, soon.
By default, you should set it to stable. The value soon will mark your app as “Coming soon” and it won’t be usable.
String
categoriesA JSON array of metadata information about your application. For instance: [“staking”,“defi” ].
You can add as many as you want.
It is not used for the moment but will be used for filtering in the future.
List(string)
currenciesA JSON array of the currency/network being used by your application.
For instance [“ethereum”,”polygon”].
Leave blank if the App does not require any currency.
List(string)
contentA description of your service. It will be displayed on the entry card of your application.L18n strings
permissionsLeave empty for now.List(string)
domainsList of allowed domains to navigate to, if a domain doesn’t match it will open in the default browser.
By default [“http://”, “https://“]
List(string)
Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Nano S, Ledger Vault, Ledger OS are registered trademarks of Ledger SAS