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/

v4.2.0-rc1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.2.0

• 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.

v4.1.0

This release contains several fixes designed to make lending and borrowing more resilient during price outages. Short summary of changes is available in the Changelog

• Price Feeder V2.1.0 is recommended for use with this release. Upgrading price feeder can be done immediately by any validators who have not already switched. It does not need to be simultaneously with the chain upgrade.

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/

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

• 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.

v4.1.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.1.0

This release contains several fixes designed to make lending and borrowing more resilient during price outages. Short summary of changes is available in the Changelog

• Price Feeder V2.1.0 is recommended for use with this release. Upgrading price feeder can be done immediately by any validators who have not already switched. It does not need to be simultaneously with the chain upgrade.

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 other 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/

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

• 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.

v4.1.0-rc4

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

Please see the CHANGELOG for an exhaustive list of changes.

Github Release

Sinice v3.2.0 new experimental features (disabled by default) are part of the linked binary. That changed the build process. Umeed officially doesn't support static CGO build (with CGO_ENABLED=1) any more. Github Actions only support build using Linux on amd64 -- we can not make a cross platform build using Github Actions (possible solution is to do it through Qemu emulator). So our Github release only contains source code archive and amd64 Linux binary.

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/

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 Peggo (v1.4.0) - updated
• Run latest Price Feeder (v2.0.2) - updated
• Swap binaries.
• Restart the chain.

There is a new option available in app.toml (in Base Configuration). Set iavl-disable-fastnode to true if you want to disable fastnode cache and reduce RAM usage (default is false).

# IAVLDisableFastNode enables or disables the fast node feature of IAVL.
# Default is false.
iavl-disable-fastnode = false

You can use Cosmovisor → see instructions.

• If you use Cosmovisor, and you didn't build binary from source in the validator machine, you have to download the respective libwasmvm into your machine. See the previous section for more details.

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

Docker

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

price-feeder/v2.1.0-rc1

price feeder v2.1.0-rc1

This is the first release candidate for v2.1.0.

The main fix is connecting to providers with multiple websocket connections.

Changelog

