beginner-walkthrough.md

Beginner walkthrough

This is a beginner tutorial for those who do not have a previous experience with Rust ecosystem or need guidance to get familiar with Duniter v2s project. You'll need a development machine with an internet connection, at least 20 GB of free storage, and an hour or two depending on your computing power.

This walkthrough is based on the following video (french), don't hesitate to record an english voiceover if you feel so.

video walkthrough on peertube https://tube.p2p.legal/w/n4TXxQ4SqxzpHPY4TNMXFu

Requirements

If you are on a debian based system, you can install the required packages with:

sudo apt install cmake pkg-config libssl-dev git build-essential clang libclang-dev curl protobuf-compiler

Else, look at the corresponding section in the system setup documentation.

Rust recommended installation method is through the rustup script that you can run with:

curl https://sh.rustup.rs -sSf | sh

If you reopen your terminal, it will give you access to the rustup, rustc and cargo commands. You can then install the required Rust toolchains with:

rustup default stable
rustup update nightly
rustup update stable
rustup target add wasm32-unknown-unknown --toolchain nightly

This can take about 2 minutes.

Build project

After cloning wherever you want the duniter-v2s repo with:

git clone https://git.duniter.org/nodes/rust/duniter-v2s.git

you can go to the root folder and build the substrate client and default runtime with:

cargo build

This will take about 2 minutes to download dependencies plus between 5 and 15 minutes to build in debug mode depending on the power of your processor. At this point, you built the substrate client (a kind of "shell" in which lies the runtime) and the default runtime itself. You can run a local blockchain with: