release-family.mdx

April 29, 2026 ยท View on GitHub

Overview

A release family is a curated set of component versions across the Cosmos Stack that are tested for compatibility with one another. Cosmos Labs provides maintenance and bug fixes only for active families.

This page is the canonical source of truth for release family lifecycle, active support windows, and retirement expectations.

What a Release Family Contains

Each release family includes pinned versions of the following components:

The goal is to guarantee that every version listed in a family is compatible with every other version in that family.

Certain packages within the SDK may not be listed as Cosmos Labs consolidates separate Go modules over time.

Current Release Families

2026.1

ComponentVersion
Cosmos SDK0.54.x
Enterprise Groups1.x.y
Enterprise PoA1.x.y
CometBFT0.39.x
IBC Gov11.x.y
Solidity IBC Eureka0.1.x
Relayer0.1.x
Attestor0.1.x

2025.1

ComponentVersion
Cosmos SDK0.53.x
CometBFT0.38.x
IBC Gov10.x.y

Upgrades and Support

Supported versions within a release family are updated over time, and upgrade paths are provided where generalized upgrades make sense.

New release families include breaking changes from the previous family. New features are only considered for backporting to the most recent release family, and only when they are non-breaking.

Cosmos Labs supports up to two release families at a time.

Release cadence targets two new release families per year. If a planned successor family is delayed, the most recent supported family remains active until its successor is formally released.

Lifecycle policy applies to families, not individual component versions in isolation. A component version is supported only when it appears in an active release family.

For security reporting and vulnerability handling details, see the Security and Maintenance Policy.

Connectivity upgrades

Connectivity-only upgrades on patch and minor versions are zero-downtime upgrades. An upgrade such as 0.0.1 to 0.0.5 requires intermediate upgrades: 0.0.2, 0.0.3, 0.0.4.

Examples

An example release family might look like:

ComponentVersion
Cosmos SDK0.54.0
CometBFT0.39.0
IBC Gov11.0.0
Solidity IBC Eureka0.1.0
Relayer0.1.0
Attestor0.1.0

Upgrades that would update versions within this family without creating a new one:

  • SDK 0.54.0 to 0.54.1
  • Relayer 0.1.0 to 0.1.1

Upgrades that would require a new release family:

  • SDK 0.54.x to 0.55.0
  • CometBFT 0.39.x to 0.40.x
  • Relayer 0.1.x to 1.0.0

End of Life Notices

The following releases are end of life and no longer receive maintenance, security patches, or compatibility support from Cosmos Labs:

  • CometBFT v0.37.x and lower
  • ibc-go v0.7.x and lower
  • Cosmos SDK v0.50.x and lower

CometBFT v1.x is not supported. That release line was retracted and is not part of any supported release family.