Requirements and installation

Introduction

All the JavaScript code related to the Ledger Live applications is in the ledger-live monorepository. The work to integrate a Blockchain in Ledger Live will all happen in this monorepository.

Ledger Live Common (./libs/ledger-live-common) is the shared core library used by Ledger Live Desktop and Mobile, that also includes a CLI for testing purpose or for using Ledger Live features directly from a terminal (in a limited way).

This library is built upon a pretty standard ES6 + Typescript stack and relies on a bunch of ledgerjs (opens in a new tab) packages, RxJS 6.x (opens in a new tab), bignumber.js (opens in a new tab) and React (opens in a new tab) + Redux (opens in a new tab) for some front-end utilities and hooks.

It is designed to have very generic models and mechanics (for currencies, accounts, storage, synchronisation, events...) that also facilitates new blockchain integrations through flexibility. All integrated coins are implemented in their own package in the libs directory, following the naming convention. To be fully integrated, a libs/ledger-live-common/src/families dedicated folder needs to contain a few "glue" files - that can be shared by multiple crypto-assets that use the same implementation (i.e. Bitcoin-like coins share the same bitcoin family).

This document only concerns new blockchain integrations using Typescript - we will use an imaginary coin named MyCoin as a walkthrough.

Setup

Requirements

• Node.js@18.x.x (opens in a new tab)
• PnPm@8.x.x (opens in a new tab)
• Python 2.7 or 3.5+
• A C/C++ toolchain (see node-gyp documentation)

Development tools (used or required)

• eslint (opens in a new tab) - ensure it works in your IDE (vscode plugin (opens in a new tab))
• prettier (opens in a new tab) - through an eslint-plugin
• typescript (opens in a new tab) - ensure it works fine with your IDE

Hardware prerequisites

• A physical device (Ledger Nano S, S Plus, X or a Stax)
• MyCoin app installed on device

Installation

• Fork and clone the ledger-live repository https://github.com/LedgerHQ/ledger-live (opens in a new tab)
• cd ledger-live
• Install with pnpm i

Structure

Your whole implementation of MyCoin must reside in a mycoin folder in libs/coin-modules/coin-mycoin. You will also need some code in libs/ledger-live-common/src/families/mycoin, for injection, setup and UI specific requirements.

Here is a typical family folder structure (TS integration):

./libs
├── coin-modules/coin-mycoin/src
│   ├── api
│   │   └── index.ts
│   ├── bridge
│   │   ├── broadcast.ts
│   │   ├── buildTransaction.ts
│   │   ├── createTransaction.ts
│   │   ├── estimateMaxSpendable.ts
│   │   ├── formatters.ts
│   │   ├── getFeesForTransaction.ts
│   │   ├── getTransactionStatus.ts
│   │   ├── prepareTransaction.ts
│   │   ├── signOperation.ts
│   │   ├── synchronization.ts
│   │   └── index.ts
│   ├── logic
│   │   ├── broadcast.ts
│   │   ├── craftTransaction.ts
│   │   ├── estimateFees.ts
│   │   ├── getBalance.ts
│   │   ├── lastBlock.ts
│   │   ├── listOperations.ts
│   │   ├── signTransaction.ts
│   │   └── index.ts
│   ├── network
│   │   ├── explorer.ts
│   │   └── index.ts
│   ├── signer
│   │   ├── getAddress.ts
│   │   └── index.ts
│   ├── test
│   │   ├── bot-deviceActions.ts
│   │   ├── bot-specs.ts
│   │   ├── bridgeDatasetTest.ts
│   │   ├── cli.ts
│   │   └── index.ts
│   ├── types
│   │   ├── bridge.ts
│   │   ├── errors.ts
│   │   ├── model.ts
│   │   ├── signer.ts
│   │   └── index.ts
│   ├── config.ts
│   └── index.ts
├── ledger-live-common/src/families/mycoin
│   ├── bridge.integration.test.ts
│   ├── config.ts
│   ├── logic.ts
│   ├── react.ts
│   ├── setup.ts
│   ├── types.ts
│   └── walletApiAdapter.ts
└── ledgerjs/packages/hw-app-mycoin/src
│   ├── MyCoin.ts
│   └── index.ts

Coin-module

• src/api directory: Contains the implementation of B2B interface (a.k.a. Alpaca) - TBD.
• src/bridge/* files: Split of CurrencyBridge and AccountBridge logic in dedicated files.
• src/bridge/index.ts file: Entry point of Ledger Live integration of the coin-module. This file lists CurrencyBridge and AccountBridge implementation.
• src/network directory: Contains all the logic to send requests to the explorer.
• src/signer/getAddress.ts file: Logic on how to interact with device-app to retrieve addresses.
• src/test/bot-specs.ts file: Definition of tests to be run on the bot.
• src/types/signer.ts file: Interface definition of the ledger device-app related to this coin.

Ledger live-common

• src/config.ts: TBD.
• src/logic.ts: Lists coin specific business logic.
• src/react.ts: Defines and lists coin specfic react hooks for UI.
• src/setup.ts: Glue file for coin integration.
• src/types.ts: Lists coin specific types.
• src/walletApiAdapter.ts: TBD.

LedgerJS

All files related to communication with the device-app.