7dd4c14 chore: update PF example config (#1826)
57abf1e fix: bnb migration (#1823)
614d2c5 feat: automatically clear unsupplied blacklisted tokens (#1808)
0e4df51 fix: 4.1 BNB migration (#1807)
5c901f4 chore: update Quota storage (#1814)
e23e4fc fix: collateral share restriction works during partial price outages (#1812)
c67510e chore: update upgrades and mergify to v4.1 (#1815)
264a782 chore: simplify upgrades (#1811)
a4e8103 chore: using AvgPrice for denom to check ibc-transfer quota (#1806)
7c04da0 build(deps): Bump google.golang.org/grpc from 1.52.3 to 1.53.0 (#1795)
99827b2 build(deps): Bump google.golang.org/grpc from 1.52.3 to 1.53.0 in /price-feeder (#1796)
4780b13 docs: update release notes & changelog (#1804)
7c9e5ef feat: register v4.0.1 upgrade (#1802)
968c5af build(deps): Bump golang.org/x/term from 0.4.0 to 0.5.0 in /price-feeder (#1797)
ea76766 fix: intercase leverage fix (#1800)
b48dc1a feat(uibc): adding event on quota pause update (#1785)
fbe0d05 chore: update price feeder changelog (#1798)
f5ea000 chore: Updating Cosmos SDK to 0.46.9 and Tendermint to 0.34.26 (#1794)
2104ccf test: add experimental e2e tests on docker image (#1771)
397e0fc chore: add 4.1 upgrade handler (#1772)
e753ad4 fix(price-feeder): Fix gate provider getCandlePrices (#1791)
89d2d3d fix: currency provider tracker causing price feeder to error (#1781)
852ff39 fix: Enforce voting threshold param in oracle endblocker (#1707)
88969af chore: fix the deprecated sdkerrors in price-feeder (#1792)
03eca68 chore: bump the sdkmath to beta6 (#1790)
cc856ab chore: remove rc upgrade handlers (#1787)
37909a3 fix: deprecated use of sdkerrors (#1788)
618dac8 chore: bump cosmos-sdk/math (#1786)
82f7716 build(deps): Bump github.com/golangci/golangci-lint from 1.51.0 to 1.51.1 (#1782)
0aba4fd refactor: websocket controller creates a separate connection per pair (#1773)
075b493 Fix GetTickerPrice() and GetCandlePrice() (#1767)
ab8e7e0 chore: move sdkutil coin functions to the coin package (#1780)
b7eb055 feat: helper function to emit events (#1777)
9a20198 fix: increase pricefeeder e2e test timeout (#1779)
f3125a6 build(deps): Bump github.com/golangci/golangci-lint from 1.50.1 to 1.51.0 (#1774)
3b91485 build(deps): Bump github.com/golangci/golangci-lint from 1.50.1 to 1.51.0 in /price-feeder (#1775)
ca7b067 fix: correct ICS20 middleware handlers (#1776)
b1518c7 fix(price-feeder): BinanceUS too many requests socket close error (#1769)
00c708d test: unit and e2e tests to ibc-quota (#1738)

price-feeder/v2.1.0

Price Feeder v2.1.0

This version of the price feeder mainly has improvements to stability.

Notable changes:

• Quoting assets in OSMO
• Handling multi-websocket-connection providers more efficiently

Please note that this also requires `LibWasm.

Download LibWasm

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

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

Changelog

7dd4c14 chore: update PF example config (#1826)
57abf1e fix: bnb migration (#1823)
614d2c5 feat: automatically clear unsupplied blacklisted tokens (#1808)
0e4df51 fix: 4.1 BNB migration (#1807)
5c901f4 chore: update Quota storage (#1814)
e23e4fc fix: collateral share restriction works during partial price outages (#1812)
c67510e chore: update upgrades and mergify to v4.1 (#1815)
264a782 chore: simplify upgrades (#1811)
a4e8103 chore: using AvgPrice for denom to check ibc-transfer quota (#1806)
7c04da0 build(deps): Bump google.golang.org/grpc from 1.52.3 to 1.53.0 (#1795)
99827b2 build(deps): Bump google.golang.org/grpc from 1.52.3 to 1.53.0 in /price-feeder (#1796)
4780b13 docs: update release notes & changelog (#1804)
7c9e5ef feat: register v4.0.1 upgrade (#1802)
968c5af build(deps): Bump golang.org/x/term from 0.4.0 to 0.5.0 in /price-feeder (#1797)
ea76766 fix: intercase leverage fix (#1800)
b48dc1a feat(uibc): adding event on quota pause update (#1785)
fbe0d05 chore: update price feeder changelog (#1798)
f5ea000 chore: Updating Cosmos SDK to 0.46.9 and Tendermint to 0.34.26 (#1794)
2104ccf test: add experimental e2e tests on docker image (#1771)
397e0fc chore: add 4.1 upgrade handler (#1772)
e753ad4 fix(price-feeder): Fix gate provider getCandlePrices (#1791)
89d2d3d fix: currency provider tracker causing price feeder to error (#1781)
852ff39 fix: Enforce voting threshold param in oracle endblocker (#1707)
88969af chore: fix the deprecated sdkerrors in price-feeder (#1792)
03eca68 chore: bump the sdkmath to beta6 (#1790)
cc856ab chore: remove rc upgrade handlers (#1787)
37909a3 fix: deprecated use of sdkerrors (#1788)
618dac8 chore: bump cosmos-sdk/math (#1786)
82f7716 build(deps): Bump github.com/golangci/golangci-lint from 1.51.0 to 1.51.1 (#1782)
0aba4fd refactor: websocket controller creates a separate connection per pair (#1773)
075b493 Fix GetTickerPrice() and GetCandlePrice() (#1767)
ab8e7e0 chore: move sdkutil coin functions to the coin package (#1780)
b7eb055 feat: helper function to emit events (#1777)
9a20198 fix: increase pricefeeder e2e test timeout (#1779)
f3125a6 build(deps): Bump github.com/golangci/golangci-lint from 1.50.1 to 1.51.0 (#1774)
3b91485 build(deps): Bump github.com/golangci/golangci-lint from 1.50.1 to 1.51.0 in /price-feeder (#1775)
ca7b067 fix: correct ICS20 middleware handlers (#1776)
b1518c7 fix(price-feeder): BinanceUS too many requests socket close error (#1769)
00c708d test: unit and e2e tests to ibc-quota (#1738)

v4.0.1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v4.0.1

This release is a consensus breaking patch which contains a fix to how we handle assets with lowercase symbols on the leverage module. Relevant PR here.

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/

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.

price-feeder/v2.0.4-rc1

v2.0.4-rc1

This is the first release candidate for the price feeder v2.0.4 release.

price-feeder/v2.0.4

v2.0.4

This is v2.0.4 of the price feeder, designed to support osmosis-native assets. Main changes are:

• Enabling asset prices to be quoted in "OSMO"
• A small bug fix to the USD conversion logic

v4.0.0

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.