Setting up a developer environment varies significantly between operating systems, so follow the specific instructions for your OS:

• Windows: Use tools like PowerShell or WSL.

• macOS: Utilize Terminal and Homebrew.

• Linux: Rely on package managers like apt, yum, or dnf depending on your distribution.

Pay careful attention to the detailed steps for your OS to ensure a smooth setup.

Please choose your Operating System from below:

Setting Up a Windows Development Environment for Rust

To create a suitable development environment for Substrate on a Windows computer, you can use Windows Subsystem for Linux (WSL) to emulate a UNIX operating system. While UNIX-based systems like macOS or Linux offer better environments for building Substrate-based blockchains, using WSL can be a viable alternative. All code examples and command-line instructions in Substrate tutorials and guides are UNIX-based.

Before You Begin

Ensure the following requirements are met:

• Operating System: Microsoft Windows 10, version 2004 or later, or Windows 11

• Internet Connection: Good broadband connection

• Shell Access: Access to a terminal on your local computer

Set Up Windows Subsystem for Linux (WSL)

WSL enables you to emulate a Linux environment on a Windows computer, allowing you to use UNIX commands directly.

Step 1: Enable WSL

1. Open PowerShell or Command Prompt as an administrator.

1. Run the following command to enable WSL:

This command installs the required WSL 2 components, downloads the latest Linux kernel, and installs the Ubuntu Linux distribution by default.

1. To see other available Linux distributions, run:

1. Restart your computer to complete the installation.

Step 2: Install Required Packages and Rust

1. Open the Ubuntu application from the Start menu.

1. Create a UNIX user account by providing a username and password.

1. Update the package list:

1. Install the required packages:

1. Download and install Rust:

1. Follow the prompts for default installation.

1. Update your shell to include Cargo:

1. Verify the Rust installation:

1. Set Rust to use the stable version by default and update:

1. Add the nightly toolchain and WebAssembly (wasm) targets:

1. Verify the configuration:

Compile the Argochain Node

Now that Rust is installed and configured, you can compile an Argochain node.

Step 1: Clone the Argochain Repository

Clone the Argochain repository:

Step 2: Compile the Argochain Node

Compile the node template:

The compilation process may take several minutes.

Your development environment is now configured for validation and staking on the Argochain network.

Setting Up a macOS Development Environment for Rust

This guide will help you install Rust and set up a Substrate development environment on Apple macOS computers with either Intel or Apple M1 processors.

Before You Begin

Ensure your computer meets the following requirements:

• Operating System: macOS 10.7 Lion or later

• Processor: At least 2GHz (3GHz recommended)

• Memory: At least 8 GB RAM (16 GB recommended)

• Storage: At least 10 GB available space

• Internet: Broadband connection

Step 1: Install Homebrew

If you don't have Homebrew installed, you should install it to manage packages on macOS.

1. Open the Terminal application.

2. Download and install Homebrew by running:

3. Verify Homebrew installation:

Step 2: Install Required Packages

1. Update Homebrew:
2. Install required packages:

Step 3: Install Rust

1. Download and run the rustup installation script:
2. Follow the prompts for default installation.

3. Update your current shell to include Cargo:
4. Verify Rust installation:
5. Configure Rust to use the stable version and update:
6. Add the nightly toolchain and WebAssembly (wasm) targets:
7. Verify the configuration:

Compile a Substrate Node

Now that Rust is installed and configured, you can compile a Substrate node.

Step 1: Clone the Node Template Repository

1. Clone the Substrate node template repository:

Step 2: Compile the Node Template

1. Compile the node template:

   The compilation process may take several minutes.

Your development environment is now set up for Substrate development.

Next Steps

Setting Up a Linux Development Environment for Rust

This guide will help you set up your Linux environment for Rust development, focusing on the necessary steps to install Rust and the required dependencies for developing and validating on the Argochain network.

Prerequisites

Before you begin, ensure your system is up to date and has the necessary tools installed. This guide uses Ubuntu as an example, but the commands can be adapted for other Linux distributions.

Step 1: Update Your System

Open a terminal and update your package lists.

sudo apt update

Step 2: Install Required Packages

Install the essential packages:

sudo apt install -y build-essential clang curl git libssl-dev llvm libudev-dev python3 python3-pip make protobuf-compiler

Step 3: Install Rust

Download and run the rustup installation script to install Rust:

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

Follow the on-screen instructions to complete the installation.

Step 4: Configure Rust

To update your current shell to include Cargo (Rust's package manager), run:

source $HOME/.cargo/env

Verify the Rust installation:

rustc --version

Set Rust to use the stable version by default and update to the latest version:

rustup default stable
rustup update

Step 5: Add Nightly Toolchain and WebAssembly Target

Add the nightly toolchain and the WebAssembly (wasm) target required for Substrate development:

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

Verify the configuration:

rustup show
rustup +nightly show

Compile the Argochain Node

Now that Rust is installed and configured, you can compile an Argochain node.

Step 1: Clone the Argochain Repository

Clone the Argochain repository:

git clone https://github.com/devolved-ai/argochain
cd argochain

Step 2: Compile the Node Template

Compile the Argochain node:

cargo build --release

The compilation process may take several minutes.