Osmosis Labs Osmosis Versions Save

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v24.0.0-rc0
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:24.0.0-rc0	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:24.0.0-rc0-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:24.0.0-rc0-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:24.0.0-rc0-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:24.0.0-rc0 version
# v24.0.0-rc0

All the images support arm64 and amd64 architectures.

Reduces default commit timeout down from 4s to 3s. Node operators can also now stop the automatic app.toml/config.toml overrides by adding the --reject-config-defaults=true flag to the start command.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.8
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.8	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.8-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.8-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.8-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.8 version
# v23.0.8

All the images support arm64 and amd64 architectures.

NOTE: Only to be used with an IAVL v1 snapshot. You can download from snapshots.osmosis.zone.

Reduces default commit timeout down from 4s to 3s. Node operators can also now stop the automatic app.toml/config.toml overrides by adding the --reject-config-defaults=true flag to the start command.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.8-iavl-v1
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.8-iavl-v1	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.8-iavl-v1-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.8-iavl-v1-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.8-iavl-v1-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.8-iavl-v1 version
# v23.0.8-iavl-v1

All the images support arm64 and amd64 architectures.

NOTE: Only to be used with an IAVL v1 snapshot. You can download from snapshots.osmosis.zone.

• Bumps IAVL version from upstream, fixing multiple bugs and improving pruning.

• A new fast node module whitelist in the app.toml. This option allows node operators to only run fast nodes for specific modules. In the case of Osmosis, this should just be set to "lockup". For IAVL v1, this allows for faster syncing, while keeping the benefits of fast nodes that are desired for epoch.

• Bump the comet version in order to improve P2P connections when running blocksync.

• No longer skips WW pools in SQS now that they are no longer broken in mainnet.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.7-iavl-v1
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.7-iavl-v1	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.7-iavl-v1-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.7-iavl-v1-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.7-iavl-v1-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.7-iavl-v1 version
# v23.0.7-iavl-v1

All the images support arm64 and amd64 architectures.

• A new fast node module whitelist in the app.toml. This option allows node operators to only run fast nodes for specific modules. In the case of Osmosis, this should just be set to "lockup". For IAVL v1, this allows for faster syncing, while keeping the benefits of fast nodes that are desired for epoch.

• Bump the comet version in order to improve P2P connections when running blocksync.

• No longer skips WW pools in SQS now that they are no longer broken in mainnet.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.6
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.6	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.6-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.6-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.6-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.6 version
# v23.0.6

All the images support arm64 and amd64 architectures.

State compatible version bumps and small sync/epoch speedups.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.3
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.3	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.3-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.3-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.3-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.3 version
# v23.0.3

All the images support arm64 and amd64 architectures.

The v23 upgrade introduces uptime-based incentives, enhancing the incentive distribution framework to reward not just liquidity depth but also uptime, refines the distribution mechanism for incentives associated with high-precision assets and reduces epoch duration.

Uptime-based Incentives

With the activation of Uptime Incentive parameters for Supercharged pools, this upgrade introduces a novel way to reward liquidity providers (LPs) not just for the depth of their contributions but also for their duration of participation. Incentive creators can now set a "minimum uptime" requirement, focusing rewards on LPs who meet these criteria. The determination of the exact "minimum uptime" period will be guided by future governance proposals.

Specific Incentive Adjustments

• External Uptime Incentives: PR #7417 allows for the customization of external incentives through a Duration setting.
• Internal Uptime Incentives: PR #7419 introduces a global parameter for the regulation of internal incentives.

Forums for Community Discussion

• Proposal for Uptime-Based Incentives: Discussion Thread

Incentives distribution for High Precision Assets

PR #7409 addresses the accurate distribution of rewards for pools involving high-precision assets, tackling the challenge of reward accumulator truncation in high liquidity scenarios.

Impacted pools must migrate to implement a new scaling factor. The migration affects six pools with a total liquidity of $1.2M at current time:

• stDYDX/DYDX - Pool 1423
• YieldEth/ETH - Pool 1213
• wstETH/ETH - Pools 1291 & 1431
• ETH/WETH.grv - Pool 1297
• ARCH/DAI - Pool 1298

Epoch Optimizations

This upgrade includes significant epoch optimizations to reduce the epoch block duration:

• PR #7250 enhances the filtering of gauges during epoch calculations.
• PR #7427 implements TWAP record pruning across multiple blocks

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.0
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.0	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.0-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.0-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.0-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.0 version
# v23.0.0

All the images support arm64 and amd64 architectures.

< DESCRIPTION OF RELEASE >

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.0-rc1
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:23.0.0-rc1	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.0-rc1-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.0-rc1-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.0-rc1-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.0-rc1 version
# v23.0.0-rc1

All the images support arm64 and amd64 architectures.

This release adds some minor epoch speedup logic, along with a new in-place-testnet CLI for creating testnets with mainnet state instantly.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v22.0.5
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:22.0.5	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:22.0.5-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:22.0.5-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:22.0.5-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:22.0.5 version
# v22.0.5

All the images support arm64 and amd64 architectures.

This release only adds some additional logging for troubleshooting.

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux (amd64 and arm64) are available below.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v22.0.3
make install

🐳 Run with Docker

As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container. The following Docker images are available in our registry:

Image Name	Base	Description
osmolabs/osmosis:22.0.3	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:22.0.3-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:22.0.3-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:22.0.3-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:22.0.3 version
# v22.0.3

All the images support arm64 and amd64 architectures.