Releases: cosmos/ibc-go
modules/apps/callbacks/v0.2.0+ibc-go-v8.0
This release bumps ibc-go to v8.0.0 and introduces two fixes:
- The event that is emitted when the callback cannot be executed due to a panic or an out of gas error indicates now that an error occurred.
- The packet is not be sent unless the
IBCSendPacketCallbackreturnsnilexplicitly (see this issue for more information).
Please also note that this release requires a coordinated upgrade.
v8.0.0
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 8.2.0.
This release main additions are:
Cosmos SDK v0.50 upgrade
We have upgraded to Cosmos SDK v0.50.1 and CometBFT v0.38.
Migration of gov proposals from v1beta1 to v1
Governance proposals based on Cosmos SDK version v1beta1 of the x/gov module have been migrated to v1 messages. The proposal ClientUpdateProposal has been deprecated and MsgRecoverClient should be used instead. Likewise, the proposal UpgradeProposal has been deprecated and MsgIBCSoftwareUpgrade should be used instead. Both proposals will be removed in the next major release.
MsgRecoverClient and MsgIBCSoftwareUpgrade will only be allowed to be executed if the signer is the authority designated at the time of instantiating the IBC keeper. So please make sure that the correct authority is provided to the IBC keeper.
Migration of params to be self managed
Params of all modules are now self-managed. Each module has a corresponding MsgUpdateParams message with a field of type Params that can be specified in full to update the module's params.
Legacy params subspaces must still be initialised in app.go in order to successfully migrate from x/params to the new self-contained approach. See this code sample for more information.
For new chains which do not rely on migration of parameters from x/params, an expected interface has been added for each module. This allows chain developers to provide nil as the legacySubspace argument to NewKeeper functions.
Highlights 🌟
Please see the v8.0.0 changelog for the full set of changes included in this release. We present here a summary of other relevant changes included in this release:
dependencies
apps/transfer
Length validation has been added to the Receiver and Memo fields of MsgTransfer.
We are now using Cosmos SDK x/bank's Metadata to store metadata for IBC vouchers when they are minted for the first time. Cosmos SDK v0.50 introduces the boolean field resolve_denom to QueryAllBalancesRequest and the flag resolve-denom in the query bank balances CLI command. When specified in the balances query, and if there exists metadata for the IBC vouchers in the balance of the account, the denomination displayed for IBC vouchers will not be the regular denomination of the form ibc/<hash>, but a human-readable denomination with full prefix trace path and the token denomination on the source chain.
For example, when using the query bank balances CLI command before the resolve-denom flag was available, the denomination for IBC vouchers displayed like this:
> simd query bank balances cosmos14wajutn6hcph9u8zl6j9c4l5cduwpqwmu3g7nt \
--node http://localhost:27010
balances:
- amount: "100"
denom: ibc/27A6394C3F9FF9C9DCF5DFFADF9BB5FE9A37C7E92B006199894CF1824DF9AC7C
- amount: "100000000"
denom: samoleans
- amount: "99998941"
denom: stake
pagination:
next_key: ""
total: "3"But from ibc-go v8.0.0, when using the resolve-denom flag, the denomination for IBC vouchers will be displayed like this:
> simd query bank balances cosmos14wajutn6hcph9u8zl6j9c4l5cduwpqwmu3g7nt --resolve-denom \
--node http://localhost:27010
balances:
- amount: "100"
denom: transfer/channel-0/samoleans
- amount: "100000000"
denom: samoleans
- amount: "99998941"
denom: stake
pagination:
next_key: ""
total: "3"Note that the denomination for the IBC voucher displays now as transfer/channel-0/samoleans.
We have also implemented an automatic migration handler to set the denomination metadata for the IBC denominations of all vouchers minted by the transfer module. Therefore, the human-readable denomination will be available for all previously minted IBC vouchers.
apps/27-interchain-accounts
- An
encodingparameter has been added toSerializeCosmosTxandDeserializeCosmosTxto specify the encoding format of the messages. Currently supported values areproto3andproto3json. - Length validation has been added to the
Ownerfield ofMsgRegisterInterchainAccountand theOwnerfield ofMsgSendTx.
apps/29-fee
- Length validation has been added to the
CounterpartyPayeefield ofMsgRegisterCounterpartyPayee.
Contributors ❤️
Special thanks to all external contributors that pushed code for this release:
- @0xmuralik
- @anhductn2001
- @aleem1314
- @alpe
- @AtreusSoltani
- @bugarela
- @catShaark
- @CyberGA
- @dzmitry-lahoda
- @emidev98
- @expertdicer
- @faddat
- @GNaD13
- @hieuvubk
- @julienrbrt
- @lazyfuhrer
- @mmsqe
- @PanGan21
- @phamminh0811
- @pysel
- @Reecepbcups
- @RegisGraptin
- @rllola
- @ruthishvitwit
- @siburu
- @sontrinh16
- @stackman27
- @tbruyelle
- @ThanhNhann
- @tac0turtle
- @trinitys7
- @ulbqb
- @vishal-kanna
- @webmaster128
Migration 🦆
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.1 and ibc-go v8.0.0, 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.
Contributors
Assets 11
modules/capability v1.0.0
x/capability -> modules/capability
The x/capability module previously maintained within the Cosmos SDK has been migrated to this repository. Thanks to the team at Binary Builders (@binary_builders) and @tac0turtle for helping to facilitate the handover.
Please note that with the v1.0.0 release of this module, it will enter maintenance mode and no additional features will be added.
v1.0.0
Dependencies
- #4068 Upgrade capability module to Cosmos SDK v0.50.1.
Improvements
- #4068 Various improvements made to testing to reduce the dependency tree and use new cosmos-sdk test utils.
- #4770 Save gas on
IsInitialized, useHasin favour ofGet.
Bug Fixes
- #15030
InitMemStorenow correctly uses aNewInfiniteGasMeterfor bothGasMeterandBlockGasMeter. This fixes an issue where thegasMeterwas incremented non-deterministically across validators. See #15015 for more information.
Capability in the Cosmos SDK Repository
The capability module was originally released in v0.40.0 of the Cosmos SDK. Please see the Release Notes.
The capability module has been removed from the Cosmos SDK from v0.50.0 onwards and has been migrated to this repository. It will now be maintained as a standalone go module.
Please refer to the Cosmos SDK repository for historical content.
Special thanks to all external contributors that pushed code for this release:
Contributors
Assets 2
v8.0.0-rc.0
This release main additions are:
Cosmos SDK v0.50 upgrade
We have upgraded to Cosmos SDK v0.50 and CometBFT v0.38.
Migration of gov proposals from v1beta1 to v1
Governance proposals based on Cosmos SDK version v1beta1 of the x/gov module have been migrated to v1 messages. The proposal ClientUpdateProposal has been deprecated and MsgRecoverClient should be used instead. Likewise, the proposal UpgradeProposal has been deprecated and MsgIBCSoftwareUpgrade should be used instead. Both proposals will be removed in the next major release.
MsgRecoverClient and MsgIBCSoftwareUpgrade will only be allowed to be executed if the signer is the authority designated at the time of instantiating the IBC keeper. So please make sure that the correct authority is provided to the IBC keeper.
Migration of params to be self managed
Params of all modules are now self-managed. Each module has a corresponding MsgUpdateParams message with a field of type Params that can be specified in full to update the module's params.
Legacy params subspaces must still be initialised in app.go in order to successfully migrate from x/params to the new self-contained approach. See this code sample for more information.
For new chains which do not rely on migration of parameters from x/params, an expected interface has been added for each module. This allows chain developers to provide nil as the legacySubspace argument to NewKeeper functions.
Please see the v8.0.0-rc.0 changelog for the full set of changes included in this pre-release. We present here a summary of other relevant changes included in this release:
dependencies
apps/transfer
We are now using Cosmos SDK x/bank's Metadata to store metadata for IBC vouchers when they are minted for the first time. Cosmos SDK v0.50 introduces the boolean field resolve_denom to QueryAllBalancesRequest and the flag resolve-denom in the query bank balances CLI command. When specified in the balances query, and if there exists metadata for the IBC vouchers in the balance of the account, the denomination displayed for IBC vouchers will not be the regular denomination of the form ibc/<hash>, but a human-readable denomination with full prefix trace path and the token denomination on the source chain.
For example, when using the query bank balances CLI command before the resolve-denom flag was available, the denomination for IBC vouchers displayed like this:
> simd query bank balances cosmos14wajutn6hcph9u8zl6j9c4l5cduwpqwmu3g7nt \
--node http://localhost:27010
balances:
- amount: "100"
denom: ibc/27A6394C3F9FF9C9DCF5DFFADF9BB5FE9A37C7E92B006199894CF1824DF9AC7C
- amount: "100000000"
denom: samoleans
- amount: "99998941"
denom: stake
pagination:
next_key: ""
total: "3"But from ibc-go v8.0.0, when using the resolve-denom flag, the denomination for IBC vouchers will be displayed like this:
> simd query bank balances cosmos14wajutn6hcph9u8zl6j9c4l5cduwpqwmu3g7nt --resolve-denom \
--node http://localhost:27010
balances:
- amount: "100"
denom: transfer/channel-0/samoleans
- amount: "100000000"
denom: samoleans
- amount: "99998941"
denom: stake
pagination:
next_key: ""
total: "3"Note that the denomination for the IBC voucher displays now as transfer/channel-0/samoleans.
We have also implemented an automatic migration handler to set the denomination metadata for the IBC denominations of all vouchers minted by the transfer module. Therefore, the human-readable denomination will be available for all previously minted IBC vouchers.
apps/27-interchain-accounts
An encoding parameter has been added to SerializeCosmosTx and DeserializeCosmosTx to specify the encoding format of the messages. Currently supported values are proto3 and proto3json.
Special thanks to all external contributors that pushed code for this release:
- @0xmuralik
- @anhductn2001
- @aleem1314
- @alpe
- @AtreusSoltani
- @bugarela
- @catShaark
- @CyberGA
- @dzmitry-lahoda
- @emidev98
- @expertdicer
- @faddat
- @GNaD13
- @hieuvubk
- @julienrbrt
- @lazyfuhrer
- @PanGan21
- @phamminh0811
- @pysel
- @Reecepbcups
- @RegisGraptin
- @rllola
- @ruthishvitwit
- @siburu
- @sontrinh16
- @stackman27
- @tbruyelle
- @ThanhNhann
- @tac0turtle
- @trinitys7
- @ulbqb
- @vishal-kanna
- @webmaster128
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 and ibc-go v8.0.0-rc.0, 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.
Contributors
Assets 2
v7.3.1
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 7.4.0.
We present here a summary of the most relevant changes, please see the v7.3.1 changelog for the full set of changes included in this release.
dependencies
- Cosmos SDK has been bumped to v0.47.5.
apps/transfer
- The REST endpoint
/ibc/apps/transfer/v1/denom_tracestakes precedence over/ibc/apps/transfer/v1/denom_traces/{hash}when no argument is provided.
Special thanks to our external contributors in this release: @emidev98
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.47.5 and ibc-go v7.3.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.
Contributors
Assets 11
v7.2.2
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 7.4.0.
We present here a summary of the most relevant changes, please see the v7.2.2 changelog for the full set of changes included in this release.
dependencies
- Cosmos SDK has been bumped to v0.47.5.
apps/transfer
- The REST endpoint
/ibc/apps/transfer/v1/denom_tracestakes precedence over/ibc/apps/transfer/v1/denom_traces/{hash}when no argument is provided.
Special thanks to our external contributors in this release: @emidev98
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.47.5 and ibc-go v7.2.2, 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.
Contributors
Assets 11
v6.2.1
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 6.3.0.
We present here a summary of the most relevant changes, please see the v6.2.1 changelog for the full set of changes included in this release.
apps/transfer
- The REST endpoints
/ibc/apps/transfer/v1/denom_traces/{hash}and/ibc/apps/transfer/v1/denom_hashes/{trace}accept now values forhashandtracethat contain slashes.
Special thanks to our external contributors in this release: @emidev98
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.46.12 and ibc-go v6.2.1, please follow:
Contributors
Assets 11
v6.1.2
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 6.3.0.
We present here a summary of the most relevant changes, please see the v6.1.2 changelog for the full set of changes included in this release.
apps/transfer
- The REST endpoints
/ibc/apps/transfer/v1/denom_traces/{hash}and/ibc/apps/transfer/v1/denom_hashes/{trace}accept now values forhashandtracethat contain slashes.
Special thanks to our external contributors in this release: @emidev98
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.46.7 and ibc-go v6.1.2, please follow:
Contributors
Assets 11
v5.3.2
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 5.4.0.
We present here a summary of the most relevant changes, please see the v5.3.2 changelog for the full set of changes included in this release.
apps/transfer
- The REST endpoints
/ibc/apps/transfer/v1/denom_traces/{hash}and/ibc/apps/transfer/v1/denom_hashes/{trace}accept now values forhashandtracethat contain slashes.
Special thanks to our external contributors in this release: @emidev98
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.46.12 and ibc-go v5.3.2, please follow:
Contributors
Assets 11
v4.5.1
UPDATES
- 5th April 2024: This release is NOT recommended since it is impacted by the ASA-2024-007 security advisory. Please use version >= 4.6.0.
We present here a summary of the most relevant changes, please see the v4.5.1 changelog for the full set of changes included in this release.
apps/transfer
- The REST endpoints
/ibc/apps/transfer/v1/denom_traces/{hash}and/ibc/apps/transfer/v1/denom_hashes/{trace}accept now values forhashandtracethat contain slashes.
Special thanks to our external contributors in this release: @emidev98
Please note that the v4 release line contains a bug where fee-enabled Interchain Accounts channels cannot be reopened in case of channel closure due to packet timeout. Regular Interchain Accounts channels (i.e. non fee-enabled) can be reopened. In order to be able to reopen fee-enabled Interchain Accounts channels, please upgrade to v5.3.1 or above.
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.45.16 and ibc-go v4.5.1, please follow: