0tech / planetarium

Test fixtures for cosmos/cosmos-sdk based apps

planetarium

Introduction

You can use this project for:

1. testing cosmos-sdk based applications - test
2. launching & maintaining validator subnet - playbook

Prerequisites

While this project does almost of its jobs in Docker instances, there is a few additional requirements (other than the basic packages on Debian GNU/Linux).

You can install the requirements by:

sudo apt install docker-compose cmake jq

Usage

Configure

At first, you need to configure the project by:

build_dir=build  # the folder which you want to output the artifacts into
cmake -S . -B $build_dir

After that, you may change some variables by:

variable_name=TEST_NUM_REGIONS  # the name of variable
variable_value=7                # set the value of variable to
cmake -S . -B $build_dir -D$variable_name=$variable_value

You can provide as many changes as you want, and the changes would be accumulated. The changes are cached so it persists forever until you override the change or remove your build directory.

You can see the list of variables which you may want to set:

cmake -S . -B $build_dir -L

You may also want to read the descriptions:

cmake -S . -B $build_dir -LH

Build

Now you may trigger some target. The core targets would be:

• build: build the project and make the binaries (e.g. daemon and cosmovisor)

You can trigger a target by:

target_name=build
cmake --build $build_dir --target $target_name

Test

You can trigger all the tests by:

ctest --test-dir $build_dir

Or, a certain test by:

test_name=upgrade_chain_auto
ctest --test-dir $build_dir -R $test_name

planetarium's Issues

Use ansible

It would allow us to deploy the chain not only on the containers, but also on various scenes, including the real environments.

Add IBC test prototype

For the IBC tests, we must refactor the fixtures so we can run different types of chains together:

• Refactor the CMake variables used for selecting app
• Refactor the app binary preparation script
• Refactor the chain fixture

After the refactor, we need to add an IBC test:

• Add a relayer fixture
• Add an IBC test using the fixture

Add tests on andromeda

After the target project releases its first version, we should add tests on it.

Add IBC tests

IBC is one of the most important features of cosmos-sdk. We should add relevant fixtures & tests into this project.

• #7
• Refactor relayer node setup
• Add a IBC test between different chains