Skip to main content

XRPL

Endpoints​

API: https://xrpl-testnet-api.kgnodes.xyz

RPC: https://xrpl-testnet-rpc.kgnodes.xyz

gRPC:https://xrpl-testnet-grpc.kgnodes.xyz

JSON-RPC:https://xrpl-testnet-jsonrpc.kgnodes.xyz

Explorer: https://explorer.kgnodes.xyz/Xrpl-Testnet

Installation

Update OS​

sudo apt update && sudo apt upgrade -y

Installing Dependencies​

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

Installing GO​

ver="1.21.6"
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"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version

Setting up environment variables​

echo "export XRPL_PORT="25"" >> $HOME/.bash_profile
source $HOME/.bash_profile

Initializing and configuring the node​

Download Binary​

cd $HOME && mkdir -p go/bin/
git clone https://github.com/xrplevm/node.git xrplevm
cd xrplevm
git checkout v7.0.0
make install

Node Settings​

sed -i -e '/^chain-id = /c\chain-id = "exrp_1449000-1"' $HOME/.exrpd/config/client.toml
sed -i -e "s|^node *=.*|node = \"tcp://localhost:${XRPL_PORT}657\"|" $HOME/.exrpd/config/client.toml
sed -i -e '/^keyring-backend = /c\keyring-backend = "test"' $HOME/.exrpd/config/client.toml

Initializing the Node​

exrpd init "your-moniker" --chain-id exrp_1449000-1

Downloading genesis and addressbook​

wget -O $HOME/.exrpd/config/genesis.json https://snapshot.kgnodes.xyz/snapshot/Xrpl/genesis.json
wget -O $HOME/.exrpd/config/addrbook.json  https://snapshot.kgnodes.xyz/snapshot/Xrpl/addrbook.json

Setting seeds and peers​

SEEDS=""
PEERS="[email protected]:26656,[email protected]:43656,[email protected]:30056,[email protected]:26656,[email protected]:30670,[email protected]:26656,[email protected]:13656,[email protected]:47656,[email protected]:3356,[email protected]:26656"
sed -i -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.exrpd/config/config.toml

Updating 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

Updating ports in 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

Configuring pruning settings​

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

Setting gas and other configurations​

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

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

Creating service file​

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

[Service]
User=$USER
ExecStart=$(which exrpd) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Enabling and starting the service​

sudo systemctl daemon-reload
sudo systemctl enable exrpd

Downloading latest snap​

Latest Snapshot:​

SizeHeigtTimeIndexer
264MB5896622025-03-28 08:00 UTCcustom: 100/0/10
sudo systemctl stop exrpd

cp $HOME/.exrpd/data/priv_validator_state.json $HOME/.exrpd/priv_validator_state.json.backup

exrpd tendermint unsafe-reset-all --home $HOME/.exrpd --keep-addr-book
curl https://snapshot.kgnodes.xyz/snapshot/Xrpl/snap_exrpd.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.exrpd


mv $HOME/.exrpd/priv_validator_state.json.backup $HOME/.exrpd/data/priv_validator_state.json

sudo systemctl restart exrpd
sudo journalctl -u exrpd -f --no-hostname -o cat

Checking logs​

sudo journalctl -u exrpd -f --no-hostname -o cat

Wallet​

Creating a New Wallet​

exrpd keys add <wallet_name>

Importing existing wallet​

exrpd keys add wallet-name --recover

Exporting private key​

exrpd keys unsafe-export-eth-key wallet-name

Creating Validator​

#pubkey
exrpd tendermint show-validator --home $HOME/.exrpd
cd $HOME
nano $HOME/.exrpd/validator.json
{
  "pubkey": {"your-pubkey"},
  "amount": "1000000000000000000axrp",
  "moniker": "your-moniker",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.2",
  "commission-max-change-rate": "0.2",
  "min-self-delegation": "1"
}
exrpd --home $HOME/.exrpd tx staking create-validator $HOME/.exrpd/validator.json --from WalletName  --chain-id xrplevm_1449000-1 -y

Self-Delegating​

exrpd tx staking delegate $(exrpd keys show wallet-name --bech val -a) 1000000apoa --from wallet-name --chain-id exrp_1449000-1 --gas="300000" --gas-prices="240000000000900000axrp" -y

Deleting the Node​

cd $HOME
sudo systemctl stop exrpd
sudo systemctl disable exrpd
sudo rm -rf /etc/systemd/system/exrpd.service
sudo systemctl daemon-reload
sudo rm -f /usr/local/bin/exrpd
sudo rm -f $(which exrpd)
sudo rm -rf $HOME/.exrpd
sed -i "/XRPL_PORT_/d" $HOME/.bash_profile