XRPL-Guide

XRPL Node Setup Guide

This guide will walk you through setting up an XRPL EVM node from scratch.

Recommended Hardware Requirements

• Operating System: Linux (AMD64)
• CPU: 8 Physical Cores or More
• Memory (RAM): 32GB
• Storage: 1TB Cloud Storage (AWS), SSD or NVMe
• Network: 100Mbps

---

Install Go and Cosmovisor

Install Go

We will use Go v1.23.4 as an example.

sudo rm -rvf /usr/local/go/
wget https://golang.org/dl/go1.23.4.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.4.linux-amd64.tar.gz
rm go1.23.4.linux-amd64.tar.gz

Configure Go

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Install Cosmovisor

Using Cosmovisor v1.0.0:

go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@v1.0.0

Install XRPL Node

git clone https://github.com/xrplevm/node xrp
cd xrp
git checkout v6.0.0
make install

Configure Node

Initialize Node

Replace YOUR_MONIKER with your preferred name:

exrpd init YOUR_MONIKER --chain-id exrp_1440002-1

Install WASMVM

export WASMVM_VERSION=v2.1.2
export LD_LIBRARY_PATH=$HOME/.exrpd/lib
mkdir -p $LD_LIBRARY_PATH
wget "https://github.com/CosmWasm/wasmvm/releases/download/$WASMVM_VERSION/libwasmvm.$(uname -m).so" -O "$LD_LIBRARY_PATH/libwasmvm.$(uname -m).so"
echo "export LD_LIBRARY_PATH=$HOME/.exrpd/lib:$LD_LIBRARY_PATH" >> ~/.bashrc
source ~/.bashrc

Configure Ports, Pruning, Gas Price, and Indexing

echo "export XRPL_PORT="47"" >> $HOME/.bashrc
source $HOME/.bashrc

Modify app.toml and config.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 -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 = \"kv\"/" $HOME/.exrpd/config/config.toml

Configure Seed Peers

PEERS=`curl -sL https://raw.githubusercontent.com/Peersyst/xrp-evm-archive/main/poa-devnet/peers.txt | sort -R | head -n 10 | awk '{print $1}' | paste -s -d, -`
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" ~/.exrpd/config/config.toml

Download Genesis

wget -O genesis.json https://raw.githubusercontent.com/Peersyst/xrp-evm-archive/main/poa-devnet/genesis.json --inet4-only
mv genesis.json ~/.exrpd/config

Configure Addrbook

wget -O $HOME/.exrpd/config/addrbook.json "https://xrpl-testnet-services.luckystar.asia/xrpl/addrbook.json"

Launch Node

Configure Cosmovisor Folder

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

Create Systemd Service File

Create a service file at /etc/systemd/system/exrpd.service:

[Unit]
Description="xrp node"
After=network-online.target

[Service]
User=USER
ExecStart=/home/USER/go/bin/cosmovisor start
Restart=always
RestartSec=3
LimitNOFILE=4096
Environment="DAEMON_NAME=exrpd"
Environment="DAEMON_HOME=/home/USER/.exrpd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target

Download Snapshot

sudo apt install lz4
wget -O xrp_14779106.tar.lz4 http://exrpd-testnet-snapshots.mekonglabs.tech/xrp_14779106.tar.lz4 --inet4-only

# Back up priv_validator_state.json if needed
cp ~/.exrpd/data/priv_validator_state.json  ~/.exrpd/priv_validator_state.json

# Reset node state
exrpd tendermint unsafe-reset-all --home $HOME/.exrpd --keep-addr-book

lz4 -c -d xrp_14779106.tar.lz4  | tar -x -C $HOME/.exrpd

# Restore priv_validator_state.json
cp ~/.exrpd/priv_validator_state.json  ~/.exrpd/data/priv_validator_state.json

Start Node Service

sudo systemctl daemon-reload
sudo systemctl enable exrpd
sudo systemctl start exrpd && sudo journalctl -u exrpd -fo cat

Conclusion

Your XRPL node should now be running successfully. To check its status:

exrpd status

To view logs:

journalctl -u exrpd -f

Maintainer: EmberValidator
Website: embervalidator.top

---