Osmosis v21.0.0-a-rc4-testnet 🧪

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

Example run:

docker run osmolabs/osmosis:21.0.0-a-rc4-testnet version
# v21.0.0-a-rc4-testnet

All the images support arm64 and amd64 architectures.

Osmosis v21.0.0-a-rc3-testnet 🧪

TESTNET ONLY

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

Example run:

docker run osmolabs/osmosis:21.0.0-a-rc3-testnet version
# v21.0.0-a-rc3-testnet

All the images support arm64 and amd64 architectures.

Osmosis v21.0.0-rc3 🧪

This upgrade adds the following features:

• Cosmos SDK Updated to v0.47.5
• Protocol Revenue Tracking
• Sidecar Query Server
• Concentrated liquidity hooks added to core CL logic in advance of allowing hook contracts to be linked.
• EstimateTradeBasedOnPriceImpact added to Stargate whitelist.
• ProtoRev module no longer pays Taker Fees on arbitrage backruns, improving the alignment between differing liquidity locations.
• Several improvements relating to mempool filtering, previously present in v20.x releases.
• Wasmd updated to v0.45.0 and wasmvm to 1.5.0

Changelog

See the Full Change Log for more API Breaking, State Breaking and other miscellaneous changes.

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

Example run:

docker run osmolabs/osmosis:21.0.0-rc3 version
# v21.0.0-rc3

All the images support arm64 and amd64 architectures.

Osmosis v21.0.0-rc2 🧪

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

Example run:

docker run osmolabs/osmosis:21.0.0-rc2 version
# v21.0.0-rc2

All the images support arm64 and amd64 architectures.

Osmosis v20.5.0 🧪

Reverts to the use of v16.x cosmos sdk fork rather than osmosis-main

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

Example run:

docker run osmolabs/osmosis:20.5.0 version
# v20.5.0

All the images support arm64 and amd64 architectures.

Osmosis v20.4.0 🧪

This state-compatible release focuses on fixing the affiliate swap contract arbitrage filter issue. This filter was introduced by v20.2.2. As a result, this v20.4.0 release discards both v20.2.2-retracted and v20.3.0-retracted. Please do not use the earlier retracted tags as they are kept for historical reasons only.

Besides the fix to the smart contracts arb filter, this release sets the adaptive mempool parameter to true by default in the config, enabling EIP-1559.

It also changes the adaptive mempool parameters to make the base fee reset smoother during spam times.

We suggest applying this release at your convenience.

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

Example run:

docker run osmolabs/osmosis:20.4.0 version
# v20.4.0

All the images support arm64 and amd64 architectures.

Osmosis v20.2.1 🧪

This release provides a state-compatible update introducing an EIP-1559 style fee market to mitigate recent congestion issues. This new mechanism is designed to prevent block congestion caused by invalid transactions.

It calculates a transaction fee for each block (named base_fee), dynamically based on the volume of transactions.

If the blocks are consistently full, the transaction fee increases at a predefined rate, making spamming with invalid transactions less attractive to the sender. This increment continues until a maximum base fee is reached.

Conversely, if the blocks are empty, the base fee decreases to a minimum value.

Transaction Fee Calculation for Integrators

To query the current base fee from your node, use the /osmosis/txfees/v1beta1/cur_eip_base_fee endpoint on your node API Server.

For example:

curl https://lcd.osmosis.zone/osmosis/txfees/v1beta1/cur_eip_base_fee

# {
#   "base_fee": "0.002500000000000000"
# }

We suggest setting the transaction fees to 2x or 3x the current value. This approach may result in clients frequently overpaying transaction fees, but it is a precautionary measure to ensure stability during peak times. Be aware that this is a temporary solution, pending the integration of a more refined fee market mechanism into the consensus layer.

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

Example run:

docker run osmolabs/osmosis:20.2.1 version
# v20.2.1

All the images support arm64 and amd64 architectures.

Osmosis v20.1.2 🧪

This release offers a state-compatible update to mitigate recent congestion issues.

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

Example run:

docker run osmolabs/osmosis:20.1.2 version
# v20.1.2

All the images support arm64 and amd64 architectures.

Osmosis v20.1.1 🧪

This release offers a state-compatible update to mitigate recent congestion issues.

It enhances the recognition of arbitrage transactions and addresses challenges with increasing mempool transaction fees under specific swap scenarios.

Recommended Action for validators:

Update nodes to v20.1.1 and modify gas configs in app.toml as follows:

arbitrage-min-gas-fee = 10
min-gas-price-for-high-gas-tx = ".01"

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

Example run:

docker run osmolabs/osmosis:20.1.1 version
# v20.1.1

All the images support arm64 and amd64 architectures.

Osmosis v20.1.0 🧪

Important

Please use this release and not v20.0.0 release to upgrade mainnet nodes

Release Notes

This upgrade adds the following features:

Volume Splitting Incentives Mechanism

• Adds a new incentives mechanism that allows pools to be grouped into Volume Splitting Gauges and be incentivized as a set.

• Incentives for pools within this set will re-adjust at each epoch to the volume ratio present in each pool over the last epoch. This allows multiple pools of the same pairing with different specifications to be incentivized to allow incentives to be optimisedoptimized around trading volume more rapidly.

• This upgrade proposal creates groups containing the Classic and Supercharged pools with existing migration links between them and moves incentive allocation to incentivize these group gauges rather than the previous mechanism of sharing via the migration link.

Concentrated Liquidity modifications

• Concentrated Liquidity positions can now be transferred to another address

• Added a parameter that allows governance to add addresses that can create concentrated liquidity pools at no cost and ignore the Quote asset whitelist restriction.

• Added a parameter that allows governance to add addresses that will be exempt from Taker Fees.

Validator Set Preferences

• Creates a temporary solution to validator set unbonding, where the user can undelegated an amount of OSMO pro rata from all validators they are currently delegated to.

• In a future release, a more appropriate method of undelegating specifically from the user's defined validator set, respecting the delegation ratios initially defined by the user will be added.

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

Example run:

docker run osmolabs/osmosis:20.1.0 version
# v20.1.0

All the images support arm64 and amd64 architectures.