This repository contains the Ledger Nano S app for IOV (BOLOS app and unit tests).
For development purposes, this repo is recommended as it includes unit tests, tools, etc.
Warning The only safe and convenient way to install apps on the Leder is via the Ledger Live Store. Those instructions are meant for testers and developers only. We recommend dedicated testing devices.
- You run some kind of UNIX-like environment
- Python3 and venv module installed (check via
python3 --version
,python3 -m venv --help
) - A C compiler
- Ensure to add Universe to your apt repositories
sudo apt install build-essential python3-dev python3-venv libusb-1.0-0-dev libudev-dev
wget https://raw.githubusercontent.com/LedgerHQ/udev-rules/master/20-hw1.rules
sudo mv 20-hw1.rules /etc/udev/rules.d/20-hw1.rules
sudo udevadm trigger && sudo udevadm control --reload-rules
- Install dependencies:
brew bundle
- Install XCode and XCode command line tools
xcode-select --install
Find a recent release from ledger-iov releases that includes a zip package (e.g. iov-testnet-ledger-0.10.0+9.zip
). The mainnet/testnet parts in the file name tell you for which network the app works. You can install both apps in parallel.
Download and extract.
- Navigate to the extracted folder, e.g.
cd ~/Downloads/iov-testnet-ledger
- Connect and unlock Ledger Nano S; navigate to the main menu.
- To install run
./install_app.sh
; to uninstall run./install_app.sh --uninstall
The +xyz
suffix in versions is build meta data, i.e. the same Ledger app in a different package
Right now, there is no support for the Ledger Nano X. However, the source code is prepared for future Nano X support, which is why there are Nano X references in some places.
The following document describes how to build the apps: Build instructions