Node setup

XRPLEVM NODE SETUP

Install tools:

sudo apt update && sudo apt upgrade -y
sudo apt install make curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

Install GO:

cd $HOME
VER="1.22.8"
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"
[ ! -f $HOME/.bash_profile ] && touch $HOME/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
[ ! -d $HOME/go/bin ] && mkdir -p $HOME/go/bin

Download & Build binary

Clone project repository

cd $HOME
rm -rf $HOME/xrp
git clone https://github.com/xrplevm/node $HOME/xrp
cd $HOME/xrp
git checkout v8.0.0

Build binaries

make install

Check version:

$HOME/go/bin/exrpd version --long | tail

result:

- pgregory.net/rapid@v1.1.0
- sigs.k8s.io/yaml@v1.4.0
build_tags: netgo ledger,
commit: 8d92d087b9a1014de748b8887868e0e90b97b56f
cosmos_sdk_version: v0.50.13-xrplevm.2
go: go version go1.23.3 linux/amd64
name: exrp
server_name: exrpd
version: v8.0.0

Install Cosmovisor and create a service

Download and install Cosmovisor

cd $HOME
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest

Or

go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.6.0

Set vars

echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="your-moniker"" >> $HOME/.bash_profile
echo "export XRPL_CHAIN_ID="xrplevm_1440000-1"" >> $HOME/.bash_profile
echo "export XRPL_PORT="10"" >> $HOME/.bash_profile
source $HOME/.bash_profile

Init & prepare for Upgrade Cosmovisor folder

mkdir -p $HOME/.exrpd/cosmovisor/upgrades/
cp $HOME/go/bin/exrpd $HOME/.exrpd/cosmovisor/genesis/bin/

DAEMON_HOME="$HOME/.exrpd/" DAEMON_NAME="exrpd" cosmovisor init $HOME/go/bin/exrpd

echo "export DAEMON_NAME="exrpd"" >> $HOME/.bash_profile
echo "export DAEMON_HOME="$HOME/.exrpd/"" >> $HOME/.bash_profile
source $HOME/.bash_profile

Create service

sudo tee /etc/systemd/system/exrpd.service > /dev/null << EOF
[Unit]
Description=XRPL node
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
WorkingDirectory=.exrpd
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
Environment="DAEMON_HOME=.exrpd"
Environment="DAEMON_NAME=exrpd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:.exrpd/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable exrpd

INITIA NODE:

CONFIG & INIT APP

Set node configuration

exrpd config set client chain-id $XRPL_CHAIN_ID
exrpd config set client keyring-backend os
exrpd config set client node tcp://localhost:${XRPL_PORT}657

Initialize the node

exrpd init "$MONIKER" --chain-id $XRPL_CHAIN_ID --home=$HOME/.exrpd

Custom Port:

set custom ports in 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

set custom ports in config.toml file

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

Set minimum gas price

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0axrp"|g' $HOME/.exrpd/config/app.toml

Set pruning

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

Disable indexer

sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.exrpd/config/config.toml

Enable Prometheus

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.exrpd/config/config.toml

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 exrpd
sudo systemctl disable exrpd
sudo rm /etc/systemd/system/exrpd.service
sudo systemctl daemon-reload
sudo rm -f $(which exrpd)
rm -rf $HOME/.exrpd
rm -rf $HOME/xrp