XRPL EVM - Cheat-sheet

XRPL EVM Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the XRPL EVM network. Make sure the environment variables mentioned at the end are correctly configured before using these commands.

1. Key Management

Create a New Wallet

⚠️ Important: Keep the generated seed phrase safe. It is the only way to recover your wallet.

noded keys add $WALLET

Recover Wallet from Seed Phrase

noded keys add $WALLET --recover

List Wallets

noded keys list

Show Wallet Details

noded keys show $WALLET

Delete Wallet

noded keys delete $WALLET

2. Wallet Operations

Check Balance

noded query bank balances $(noded keys show $WALLET -a)

Send Tokens

noded tx bank send $WALLET <recipient_address> <amount>axrp --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

3. Validator Management

💡 Note: Ensure you have enough tokens for self-delegation and transaction fees before creating a validator.

Create Validator

noded tx staking create-validator \\
  --amount 1000000axrp \\
  --from $WALLET \\
  --commission-rate 0.1 \\
  --commission-max-rate 0.2 \\
  --commission-max-change-rate 0.01 \\
  --min-self-delegation 1 \\
  --pubkey $(noded tendermint show-validator) \\
  --moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --security-contact "your@email.com" \\
  --chain-id xrplevm_1440000-1 \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500axrp

Edit Validator

noded tx staking edit-validator \\
  --new-moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --chain-id xrplevm_1440000-1 \\
  --from $WALLET \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500axrp

Delegate Tokens

noded tx staking delegate $(noded keys show $WALLET --bech val -a) 1000000axrp --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

Withdraw Rewards (Delegator)

noded tx distribution withdraw-rewards $(noded keys show $WALLET --bech val -a) --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

Withdraw Rewards (Validator Commission)

noded tx distribution withdraw-rewards $(noded keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

Unbond Tokens

noded tx staking unbond $(noded keys show $WALLET --bech val -a) 1000000axrp --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

Redelegate Tokens

noded tx staking redelegate $(noded keys show $WALLET --bech val -a) <destination_validator_address> 1000000axrp --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

4. Node Status & Info

Check Sync Status

noded status 2>&1 | jq .SyncInfo

Check Peer Info

curl -s localhost:26657/net_info | jq -r '.result.peers[] | "\\(.node_info.id)@\\(.remote_ip):\\(.node_info.listen_addr | split(":")[2])"'

Show Node ID

noded tendermint show-node-id

Restart Node

sudo systemctl restart noded

View Node Logs

sudo journalctl -u noded -f -o cat

5. Governance

List Proposals

noded query gov proposals

View Proposal Details

noded query gov proposal <proposal_id>

Vote on Proposal

noded tx gov vote <proposal_id> yes --from $WALLET --chain-id xrplevm_1440000-1 --gas auto --gas-adjustment 1.5 --fees 500axrp

6. Environment Variables

💡 Tip: Make sure to set these in your ~/.bash_profile or equivalent shell config.

echo "export WALLET=\"wallet\"" >> $HOME/.bash_profile
echo "export MONIKER=\"your-moniker\"" >> $HOME/.bash_profile
echo "export CHAIN_ID=\"xrplevm_1440000-1\"" >> $HOME/.bash_profile
source $HOME/.bash_profile

This cheat sheet is provided to streamline XRPL EVM validator and wallet management. All commands use environment variables for easier management.