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

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:

#![no_main]

valida_rs::entrypoint!main(main);

#[no_mangle]
fn main() {
    ...
}

If you do not require random number support, then you don't need any boilerplate in the main.rsmodule. However as of 0.8.0-alpha, you will need the following .cargo/config.tomlfile in your root directory, as in the fibonaccirepo.

[build]
target = "valida-unknown-baremetal-gnu"

[target.valida-unknown-baremetal-gnu]
linker = "/valida-toolchain/bin/ld.lld"
rustflags = [
    "-C", "link-arg=/valida-toolchain/ValidaEntryPoint.o",
    "-C", "link-arg=/valida-toolchain/io.o",
    "-C", "link-arg=--script=/valida-toolchain/valida.ld",
    "-C", "link-arg=/valida-toolchain/lib/valida-unknown-baremetal-gnu/libc.a",
    "-C", "link-arg=/valida-toolchain/lib/valida-unknown-baremetal-gnu/libm.a",
]

[env]
CC_valida_unknown_baremetal_gnu = "/valida-toolchain/bin/clang"
CFLAGS_valida_unknown_baremetal_gnu = "--sysroot=/valida-toolchain/ -isystem /valida-toolchain/include"

Rust library functions, etc.

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