Command
XRPLEVM
Useful commands
🔑 Key management
Add new key
exrpd keys add $WALLET --key-type eth_secp256k1
Recover existing key
exrpd keys add $WALLET --recover
List all keys
exrpd keys list
Delete key
exrpd keys delete $WALLET
Export key to the file
exrpd keys export $WALLET
Import key from the file
exrpd keys import $WALLET wallet.backup
Query wallet balance
exrpd q bank balances $(exrpd keys show $WALLET -a)
👷 Validator management
Please make sure you have adjusted moniker
, identity
, details
and website
to match your values.
Create new validator
exrpd tx staking create-validator \
--amount 10000000000000000000axrp \
--pubkey $(exrpd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id xrplevm_1449000-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 2000000000000000000axrp \
-y
Edit existing validator
exrpd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id xrplevm_1449000-1 \
--commission-rate 0.05 \
--from $WALLET \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 2000000000000000000axrp \
-y
Unjail validator
exrpd tx slashing unjail --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Jail reason
exrpd query slashing signing-info $(exrpd tendermint show-validator)
List all active validators
exrpd 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
exrpd 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
exrpd q staking validator $(exrpd keys show $WALLET --bech val -a)
💲 Token management
Withdraw rewards from all validators
exrpd tx distribution withdraw-all-rewards --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Withdraw commission and rewards from your validator
exrpd tx distribution withdraw-rewards $(exrpd keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Delegate tokens to yourself
exrpd tx staking delegate $(exrpd keys show $WALLET --bech val -a) 2000000000000000000axrp --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Delegate tokens to validator
exrpd tx staking delegate <TO_VALOPER_ADDRESS> 2000000000000000000axrp --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Redelegate tokens to another validator
exrpd tx staking redelegate $(exrpd keys show $WALLET --bech val -a) <TO_VALOPER_ADDRESS> 2000000000000000000axrp --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Unbond tokens from your validator
exrpd tx staking unbond $(exrpd keys show $WALLET --bech val -a) 2000000000000000000axrp --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Send tokens to the wallet
exrpd tx bank send $WALLET <TO_WALLET_ADDRESS> 2000000000000000000axrp --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
🗳 Governance
List all proposals
exrpd query gov proposals
View proposal by id
exrpd query gov proposal 1
Vote 'Yes'
exrpd tx gov vote 1 yes --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Vote 'No'
exrpd tx gov vote 1 no --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Vote 'Abstain'
exrpd tx gov vote 1 abstain --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
Vote 'NoWithVeto'
exrpd tx gov vote 1 NoWithVeto --from $WALLET --chain-id xrplevm_1449000-1 --gas-adjustment 1.4 --gas auto --gas-prices 2000000000000000000axrp -y
⚡️ Utility
Update ports
CUSTOM_PORT=258
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}57\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}60\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}56\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}66\"%" $HOME/.exrpd/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}17\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}80\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}90\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}91\"%" $HOME/.exrpd/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.exrpd/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.exrpd/config/config.toml
Update pruning
sed -i \
-e 's|^pruning *=.*|pruning = "custom"|' \
-e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "107"|' \
-e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
-e 's|^pruning-interval *=.*|pruning-interval = "13"|' \
$HOME/.exrpd/config/app.toml
🚨 Maintenance
Get validator info
exrpd status 2>&1 | jq .ValidatorInfo
Get sync info
exrpd status 2>&1 | jq .SyncInfo
Get node peer
echo $(exrpd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.exrpd/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(exrpd q staking validator $(exrpd keys show $WALLET --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(exrpd 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:19657/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 = \"2000000000000000000axrp\"/" $HOME/.exrpd/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.exrpd/config/config.toml
Reset chain data
exrpd tendermint unsafe-reset-all --home $HOME/.exrpd --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 exrpdtest
sudo systemctl disable exrpdtest
sudo rm /etc/systemd/system/exrpdtest.service
sudo systemctl daemon-reload
rm -f $(which exrpd)
rm -rf $HOME/.exrpd
rm -rf $HOME/xrp
⚙️ Service Management
Reload sedad configuration
sudo systemctl daemon-reload
Enable sedad
sudo systemctl enable exrpdtest
Disable sedad
sudo systemctl disable exrpdtest
Start sedad
sudo systemctl start exrpdtest
Stop sedad
sudo systemctl stop exrpdtest
Restart sedad
sudo systemctl restart exrpdtest
Check sedad status
sudo systemctl status exrpdtest
Check sedad logs
sudo journalctl -u exrpdtest -f --no-hostname -o cat
END
Last updated