{"id":13564766,"url":"https://github.com/strangelove-ventures/interchaintest","last_synced_at":"2025-12-29T23:20:37.726Z","repository":{"id":37074745,"uuid":"457886172","full_name":"strangelove-ventures/interchaintest","owner":"strangelove-ventures","description":"e2e testing framework for the interchain","archived":false,"fork":false,"pushed_at":"2024-04-12T18:20:15.000Z","size":45096,"stargazers_count":167,"open_issues_count":38,"forks_count":92,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-04-13T22:01:25.406Z","etag":null,"topics":["cosmos","go","ibc","testing"],"latest_commit_sha":null,"homepage":"https://interchaintest-docs.vercel.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/strangelove-ventures.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-02-10T17:46:22.000Z","updated_at":"2024-05-31T19:23:17.198Z","dependencies_parsed_at":"2024-01-04T03:31:12.375Z","dependency_job_id":"dcaad2e3-813b-40b2-a863-2a6658a1310d","html_url":"https://github.com/strangelove-ventures/interchaintest","commit_stats":{"total_commits":247,"total_committers":15,"mean_commits":"16.466666666666665","dds":0.6720647773279352,"last_synced_commit":"cc5bb34eeea5c54164eb361b595b754df037590a"},"previous_names":["strangelove-ventures/ibctest","strangelove-ventures/ibc-test-framework"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Finterchaintest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Finterchaintest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Finterchaintest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Finterchaintest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/strangelove-ventures","download_url":"https://codeload.github.com/strangelove-ventures/interchaintest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247083723,"owners_count":20880898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cosmos","go","ibc","testing"],"created_at":"2024-08-01T13:01:35.608Z","updated_at":"2025-12-14T20:33:49.250Z","avatar_url":"https://github.com/strangelove-ventures.png","language":"Go","funding_links":[],"categories":["Testing","Go"],"sub_categories":["Terminal Block Explorers"],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003e\u003ccode\u003einterchaintest\u003c/code\u003e\u003c/h1\u003e\n\nFormerly known as `ibctest`.\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/strangelove-ventures/interchaintest@main.svg)](https://pkg.go.dev/github.com/strangelove-ventures/interchaintest@main)\n[![License: Apache-2.0](https://img.shields.io/github/license/strangelove-ventures/interchaintest.svg?style=flat-square)](https://github.com/strangelove-ventures/interchaintest/blob/main/LICENSE)\n[![Go Report Card](https://goreportcard.com/badge/github.com/strangelove-ventures/interchaintest)](https://goreportcard.com/report/github.com/strangelove-ventures/interchaintest)\n\u003c/div\u003e\n\n\n\n🌌 Why use `interchaintest`?\n=============================\n\nIn order to ship production-grade software for the Interchain, we needed sophisticated developer tooling...but IBC and Web3 have a *lot* of moving parts, which can lead to a steep learning curve and all sorts of pain. Recognize any of these?\n\n- repeatedly building repo-specific, Docker- and shell-based testing solutions,\n- duplication of effort, and\n- difficulty in repurposing existing testing harnesses for new problem domains.\n\nWe built `interchaintest` to extract patterns and create a generic test harness: a use-case-agnostic framework for generating repeatable, diagnostic tests for every aspect of IBC.\n\nRead more at the [Announcing `interchaintest` blog post](https://strange.love/blog/announcing-interchaintest).\n\n🌌🌌 Who benefits from `interchaintest`?\n=============================\n\n`interchaintest` is for developers who expect top-shelf testing tools when working on blockchain protocols such as Cosmos or Ethereum.\n\n\n🌌🌌🌌 What does `interchaintest` do?\n=============================\n\n`interchaintest` is a framework for testing blockchain functionality and interoperability between chains, primarily with the Inter-Blockchain Communication (IBC) protocol.\n\nWant to quickly spin up custom testnets and dev environments to test IBC, [Relayer](https://github.com/cosmos/relayer) setup, chain infrastructure, smart contracts, etc.? `interchaintest` orchestrates Go tests that utilize Docker containers for multiple [IBC](https://www.ibcprotocol.dev/)-compatible blockchains.\n\n\n\n🌌🌌🌌🌌 How do I use it?\n=============================\n\n## As a Module\n\nMost people choose to import `interchaintest` as a module.\n- Often, teams will [integrate `interchaintest` with a github CI/CD pipeline](./docs/ciTests.md).\n- Most teams will write their own suite. Here's a tutorial on [Writing Custom Tests](./docs/writeCustomTests.md).\n- You can also [utilize our suite of built-in Conformance Tests that exercise high-level IBC compatibility](./docs/conformance-tests-lib.md).\n\n## As a Binary\n\nThere's also an option to [build and run `interchaintest` as a binary](./docs/buildBinary.md) (which might be preferable, e.g., with custom chain sets). You can still [run Conformance Tests](./docs/conformance-tests-bin.md).\n\n\n## References\n- [Environment Variable Options](./docs/envOptions.md)\n- [Retaining Data on Failed Tests](./docs/retainingDataOnFailedTests.md)\n\n\n🌌🌌🌌🌌🌌 Extras\n=============================\n\n\n\n### Maintained Branches\n\n|                                **Branch Name**                               | **IBC-Go** | **Cosmos-sdk** |\n|:----------------------------------------------------------------------------:|:----------:|:--------------:|\n|     [main](https://github.com/strangelove-ventures/interchaintest)           |     v8     |      v0.50     |\n|     [v7](https://github.com/strangelove-ventures/interchaintest/tree/v7)     |     v7     |      v0.47     |\n\n### Deprecated Branches\n\nThese are branches that we no longer actively update or maintain but may be of use if a chain is running older versions of the `Cosmos SDK ` or `IBC Go`. Please see the [Backport Policy](#backport-policy) below.\n\n\n|                               **Branch Name**                                | **IBC-Go** | **Cosmos-sdk** | **Deprecated Date** |\n|:----------------------------------------------------------------------------:|:----------:|:--------------:|:--------------------:|\n|     [v6](https://github.com/strangelove-ventures/interchaintest/tree/v6)     |     v6     |     v0.46      |     Sept 5 2023      |\n|     [v5](https://github.com/strangelove-ventures/interchaintest/tree/v5)     |     v5     |     v0.46      |     Aug 11 2023      |\n|     [v4](https://github.com/strangelove-ventures/interchaintest/tree/v4)     |     v4     |     v0.45      |     Aug 11 2023      |\n| [v4-ics](https://github.com/strangelove-ventures/interchaintest/tree/v4-ics) |     v4     |  v0.45.x-ics   |     Aug 11 2023      |\n|     [v3](https://github.com/strangelove-ventures/interchaintest/tree/v3)     |     v3     |     v0.45      |     June 25 2023     |\n| [v3-ics](https://github.com/strangelove-ventures/interchaintest/tree/v3-ics) |     v3     |  v0.45.11-ics  |    April 24 2023     |\n\n\n#### Backport Policy:\nStrangelove maintains `n` and `n - 1` branches of `interchaintest`, `n` being current `main`.\n\nWe strive to keep `interchaintest` inline with the latest from the ibc-go and cosmos sdk teams. Once an alpha versions of the next major ibc-go version is released, we will discontinue `n - 1` and branch off a new `n`.\n\n**Recommendation:** Even if your chain uses an older version of ibc-go, try importing from `main`. This should work unless you are decoding transactions that require a specific ibc-go version.\n\nIf there is a feature you would like backported to an older branch, make an issue! We are happy to work with you.\n\n\n## Contributing\n\nContributing is encouraged.\n\nPlease read the [logging style guide](./docs/logging.md).\n\n## Trophies\n\nSignificant bugs that were more easily fixed with `interchaintest`:\n\n- [Juno network halt reproduction](https://github.com/strangelove-ventures/interchaintest/pull/7)\n- [Juno network halt fix confirmation](https://github.com/strangelove-ventures/interchaintest/pull/8)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrangelove-ventures%2Finterchaintest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstrangelove-ventures%2Finterchaintest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrangelove-ventures%2Finterchaintest/lists"}