fa-info-circle Info
ELYS
Elys is a fast layer 1 blockchain powered by the Cosmos-SDK. It is the first, and only, decentralized suite of financial applications in the Cosmos ecosystem that has built-in native bridging capabilities for optimal user experience and value capture, and native margin trading capabilities that are powered by liquidity pools & liquidity providers.
Chain Explorer:
https://exp.nodeist.net/Elys
Public Endpoints:
# API ENDPOINT
https://api-elys.nodeist.net
# RPC ENDPOINT
https://rpc-elys.nodeist.net
# GRPC ENDPOINT
https://grpc-elys.nodeist.net
Peering:
addrbook:
curl -Ls https://ss.nodeist.net/t/elys/addrbook.json > $HOME/.elys/config/addrbook.json
live-peers:
peers="[email protected]:21956,[email protected]:21956,[email protected]:27656,[email protected]:34656,[email protected]:27296"
sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.elys/config/config.toml
fa-spinner fa-spin Install
Manual Installation
This section contains a list of commands to install the node in manual mode.
Server Preparation
apt update && apt upgrade -y
apt install curl iptables build-essential git wget jq make gcc nano tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y
Install GO
ver="1.20.3"
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version
Node Installation
Replace Nodeist_Guide in the first line with your moniker name.
NODE_MONIKER="Nodeist_Guide"
cd || return
rm -rf elys
git clone https://github.com/elys-network/elys.git
cd elys
git checkout v0.4.0
make install
elysd config chain-id elystestnet-1
elysd init "$NODE_MONIKER" --chain-id elystestnet-1
curl -s https://ss.nodeist.net/t/elys/genesis.json > $HOME/.elys/config/genesis.json
curl -s https://ss.nodeist.net/t/elys/addrbook.json > $HOME/.elys/config/addrbook.json
SEEDS=""
PEERS=""
sed -i 's|^seeds *=.*|seeds = "'$SEEDS'"|; s|^persistent_peers *=.*|persistent_peers = "'$PEERS'"|' $HOME/.elys/config/config.toml
sed -i 's|^pruning *=.*|pruning = "custom"|g' $HOME/.elys/config/app.toml
sed -i 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|g' $HOME/.elys/config/app.toml
sed -i 's|^pruning-interval *=.*|pruning-interval = "10"|g' $HOME/.elys/config/app.toml
sed -i 's|^snapshot-interval *=.*|snapshot-interval = 0|g' $HOME/.elys/config/app.toml
sed -i 's|^minimum-gas-prices *=.*|minimum-gas-prices = "0.025uelys"|g' $HOME/.elys/config/app.toml
sed -i 's|^prometheus *=.*|prometheus = true|' $HOME/.elys/config/config.toml
sudo tee /etc/systemd/system/elysd.service > /dev/null << EOF
[Unit]
Description=Elys Node
After=network-online.target
[Service]
User=$USER
ExecStart=$(which elysd) start
Restart=on-failure
RestartSec=10
LimitNOFILE=10000
[Install]
WantedBy=multi-user.target
EOF
elysd tendermint unsafe-reset-all --home $HOME/.elys --keep-addr-book
curl -L https://ss.nodeist.net/t/elys/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.elys --strip-components 2
sudo systemctl daemon-reload
sudo systemctl enable elysd
sudo systemctl start elysd
sudo journalctl -fu elysd -o cat
fa-camera-alt Snapshot
elys
Instructions
Stop the service and reset the data
sudo systemctl stop elysd
cp $HOME/.elys/data/priv_validator_state.json $HOME/.elys/priv_validator_state.json.backup
rm -rf $HOME/.elys/data
Download latest snapshot
curl -L https://ss.nodeist.net/t/elys/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.elys --strip-components 2
mv $HOME/.elys/priv_validator_state.json.backup $HOME/.elys/data/priv_validator_state.json
Restart the service and check the log
sudo systemctl restart elysd && sudo journalctl -fu elysd -o cat
fa-sync fa-spin State Sync
Instructions
Stop the service and reset the data
sudo systemctl stop elysd
cp $HOME/.elys/data/priv_validator_state.json $HOME/.elys/priv_validator_state.json.backup
elysd tendermint unsafe-reset-all --home $HOME/.elys
Get and configure the state sync information
SNAP_RPC="https://rpc-elys.nodeist.net:443"
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)
sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"|" $HOME/.elys/config/config.toml
mv $HOME/.elys/priv_validator_state.json.backup $HOME/.elys/data/priv_validator_state.json
Restart the service and check the log
sudo systemctl restart elysd && sudo journalctl -fu elysd -o cat
fa-terminal CLI Cheatsheets
🔑 Key management
Add new key
elysd keys add wallet
Recover existing key
elysd keys add wallet --recover
List all keys
elysd keys list
Delete key
elysd keys delete wallet
Export key to the file
elysd keys export wallet
Import key from the file
elysd keys import wallet wallet.backup
Query wallet balance
elysd q bank balances $(elysd keys show wallet -a)
👷 Validator management
- Please make sure you have adjusted moniker, identity, details and website to match your values.
Create new validator
elysd tx staking create-validator \
--amount 1000000uelys \
--pubkey $(elysd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id elystestnet-1 \
--commission-rate 0.05 \
--commission-max-rate 0.20 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.025uelys \
-y
Edit existing validator
elysd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id elystestnet-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.025uelys \
-y
Unjail validator
elysd tx slashing unjail --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Jail reason
elysd query slashing signing-info $(elysd tendermint show-validator)
List all active validators
elysd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
List all inactive validators
elysd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
View validator details
elysd q staking validator $(elysd keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
elysd tx distribution withdraw-all-rewards --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Withdraw commission and rewards from your validator
elysd tx distribution withdraw-rewards $(elysd keys show wallet --bech val -a) --commission --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Delegate tokens to yourself
elysd tx staking delegate $(elysd keys show wallet --bech val -a) 1000000uelys --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Delegate tokens to validator
elysd tx staking delegate <TO_VALOPER_ADDRESS> 1000000uelys --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Redelegate tokens to another validator
elysd tx staking redelegate $(elysd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000uelys --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Unbond tokens from your validator
elysd tx staking unbond $(elysd keys show wallet --bech val -a) 1000000uelys --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Send tokens to the wallet
elysd tx bank send wallet <TO_WALLET_ADDRESS> 1000000uelys --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
🗳 Governance
List all proposals
elysd query gov proposals
View proposal by id
elysd query gov proposal 1
Vote 'Yes'
elysd tx gov vote 1 yes --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Vote 'No'
elysd tx gov vote 1 no --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Vote 'Abstain'
elysd tx gov vote 1 abstain --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
Vote 'NoWithVeto'
elysd tx gov vote 1 NoWithVeto --from wallet --chain-id elystestnet-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uelys -y
⚡️ Utility
Update Indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.elys/config/config.toml
Update pruning
sed -i \
-e 's|^pruning *=.*|pruning = "custom"|' \
-e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
-e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
-e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
$HOME/.elys/config/app.toml
🚨 Maintenance
Get validator info
elysd status 2>&1 | jq .ValidatorInfo
Get sync info
elysd status 2>&1 | jq .SyncInfo
Get node peer
echo $(elysd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.elys/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(elysd q staking validator $(elysd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(elysd status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
Get live peers
curl -sS http://localhost:27657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.025uelys\"/" $HOME/.elys/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.elys/config/config.toml
Reset chain data
elysd tendermint unsafe-reset-all --home $HOME/.elys --keep-addr-book
Remove node
- Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json!
cd $HOME
sudo systemctl stop elysd
sudo systemctl disable elysd
sudo rm /etc/systemd/system/elysd.service
sudo systemctl daemon-reload
rm -f $(which elysd)
rm -rf $HOME/.elys
rm -rf $HOME/elysd
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable elysd
Disable service
sudo systemctl disable elysd
Start service
sudo systemctl start elysd
Stop service
sudo systemctl stop elysd
Restart service
sudo systemctl restart elysd
Check service status
sudo systemctl status elysd
Check service logs
sudo journalctl -u elysd -f --no-hostname -o cat