Node Install

Guide to Set Up a XRPL EVM Node (Testnet)

Prerequisites

Operating System: Linux (preferably Ubuntu 20.04 or later).

8 CPUs
32 GB RAM
1 Tb of disk space

Network Details

Chain ID: xrplevm_1440000-1
Binary version: v8.0.0
GitHub: xrplevm/node

Installation and Configuration

1. Install dependencies:

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

2. Install Go:

sudo rm -rf /usr/local/go
wget https://go.dev/dl/go1.23.4.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.4.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
source ~/.profile
go version

3. Build and install binary:

git clone https://github.com/xrplevm/node.git
cd node
make build
make install
export PATH=$PATH:$HOME/go/bin
exrpd version

4. Configure the node:

exrpd config set client chain-id xrplevm_1440000-1

5. Initialize the node:

exrpd init Moniker --chain-id xrplevm_1440000-1

6. Download genesis file:

curl -Ls https://xrpl.cumulo.org.es/genesis/genesis.json > $HOME/.exrpd/config/genesis.json

7. Add seed peers:

peers=$(curl -s https://rpc.xrpl.cumulo.org.es/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.node_info.listen_addr)"' | grep -v "0.0.0.0" | paste -sd, -)
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.exrpd/config/config.toml

8. Enable pruning and Prometheus:

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

9. Create systemd service:

sudo tee /etc/systemd/system/exrpd.service > /dev/null <<EOF
[Unit]
Description=XRPL EVM 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

10. Start the node:

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