Skip to main content


Gem Node a fresh FRAME-based experimental network, ready for hacking ๐Ÿš€

Getting Started#

Using Nix#

Install nix and optionally direnv and lorri for a fully plug and play experience for setting up the development environment. To get all the correct dependencies activate direnv direnv allow and lorri lorri shell.

Rust Setup#

First, complete the basic Rust setup instructions.


Use Rust's native cargo command to build and launch the Gem node:

cargo run --release -- --dev --tmp


The cargo run command will perform an initial build. Use the following command to build the node without launching it:

cargo build --release

Embedded Docs#

Once the project has been built, the following command can be used to explore all parameters and subcommands:

./target/release/gem -h


The provided cargo run command will launch a Gem node and its state will be discarded after you terminate the process. After the project has been built, there are other ways to launch the node.

Single-Node Development Chain#

This command will start the single-node development chain with persistent state:

./target/release/gem --dev

Purge the development chain's state:

./target/release/gem purge-chain --dev

Start the development chain with detailed logging:

RUST_LOG=debug RUST_BACKTRACE=1 ./target/release/gem -lruntime=debug --dev

Connect with Polkadot-JS Apps Front-end#

Once the Gem node is running locally, you can connect it with Polkadot-JS Apps front-end to interact with your chain. Click here connecting the Apps to your local Gem node.