royki / avn-dev-node

AvN dev node template

⚠️ IMPORTANT NOTE ⚠️
This template provides a simple example of how to build a parachain node using Avn pallets and MUST NOT BE USED IN PRODUCTION. It is configured with limited functionality and only contains a subset of avn pallets.

---

AvN Dev Node - an AvN Parachain Template based on Substrate Cumulus

This project template is a modified version of the original Substrate parachain Template. It has been customized to include the minimum necessary dependencies for integrating some of the AvN pallets into the runtime.

For more details on the implementation of the AvN Dev Node runtime, please refer to the runtime/README.md file.

Parachains introduction and tutorials

👉 Learn more about parachains here, and parathreads here.

🧙 Learn about how to use this template and run your own parachain testnet for it in the Devhub Cumulus Tutorial.

Building the project

Based on Polkadot Build Guide

First Install Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

If you already have Rust installed, make sure you're using the latest version by running:

rustup update

Once done, finish installing the support software:

# Additional rust targets
rustup target add wasm32-unknown-unknown --toolchain nightly-2020-10-18
# Additional OS dependencies
sudo apt install build-essential git clang libclang-dev pkg-config libssl-dev

Building the client

Build the client by cloning this repository and running the following commands from the root directory of the repo:

cargo build --release

Building the docker image

Prerequisites:

• Install Docker Engine 24.0.2 or newer
• Post-installation steps for Linux | Docker Documentation

# Builds the docker image with the build artefacts under target/release
docker build . --tag avn-dev-node:latest

Running the node

Once the build process is complete, you can use the binary to run a node and perform other subcommands.

When running a parachain node, you have the option to configure various settings using the command-line interface (CLI). To view a full list of available options, execute the following command:

target/release/avn-dev-node -h

The simplest way to run a node is as follows:

target/release/avn-dev-node --dev -- --chain rococo-local

After starting the node, you will notice that no blocks are generated. This is because a parachain needs to be onboarded to a relay chain that it is configured with. Substrate provides useful tutorials on how to set up an environment with a relay chain, which is highly recommended to complete. You can find these tutorials here.

To expedite the process of local development for this project, we recommend following the local setup guide to orchestrate a full local network.