Validator

Copy
﻿
The XRPL EVM Sidechain enables Ethereum smart contracts and ERC-20 tokens to interact with the XRP Ledger, combining the best of both ecosystems. Whether you are a user, developer, operator, or interested in bridging assets, this documentation will guide you.
🖥️ Hardware Requirements
Component
Storage KV
Memory
32 GB RAM
CPU
8 cores
Storage
1TB Cloud Storage (AWS), SSD or NVMe
Bandwidth
100Mbp
🛞 Auto installer : In Progress
🕹️ Manual installer 
1. Install necessary packages
sudo apt update && sudo apt upgrade -y
sudo apt install make curl git wget htop tmux build-essential jq make lz4 gcc unzip -y
sudo apt update && sudo apt upgrade -y
sudo apt install make curl git wget htop tmux build-essential jq make lz4 gcc unzip -y
﻿
2. Clone the 0g-storage-kv repository from GitHub
echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="Zstake"" >> $HOME/.bash_profile
echo "export XRPL_CHAIN_ID="xrplevm_1449000-1"" >> $HOME/.bash_profile
echo "export XRPL_PORT="50"" >> $HOME/.bash_profile
source $HOME/.bash_profile
echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="Zstake"" >> $HOME/.bash_profile
echo "export XRPL_CHAIN_ID="xrplevm_1449000-1"" >> $HOME/.bash_profile
echo "export XRPL_PORT="50"" >> $HOME/.bash_profile
source $HOME/.bash_profile
﻿
4. Build the project in release mode
cd $HOME
git clone https://github.com/xrplevm/node
cd node
git checkout v6.0.0
make install
exrpd version
cd $HOME
git clone https://github.com/xrplevm/node
cd node
git checkout v6.0.0
make install
exrpd version
﻿
5. Edit the configuration file
export WASMVM_VERSION=v2.1.2
export Exrpd_PATH=$HOME/.exrpd/lib
mkdir -p $Exrpd_PAT
wget "https://github.com/CosmWasm/wasmvm/releases/download/$WASMVM_VERSION/libwasmvm.$(uname -m).so" -O "$Exrpd_PATH/libwasmvm.$(uname -m).so"
echo "export Exrpd_PATH=$HOME/.exrpd/lib:$Exrpd_PATH" >> ~/.bashrc
source ~/.bashrc
export WASMVM_VERSION=v2.1.2
export Exrpd_PATH=$HOME/.exrpd/lib
mkdir -p $Exrpd_PAT
wget "https://github.com/CosmWasm/wasmvm/releases/download/$WASMVM_VERSION/libwasmvm.$(uname -m).so" -O "$Exrpd_PATH/libwasmvm.$(uname -m).so"
echo "export Exrpd_PATH=$HOME/.exrpd/lib:$Exrpd_PATH" >> ~/.bashrc
source ~/.bashrc
﻿
6. Node init
exrpd config set client node "tcp://localhost:50657"
exrpd config set client keyring-backend os
exrpd config set client chain-id xrplevm_1449000-1
exrpd init "Zstake" --chain-id xrplevm_1449000-1
exrpd config set client node "tcp://localhost:50657"
exrpd config set client keyring-backend os
exrpd config set client chain-id xrplevm_1449000-1
exrpd init "Zstake" --chain-id xrplevm_1449000-1
﻿
7. PEERS, SEED setting
SEEDS=""
PEERS=972f58b459debdbaa92fd8479d89128b653d7eb8@65.21.29.250:3640,f8452f28064e9cf9ef1df0c055ac0280576143b6@65.108.69.56:26696,b96d3e221688108e40706d51cca59d80a60f67e9@65.21.200.7:3640,1881f3f71603b7eba91b8b84148834c7322122be@45.77.195.1:26656,6c5b34685a0c1956bde097914e42bc537f5ca5c7@79.137.70.143:26646
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.exrpd/config/config.toml
SEEDS=""
PEERS=972f58b459debdbaa92fd8479d89128b653d7eb8@65.21.29.250:3640,f8452f28064e9cf9ef1df0c055ac0280576143b6@65.108.69.56:26696,b96d3e221688108e40706d51cca59d80a60f67e9@65.21.200.7:3640,1881f3f71603b7eba91b8b84148834c7322122be@45.77.195.1:26656,6c5b34685a0c1956bde097914e42bc537f5ca5c7@79.137.70.143:26646
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.exrpd/config/config.toml
﻿
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.exrpd/config/config.toml
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.exrpd/config/config.toml
﻿
8. Download genesis.json & Addrbook file
wget -O $HOME/.exrpd/config/genesis.json https://snapshots.polkachu.com/testnet-genesis/xrp/genesis.json
wget -O $HOME/.exrpd/config/addrbook.json https://snapshots.polkachu.com/testnet-addrbook/xrp/addrbook.json
wget -O $HOME/.exrpd/config/genesis.json https://snapshots.polkachu.com/testnet-genesis/xrp/genesis.json
wget -O $HOME/.exrpd/config/addrbook.json https://snapshots.polkachu.com/testnet-addrbook/xrp/addrbook.json
﻿
9. Custom port setting
sed -i.bak -e "s%:1317%:${XRPL_PORT}317%g;
s%:8080%:${XRPL_PORT}080%g;
s%:9090%:${XRPL_PORT}090%g;
s%:9091%:${XRPL_PORT}091%g;
s%:8545%:${XRPL_PORT}545%g;
s%:8546%:${XRPL_PORT}546%g;
s%:6065%:${XRPL_PORT}065%g" $HOME/.exrpd/config/app.toml
sed -i.bak -e "s%:1317%:${XRPL_PORT}317%g;
s%:8080%:${XRPL_PORT}080%g;
s%:9090%:${XRPL_PORT}090%g;
s%:9091%:${XRPL_PORT}091%g;
s%:8545%:${XRPL_PORT}545%g;
s%:8546%:${XRPL_PORT}546%g;
s%:6065%:${XRPL_PORT}065%g" $HOME/.exrpd/config/app.toml
﻿
sed -i.bak -e "s%:26658%:${XRPL_PORT}658%g;
s%:26657%:${XRPL_PORT}657%g;
s%:6060%:${XRPL_PORT}060%g;
s%:26656%:${XRPL_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${XRPL_PORT}656\"%;
s%:26660%:${XRPL_PORT}660%g" $HOME/.exrpd/config/config.toml
sed -i.bak -e "s%:26658%:${XRPL_PORT}658%g;
s%:26657%:${XRPL_PORT}657%g;
s%:6060%:${XRPL_PORT}060%g;
s%:26656%:${XRPL_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${XRPL_PORT}656\"%;
s%:26660%:${XRPL_PORT}660%g" $HOME/.exrpd/config/config.toml
﻿
10. Config pruning, set gas price, enable prometheus, disable indexer
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.exrpd/config/app.toml 
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.exrpd/config/app.toml 
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.exrpd/config/app.toml
﻿
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0axrp"|g' $HOME/.exrpd/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.exrpd/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.exrpd/config/config.toml
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0axrp"|g' $HOME/.exrpd/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.exrpd/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.exrpd/config/config.toml
﻿
11. Create a systemd service file
sudo tee /etc/systemd/system/exrpd.service > /dev/null <<EOF
[Unit]
Description=XRPL node
After=network-online.target
[Service]
User=$USER
WorkingDirectory=$HOME/.exrpd
ExecStart=$(which exrpd) start --home $HOME/.exrpd
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
sudo tee /etc/systemd/system/exrpd.service > /dev/null <<EOF
[Unit]
Description=XRPL node
After=network-online.target
[Service]
User=$USER
WorkingDirectory=$HOME/.exrpd
ExecStart=$(which exrpd) start --home $HOME/.exrpd
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
﻿
12. Start the service immediately
sudo systemctl daemon-reload && sudo systemctl enable exrpd && sudo systemctl restart exrpd
sudo systemctl daemon-reload && sudo systemctl enable exrpd && sudo systemctl restart exrpd
﻿
﻿
⌨️ Useful Commands
1. Log Check
sudo journalctl -u exrpd -fo cat
sudo journalctl -u exrpd -fo cat
﻿
﻿
2. Key Command
exrpd keys add $WALLET
exrpd keys add $WALLET
﻿
exrpd keys add $WALLET --recover
exrpd keys add $WALLET --recover
﻿
exrpd q bank balances $WALLET
exrpd q bank balances $WALLET
﻿
exrpd keys unsafe-export-eth-key $WALLET
exrpd keys unsafe-export-eth-key $WALLET
﻿
exrpd tx staking delegate $(exrpd keys show $WALLET --bech val -a) 1000000uxrp --from $WALLET --chain-id exrp_1440002-1 --gas auto --gas-adjustment 1.5 -y 
exrpd tx staking delegate $(exrpd keys show $WALLET --bech val -a) 1000000uxrp --from $WALLET --chain-id exrp_1440002-1 --gas auto --gas-adjustment 1.5 -y 
﻿
exrpd tx staking create-validator \
--amount 1000000uxrp \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(exrpd tendermint show-validator) \
--moniker "$MONIKER" \
--identity "" \
--details "Exrp_node_by_Stv" \
--chain-id exrp_1440002-1 \
--gas auto --gas-adjustment 1.5 \
-y 
exrpd tx staking create-validator \
--amount 1000000uxrp \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(exrpd tendermint show-validator) \
--moniker "$MONIKER" \
--identity "" \
--details "Exrp_node_by_Stv" \
--chain-id exrp_1440002-1 \
--gas auto --gas-adjustment 1.5 \
-y 
﻿
exrpd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--security-contact "YOUR_CONTACT"
--from $WALLET \
--chain-id exrp_1440002-1 \
--gas auto --gas-adjustment 1.5 \
-y 
exrpd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--security-contact "YOUR_CONTACT"
--from $WALLET \
--chain-id exrp_1440002-1 \
--gas auto --gas-adjustment 1.5 \
-y 
﻿
exrpd q staking validator $(exrpd keys show wallet --bech val -a)
exrpd tendermint show-validator
exrpd q staking validator $(exrpd keys show wallet --bech val -a)
exrpd tendermint show-validator
﻿
exrpd q staking validator $(exrpd keys show $WALLET --bech val -a) 
exrpd q staking validator $(exrpd keys show $WALLET --bech val -a) 
﻿
﻿
Component	Storage KV
Memory	32 GB RAM
CPU	8 cores
Storage	1TB Cloud Storage (AWS), SSD or NVMe
Bandwidth	100Mbp