ibctest

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

Focusing on Specific Tests

You may focus on a specific tests using the -test.run=<regex> flag.

ibctest -test.run=/<test category>/<chain combination>/<relayer>/<test subcategory>/<test name>

If you want to focus on a specific test:

ibctest -test.run=/////relay_packet
ibctest -test.run=/////no_timeout
ibctest -test.run=/////height_timeout
ibctest -test.run=/////timestamp_timeout

Example of narrowing your focus even more:

# run all tests for Go relayer
ibctest -test.run=///rly/

# run all tests for Go relayer and gaia chains
ibctest -test.run=//gaia/rly/

# only run no_timeout test for Go relayer and gaia chains
ibctest -test.run=//gaia/rly/conformance/no_timeout

Contributing

Running make ibctest will produce an ibctest binary into ./bin. Running that binary without any extra arguments will run a simple IBC test suite involving the Go Relayer. Alternatively, you can run ibctest -matrix path/to/matrix.json to define a set of chains to IBC-test. See cmd/ibctest/README.md for more details.

Note that ibctest is under active development and we are not yet ready to commit to any stable APIs around the testing interfaces.

Please read the logging style guide.

Trophies

Significant bugs that were more easily fixed with ibctest:

• Juno network halt reproduction
• Juno network halt fix confirmation