Rust Usage

Usage Instructions for Rust

For examples of how to build a Rust program which compiles and runs on Valida, see lita-xyz/rust-examples on Github. You can use any of these examples as a starting point for developing your own programs using the Valida toolchain. Here are steps for doing so:

1. Clone the project template:

git clone https://github.com/lita-xyz/fibonacci.git

Basing your project on the project template is not needed unless you require pseudo-random number functions to be available. If that is not the case, then you can replace the above with cargo new fibonacci.

1. cd into the project template:

cd fibonacci

1. Enter the Valida shell or the Docker toolchain shell, following the instructions specific to your selected installation method.

2. Build the project:

cargo +valida build --release

1. Run the code:

valida run --fast target/valida-unknown-baremetal-gnu/release/fibonacci log

If your program requires the pseudo-random number support included in the valida_rs crate, you need the following boilerplate:

valida_rs::entrypoint!main(main);

fn main() {
    ...
}

If you do not require random number support, then you don't need any boilerplate in the main.rsmodule.

Rust library functions, etc.

See USAGE: Using the Rust toolchain for more information on how to write Rust programs to run on Valida.