/ibctest

e2e testing framework for IBC capable chains

Primary LanguageGoApache License 2.0Apache-2.0

ibctest

Go Reference License: Apache-2.0 Go Report Card

ibctest orchestrates Go tests that utilize Docker containers for multiple IBC-compatible blockchains.

It allows users to quickly spin up custom testnets and dev environments to test IBC and chain infrastructures.

-- Features --

  • Built-in suite of conformance tests to test high-level IBC compatibility between chain sets
  • Easily construct customized tests in highly configurable environments
  • Deployable as CI tests in production workflows

Table Of Contents


Building Binary

While it is not necessary to build the binary, sometimes it can be more convenient, specifically when running conformance test with custom chain sets.

Building binary:

git clone https://github.com/strangelove-ventures/ibctest.git
cd ibctest
make ibctest

This places the binary in ibctest/.bin/ibctest

Note that this is not in your Go path.

Contributing

Contributing is encouraged.

Please read the logging style guide.

Trophies

Significant bugs that were more easily fixed with ibctest: