Migration to v0.4.0

Release Notes

For Linux AMD Distributions

Install Go 1.23.0 on Linux (manually)

1. Remove the old Go version (if installed manually):

sudo rm -rf /usr/local/go

---

1. Download Go 1.23.0 tarball:

wget https://go.dev/dl/go1.23.0.linux-amd64.tar.gz

---

1. Extract and install to /usr/local:

sudo tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz

---

1. Add Go to your PATH (if not already added):

Add this line to your shell config file (~/.bashrc, ~/.zshrc, or ~/.profile):

export PATH=$PATH:/usr/local/go/bin

Then reload your shell:

source ~/.bashrc
# or
source ~/.zshrc

---

1. Verify the installation:

go version

You should see:

go version go1.23.0 linux/amd64

---

Install emped binary

Download the tar.gz file:

curl -LO https://github.com/empe-io/empe-chain-releases/raw/master/v0.4.0/emped_v0.4.0_linux_amd64.tar.gz

Verify the checksum (change filename for ARM):

sha256sum emped_v0.4.0_linux_amd64.tar.gz

You should see the following:

776ae05a7dd79251306a98cc947eed98aa5c99195f3cfaed0ce3e3a12a715481  emped_v0.4.0_linux_amd64.tar.gz

Unpack the tar.gz file:

tar -xvf emped_v0.4.0_linux_amd64.tar.gz

Move the binary to your local bin directory:

mkdir -p ~/go/bin
sudo mv emped ~/go/bin

Check the version

emped version

You should see the following:

0.4.0

Setup cosmovisor

Create cosmovisor upgrade dir

export DAEMON_HOME=$HOME/.empe-chain/
mkdir -p $DAEMON_HOME/cosmovisor/upgrades/v0.4.0/bin

Put binary in proper dir;

cp ~/go/bin/emped $DAEMON_HOME/cosmovisor/upgrades/v0.4.0/bin

Just to be sure check version (should be 0.4.0);

$DAEMON_HOME/cosmovisor/upgrades/v0.4.0/bin/emped version

You should see the following:

0.4.0

Common problems

Cannot open or find libwasmvm before or after the migration

Install wasmvm library

Create a directory for the library

mkdir ~/.empe-chain/lib

Download the library to the directory

wget https://github.com/CosmWasm/wasmvm/releases/download/v1.5.2/libwasmvm.x86_64.so -P ~/.empe-chain/lib

Add the library to the path

echo 'export LD_LIBRARY_PATH=/home/$USER/.empe-chain/lib:$LD_LIBRARY_PATH' >> ~/.profile
source ~/.profile

Add wasmvm path to cosmovisor service

Add the following line to the cosmovisor service file under the [Service] section. Remember to change user_path to your actual path

Environment="LD_LIBRARY_PATH=/home/user_path/.empe-chain/lib:$LD_LIBRARY_PATH"

Restart the cosmovisor service

sudo systemctl daemon-reload
sudo systemctl restart cosmovisor