Osmosis Labs Osmosis Versions Save

Upgrade Features

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

Block SDK - Top of Block Auction

Enhances Osmosis Block construction by adding Lanes within blocks via Skip’s Block SDK. Lanes act as categorised mempools, each with its own rules and traffic flow.

The initial Lane implemented is the Top of Block Auction.

• Users can submit a transaction bundle to a lane that takes place before all the other transactions in the block.
• The first position within the block has value, confirming that the submitter will obtain any time-sensitive value, such as cross-chain arbitrage opportunities.
• The transaction bundle with the highest bid in USDC will be accepted.

Revenue generated by the Top-of-Block Auction is split: 5% goes to the validator that proposed the block, and 95% is accumulated to a module address for future usage to be determined by governance.

Check out the Blog Post for more information on this feature.

Consensus Improvements

• Gas prices are now entirely calculated by the EIP 1559-style gas market. Some validators had previously set a higher constant to combat spam, which resulted in empty blocks being produced. The default min-gas-prices parameter used by nodes has been changed to 0.

• Target Block time of 2.5 seconds, down from the current 3-second target. Block timeout has been reduced from 2 to 1.5 seconds as part of the incremental push towards 1.5-second blocks.

• Preparation for Comet Pruning implementation by updating consensus parameters for evidence retention periods to two weeks. This ensures all nodes retain the entire unbonding period in blocks for slashing purposes.

Smart Accounts

Smart Accounts allow transactions to be approved by multiple authentication methods. Example usage of this feature includes functions such as

• Automated transaction triggers, such as stop orders.
• One-click trading.
• Multi-device support.
• Sub-management of assets.
• Registration of an Osmosis address using Passkeys, Face ID, or Touch ID.
• Personal Rate Limit setting for deposits.
• Social recovery or anti-phishing features.

Smart Account functionality will be enabled by a future governance proposal. The Smart Account functionality includes a circuit breaker address as an additional security measure to disable the Smart Account service if any vulnerabilities are detected. This address is currently controlled by Osmosis Labs contributors.

Config Updates

If you utilize the --reject-config-defaults flag, please consider manually changing the following values in your config.toml:

[consensus]
timeout_commit = "1.5s"
timeout_propose = "2s"

and the following values in your app.toml:

minimum-gas-prices = "0uosmo"

[osmosis-mempool]
max-gas-wanted-per-tx =  "60000000"
arbitrage-min-gas-fee =  "0.1"

If you don’t utilize this flag, the above values will automatically be set for you, so no action is needed.

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

Example run:

docker run osmolabs/osmosis:25.0.0 version
# v25.0.0

All the images support arm64 and amd64 architectures.

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

Example run:

docker run osmolabs/osmosis:25.0.0-rc0 version
# v25.0.0-rc0

All the images support arm64 and amd64 architectures.

This release overwrites the commit timeout to 1.5s, targeting 2.5s 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 v24.0.4
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.4	distroless/static-debian11	Default image based on Distroless
osmolabs/osmosis:24.0.4-distroless	distroless/static-debian11	Distroless image (same as above)
osmolabs/osmosis:24.0.4-nonroot	distroless/static-debian11:nonroot	Distroless non-root image
osmolabs/osmosis:24.0.4-alpine	alpine	Alpine image

Example run:

docker run osmolabs/osmosis:24.0.4 version
# v24.0.4

All the images support arm64 and amd64 architectures.

This release bumps the version of our cometbft fork. This primarily patches a query issue in comet, which should result in querying transactions by events using much less RAM than before.

Additionally, websocket logs were moved to debug, and merkle tree hashing was optimized.

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

Example run:

docker run osmolabs/osmosis:24.0.3 version
# v24.0.3

All the images support arm64 and amd64 architectures.

The primary feature of this release is improved config and app toml overrides. This now allows node operators to keep their comments within the toml files, and fixes an edge case where a brand new config is generated.

This release also contains minor speedups and removal of legacy code.

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

Example run:

docker run osmolabs/osmosis:24.0.2 version
# v24.0.2

All the images support arm64 and amd64 architectures.

This release includes async pruning for IAVL v1, which prevents nodes from pausing while pruning lots of data.

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

Example run:

docker run osmolabs/osmosis:24.0.1 version
# v24.0.1

All the images support arm64 and amd64 architectures.

This release includes async pruning for IAVL v1, which prevents nodes from pausing while pruning lots of data.

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

Example run:

docker run osmolabs/osmosis:23.0.12-iavl-v1 version
# v23.0.12-iavl-v1

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

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

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.