Testing a Polkadot Parachain with Zombienet: Key steps and considerations

Regardless of what type ofĀ ParachainĀ you are building, testing it rigorously and optimizing various aspects is integral before moving the parachain to the production environment. You may need to test the chain under certain conditions to see its operational capabilities. For example, how many transactions the Parachain can process (TPS), how much storage, RAM, and CPU it will consume, how well the nodes are connecting with each other, howā€™s the connectivity with the Relay chain, and a lot more. One of the best and most recommended ways of testing your Parachain is by using Zombienetā€“ a CLI tool designed to easily spawn and test Polkadot/Substrate based networks.

This guide explains the step-by-step process of testingĀ Polkadot ParachainĀ with Zombienet. Basically, we will discuss two ways of doing itā€“ by using Zombienet CLI and Zeeveā€™s Larchā€“ Zeeveā€™s Zombienet automation tool and GUI for effortless creation of a local Parachain testing network.

But before we begin, letā€™s quickly explore Parachains and their unique features for those who have just started exploring Parachains. This will give a fair idea of what parachains could add to your application.

ParachainsĀ are popular because of their heterogeneous, multi-chain model that allows development of general-purpose or application-specific chains customized to suit specific needs of web3 projects and dApps. Parachains inherits security and computational resources from the underlying Layer-0 Polkadot ecosystem. Also, all the Parachain are connected to the Relay chain while running in parallel, to maintain interoperability between all the Parachains. Following are the unique benefits of Parachains:

  • Enables creation of specialized L1 blockchains
  • Flexibility in customizing various aspects of the chain, for example- TPS.
  • Interoperability through native bridges.
  • Ease of scaling for higher TPS, without the need of sacrificing security and decentralization.
  • Does not requires users to pay platform fees as Parachains consume computational power from Polkadot.
  • Freedom to offer a custom fee structure designed as per the projectā€™s specifications.
  • No need of bootstrapping their own validators or miners, Parachains leverage security from Polkadot.
  • Easy to upgrade, fix bugs, and incorporate new features as needed.
  • And, much moreā€¦

Key considerations forĀ testing Polkadot Parachains with Zombienet

The following are the important things you need to consider before you test Parachain with Zombienet:


Zombienet is currently compatible with Kubernetes, Podman, and native. However, the requirements for all three platforms are different. For example, Zombienet can work on any k8s cluster, but you must installĀ kubectlĀ to interact with cluster. As for Podman, Zombienet supportsĀ rootlessĀ as provider. The Native Zombienet provider allows nodes to run as local process in any environment.

Features by providers:

Each of the Kubernetesā€™ supported providers offers distinct features. For k8s, Zombinet use Prometheus operator for offloading the visibility/monitoring layer, allowing only the pods to be deployed. Whereas, with Podman,Ā  ZombieNet can deploy a couple of extra pods to add a layer of monitoring/visibility to the running network. Right now, native provider doesnā€™t run any extra layer/process at the moment.

Testing parameters:

Zombienet spawns a network to perform test against metrics, logs, and built-in functions upholding the network. For example, it will check if all the nodes in your network is running, is the defined parachain registered, or can the parachain produce atleast 10 blocks within 100 seconds.

Project types:

Zombienet is suitable for a range of projects using it for as a testing framework or integration. For example in Parity, the projects are CAPI, Cumulus, Polkadot in the testing pipeline, Substrate,Ā SubstrateĀ Connect. Speaking aboutĀ Polkadot, the projects are Acurast, Astar, Gossamer, Oak/Turing/Neumann, Hydradx, InvArch, Mangata, Manta/Phala, Moonbeam, and more.

Testing a Polkadot Parachain with Zombienet: Important steps to follow

Testing of a Parachain involves multiple steps, such as unit testing, benchmarking, runtime check, and debugging. With Zombienet test network, you can easily test a Parachain on several parameters to see if it functions as expected. Further, you can easily make changes to your Parachain setup (if required) because Zombienet creates a configurable local test network, which makes testing and optimization easy and simple.

For this guide, we will discuss two different ways of testing Parachain with Zombienetā€” the CLI method and low-code, automated process with Zeeveā€™s Larch.

However, as we know that Zombienet simulates a Parachain or Relay chain network once it is developed, considering all the configurations and parameters. Building a Parachain can be complex, engineering-intensive, and time consuming. Now, you can deploy your modular Parachain with ā€˜Wrenchā€™ā€” a no-code tool, optimized to launch custom Polkadot and Kusama Parachain devnet within few clicks. Learn more about WrenchĀ here.

Now, itā€™s time to discuss the step-by-step process of testing Polkadot with Zombienet CLI tool:

Option 1:Ā  Creating test network with Zombienet CLI

The Objective:Ā 

Creating a local testnet environmentā€“ Rococo with the following:

  1. Two validators; Alice and Bob.
  2. One Parachain.
  3. One collator.

Step:1 Getting the required binaries

Zombienet CLI is compatible with binaries, Kubernetes, docker, andĀ more. For this article, letā€™s setup Zombienet for using binaries.

For this, you first need to create aĀ binĀ folder that will hold your binaries. Use the below command for this:

mkdir binĀ 

The first binary you need is Polkadot, which will spin up the relay chain.

Use the following command to clone the Polkadot:

git clone https://github.com/paritytech/polkadot

cd to the repository and checkout the latest Polkadotā€™s release and compile it, use the below command for this:

git checkout release-v0.9.32
cargo build -release

