This is a Near application written in Rust for the Ledger Nano S/X/SP devices.
- Implements standard features (display address, transaction signature...),
- Has functional tests using Ragger,
- Has CI workflows mandatory for app deployment in the Ledger store.
Details of the structure of application, features and encountered problems as seen during initial development cycle are present in issue.
Advantages in comparison with app-near-legacy
- unlimited size of transactions
- normal support of batch transactions, test, screenshots of 2/12 action , none of the details of actions are shown in
app-near-legacy
You can quickly setup a development environment on any platform (macOS, Linux or Windows) to build and test your application with Ledger's VS Code extension.
By using Ledger's own developer tools Docker image, the extension allows you to build your apps with the latest SDK, test them on Speculos and load them on any supported device.
- Install and run Docker.
- Make sure you have an X11 server running :
- Install VScode and add Ledger's extension.
- Open a terminal and clone
app-near-rust
withgit clone git@github.com:dj8yfo/app-near-rs.git
. - Open the
app-near-rust
folder with VSCode. - Use Ledger extension's sidebar menu or open the tasks menu with
ctrl + shift + b
(command + shift + b
on a Mac) to conveniently execute actions :- Build the app for the device model of your choice with
Build
. - Test your binary on the Speculos emulator with
Run with emulator
. - You can also run functional tests, load the app on a physical device, and more.
- Build the app for the device model of your choice with
ℹ️ The terminal tab of VSCode will show you what commands the extension runs behind the scene.
You can build the Near app with the following command executed in the root directory of the app.
cargo ledger build nanox
This command will build the app for the Nano X, but you can use any supported device (nanos
, nanox
, nanosplus
)
ℹ️ Your device must be connected, unlocked and the screen showing the dashboard (not inside an application).
cargo-ledger also allows you to side load the binary with the following command line executed in the root directory of the Near app.
cargo ledger build nanox --load
As for the build command, you can replace nanos
with nanox
or nanosplus
.
You can also run the app directly on the Speculos emulator
speculos --model nanox target/nanox/release/app-near-rust
See local_test_helper.sh and Justfile
See local_unit_tests.sh.
The following workflows are executed in GitHub Actions :
- Ledger guidelines enforcer which verifies that an app is compliant with Ledger guidelines. The successful completion of this reusable workflow is a mandatory step for an app to be available on the Ledger application store. More information on the guidelines can be found in the repository ledger-app-workflow
- Compilation of the application for all supported devices in the ledger-app-builder docker image
- End-to-end tests with the Speculos emulator and ragger (see tests/)
- Various lint checks :
- Source code lint checks with
cargo fmt
- Python functional test code lint checks with
pylint
andmypy
- Source code lint checks with