You are not reading the current version of this documentation. 3.0.0-rc is the current version.

Substrate Parachain Runtimes

A collection of runtimes that describe parachains with different purposes.

Quick start

  • Begin by visiting our repository. You can fork it, use it as a template, or simply clone it to your local directory.

git clone [email protected]:OpenZeppelin/polkadot-runtime-template.git

  • Build a release version of the runtime and node:

cargo build --release

  • Receive some ROC from the Rococo faucet

  • Reserve a ParaId on Rococo:

    • Go to PolkadotJS. Check that it points to Rococo testnet.

    • Go to Network > Parachains

    • Go to Parathreads tab

    • Click the + ParaId button

    • Save a parachain id for the further usage.

    • Click Submit and Sign and Submit.

  • Generate and customize a chainspec:

    • Generate a plain chainspec with this command:

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

    • Edit the chainspec:

      • Update name, id and protocolId to unique values.

      • Change relay_chain from rococo-local to rococo.

      • Change para_id and parachainInfo.parachainId from 1000 to the previously saved parachain id.

    • Generate a raw chainspec with this command:

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

  • Run two nodes and wait till it syncs with the Rococo relay chain (it may take up to two days to sync it):

    ./target/release/parachain-template-node \
    --alice \
    --collator \
    --force-authoring \
    --chain raw-parachain-chainspec.json \
    --base-path <path to datadir> \
    --port 40333 \
    --rpc-port 8844 \
    -- \
    --execution wasm \
    --chain <path to the Rococo chainspec> \
    --port 30343 \
    --rpc-port 9977
    ./target/release/parachain-template-node \
    --bob \
    --collator \
    --force-authoring \
    --chain raw-parachain-chainspec.json \
    --base-path <path to datadir> \
    --port 40333 \
    --rpc-port 8845 \
    -- \
    --execution wasm \
    --chain <path to the Rococo chainspec> \
    --port 30343 \
    --rpc-port 9977

  • Register a parathread:

    • Generate a genesis state:

      ./target/release/parachain-template-node export-genesis-state --chain raw-parachain-chainspec.json para-<paraId>-genesis-state

    • Generate a genesis wasm:

      ./target/release/parachain-template-node export-genesis-wasm --chain raw-parachain-chainspec.json para-<paraId>-wasm

    • Go to PolkadotJS. Check that it points to Rococo testnet.

    • Go to Network > Parachains.

    • Go to Parathreads tab.

    • Click the + ParaThread button.

    • Insert para-<paraId>-wasm to code field.

    • Insert para-<paraId>-genesis-state to initial state field.

    • Click Submit and Sign and Submit.

  • When a parachain gets synced with a relaychain, you may start producing blocks as a parathread:

    • Create some transaction with a PolkadotJS pointing to your parachain setup.

    • With a PolkadotJS pointing to Rococo go to Developer > Extrinsics.

    • Submit an extrinsic onDemandAssignmentProvider.placeOrderAllowDeath or onDemandAssignmentProvider.placeOrderKeepAlive:

      • maxAmount should be not less than 10_000_000 and it is amount of 0.00001 ROC. It is an amount of ROC paid for the block.

      • paraId should be set to your parachain id.

      • Click Submit and Sign and Submit.

    • In some time your parathread will produce a block and in one of the next blocks of Rococo there will be an inclusion of this block

What’s next?

  • Read our general guides to understand more about the concepts of runtime development.

  • Learn more about the runtime configuration. Currently, we have a single runtime template (generic one), and you can find documentation for it here.

  • Explore the documentation for pallets. It may be useful if you are considering building a frontend for your parachain.

Weights & Fees →