Thatā€™s done! You have a Polkadot binary now.

Next, you need substrate-parachain-template binary that will spin up the Parachains:

Use the following command to clone substrate-parachain-template binary:

git clone https://github.com/substrate-developer-hub/substrate-parachain-template

cdĀ into the repo, check latest Polkadot release, and then compile:

git checkout polkadot-v0.9.32
cargo build -release

Now, you have a Parachain collator binary. Copy this binary to your bin folder, use the below command:

cp ./target/release/parachain-template-node ../bin/parachain-template-node-v0.9.32

Now that you have all the required binaries, letā€™s create a Zombienet network.

Step:2 Setting up local test network with Zombienet

A Zombienet network requires configuration. Hence, you need to create a configuration fileā€“ .toml file.

touch config.toml

Basically, we are defining a local Rococo network with two validators and a Parachain. Both these validators will use default image, argos, and commands. Below is the example of .toml file:

default_image = "docker.io/parity/polkadot:latest"
default_command = "polkadot"
default_args = [ "-lparachain=debug" ]

chain = "rococo-local"

Ā  [[relaychain.nodes]]
Ā  name = "alice"
Ā  validator = true

Ā  [[relaychain.nodes]]
Ā  name = "bob"
Ā  validator = true

id = 100

Ā  [parachains.collator]
Ā  name = "collator01"
Ā  image = "docker.io/parity/polkadot-parachain:latest"
Ā  command = "polkadot-parachain"
Ā  args = ["-lparachain=debug"]

If you are using Kubernetes, spawn the network simply by using:

./zombienet-linux -p kubernetes spawn examples/0001-small-network.toml

Or simpler, because Kubernets is the default provider:

./zombienet-linux spawn examples/0001-small-network.toml

Now, you will see that zombienet starts creating the resources needed to launch the network. Therefore, a list of nodes will appear at the end, allowing you to connect to any of the nodes.

Option 2:Ā  Creating test network with Zeeveā€™s Larch-Ā  Zombienet automation tool (the low-code way)

Larch is a innovative GUI frontend designed to automate creation, management, and testing process of Zombienet network. Using Larchā€™s comprehensive dashboard, developers can quickly setup relay chains and parachains just in a few clicks, with no need of manually writing command lines or creating .toml or .yaml files.

Below is a step-by-step process of creating local test network with Zombienet. While these steps are curated for Linux OS,Ā  you can refer toĀ Larchā€™s prerequisitesĀ for using Mac.

Step:1Ā Get the Larch binary first. You can download it from release or build from scratch by yourself.

Step:2Ā Install Podman/Kubectl as per the instructions as it will allow orchestration of Zombinet network.

Step:3Ā Assign execute permission to Larch binary, use the below command:

chmod 755 larch

Run Larch binary using this command:


Step:4Ā Navigate to http://localhost:9000 and click on ā€˜Network Templateā€™ button given at the top.

Step:5Ā Label this template as ā€˜sample templateā€™ (or whatever you want). Here, you can choose Podman or Kubernetes based on your setup. Click ā€˜Nextā€™ to continue.

Step 6:Ā Ā Head to theĀ Relaychain ConfigurationĀ to populate theĀ NodesĀ subsection. Add ā€œaliceā€ as name and then select the ā€˜Validatorā€™ option. Press + button,Ā  to add a new node. Insert ā€œbobā€ as name and chooseĀ  ā€˜Validatorā€™. Again, Press Next.

Step 7:Ā Move to the Parachain Configuration an tap on the ā€˜+ā€˜ button. Set the Parachain ID to 100 (or a number of your choice). Name the collator as ā€œcollator01ā€ and ā€˜polkadot-parachainā€™ as command. Click ā€˜Nextā€™ to continue.

Step 8: For this tutorial, we are skipping HRMP. Hence, click ā€˜Nextā€™.

Step 9:Ā In the Test Configuration section, you can make required configurations in the pre-filled sections and store the template by clicking at ā€˜Saveā€™.

Step10: Go to the Templates page and select ā€˜Createā€™ to initiate the network creation. A dialogue box will pop up where you need to input the networkā€™s name and ā€˜Confirmā€™ to start the orchestration. Now,Ā  Larch will transition you to the networks page while the network is in the creation state.

Step 11:Ā Tap on ā€˜Eyeā€ icon to inspect commands and execution logs. Also, you canĀ  click ā€˜Commandā€™ button to see detailed command and metadata. To see logs/outputs, click the ā€˜Outputā€™ button, which will open another modal revealing the streams.

Upon this, Zombienet network creation will be completed.

Step 12:Ā Also, you can see metrics of your deployed network from ā€˜My Networkā€™ page by tapping on the ā€˜Monitoringā€™ icon. You will be redirected to the Grafana service. Now, open the dashboard from ā€˜Generalā€™ folder and inspect metrics.
Learn more about Larchā€™s featuresĀ here.

Letā€™s wrap up!

As discussed, creating a Zombienet network via the traditional method involves writing commands and compiling JSON, .yaml, and .toml files. This will demand time, resource, and development expertise. With Larch, developers get a GUI interface for Zombienet creation that enables quick simulation and configuration of the local Parachain testing network in a few clicks. If you want to gather more details about Larch or other Zeeveā€™s solutions likeĀ WrenchĀ orĀ Polygon CDK, feel free toĀ connect with our experts. You can schedule one-to-one meeting with them or drop us your queries via email on this page.

Related Articles