Ledger-IOV
This repository contains the Ledger Nano S app for IOV (BOLOS app and unit tests).
Source code for apps is linked as submodules to allow for Ledger's build infrastructure. For development purposes, this repo is recommended as it includes unit tests, tools, etc.
Installing the release
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.
Prerequisites
- You run some kind of UNIX-like environment
- Python3 and venv module installed (check via
python3 --version,python3 -m venv --help) - A C compiler
Debian/Ubuntu
- 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.rulessudo mv 20-hw1.rules /etc/udev/rules.d/20-hw1.rulessudo udevadm trigger && sudo udevadm control --reload-rules
MacOS
- Install dependencies:
brew bundle - Install XCode and XCode command line tools
xcode-select --install
Download
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.
Install / Uninstall
- 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
Further notes
The +xyz suffix in versions is build meta data, i.e. the same Ledger app in a different package
Ledger Nano X support
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.
Building
The following document describes how to build the apps: Build instructions