Releases: cosmos/ibc-go
v8.7.0
This release contains a fix for ISA-2025-001.
This version addresses a security vulnerability in IBC-go's deserialisation of acknowledgements and we strongly encourage everyone in the affected versions to update their chain immediately. This patch is not state-breaking, so chains can upgrade in a rolling manner. This does not have to be a co-ordinated upgrade. However, validators should upgrade as soon as possible when the release is made available. If the vulnerability is exploited before 2/3 is patched, the chain will halt.
Full Changelog: v8.6.1...v8.7.0
To learn more about ibc-go versioning, please read our RELEASES.md.
IMPORTANT: Please read the migration guides for any versions of ibc-go that you might be going through when upgrading to this version. For example: if you upgrade from the IBC module contained in the Cosmos SDK 0.42.0 to SDK v0.50.9 and ibc-go v8.5.1, please follow:
- The migration from SDK 0.41.x or 0.42.x to the IBC module in the ibc-go repository based on the SDK v0.44.x.
- The migration from ibc-go v1 to v2.
- The migration from ibc-go v2 to v3.
- The migration from ibc-go v3 to v4.
- The migration from ibc-go v4 to v5.
- The migration from ibc-go v5 to v6.
- The migration from ibc-go v6 to v7.
- The migration from ibc-go v7 to v7.1.
- The migration from ibc-go v7.2 to v7.3.
- The migration from ibc-go v7 to v8.
- The migration from ibc-go v8 to v8.1.
v7.10.0
This release contains a fix for ISA-2025-001.
This version addresses a security vulnerability in IBC-go's deserialisation of acknowledgements and we strongly encourage everyone in the affected versions to update their chain immediately. This patch is not state-breaking, so chains can upgrade in a rolling manner. This does not have to be a co-ordinated upgrade. However, validators should upgrade as soon as possible when the release is made available. If the vulnerability is exploited before 2/3 is patched, the chain will halt.
Full Changelog: v7.9.2...v7.10.0
To learn more about ibc-go versioning, please read our RELEASES.md.
IMPORTANT: Please read the migration guides for any versions of ibc-go that you might be going through when upgrading to this version. For example: if you upgrade from the IBC module contained in the Cosmos SDK 0.42.0 to SDK v0.50.9 and ibc-go v8.5.1, please follow:
- The migration from SDK 0.41.x or 0.42.x to the IBC module in the ibc-go repository based on the SDK v0.44.x.
- The migration from ibc-go v1 to v2.
- The migration from ibc-go v2 to v3.
- The migration from ibc-go v3 to v4.
- The migration from ibc-go v4 to v5.
- The migration from ibc-go v5 to v6.
- The migration from ibc-go v6 to v7.
- The migration from ibc-go v7 to v7.1.
- The migration from ibc-go v7.2 to v7.3.
ibc-go v10 release candidate
This is the third release candidate for ibc-go v10.0.0.
Like most unreleased software, it is not recommended to use this in production as it might still have bugs and unexpected behavior.
The changelog and migration docs are not up-to-date yet, but some notable changes from v8 are below:
New versioning scheme for modules
Previously, the modules in the ibc-go repo has been versioned and branched separately from ibc-go. Starting with v10, modules/light-clients/08-wasm
will follow and release together with ibc-go. So the first stable release of both modules will be {MODULE_NAME}/v10.0.0
. The callbacks module has been included in ibc-go's own module, and is therefore not a separate module anymore.
You can find releases and notes for those modules separately.
Features
Removal to ease maintenance and attack surface
- Removal of the capabilities module
- Removal of the fee middleware module
- Removal of channel upgradability
- Removed fee middleware
- Removed channel upgradability
Other noteworthy changes
Since the early work started on v10, some important changes also include
- Redaction of ibc-go v9, so that we could also remove ICS20v2 (
ics20-2
) - Cleanup of API surface, bringing back multiple functions as deprecated to reduce upgrade burden from v8
modules/light-clients/08-wasm v10 release candidate
This is the third release candidate for modules/light-clients/08-wasm v10.0.0.
The main changes are noted in ibc-go's release notes: https://github.com/cosmos/ibc-go/releases/tag/v10.0.0-rc.3
Special notice for the 08-wasm release are:
Ethereum light client support
While the main Ethereum light client support is implemented as a separate 08-wasm CosmWasm smart contract in the solidity-ibc-eureka repo, there is a new blsverifier querier that enables BLS verification in CosmWasm.
v8.6.1
This release contains a fix to ASA-2025-004
It is recommended to upgrade to this version as soon as possible.
Full Changelog: v8.5.3...v8.6.1
To learn more about ibc-go versioning, please read our RELEASES.md.
IMPORTANT: Please read the migration guides for any versions of ibc-go that you might be going through when upgrading to this version. For example: if you upgrade from the IBC module contained in the Cosmos SDK 0.42.0 to SDK v0.50.9 and ibc-go v8.5.1, please follow:
- The migration from SDK 0.41.x or 0.42.x to the IBC module in the ibc-go repository based on the SDK v0.44.x.
- The migration from ibc-go v1 to v2.
- The migration from ibc-go v2 to v3.
- The migration from ibc-go v3 to v4.
- The migration from ibc-go v4 to v5.
- The migration from ibc-go v5 to v6.
- The migration from ibc-go v6 to v7.
- The migration from ibc-go v7 to v7.1.
- The migration from ibc-go v7.2 to v7.3.
- The migration from ibc-go v7 to v8.
- The migration from ibc-go v8 to v8.1.
v7.9.2
This release contains a fix to ASA-2025-004
It is recommended to upgrade to this version as soon as possible.
Full Changelog: v7.8.0...v7.9.2
To learn more about ibc-go versioning, please read our RELEASES.md.
IMPORTANT: Please read the migration guides for any versions of ibc-go that you might be going through when upgrading to this version. For example: if you upgrade from the IBC module contained in the Cosmos SDK 0.42.0 to SDK v0.50.9 and ibc-go v8.5.1, please follow:
- The migration from SDK 0.41.x or 0.42.x to the IBC module in the ibc-go repository based on the SDK v0.44.x.
- The migration from ibc-go v1 to v2.
- The migration from ibc-go v2 to v3.
- The migration from ibc-go v3 to v4.
- The migration from ibc-go v4 to v5.
- The migration from ibc-go v5 to v6.
- The migration from ibc-go v6 to v7.
- The migration from ibc-go v7 to v7.1.
- The migration from ibc-go v7.2 to v7.3.
modules/light-clients/08-wasm/v0.6.0+ibc-go-v10.0-wasmvm-v2.2 beta
Third beta of the 08-wasm light client with ibc-go v10.
This version is only relevant for early integrators as documentation are still missing and bugs are expected.
modules/apps/callbacks/v0.3.0+ibc-go-v10.0 beta
Third beta of the callbacks middleware with ibc-go v10 and Eureka support.
This version is only relevant for early integrators as documentation are still missing and bugs are expected.
modules/light-clients/08-wasm/v0.5.0+ibc-go-v8.4-wasmvm-v1.2
The changes in this release:
Dependencies
- #7735 Bump wasmvm to v2.1.4 * (NOTE: This is a state machine breaking dependency update)
In order to use this release, please follow the steps to import git commit 3f2a900.
Full Changelog: modules/light-clients/08-wasm/v0.4.1+ibc-go-v8.4-wasmvm-v2.0...modules/light-clients/08-wasm/v0.5.0+ibc-go-v8.4-wasmvm-v1.2
modules/light-clients/08-wasm/v0.4.0+ibc-go-v7.4-wasmvm-v1.5
The changes in this release:
Dependencies
- #7744 Bump wasmvm to 1.5.6 * (NOTE: This is state machine breaking change)
In order to use this release, please follow the steps to import git commit 8392c48.
Full Changelog: modules/light-clients/08-wasm/v0.3.1+ibc-go-v7.4-wasmvm-v1.5...modules/light-clients/08-wasm/v0.4.0+ibc-go-v7.4-wasmvm-v1.5