Osmosis v23.0.11-iavl-v1 🧪

< 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.11-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.11-iavl-v1	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.11-iavl-v1-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.11-iavl-v1-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.11-iavl-v1-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.11-iavl-v1 version
# v23.0.11-iavl-v1

All the images support arm64 and amd64 architectures.

Osmosis v23.0.11 🧪

< 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.11
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.11	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:23.0.11-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:23.0.11-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:23.0.11-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:23.0.11 version
# v23.0.11

All the images support arm64 and amd64 architectures.

Osmosis v24.0.0 🧪

This upgrade primarily consists of fixes and improvements for the Osmosis codebase.

Please see the Full Change Log for a complete list of optimizations and any API changes.

User-facing upgrades

3 Second blocks, Implementing IAVL v1.0

The optional v23.0.6-iavl-v1 upgrade implemented a trial reduction to 4 seconds, with partial validator uptake. This has reduced block times to an average of 4.5s from 5s in v23.

This incremental reduction is part of an ongoing push to reduce block time on Osmosis to 1.5s to improve user interaction responsiveness.

This is partially backed by the implementation of an upgraded data structure for persistent storage, IAVL v1.0

Burn Mechanism for ProtoRev

ProtoRev accumulates OSMO, ATOM, and USDC by performing arbitrage on each swap performed on Osmosis against other pools.

Approved in Proposal 710, any OSMO obtained from this will now be burned by sending it to the Null address, reducing the maximum supply of OSMO over time from the 1 billion cap.

Approved in Proposal 709, any non-OSMO assets will be sent to the Community Pool to be used for further initiatives.

Fee Token Whitelist permissioned Address

Delegates control of the Fee Token Whitelist to a subDAO, allowing rapid addition of new listings to those accepted as fees on Osmosis.

Osmosis currently accepts 128 different tokens as payment for the transaction fee, which are then converted to OSMO at epoch for onward distribution to stakers.

These must undergo the standard five-day governance period, which causes friction with new listings. By delegating maintenance of this list to a subDAO, these tokens can be added concurrently with the listing process.

See this forum post for more details.

IBC Wasm Module Added

The IBC Wasm module enables the addition of new light clients for Osmosis, this allows the ability for custom light clients to be added by governance to allow IBC to extend past Cosmos SDK based chains and will play a pivotal role in realizing the vision of IBC as the TCP/IP for blockchains.

ICA Controller Added

Enables Osmosis addresses to perform crosschain transactions with a greater number of previously unavailable chains, such as the Cosmos Hub, Stride, and Noble.

Max Gas per Transaction increased to 60 million

CosmWasm uploads have encountered issues with the previous limit; this change allows each transaction to be far larger if required, allowing more complex contract uploads to occur.

Minimum Epoch Distribution

Approved by Proposal 733, this adds a minimum epoch reward value for Classic pool incentive distribution. This reduces the calculations to be performed at Epoch and, therefore, the time taken to process this block.

Uptime Incentives Redistribution

Uptime Incentives were implemented in v23 and set to one minute by default across Osmosis in Proposal 757. Positions modified under the one-minute duration forfeit the incentives for that period. These are now redistributed to other Liquidity Providers in the pool rather than transferred to the Community Pool.

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
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	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:24.0.0-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:24.0.0-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:24.0.0-alpine	alpine	Alpine image

Example run:

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

All the images support arm64 and amd64 architectures.

Osmosis v24.0.0-rc0 🧪

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.

Osmosis v23.0.8-iavl-v1 🧪

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.

Osmosis v23.0.8 🧪

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.

Osmosis v23.0.7-iavl-v1 🧪

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.

Osmosis v23.0.6 🧪

• 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.

Osmosis v23.0.3 🧪

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.

Osmosis v23.0.0 🧪

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.