Crate that allows developing Ledger Nano apps in Rust with a default configuration.
Contains:
This SDK is incomplete in the sense that wrappers are currently missing, and not all wrappers have a nice Rust abstraction on top, but two apps were made using it:
You can submit an issue or even a pull request if you wish to contribute, we will check what we can do.
| Nano S | Nano X | Nano S Plus | | ------------------ | ------------------ | ------------------ | | :heavycheckmark: | :heavycheckmark: | :heavycheckmark: |
Building requires adding rust-src
to your Rust installation, and both Clang and arm-none-eabi-gcc.
On Ubuntu, gcc-multilib
might also be required.
Using rustc nightly builds is mandatory as some unstable features are required.
rustup default nightly
rustup component add rust-src
If you wish to install the ARM gcc toolchain using your distribution's packages, these commands should work:
```bash
sudo apt install clang gcc-arm-none-eabi gcc-multilib
sudo dnf install clang arm-none-eabi-gcc arm-none-eabi-newlib
sudo pacman -S clang arm-none-eabi-gcc arm-none-eabi-newlib ```
This SDK provides three custom target files for Nano S, Nano X and Nano S+.
cargo build --release -Z build-std=core --target=./nanos.json
cargo build --release -Z build-std=core --target=./nanox.json
cargo build --release -Z build-std=core --target=./nanosplus.json
Building before rustc 1.54 should fail with error[E0635]: unknown feature const_fn_trait_bound
.
This is solved by activating a specific feature: cargo build --features pre1_54
Make sure you've followed the installation steps above. In order for your PR to be accepted, it will have to pass the CI, which performs the following checks:
clippy
does not emit any warningsrustfmt
's format (using cargo fmt
)