Osmosis v17.0.0-rc0 🧪

Release candidate to test the v17.0.0 upgrade.
DO NOT USE THESE RELEASE BINARIES TO UPDATE NODES.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:17.0.0-rc0	Default image. Based on Distroless image
osmolabs/osmosis:17.0.0-rc0-distroless	Distroless image (same as above)
osmolabs/osmosis:17.0.0-rc0-nonroot	Distroless non root image
osmolabs/osmosis:17.0.0-rc0-alpine	Alpine image

Example:

docker run osmolabs/osmosis:17.0.0-rc0 version
# v17.0.0-rc0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v16.1.1 🧪

This minor release focus on add missing superfluid (#5831) and Concentrated Liquidity CLI queries (#5796).

Changelog

See the full changelog here

⚡️ Binaries

Binaries for Linux and Darwin (amd64 and arm64) are available below.
Darwin users can also use the same universal binary osmosisd-{{ .Version }}-darwin-all for both amd64 and arm64.

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

Example run:

docker run osmolabs/osmosis:16.1.1 version
# v16.1.1

All the images support arm64 and amd64 architectures.

Osmosis v16.1.0 🧪

This is a major release for the highly anticipated v16.1.0 upgrade, focused on enhancing the Osmosis platform's functionality and capital efficiency.

It introduces several new modules and features while also updating existing APIs and dependencies.

Key Features and Enhancements:

1. SuperCharged Liquidity Module (x/concentrated-liquidity):
   The SuperCharged Liquidity Module revolutionizes the pool model on Osmosis, significantly improving capital efficiency. It offers optimized liquidity allocation and enhanced trading performance for users.

2. CosmWasm Pool Module (x/cosmwasmpool):
   With the CosmWasm Pool Module, users can now create and manage liquidity pools backed by CosmWasm smart contracts. This integration brings heightened security and flexibility to the liquidity pool ecosystem.

3. ProtoRev Changes (x/protorev):
   ProtoRev implements crucial modifications to the payment schedule for the development account, transitioning it from a weekly structure to immediate settlements after each trade. Additionally, hooks are introduced to enable efficient triggers for backruns, joinPool, and exitPool operations.

4. Exit Fee disabled on pool creation
   Actions Proposal 429 by preventing the creation of new pools with an Exit Fee.

5. Multi-Asset Fee Whitelisting
   Allows a single governance proposal to whitelist multiple fee tokens that are permitted for use as transaction fees at a time. This will enable the bulk addition of fee tokens to Osmosis and enable users to pay for their first transaction in most denominations.

6. Route Splitting Impact protection enabled
   Allows multiple swap messages provided across multiple routes to be linked together while keeping the price impact protection setting from the overall Swap message. This optimizes swaps by allowing interfaces to route through multiple pools to obtain a lower slippage than using one pool alone.

7. SwapFee parameters changed to SpreadFactor
   Osmosis has listed pools as having a "swap fee" since launch. In an AMM this acts identically to a spread on an order book in which a position trades around. With the introduction of Supercharged Liquidity, this becomes more apparent due to the variable positions and so all instances of a Swap Fee are renamed to a Spread Factor.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis-dev:16.1.0	Default image. Based on Distroless image
osmolabs/osmosis-dev:16.1.0-distroless	Distroless image (same as above)
osmolabs/osmosis-dev:16.1.0-nonroot	Distroless non root image
osmolabs/osmosis-dev:16.1.0-alpine	Alpine image

Example:

docker run osmolabs/osmosis-dev:16.1.0
# v16.1.0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

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

From this release, we have available in beta Darwin (amd64 and arm64) binaries.
Darwin users can also use the same universal binary osmosisd-16.1.0-darwin-all for both amd64 and arm64.

Osmosis v16.0.0-rc2 🧪

This is a major release candidate for the highly anticipated v16.0.0 major release, focused on enhancing the Osmosis platform's functionality and capital efficiency.

This release candidate introduces several new modules and features while also updating existing APIs and dependencies.

Key Features and Enhancements:

1. SuperCharged Liquidity Module (x/concentrated-liquidity):
   The SuperCharged Liquidity Module revolutionizes the pool model on Osmosis, significantly improving capital efficiency. It offers optimized liquidity allocation and enhanced trading performance for users.

2. CosmWasm Pool Module (x/cosmwasmpool):
   With the CosmWasm Pool Module, users can now create and manage liquidity pools backed by CosmWasm smart contracts. This integration brings heightened security and flexibility to the liquidity pool ecosystem.

3. ProtoRev Changes (x/protorev):
   ProtoRev implements crucial modifications to the payment schedule for the development account, transitioning it from a weekly structure to immediate settlements after each trade. Additionally, hooks are introduced to enable efficient triggers for backruns, joinPool, and exitPool operations.

⚠️ This release candidate includes also the binaries for the osmo-test-5 testnet, which contain a different upgrade handler. The code for the testnet can be found in the v16.0.0-rc2-testnet tag.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis-dev:16.0.0-rc2	Default image. Based on Distroless image
osmolabs/osmosis-dev:16.0.0-rc2-distroless	Distroless image (same as above)
osmolabs/osmosis-dev:16.0.0-rc2-nonroot	Distroless non root image
osmolabs/osmosis-dev:16.0.0-rc2-alpine	Alpine image

Example:

docker run osmolabs/osmosis-dev:16.0.0-rc2 version
# v16.0.0-rc2

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v15.2.0 🧪

This minor release primarily mitigates a potential deadlock that could be triggered by the uploads of new cosmwasm contracts. Additionally, it introduces query-gas-limit, a new configuration option in app.toml, designed to address previously observed P2P disconnection anomalies. Finally, this release fixes several bugs related to export genesis, the emission of governance events, and block timestamps in queries.

We highly recommend all validators and fullnodes to upgrade to this version to increase the stability of the network.

Security updates

• Deadlock Prevention: We've corrected SDK bugs that could potentially induce deadlock situations during new smart contract deployment.

• Introduction of query-gas-limit in app.toml: We've added a new configurationquery-gas-limit to app.toml . This helps limit the computational resources a query can demand, solving issues of nodes being disconnected while responding to resource-intensive queries.

Bug Fixes

• Fixes in Export Genesis: Various bugs identified in the export genesis have been fixed.
• Fix Bug in Emission of Governance Events: the missing emission of some governance events has been fixed.
• Correct Block Timestamp in Historic Queries: historic queries now return correct block timestap.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:15.2.0	Default image. Based on Distroless image
osmolabs/osmosis:15.2.0-distroless	Distroless image (same as above)
osmolabs/osmosis:15.2.0-nonroot	Distroless non root image
osmolabs/osmosis:15.2.0-alpine	Alpine image

Example:

docker run osmolabs/osmosis:15.2.0 version
# v15.2.0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v15.1.2 🧪

This release applies the security patch "Huckleberry" to ibc-go, upgrading it to version 4.3.1.
The details of the security advisory can be found here: IBC huckleberry security advisory.

While this change can be applied at your own convenience, we recommend doing that at the earliest opportunity.

Other changes:

• Update sdk fork with the change for correct block time in historical queries (#5134)
• Relax twap record validation in init genesis to allow one of the spot prices to be non-zero when twap error is observed. (#5129)

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:15.1.2	Default image. Based on Distroless image
osmolabs/osmosis:15.1.2-distroless	Distroless image (same as above)
osmolabs/osmosis:15.1.2-nonroot	Distroless non root image
osmolabs/osmosis:15.1.2-alpine	Alpine image

Example:

docker run osmolabs/osmosis:15.1.2 version
# v15.1.2

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v15.1.0 🧪

This release focuses on applying a security patch "Cherry" of the wasmvm: https://github.com/CosmWasm/advisories/blob/main/CWAs/CWA-2023-002.md

While this change can be applied at your own convenience, we recommend doing that at the earliest opportunity.

The risk to Osmosis is mitigated by the fact that contracts are permissionned. However, we do not know at this time if any of the earlier uploaded contracts are exploitable.

In addition, this release includes minor state-compatible changes. Most notably, new events and a highest liquidity pool query for protorev.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:15.1.0	Default image. Based on Distroless image
osmolabs/osmosis:15.1.0-distroless	Distroless image (same as above)
osmolabs/osmosis:15.1.0-nonroot	Distroless non root image
osmolabs/osmosis:15.1.0-alpine	Alpine image

Example:

docker run osmolabs/osmosis:15.1.0 version
# v15.1.0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v15.0.0 🧪

This release contains the following new modules:

• ProtoRev module (x/protorev). This module captures MEV via in-protocol cyclic arbitrage and distributes the revenue back to the protocol based on governance. It was developed by the Skip team.

• Validator Set Preference module (x/valset-pref). This module allows users to delegate to multiple validators according to their preference list.

• Pool Manager module (x/poolmanager). This module manages the infrastructure around pool creation and swaps. It serves as a unified entry point for any swap-related message or query. This module is extracted from the pre-existing x/gamm. It is the first milestone on the path toward delivering concentrated liquidity.

It also includes new features in other modules such as:

• Superfluid unlock partial amount
• Consensus min fee of .0025 uosmo. Now, Osmosis takes the given gas multiplies it by at least the consensus min fee and compares it against the given fee where the fee must be >= gas * consensus min fee.
• Async ICQ
• Added rate limits according to: https://www.mintscan.io/osmosis/proposals/427

Notable bug fixes and API breaks:

• Fix incorrect time delta due to nanoseconds in time causing TWAP jitter.
• Remove Osmosis gamm and twap bindings that were previously supported as custom wasm plugins.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:15.0.0	Default image. Based on Distroless image
osmolabs/osmosis:15.0.0-distroless	Distroless image (same as above)
osmolabs/osmosis:15.0.0-nonroot	Distroless non root image
osmolabs/osmosis:15.0.0-alpine	Alpine image

Example:

docker run osmolabs/osmosis:15.0.0 version
# v15.0.0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v14.0.1 🧪

This is a patch release that introduces minor bug fixes. It can be applied at the node operator's convenience.

Namely, fixes EstimateSwapExactAmountIn and EstimateSwapExactAmountOut x/gamm CLI and geometric TWAP genesis validation.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:14.0.1	Default image. Based on Distroless image
osmolabs/osmosis:14.0.1-distroless	Distroless image (same as above)
osmolabs/osmosis:14.0.1-nonroot	Distroless non root image
osmolabs/osmosis:14.0.1-alpine	Alpine image

Example:

docker run osmolabs/osmosis:14.0.1 version
# v14.0.1

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.

Osmosis v14.0.0 Neon 🧪

Osmosis Neon major release brings new features and improvements to smart contract development on Osmosis.

Cosmwasm <> IBC Composability Work

Added hooks that provide sender information when transferring tokens to a contract between chains. This for instance suffices for someone to build ICA via cosmwasm. Added the ability for IBC contracts to register a callback that forwards into a smart contract. This work is stand-alone importable by other chains, to help this composability become more standard in the interchain.

Downtime Detection Tooling

This module detects if the Osmosis chain has been down for a period of time, allowing users of price oracles to wait until any price differential between on-chain liquidity and wider liquidity has been arbitraged away.

Geometric TWAP

Geometric Time Weighted Average Price (TWAP) is now available as a price oracle for pools. Geometric TWAPs should theoretically be more accurate in measuring the actual price over time of a pool than the more commonly used, but also available, Arithmetic mean TWAP.

Other Improvements

In addition to the above features, this release includes an upgrade to IBC v4.2.0 and wasmd v0.30.x, as well as a update to the go build version to go 1.19.

What Changed

See the full changelog here

Usage

🐳 Docker

The following Docker images are available in our registry:

Image	Description
osmolabs/osmosis:14.0.0	Default image. Based on Distroless image
osmolabs/osmosis:14.0.0-distroless	Distroless image (same as above)
osmolabs/osmosis:14.0.0-nonroot	Distroless non root image
osmolabs/osmosis:14.0.0-alpine	Alpine image

Example:

docker run osmolabs/osmosis:14.0.0 version
# v14.0.0

All the images have support for arm64 and amd64 architectures.

🔨 Build from source

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

⚡️ Download binaries

Binaries for linux amd64 and arm64 are available below.
Darwin users should build binaries from source.