📚
Open Polkadot Bootcamp
  • 📚 About the Bootcamp
    • 📖 Additional Resources
    • 👐 Ask For Support
  • 📖 Curriculum
  • 📕Rust Programming Language
    • Basic Rust
      • Introduction to Rust
        • 🧑‍💻 Excercises
      • Common Programming Concepts
        • 🧑‍💻 Excercises
      • Program Life Cycle
        • 🧑‍💻 Excercises
      • Ownership & Borrow Checker
      • Common Data Structures
    • Advanced Rust
      • Generic types, Trait extension and Advanced types
      • Lifetime Notation
      • Smart pointers & Macros
      • Common design patterns in Rust
      • Package management & How to structure your Rust project
      • Overview of the Rust ecosystem
  • 📘Building a blockchain with Polkadot SDK
    • Polkadot
      • Additional Reads
        • Why do you want to build a blockchain on Polkadot?
        • Understanding the sharded network design of Polkadot
      • Development on Polkadot
    • Polkadot SDK
      • Substrate
        • Create a new blockchain
          • 🧑‍💻 Exercise: Clone the minimal template
          • Understanding the architecture
          • Break down the node architecture
          • Introducing to Pop CLI tool
        • Adding a custom logic to runtime
          • 🧑‍💻 Exercise: Rust State Machine
          • Components of a Pallet
          • Hooks
          • Weights & Benchmarking
          • Extensions
            • Signed Extensions
            • Transaction Extensions
        • Common runtime modules
          • 📕Example: System Pallet
          • 📕Example: Contracts Pallet
          • 📕Example: Assets Pallet
          • 📕Example: Utility Pallet
        • Runtime API and RPC
        • Runtime upgrade
        • Bump Polkadot SDK versions
      • Cumulus
        • Introduction to Cumulus
          • Parachain from scratch
          • 🧑‍💻 Exercise: Build a parachain from scratch
        • Running a local relaychain network
          • Register & reserve a parachain
          • Launch the network & run a collator node
          • Launch the network with Pop CLI
        • Agile Coretime
    • Polkadot Hub
  • 📒Smart Contract Development
    • Introduction
      • Introduction to PolkaVM
      • Getting started with Solidity development
      • Solidity File Structure
      • Contract Structure
    • Basic Solidity
      • Value types
      • Reference Types
      • Mapping Types
      • Simple Storage
    • Advanced Solidity
      • Units
      • Global Variables
      • Expression and Control Structures
      • Advanced Storage
      • Contract Tests
      • Contracts
Powered by GitBook
On this page
  • Getting Started
  • Generate chainspec, runtime wasm, genesis state
  • Chainspec
  • Runtime wasm
  • Genesis state
  1. Building a blockchain with Polkadot SDK
  2. Polkadot SDK
  3. Cumulus

Running a local relaychain network

PreviousParachain from scratchNextRegister & reserve a parachain

Last updated 4 months ago

Below materials are primarily referenced from:

Before setting up a local relaychain network, walk through these materials:

  • Understanding the sharded network design of Polkadot

  • Prepare a local relaychain:

  • Connect a local parachain:

Getting Started

Make sure they are compiled based on the same release version. If you want to connect the parachain to an already running Relay chain you can skip the Polkadot steps.

NOTE: Our polkadot version for the binaries is v1.14.0

  • Build Polkadot:

git clone https://github.com/paritytech/polkadot
cd polkadot
cargo build --release

  • Build Parachain:

git clone https://github.com/paritytech/polkadot-sdk-parachain-template
cd polkadot-sdk-parachain-template
cargo build --release

Generate chainspec, runtime wasm, genesis state

Chainspec

  • Plain:

./target/release/parachain-template-node build-spec --disable-default-bootnode > parachain-chainspec.json

Important: edit the parachain-chainspec.json where necessary. For example; set the correct para-id, protocolid or relay_chain.

  • Raw:

./target/release/parachain-template-node build-spec --chain parachain-chainspec.json --disable-default-bootnode --raw > parachain-chainspec-raw.json

Runtime wasm

Required to register the Parachain on the Relay Chain. The Relay Chain needs the runtime code to validate blocks.

./target/release/parachain-template-node export-genesis-wasm --chain parachain-chainspec-raw.json parachain-wasm

Genesis state

Required to register the Parachain on the Relay Chain. Both the Relay Chain and the Parachain need to start from the same starting state.

./target/release/parachain-template-node export-genesis-state --chain parachain-chainspec-raw.json parachain-genesis-state

The para-id needs to be reserved on the Relay Chain. Check out the tutorial and look for the step "Reserve a unique identifier"

📘
https://hackmd.io/@s_iGZLIITG6WjSgnFX0pcg/the-collator-setup-guide
https://docs.substrate.io/tutorials/build-a-parachain/prepare-a-local-relay-chain/
https://docs.substrate.io/tutorials/build-a-parachain/connect-a-local-parachain/
"Connect a local Parachain"