v2 beta

Release Notes

Cosmos SDK enters a new phase. A phase with a more performant core layer, rewritten from the ground up. A phase where modules can remain unchanged and chains can take advantage of those performances and UX improvements at no cost.

Unburdened By What Has Been

How to upgrade

Already Enthousiast? Great!

Upgrade now by following v0.52.0 UPGRADING.md and afterwards the UPGRADING_v2.md (wip).
The documentation at docs.cosmos.network is being updated to reflect the new core design, and the UPGRADING_v2.md is being crafted.

As always, an example application is available: simapp/v2.

Note

Hesitant? Upgrade to Olympus LTS (v0.52), same core as before, improved, with long term support, and ease into v2 later on.

Disambiguation

v2 refers to all the new core components of the SDK:

• cosmossdk.io/runtime/v2 v2.0.0-beta.1
• cosmossdk.io/server/v2 v2.0.0-beta.1
• cosmossdk.io/server/v2/stf v1.0.0-beta.1
• cosmossdk.io/server/v2/appmanager v1.0.0-beta.1
• cosmossdk.io/server/v2/cometbft v1.0.0-beta.1
• cosmossdk.io/store/v2 v2.0.0-beta.1

Official Cosmos SDK modules in this repository are compatible with v2 and v0.52.0. Refer to the version matrix to understand what it means.

Tip

• The v2 core layer only needs cosmossdk.io/core v1.
• Essentially, the core layer of v0.52 (baseapp & server packages) is being replaced by v2 in a v2 chain.
• The default consensus server (server/v2/cometbft) and core v1 compatible modules are using v0.52.

What next?

• v2 has already 98% feature parity with v0.52.x.
  • What's missing? Check out our project board.
• v2 is as good as ready for final release
  • IAVL v2 integration is coming in a store v2.0.0-beta.2 (review + benchmarks ongoing)
  • Documentation is being updated.
• An audit of the v2 components will happen begin next year (Jan/Feb 2025).

Made with ❤️ by

(in alphabetical order)

• Binary Builders @binary_builders
• Decentrio @decentriolabs
• Vitwit @vitwit_

Special thanks to the Cronos & Strangelove team for already testing v2 🫶

v0.52.0-rc.1

Cosmos SDK v0.52.0-rc.1 Release Notes

We've just released a release candidate for the Cosmos SDK v0.52.0.
APIs should now be stable, and we encourage everyone to start integrating with this release candidate.

This release is the first totally modular release of the Cosmos SDK. Many components have been extracted in their own modules. Refer to the version matrix to understand what it means (modules have been tagged as rc.1 as well).

A final release is expected in the coming days 🎄.

Please see the CHANGELOG for an exhaustive list of changes.
Refer to the UPGRADING.md for upgrading your application.

Full Commit History: release/v0.50.x...release/v0.52.x

v0.50.11

Cosmos SDK v0.50.11 Release Notes

💬 Release Discussion

🚀 Highlights

We are back on schedule for our monthly v0.50.x patch releases.
The last two months, next to ramping up on v0.52 and v2, we added a few bug fixes and (UX) improvements.

Notable changes:

• Fix ABS-0043/ABS-0044.
• New Linux-only backend that adds Linux kernel's keyctl support
• Skip sims test when running dry on validators

📝 Changelog

Check out the changelog for an exhaustive list of changes, or compare changes from the last release.

Maintenance Policy

Cosmos SDK Olympus (v0.52) final release is approaching really soon. That means the Eden line (v0.50.x) will soon only be supported for bug fixes only, as per our release policy. Earlier versions are not maintained.

Note, that the next SDK release, v0.52, does not include x/params migration, when migrating from < v0.47, v0.50.x or v0.47.x, is a mandatory migration.

Start integrating with Cosmos SDK Eden (v0.52) and enjoy and the new features and performance improvements.

v0.47.15

Cosmos SDK v0.47.15 Release Notes

💬 Release Discussion

🚀 Highlights

This release fixes ABS-0043/ABS-0044. Check the advisory for more information.

Additionally, this release is mainly here to disclose the incoming end-of-life of the v0.47.x line.

Check out the changelog for an exhaustive list of changes or compare changes from last release.

End-of-Life Notice

