template

This is a Boilerplate V-App.

• app contains the Risc-V app for Vanadium.
• client folder contains the client of the app, and a simple CLI interface.

The client is a library crate (see lib.rs), but it also has a test executable (main.rs) to interact with the app from the command line.

Build the V-App

If you installed just, simply running just from the app folder will build both the Risc-V and the native binaries.

Risc-V

In order to build the app for the Risc-V target, enter the app folder and run:

cargo build --release --target=riscv32imac-unknown-none-elf

Native

In order to build the app for the native target, enter the app folder and run:

cargo build --release

Run the V-App

Native target

Make sure you built the V-App for the native target.

On a terminal in the app folder, simply run:

cargo run

On a different terminal in the client folder, run:

cargo run -- --native

Note: you can customize the hostname and port of the app by setting the VAPP_ADDRESS environment variable.

RISC-V

Make sure you built the V-App for the RISC-V target.

Launch Vanadium on speculos. Then execute:

From the client folder

cargo run

If you want to run the V-app on a real device, launch the Vanadium app on the device, then execute instead:

cargo run -- --hid