Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.0.0

This release contains the Historacle Upgrade, a pricing update which improves the way we treat quickly-changing prices in the leverage module.

• See the Historacle Design Doc for a description of how these prices are calculated.
• See the Leverage Module Spec for a description of how these prices are treated by the leverage protocol.

Please Note:

• This upgrade requires the use of Price Feeder V2.0.3 immediately after the Umee v4.0 Upgrade. Prior to this upgrade, you should stay on Price Feeder V2.0.2.
• To run the provided binary, you have to have libwasmvm.x86_64.so v1.1.1 in your system lib directory.

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 Relases) 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/

Additional highlights:

• 1694 MsgMaxWithdraw, MsgMaxBorrow and MsgRepay won't return errors if there is nothing to withdraw, borrow or repay respectively. Leverage ErrMaxWithdrawZero and ErrMaxBorrowZero has been removed.

Please see the CHANGELOG for an exhaustive list of changes.

Update 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

• Wait for software upgrade proposal to pass and trigger the chain upgrade.
• Run latest Price Feeder (v2.0.3) - updated
• Swap binaries.
• 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.0.0 --version.

Docker

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