Functional testing for Moonbeam

🚧 This folder is currently under W.I.P 🚧

ℹ️ This folder is meant to eventually replace /tests/ when it is feature complete.

This folder contains a set of functional tests designed for Moonbeam network.

It is written in typescript, using the Moonwall framework.

Test Categories

• smoke: Read-only tests that execute against live networks, primarily to verify state consistency and invariant conditions.
• dev: Tests that execute a single local dev node, using PolkadotJs / Ethers.js / Web3.js, to check the runtime and client in a relatively end-to-end manner.
• chopsticks: Tests that use the Chopsticks framework to execute simulations of the state transition function against live state values - but in a sandboxed local environment.
• para: Tests that use the ZombieNet framework to verify Moonbeam in the context of a parachain connected to a relay chain, and other topologies.

Installation

PNPM is the package manager of choice for this repo, due to its superior handling of heavily nested dependencies. There are many ways to install it, but perhaps the easiest is sudo npm -g i pnpm

Once installed, install the package dependencies with pnpm i

Usage

Launch the CLI:

pnpm moonwall

Run a network:

pnpm moonwall run <environment_name>

Download from GitHub:

pnpm moonwall download <artifact>

Test an environment:

pnpm moonwall test <environment_name>

If in doubt, use --help for available options for each command.

Examples

pnpm moonwall test chopsticks_moonbeam

pnpm moonwall run dev_moonbase

pnpm moonwall download moonriver-runtime 2201