v6.4.1

Release Notes

The Release Procedure is defined in the CONTRIBUTING document.

v6.4.1

This release updates our dependencies and applies latest patches to the v6.4.x line. All validators must update to this patch release.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.4.0

Release Notes

The Release Procedure is defined in the CONTRIBUTING document.

v6.4.0

Highlights:

• Cosmos SDK v0.47.10 patch update.
• IBC Hooks: we integrated ICS20 Memo handling.
• Integrated Packet Forwarding Middleware.
• Update uibc/MsgGovUpdateQuota Msg type to handle the new inflow parameters.
• Update uibc/QueryAllOutflowsResponse to include denom symbol (token name) in every outflow.

CHANGELOG

IBC Hooks

This release brings the first part of the seamless cross-chain money market transactions. At UX, we want to provide the best User Experience for handling lending and leverage. In this release, we support the following x/leverage messages:

• MsgSupply
• MsgSupplyCollateral
• MsgLiquidate

The operation can only use tokens that are part of the IBC transfer (after any intermediate deductions) and the supplier / liquidator must be the IBC recipient (acting on someone else's behalf is not allowed). Authz is not supported. The remaining tokens will be credited to the recipient.

Documentation: x/uibc/README.md

Validators

Upgrade Title (for Cosmovisor): v6.4.

Update Price Feeder to umee/2.4.1+.

NOTE: after the upgrade, you should restart your Price Feeder. We observed that Price Feeder doesn't correctly re-established a connection after the chain upgrade.

libwasmvm update

Our dependencies have been updated. The binary requires libwasmvm v1.5.2. When you build the binary from source on the server machine you probably don't need any change. However, when you download a binary from GitHub, or from another source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.5.2/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.5.2/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and ensure your price feeder configuration is up-to-date.
• Restart the chain.
• Restart Price Feeder.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.4.0-beta1

Release Notes

The Release Procedure is defined in the CONTRIBUTING document.

v6.4.0

Highlights:

• Cosmos SDK v0.47.10 patch update.
• IBC Hooks: we integrated ICS20 Memo handling.
• Update uibc/MsgGovUpdateQuota Msg type to handle the new inflow parameters.
• Update uibc/QueryAllOutflowsResponse to include denom symbol (token name) in every outflow.

CHANGELOG

IBC Hooks

This release brings the first part of the seamless cross-chain money market transactions. At UX, we want to provide the best User Experience for handling lending and leverage. In this release, we support the following x/leverage messages:

• MsgSupply
• MsgSupplyCollateral
• MsgLiquidate

The operation can only use tokens as the part of the IBC transfer (after any intermediate deductions) and the supplier / liquidator must be the IBC recipient (acting on someone else's behalf is not allowed). Authz is not supported. The remaining tokens will be credited to the recipient.

Validators

Upgrade Title (for Cosmovisor): v6.4.

Update Price Feeder to umee/2.4.1+.

libwasmvm update

Our dependencies have been updated. The binary requires libwasmvm v1.5.2. When you build the binary from source on the server machine you probably don't need any change. However, when you download a binary from GitHub, or from another source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.5.2/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.5.2/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and ensure your price feeder configuration is up-to-date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.3.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.3.0

Highlights:

• Cosmos SDK v0.47.7 patch update.
• New queries: oracle/MissCounters, uibc/Inflows, uibc/QuotaExpires, leverage/RegisteredTokenMarkets
• Update uibc/MsgGovUpdateQuota Msg type to handle the new inflow parameters.
• Update uibc/QueryAllOutflowsResponse to include denom symbol (token name) in every outflow.

CHANGELOG

Validators

Upgrade Title (for Cosmovisor): v6.3.

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.2-canon

This is a release for the canon-4 testnet, in order to bring it to the same codebase as the mainnet.

Upgrade Instructions

Once the Software Upgrade Proposal will be triggered, swap your binaries.

v6.2.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.2.0

Highlights:

• Umee chain upgrades to the latest stable Cosmos SDK v0.47
• The gov module in in Cosmos SDK v0.47 has been updated to support a minimum proposal deposit at submission time. It is determined by a new parameter called MinInitialDepositRatio. When multiplied by the existing MinDeposit parameter, it produces the necessary proportion of coins needed at the proposal submission time. The motivation for this change is to prevent proposal spamming.
  We set MinInitialDepositRatio to 10%.`
• Added meToken WASM queries.
• IBC Quota v2 mechanism
  1. Outflows quota has been increased to $1.6M for total outflows and $1.2M per token outflows.
  2. new lifting conditions is added: IBC outflows are possible if (1.) fails, but
     • sum outflows of all tokens <= $1M + InflowOutflowQuotaRate * sum_of_all_inflows;
     • and token outflows <= $0.9M + InflowOutflowQuotaRate * token_inflows.
       See IBC Quota Design for more details.

CHANGELOG

Validators

Upgrade Title (for Cosmovisor): v6.2.

Price Feeder

Price Feeder < umee/v2.3.0 is not compatible with Cosmos SDK v0.47. Validators must update to umee/v2.3.0 or newer.

During the testnet upgrade, we noticed miss counters increasing dramatically. Please make sure your transactions are going through. If you see out of gas in your transactions (example), please increase gas_adjustment to 2.0 in your price-feeder.toml.

We recommend to actively track your miss counters and making sure you follow the latest currency-pairs config (note the umee branch).

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.5.0. When you build the binary from source on the server machine you probably don't need any change. However when you download a binary from GitHub, or from other source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.5.0/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.5.0/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.2.0-beta

Highlights:

• Umee chain upgrades to the latest stable Cosmos SDK v0.47
• The gov module in in Cosmos SDK v0.47 has been updated to support a minimum proposal deposit at submission time. It is determined by a new parameter called MinInitialDepositRatio. When multiplied by the existing MinDeposit parameter, it produces the necessary proportion of coins needed at the proposal submission time. The motivation for this change is to prevent proposal spamming.
  We set MinInitialDepositRatio to 10%.`
• Added meToken WASM queries.
• IBC Quota v2 mechanism
  1. Outflows quota has been increased to $1.6M for total outflows and $1.2M per token outflows.
  2. new lifting conditions is added: IBC outflows are possible if (1.) fails, but
     • sum outflows of all tokens <= $1M + InflowOutflowQuotaRate * sum_of_all_inflows;
     • and token outflows <= $0.9M + InflowOutflowQuotaRate * token_inflows.
       See IBC Quota Design for more details.

CHANGELOG

Validators

Upgrade Title (for Cosmovisor): v6.2

Price Feeder

Price Feeder < umee/v2.3.0 is not compatible with Cosmos SDK v0.47. Validators must update to umee/v2.3.0 or newer.

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.5.0. When you build the binary from source on the server machine you probably don't need any change. However when you download a binary from GitHub, or from other source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.5.0/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.5.0/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

v6.1.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.1.0

Highlights:

• meToken module: allows to create an index composed of a list of assets and realize operations such as swap and redeem between the assets and the index token.
• Bump go version to 1.21.
• Add spot price fields to account summary, and ensure all other fields use leverage logic prices.
• Fix avg params storage for x/oracle.
• Emergency Groups are able to do security adjustments in x/metoken.
• Reduced consensus.block.max_size to 4 MB.

CHANGELOG

meTokens

meTokens is an abbreviation for Multi-Variant Elastic Tokens. We describe them as a general-purpose packaged asset builder. Simply put, they are tools to index multiple assets, which allows holders to build composable indexes that spread the risk associated with each asset bundled in an index.

MeTokens offer a way to build DeFi alternatives to TradFi and Web2 financial products. Think of a better, more liquid version of ETFs or mortgage-backed securities. The scope of buildable products will vary from builder to builder as the protocol allows for the creation of some of the most diverse use cases in the Cosmos Ecosystem.

Validators

Following recent asa-2023-002 security advisory we decreased the max block size to 4 MB.
Based on Notional analysis, mempool size should be adjusted as well. We recommend to set it to 15 * 4 MB (15 x block size):

max_txs_bytes = 60000000

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.1.0-rc2

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.1.0

• Enable meToken module: allows to create an
  index composed of a list of assets and realize operations such as swap and redeem between the assets and the
  index token.
• Bump go version to 1.21.
• Add spot price fields to account summary, and ensure all other fields use leverage logic prices.
• Fix avg params storage for x/oracle.

v6.0.2

This fixes a crash shortly after the 6.0.1 upgrade. The crash occurred at height 8427849 but this binary works even if you switch to it immediately after the gov upgrade. Patch must be applied as soon as possible.

v6.0.1

This is a bug fix release for the leverage.MsgGovUpdateSpecialAssets handler.
We also added umeed q ugov emergency-group CLI query. Users were able to query the Emergency Group address using REST.

CHANGELOG

v6.0.0

Highlights:

• We introduce Special Assets: a new primitive to optimize positions in x/leverage.
• New inflation mechanism.
• Emergency Groups.
• Full Gravity Bridge removal. We don't include GB module any more in Umee.
• New MsgLeveragedLiquidate.MaxRepay which allows to limit the liquidation size using the leveraged liquidation mechanism.
• Renamed ugov EventMinTxFees to EventMinGasPrice.

New Inflation Mechanism

The Upgrade Handler sets the following values to the Umee x/ugov Inflation Cycle parameters:

• max_supply = 21e18uumee (21 billions UMEE)
• inflation_cycle = time.Hour * 24 * 365 * 2 (2 years)
• inflation_reduction_rate = 2500 basis points (25%)

The new Inflation Cycle will start on 2023-10-15 15:00 UTC. This will mark the first inflation reduction from the current rates:

• inflation_min 7% → 5.25%
• inflation_max 14% → 10.5%

The x/staking Bonded Goal stays the same: 33.00%.

Emergency Groups

Currently, any parameter update requires going through a standard governance process, which takes 4 days. In a critical situation we need to act immediately:

• Control IBC Quota parameters (eg disable IBC)
• apply safe updates to oracle, leverage or incentive module parameters.

Emergency Group can trigger safe parameter updates at any time as a standard transaction. The Emergency Group address is controlled by the Umee Chain governance (x/gov) and can be disabled at any time.

Validators

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.3.0. When you build the binary from source on the server machine you probably don't need any change. However when you download a binary from GitHub, or from other source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.3.0/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.3.0/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Min Gas Prices

Since v4.2 release we request all validators set a minimum-gas-prices setting (in app config/app.toml file, general settings). We recommend 0.1uumee which is equal the current Keplr average setting:

minimum-gas-prices = "0.1uumee"

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.

v6.1.0-beta1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.1.0

• Enable meToken module: allows to create an
  index composed of a list of assets and realize operations such as swap and redeem between the assets and the
  index token.
• Bump go version to 1.21.
• Add spot price fields to account summary, and ensure all other fields use leverage logic prices.
• Fix avg params storage for x/oracle.

v6.0.2

This fixes a crash shortly after the 6.0.1 upgrade. The crash occurred at height 8427849 but this binary works even if you switch to it immediately after the gov upgrade. Patch must be applied as soon as possible.

v6.0.1

This is a bug fix release for the leverage.MsgGovUpdateSpecialAssets handler.
We also added umeed q ugov emergency-group CLI query. Users were able to query the Emergency Group address using REST.

CHANGELOG

v6.0.0

Highlights:

• We introduce Special Assets: a new primitive to optimize positions in x/leverage.
• New inflation mechanism.
• Emergency Groups.
• Full Gravity Bridge removal. We don't include GB module any more in Umee.
• New MsgLeveragedLiquidate.MaxRepay which allows to limit the liquidation size using the leveraged liquidation mechanism.
• Renamed ugov EventMinTxFees to EventMinGasPrice.

New Inflation Mechanism

The Upgrade Handler sets the following values to the Umee x/ugov Inflation Cycle parameters:

• max_supply = 21e18uumee (21 billions UMEE)
• inflation_cycle = time.Hour * 24 * 365 * 2 (2 years)
• inflation_reduction_rate = 2500 basis points (25%)

The new Inflation Cycle will start on 2023-10-15 15:00 UTC. This will mark the first inflation reduction from the current rates:

• inflation_min 7% → 5.25%
• inflation_max 14% → 10.5%

The x/staking Bonded Goal stays the same: 33.00%.

Emergency Groups

Currently, any parameter update requires going through a standard governance process, which takes 4 days. In a critical situation we need to act immediately:

• Control IBC Quota parameters (eg disable IBC)
• apply safe updates to oracle, leverage or incentive module parameters.

Emergency Group can trigger safe parameter updates at any time as a standard transaction. The Emergency Group address is controlled by the Umee Chain governance (x/gov) and can be disabled at any time.

Validators

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.3.0. When you build the binary from source on the server machine you probably don't need any change. However when you download a binary from GitHub, or from other source, make sure you update the /usr/lib/libwasmvm.<cpu_arch>.so. For example:

• copy from $GOPATH/pkg/mod/github.com/!cosm!wasm/wasmvm@v1.3.0/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.3.0/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

You don't need to do anything if you are using our Docker image.

Min Gas Prices

Since v4.2 release we request all validators set a minimum-gas-prices setting (in app config/app.toml file, general settings). We recommend 0.1uumee which is equal the current Keplr average setting:

minimum-gas-prices = "0.1uumee"

Upgrade instructions

• Download latest binary or build from source.
• Make sure libwasmvm.$(uname -m).so is properly linked
  • Run the binary to make sure it works for you: umeed version
• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Swap binaries.
• Ensure latest Price Feeder (see compatibility matrix) is running and check your price feeder config is up to date.
• Restart the chain.

You can use Cosmovisor → see instructions.

Docker

Docker images are available in ghcr.io umee-network repository.