v6.0.1

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

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/[email protected]/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.0.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

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/[email protected]/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.0.0-beta2

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v6.0.0

Highlights:

• TODO: special assets, new Gov messages
• New inflation mechanism.

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

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/[email protected]/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.

v5.2.0

Release Notes

Release Procedure is defined in the CONTRIBUTING document.

v5.2.0

This is a maintenance release, which prepares the chain for the v6.0 release.

Highlights:

• [x/leverage] Allow setting multiple tokens with the same symbol name but different denom. This fixes the oracle voting miss counter on duplicate symbol denoms.
• Adding Amino support to x/leverage.MsgLeveragedLiquidate.
• Fix MsgBeginUnbonding counting existing unbondings against max unbond twice.
• Fixes an x/oracle RPC endpoint spelling: /umee/oracle/v1/validators/{validator_addr}/aggregate_vote

More: v5.2.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.

v6.0.0-beta1

This is v6.0.0-beta1 beta release

Full Changelog: v5.1.0-rc2...v6.0.0-beta1

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/[email protected]/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.