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.