# Build, run & test using source code

This guide will walk you through:

* building the blockchain node from source code,
* running a local development instance, which spawns a new single-node testnet,
* interacting with development instance,
* running automated tests.

## Install dependencies

For Ubuntu & Debian derivatives:

```
sudo apt update
sudo apt install build-essential git clang curl libssl-dev llvm libudev-dev make protobuf-compiler pkg-config
```

Next install Rust itself. Run and follow prompts:

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

And install WASM target:

```
rustup target add wasm32-unknown-unknown
```

See [Substrate docs](https://docs.substrate.io/install/) for detailed guide and other platforms.

## Fetch latest source code

Development of Liberland Blockchain Node happens in two branches:

* `main`, which contains latest stable release
* `develop`, which contains latest, not yet released as stable changes

To fetch source code, run the following (you may replace `main` with `develop` if desired):

```
git clone https://github.com/liberland/liberland_substrate.git -b main
cd liberland_substrate
```

## Minimum requirements

Make sure you have at least 4 GB of RAM available. If you dont, add whats missing to swap. [Adding swap for ubuntu](https://www.cloudsigma.com/adding-swap-space-on-ubuntu-20-04-a-tutorial/) Note that this will fix some out of memory build errors, but will significantly prolong the build.

## Build the node

To build the node, run:

```
cargo build --release
```

Note that this will likely take a long time. If everything goes correctly, you'll see:

```
    Finished release [optimized] target(s)
```

And will be able to run the node using built executable (output might differ slightly):

```
user@machine:~/liberland_substrate$ ./target/release/substrate --version
substrate 3.0.0-dev-41cd30e9e7d
```

## Run and interact with development instance

To run a development instance of Liberland node, execute:

```
cargo run --release -- --dev
```

Development instance is a single-node testnet, in which standard development accounts (Alice, Bob, etc.) are endowed with assets. To interact with it, visit [Polkadot.js Apps](https://polkadotjs.blockchain.liberland.org/?rpc=ws://localhost:9944).

## Run automated tests

Liberland Blockchain node is comprehensively covered with automated unit tests. To run them, execute:

```
cargo test --features runtime-benchmarks
```

As these typically take a long time, you can also choose to run tests only for specific pallets. Here's example for the legislation pallet:

```
cargo test --features runtime-benchmarks -p pallet-liberland-legislation --lib
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.liberland.org/blockchain/for-developers-and-testers/dev.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.