v0.47.15 is the last release of the v0.47.x line. Per this version, the v0.47.x line has reached its end-of-life.
The SDK team maintains the latest two major versions of the SDK. This means no features, improvements or bug fixes will be backported to the v0.47.x line. Per our policy, the v0.47.x line will receive critical security patches only.

We encourage all chains to upgrade to Cosmos SDK Olympus (rc) (v0.52.0), or the v0.50.x line.

cosmovisor/v1.7.0

Cosmovisor v1.7.0 Release Notes

See the CHANGELOG for details on the changes in v1.7.0.

Installation instructions

go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest

v0.52.0-beta.2

Cosmos SDK v0.52.0-beta.2 Release Notes

There are no release notes for pre-releases.

When integrating, use the latest pseudo version from the release branch (release/v0.52.x) for SDK modules or main for other packages. Cosmos SDK modules won't be tagged before RC. Refer to the version matrix to understand what it means.
Note, this beta contains some dependencies annoyance that will be resolved before the RC (i.e. the SDK is temporarily importing bank and staking).

Please see the CHANGELOG for an exhaustive list of changes.
Refer to the UPGRADING.md for upgrading your application.

Full Commit History: release/v0.50.x...release/v0.52.x
Changes from last beta: v0.52.0-beta.1...v0.52.0-beta.2

v0.50.10

Cosmos SDK v0.50.10 Release Notes

💬 Release Discussion

🚀 Highlights

For this month patch release of the v0.50.x line, some bugs were fixed.

Notably, we fixed the following:

• Add the root command module-hash-by-height to query and retrieve module hashes at a specific height
• PreBlock events (mainly x/upgrade) are now emitted (this time, for real)
• A fix in runtime baseapp option ordering, giving issue when other modules were having options

📝 Changelog

Check out the changelog for an exhaustive list of changes, or compare changes from the last release.

Refer to the upgrading guide when migrating from v0.47.x to v0.50.1.
Note, that the next SDK release, v0.52, will not include x/params migration, when migrating from < v0.47, v0.50.x or v0.47.x, is a mandatory migration.

v0.47.14

Cosmos SDK v0.47.14 Release Notes

💬 Release Discussion

🚀 Highlights

For this month's patch release of the v0.47.x line, a few bugs were fixed in the SDK.

Check out the changelog for an exhaustive list of changes or compare changes from last release.

Refer to the upgrading guide when migrating from v0.47.x to v0.50.x.

Maintenance Policy

v0.50 has been released which means the v0.47.x line is now supported for bug fixes only, as per our release policy. Earlier versions are not maintained.

Start integrating with Cosmos SDK Eden (v0.50) and enjoy and the new features and performance improvements.

v0.52.0-beta.1

Cosmos SDK v0.52.0-beta.1 Release Notes

There are no release notes for pre-releases.

This is the first beta of the Cosmos SDK v0.52.0 release since the internal audit has been completed.

When integrating, use the latest pseudo version from the release branch (release/v0.52.x) for SDK modules or main for other packages. Cosmos SDK modules won't be tagged before RC. Refer to the version matrix to understand what it means.
Note, this beta contains some dependencies annoyance that will be resolved before the RC (i.e. the SDK is temporarily importing bank and staking).

Please refer to the CHANGELOG for an exhaustive list of changes.
Refer to the UPGRADING.md for upgrading your application.

Full Commit History: release/v0.50.x...release/v0.52.x

v0.52.0-alpha.1

Cosmos SDK v0.52.0-alpha.1 Release Notes

There are no release notes for pre-releases.

A beta release will be cut in the coming days after audits.
Cosmos SDK modules won't be tagged before RC, when integrating with alphas and betas, use the latest pseudo version from the release branch for SDK modules or main for other packages. Refer to the version matrix to understand what it means.
On the other hand, cosmossdk.io/core v1 beta will be cut soon, to allow you to upgrade your modules easily.
Lastly, this alpha contains some dependencies annoyance that will be resolved before the RC (i.e. the SDK is temporarily importing auth, bank and staking).

Please see the CHANGELOG for an exhaustive list of changes.
Refer to the UPGRADING.md for upgrading your application.

Full Commit History: release/v0.50.x...release/v0.52.x