v5

Documentation

Index

• Constants
• Variables
• func CreateUpgradeHandler(mm *module.Manager, configurator module.Configurator, bk bankkeeper.Keeper, ...) upgradetypes.UpgradeHandler
• func MigrateContributorClaim(ctx sdk.Context, k *claimskeeper.Keeper)
• func MigrateGenesis(appState genutiltypes.AppMap, clientCtx client.Context) genutiltypes.AppMap
• func ResolveAirdrop(ctx sdk.Context, k *claimskeeper.Keeper)
• func UpdateConsensusParams(ctx sdk.Context, sk stakingkeeper.Keeper, pk paramskeeper.Keeper)
• func UpdateIBCDenomTraces(ctx sdk.Context, transferKeeper ibctransferkeeper.Keeper)

Constants

const (
	// UpgradeName is the shared upgrade plan name for mainnet and testnet
	UpgradeName = "v5.0.0"
	// MainnetUpgradeHeight defines the Evmos mainnet block height on which the upgrade will take place
	MainnetUpgradeHeight = 837_500
	// TestnetUpgradeHeight defines the Evmos testnet block height on which the upgrade will take place
	TestnetUpgradeHeight = 1_762_500
	// UpgradeInfo defines the binaries that will be used for the upgrade
	UpgradeInfo = `` /* 552-byte string literal not displayed */
	// ContributorAddrFrom is the lost address of an early contributor
	ContributorAddrFrom = "evmos13cf9npvns2vhh3097909mkhfxngmw6d6eppfm4"
	// ContributorAddrTo is the new address of an early contributor
	ContributorAddrTo = "evmos1hmntpkn623y3vl0nvzrazvq4rqzv3xa74l40gl"
	// AvgBlockTime defines the new expected average blocktime on mainnet and testnet
	//
	// CONTRACT: in order for AvgBlockTime to represent an accurate value on-chain, validator nodes
	// will need to update their "timeout_commit" value to "1s" on the config.toml under the
	// "Consensus Configuration Options" section
	//
	// NOTE: the value is calculated based that it takes <1s to reach consensus and 1s for
	// "timeout_commit" duration
	AvgBlockTime = 2 * time.Second
)

Variables

var (
	// MainnetMinGasPrices defines 25B aevmos (or atevmos) as the minimum gas price value on the fee market module.
	// See https://commonwealth.im/evmos/discussion/5073-global-min-gas-price-value-for-cosmos-sdk-and-evm-transaction-choosing-a-value for reference
	MainnetMinGasPrices = sdk.NewDec(25_000_000_000)
	// MainnetMinGasMultiplier defines the min gas multiplier value on the fee market module.
	// 50% of the leftover gas will be refunded
	MainnetMinGasMultiplier = sdk.NewDecWithPrec(5, 1)
)

var TestnetDenomMetadata = banktypes.Metadata{
	Description: "The native EVM, governance and staking token of the Evmos testnet",
	DenomUnits: []*banktypes.DenomUnit{
		{
			Denom:    "atevmos",
			Exponent: 0,
			Aliases:  []string{"attotevmos"},
		},
		{
			Denom:    "tevmos",
			Exponent: 18,
		},
	},
	Base:    "atevmos",
	Display: "tevmos",
	Name:    "Testnet Evmos",
	Symbol:  "tEVMOS",
}

TestnetDenomMetadata defines the metadata for the tEVMOS denom on testnet

Functions

func CreateUpgradeHandler

func CreateUpgradeHandler(
	mm *module.Manager,
	configurator module.Configurator,
	bk bankkeeper.Keeper,
	ck *claimskeeper.Keeper,
	sk stakingkeeper.Keeper,
	pk paramskeeper.Keeper,
	tk ibctransferkeeper.Keeper,
) upgradetypes.UpgradeHandler

CreateUpgradeHandler creates an SDK upgrade handler for v5

func MigrateContributorClaim

func MigrateContributorClaim(ctx sdk.Context, k *claimskeeper.Keeper)

MigrateContributorClaim migrates the claims record of a specific early contributor (Blockchain at Berkeley) from one address to another. See https://medium.com/evmos/the-evmos-rektdrop-abbe931ba823 for details about Early Contributors.

func MigrateGenesis

func MigrateGenesis(appState genutiltypes.AppMap, clientCtx client.Context) genutiltypes.AppMap

MigrateGenesis migrates exported state from v4 to v5 genesis state. It performs a no-op if the migration errors.

func ResolveAirdrop

func ResolveAirdrop(ctx sdk.Context, k *claimskeeper.Keeper)

ResolveAirdrop iterates over all the available claim records and attempts to swap claimed actions and unclaimed actions. The following priority is considered, and only one swap will be performed: 1 - Unclaimed EVM <-> claimed IBC 2 - Unclaimed EVM <-> claimed Vote 3 - Unclaimed EVM <-> claimed Delegate 4 - Unclaimed Vote <-> claimed IBC 5 - Unclaimed Delegate <-> claimed IBC

Rationale: A few users tokens are still locked due to issues with the airdrop By swapping claimed actions we allow the users to migrate the records via IBC if needed or mark the Evm action as completed for the Keplr users who are not able to complete it Since no actual claiming of action is occurring, balance will remain unchanged

func UpdateConsensusParams

func UpdateConsensusParams(ctx sdk.Context, sk stakingkeeper.Keeper, pk paramskeeper.Keeper)

UpdateConsensusParams updates the Tendermint Consensus Evidence params (MaxAgeDuration and MaxAgeNumBlocks) to match the unbonding period and use the expected avg block time based on the node configuration.

func UpdateIBCDenomTraces

func UpdateIBCDenomTraces(ctx sdk.Context, transferKeeper ibctransferkeeper.Keeper)

UpdateIBCDenomTraces iterates over current traces to check if any of them are incorrectly formed and corrects the trace information. See https://github.com/cosmos/ibc-go/blob/main/docs/migrations/support-denoms-with-slashes.md for context.