parallel: A Rust repository from ayushmishra2005

A new Cumulus-based Substrate node, ready for hacking 🚀

Website | White Paper | API Docs | Chat

Getting Started

Follow these steps to get started with the Cumulus Template 🛠️

Setup

First, complete the basic Rust setup instructions.

If necessary, refer to the setup instructions at the Substrate Developer Hub.

Build

Once the development environment is set up, build the node template. This command will build the Wasm and native code:

cargo build --release

Available commands

make help

Run Heiko Node (via polkadot-launch 1.7.0)

make launch

Run Heiko Node (manually)

Local Testnet

Polkadot (release-v0.9.8 branch)

cargo build --release

./target/release/polkadot build-spec --chain rococo-local --raw --disable-default-bootnode > rococo_local.json

./target/release/polkadot --chain ./rococo_local.json -d cumulus_relay0 --validator --alice --port 50555 --node-key 0000000000000000000000000000000000000000000000000000000000000001


./target/release/polkadot --chain ./rococo_local.json -d cumulus_relay1 --validator --bob --port 50556 \
        --bootnodes /ip4/127.0.0.1/tcp/50555/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp

Substrate Parachain Template:

# this command assumes the chain spec is in a directory named polkadot that is a sibling of the working directory
./target/release/parallel -d local-test --collator --alice --chain heiko-dev --ws-port 9915 --parachain-id 200 -- --chain ../polkadot/rococo_local.json \
        --bootnodes /ip4/127.0.0.1/tcp/50555/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp

Registering on Local Relay Chain

In order to produce blocks you will need to register the parachain as detailed in the Substrate Cumulus Workshop by going to

Developer -> sudo -> paraSudoWrapper -> sudoScheduleParaInitialize(id, genesis)

Ensure you set the ParaId to 200 and the parachain: Bool to Yes.

The files you will need are in the ./resources folder, if you need to build them because you modified the code you can use the following commands

cargo build --release
# Build the Chain spec
./target/release/parallel build-spec --disable-default-bootnode > ./resources/template-local-plain.json
# Build the raw file
./target/release/parallel build-spec --chain=./resources/template-local-plain.json --raw --disable-default-bootnode > ./resources/template-local.json


# export genesis state and wasm
./target/release/parallel export-genesis-state --parachain-id 200 > ./resources/para-200-genesis
./target/release/parallel export-genesis-wasm > ./resources/para-200.wasm

Embedded Docs

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

./target/release/parallel -h

Docker

Run Vanilla Dev Node

docker run --restart=always -d -p 9944:9944 \
    -v "$(pwd):/data" \
    parallelfinance/parallel:latest \
    parallel-dev -d /data --dev --ws-external

Run Vanilla Live Validator Node

docker volume create chains

docker run --restart=always --name parallel -d -p 9944:9944 -p 9933:9933 \
    -v "chains:/data" \
    -v "$(pwd)/live.json:/usr/local/bin/live.json" \
    parallelfinance/parallel:latest \
    parallel-dev -d /data --chain /usr/local/bin/live.json --validator --rpc-cors all --rpc-methods=Unsafe --unsafe-rpc-external --unsafe-ws-external

# insert aura & gran keys to keystore
curl http://localhost:9933 -H "Content-Type:application/json;charset=utf-8" -d "@aura.json"
curl http://localhost:9933 -H "Content-Type:application/json;charset=utf-8" -d "@gran.json"

docker exec -it parallel bash

# setup liquidation account
parallel-dev key insert --chain=/usr/local/bin/live.json --suri "<validator's seed>" --key-type pool -d /data

# restart and allow only p2p connections
docker container stop parallel
docker container rm parallel

docker run --restart=always --name parallel -d -p 30333:30333 \
    -v "chains:/data" \
    -v "$(pwd)/live.json:/usr/local/bin/live.json" \
    parallelfinance/parallel:latest  \
    parallel-dev -d /data --chain /usr/local/bin/live.json --validator

Run Vanilla Live Full Node

docker volume create chains

docker run --restart=always --name parallel -d -p 9944:9944 \
    -v "chains:/data" \
    -v "$(pwd)/live.json:/usr/local/bin/live.json" \
    parallelfinance/parallel:latest \
    parallel-dev -d /data --chain /usr/local/bin/live.json --rpc-cors all --unsafe-ws-external

Run Heiko Dev Network

docker-compose -f docker-compose-heiko-dev.yml up -d
docker-compose logs -f

Generate heiko-dev's genesis state & wasm

docker run --rm  parity/polkadot:latest build-spec --chain rococo-local --raw --disable-default-bootnode > rococo-local.json

docker run --rm  parallelfinance/parallel:latest parallel export-genesis-state --chain heiko-dev --parachain-id 200 > ./para-200-genesis
docker run --rm  parallelfinance/parallel:latest parallel export-genesis-wasm --chain heiko-dev > ./para-200.wasm

Learn More

Refer to the upstream Substrate Developer Hub Node Template to learn more about the structure of this project, the capabilities it encapsulates and the way in which those capabilities are implemented. You can learn more about The Path of Parachain Block on the official Polkadot Blog.

Open Source Credits

We would like to thank the following projects.

ayushmishra2005/parallel