7 stable releases

1.3.0 Feb 5, 2024
1.2.4 Jan 24, 2024
1.2.1 Dec 11, 2023
1.1.0 Sep 20, 2023

#196 in Cargo plugins

37 downloads per month


512 lines


Builds a Nano App and outputs a JSON manifest file that can be used by ledgerctl to install an application directly.

In order to build for Nano S, Nano X, and Nano S Plus, custom target files are used. They can be found at the root of the Rust SDK and can be installed automatically with the command setup.


This program requires:

Install this repo with:

cargo install --git https://github.com/LedgerHQ/ledger-device-rust-sdk cargo-ledger 

or download it manually and install with:

cargo install --path cargo-ledger

Note that cargo's dependency resolver may behave differently when installing, and you may end up with errors. In order to fix those and force usage of the versions specified in the tagged Cargo.lock, append --locked to the above commands.


General usage is displayed when invoking cargo ledger.


This will install custom target files from the SDK directly into your environment.

cargo ledger setup


cargo ledger build nanos
cargo ledger build nanox
cargo ledger build nanosplus

Loading on device can optionally be performed by appending --load or -l to the command.

By default, this program will attempt to build the current program with in release mode (full command: cargo build --release --target=nanos --message-format=json)

Arguments can be passed to modify this behaviour after inserting a -- like so:

cargo ledger build nanos --load -- --features one -Z unstable-options --out-dir ./output/


~71K SLoC