Skip to main content

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. For lifecycle policy and maintenance windows, see the Security and Maintenance Policy.

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. For full lifecycle and retirement 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