Evmos Utils

This tool contains several utility functionalities that are useful during development of the Evmos blockchain.

At the core, all interactions go through the Evmos CLI interface, which is called from within the Go code.

Note, that this script is designed to work with a local node that was started by calling the local_node.sh script from the Evmos main repository.

Installation

In order to install the tool, clone the source and install locally.

Note, that using go install github.com/MalteHerrmann/evmos-utils@latest does not work because of the replace directives in go.mod, which are necessary for the Evmos dependencies.

git clone https://github.com/MalteHerrmann/evmos-utils.git
cd evmos-utils
make install

Features

The tool is based on Cobra CLI so you can use --help to get a list of all available commands and flags.

Upgrade a Local Node

The tool creates and submits a software upgrade proposal to a locally running Evmos node, and votes on the proposal. To do so, run:

evmos-utils upgrade TARGET_VERSION

The target version must be specified in the format vX.Y.Z(-rc*), e.g. v13.0.0-rc2.

Vote on Proposal

The tool can vote with all keys from the configured keyring, that have delegations to validators. This can either target the most recent proposal, or a specific one when passing an ID to the command.

evmos-utils vote [PROPOSAL_ID]

Deposit for Proposal

The tool can make a deposit for a proposal. It returns the minimum deposit necessary from the governance parameters of the running local node and places the deposit on behalf of the first account in the test keyring.

evmos-utils deposit [PROPOSAL_ID]

Configuration

By default, the tool is using settings related to the Evmos network. However, through CLI flags it is also possible to use this tool to upgrade other networks. Detailed information is given in the help output of the commands.

An example for a custom development chain can be found hereafter:

evmos-utils upgrade v1.1.0 \
--chain-id mychain_1234-1 \
--bin chaind \
--home /path/to/chaind \
--node http://localhost:26657 \
--keyring-backend test