ibc-test-framework
| Crates.io | ibc-test-framework |
| lib.rs | ibc-test-framework |
| version | 0.32.2 |
| created_at | 2022-05-23 14:43:21.212659+00 |
| updated_at | 2025-06-27 13:23:35.558061+00 |
| description | Framework for writing integration tests for IBC relayers |
| homepage | https://hermes.informal.systems/ |
| repository | https://github.com/informalsystems/hermes |
| max_upload_size | |
| id | 591860 |
| size | 844,761 |
Luca Joss (ljoss17)
documentation
README
IBC Relayer Integration Test Framework
Overview
The ibc-test-framework crate provides the infrastructure and framework for writing end-to-end (E2E) tests that include the spawning of the relayer together with Cosmos full nodes running as child processes inside the tests.
Installation
Other than Rust, the test suite assumes the gaiad binary is present in $PATH. You can install Gaia by either building from source, or load it using Cosmos.nix:
nix shell github:informalsystems/cosmos.nix#gaia11
Alternatively, you can use $CHAIN_COMMAND_PATH to override with a different executable that is compatible with gaiad.
Examples
Example tests written using ibc-test-framework can be found in the ibc-rs project repository
Diagrams
Some diagrams have been prepared to ease the understanding of the test framework: