v5.1.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.1.0

Highlights:

• x/incentive module: allows to create incentive programs for liquidity mining.
• new x/leverage security measure: Borrow Factor
• new x/leverage MsgLeveragedLiquidate was added. Allows suppliers to use their active collateral to absorb unhealthy debts. See Liquidation for more details.
• Gravity Bridge phase-4: the GB valset was correctly burned. Slashing is removed and there is no need to run Peggo any more.

v5.1.0 CHANGELOG.

Validators

Peggo

You can kill Peggo (there is no need to run it any more).

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.

v5.1.0-rc2

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.1.0

Highlights:

• x/incentive module: allows to create incentive programs for liquidity mining.
• new x/leverage security measure: Borrow Factor
• new x/leverage MsgLeveragedLiquidate was added. Allows suppliers to use their active collateral to absorb unhealthy debts. See Liquidation for more details.
• Gravity Bridge phase-4: the GB valset was correctly burned. Slashing is removed and there is no need to run Peggo any more.

v5.1.0-rc1 CHANGELOG.

Validators

Peggo

You can kill Peggo.

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.

v5.1.0-rc1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.1.0

Highlights:

• x/incentive module: allows to create incentive programs for liquidity mining.
• new x/leverage security measure: Borrow Factor
• new x/leverage MsgLeveragedLiquidate was added. Allows suppliers to use their active collateral to absorb unhealthy debts. See Liquidation for more details.
• Gravity Bridge phase-4: the GB valset was correctly burned. Slashing is removed and there is no need to run Peggo any more.

v5.1.0-rc1 CHANGELOG.

Validators

Peggo

You can kill Peggo.

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.

v5.0.1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.0.1

Patch release: Cosmos SDK updated related to the barberry advisory.

v5.0.0

Highlights:

• Cosmwasm integration (v0.31).
• Gravity Bridge phase-3: shutdown of the transfers. In this release we introduce valset burn mechanism,
  which will block the Ethereum smart contract for processing any further transactions, as well
  as sending transfers back to Ethereum. This follows the plan approved through in the
  prop-67.
  NOTE: All validators must continue to use Peggo to not get slashed.
• Updated to the latest Cosmos SDK v0.46.12
• New generic functions for storage management: util/store.

See CHANGELOG.

Validators

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.2.4. 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.2.4/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.2.4/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"

You MUST also set the related parameter when starting Peggo --cosmos-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 Peggo (v1.4.0) is running
• 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.

v4.4.2

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.4.2

Patch release: Cosmos SDK updated related to the barberry advisory.

See CHANGELOG for a full list of changes.

v5.0.0-rc1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.0.0-rc1

Highlights:

• Cosmwasm integration.
• Gravity Bridge phase-3: shutdown of the transfers. In this release we introduce valset burn mechanism,
  which will block the Ethereum smart contract for processing any further transactions, as well
  as sending transfers back to Ethereum. This follows the plan approved through in the
  prop-67.
  NOTE: All validators must continue to use Peggo to not get slashed.
• Updated to the latest Cosmos SDK v0.46.12

See CHANGELOG

Validators

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.2.3. 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.2.3/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.2.3/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"

You MUST also set the related parameter when starting Peggo --cosmos-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 Peggo (v1.4.0) is running
• 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.

v4.4.1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.4.1

Patch release updating ibc-go to the most recent patch release.

Please update as soon as possible.

See v4.4.0 for more details about the v4.4.x line.

See CHANGELOG for a full list of changes.

v4.4.0

This is a small, intermediate release.

For the Stride onboarding process, we decided to disable the IBC ICS-20 inflow limit of x/leverage registered tokens only. That means, now all tokens will be available for inflow transfers. IBC outflow quota will still hold: unregistered tokens can be transferred out without any limit and x/leverage registered tokens are limited to the daily quota.

No extra changes are required during this upgrade: all dependencies are the same as in v4.3.0.

See CHANGELOG for a full list of changes.

v4.3.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.3.0

Highlights:

• Gravity Bridge Shutdown Phase 2. Following Prop-67 we are disabling Umee -> Ethereum token transfers. Ethereum -> Umee transfers are still possible, and we encourage everyone to move the tokens back to Umee. In May we are planning the complete shut down. See more in the blog post.
• IBC updated to ibc-go v6.1. That also triggered our wasmvm dependency update (see libwasmvm update in Validators section)
• ICA Host integration.
• IBC ICS20: we will only accept tokens (denoms) which are registered in the x/leverage token registry. You can check the supported tokens by umeed q leverage registered-tokens or by visiting umee/leverage/v1/registered_tokens.
• IBC Quota status handling: enable/disable quota or pause IBC ICS20 app.

See CHANGELOG for a full list of changes.

Validators

libwasmvm update

Our dependencies have been updated. Now the binary requires libwasmvm v1.2.1. 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.2.1/internal/api/libwasmvm.$(uname -m).so
• or download from github wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.2.1/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

Same as with 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"

You MUST also set the related parameter when starting Peggo --cosmos-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 Peggo (v1.4.0) is running
• Ensure latest Price Feeder (v2.1.1) is running and check your price feeder config is up to date. Price Feeder was moved to the new repository: ojo-network/price-feeder.
• Restart the chain.

You can use Cosmovisor → see instructions.

NOTE: BEFORE the upgrade, make sure the binary is working and libwasmvm is in your system. You can test it by running ./umeed-v4.3.0 --version.

Docker

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

v4.2.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

The main highlight of this release is new x/uibc module which introduces IBC Quota functionality.
We are using it to limit daily (quota resets every 24 hours) IBC outflows in USD value based on our Avg price oracle update. Our current daily quota is 1M USD of total outflows and 600k USD of per token outflows. We only track the x/leverage registered tokens.
Example IBC outflows reaching the daily quota:

• 600k USD worth of ATOM (this is the max of a single token we can send per day), 400k USD worth of UMEE.
• 300k USD worth of ATOM, 200k USD worth of STATOM, 250k USD worth of UMEE and 250k USD worth JUNO.

Other highlights:

• Oracle: Avg prices. We compute average price based on ~16h rolling window.
• New option is available in app.toml: iavl-lazy-loading (in general settings). When setting to true, lazy loading of iavl store will be enabled and improve start up time of archive nodes.
• Migration from Tendermint to CometBFT.

See CHANGELOG for a full list of changes.

Validators

Given recent spam transactions in Umee, 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"

In next release we will be enforcing the minimum setting.

Peggo

Related to min gas price updates, you MUST also set the related parameter when starting Peggo:

--cosmos-gas-prices="0.1uumee"

Upgrade instructions

• Note: Skip this step if you build binary from source and are able to properly link libwasmvm.
  • Download libwasmvm:

$ wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.1.1/internal/api/libwasmvm.$(uname -m).so -O /lib/libwasmvm.$(uname -m).so

• Download latest binary or build from source.
• 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.
• Restart the chain.
• Ensure latest Peggo (v1.4.0) is running
• Ensure latest Price Feeder (v2.1.0) is running

You can use Cosmovisor → see instructions.

NOTE: BEFORE the upgrade, make sure the binary is working and libwasmvm is in your system. You can test it by running ./umeed-v4.1.0 --version.

Docker

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

Please Note:

Building from source will automatically link the libwasmvm.x86_64.so created as a part of the build process (you must build on the same host as you run the binary, or copy the libwasmvm.x86_64.so your lib directory).

If you build on system different than Linux amd64, then you need to download appropriate version of libwasmvm (eg from CosmWasm/wasmvm Releases) or build it from source (you will need Rust toolchain).

Otherwise you have to download libwasmvm. Please check Supported Platforms. Example:

wget https://raw.githubusercontent.com/CosmWasm/wasmvm/v1.1.1/internal/api/libwasmvm.$(uname -m).so -P /lib/