Skip to content

NETWORK_CONFIG.md

Latest commit

 

History

History
93 lines (66 loc) · 2.6 KB

NETWORK_CONFIG.md

File metadata and controls

93 lines (66 loc) · 2.6 KB

NETWORK CONFIGURATION GUIDE

SINGLE SOURCE OF TRUTH

THE FRONTEND CONFIGURATION IS THE SINGLE SOURCE OF TRUTH FOR NETWORK SELECTION. THE BACKEND AUTOMATICALLY SYNCS WITH THE FRONTEND'S NETWORK SETTING.

QUICK SWITCH BETWEEN TESTNET AND MAINNET

XAHPAYROLL CAN BE EASILY CONFIGURED TO USE EITHER THE XRP LEDGER TESTNET OR MAINNET BY CHANGING A SINGLE ENVIRONMENT VARIABLE IN THE FRONTEND CONFIGURATION.

CONFIGURATION STEPS

  1. OPEN THE FRONTEND .ENV FILE:

    CD FRONTEND
NANO .ENV

  2. CHANGE THE VITE_XRPL_NETWORK VARIABLE:

    FOR MAINNET (PRODUCTION):

    VITE_XRPL_NETWORK=MAINNET

    FOR TESTNET (DEVELOPMENT/TESTING):

    VITE_XRPL_NETWORK=TESTNET

  3. RESTART THE DEVELOPMENT SERVER:

    NPM RUN DEV

NETWORK DETAILS

MAINNET

TESTNET

  • WEBSOCKET URL: WSS://XAHAU-TEST.NET
  • USE FOR: DEVELOPMENT, TESTING WITH TEST XAH
  • FAUCET: GET FREE TEST XAH FROM THE TESTNET FAUCET
  • EXPLORER: HTTPS://EXPLORER.XAHAU-TEST.NET

IMPORTANT NOTES

⚠️ BEFORE SWITCHING NETWORKS:

  • DISCONNECT ANY CONNECTED WALLETS
  • CLEAR BROWSER LOCALSTORAGE IF YOU EXPERIENCE ISSUES
  • ENSURE YOUR WALLET (XAMAN, CROSSMARK, GEMWALLET) IS CONFIGURED FOR THE SAME NETWORK

⚠️ TESTNET VS MAINNET:

  • TESTNET XAH HAS NO REAL VALUE - IT'S FOR TESTING ONLY
  • MAINNET XAH IS REAL CRYPTOCURRENCY WITH REAL VALUE
  • NEVER USE MAINNET FOR TESTING OR DEVELOPMENT
  • ALWAYS DOUBLE-CHECK WHICH NETWORK YOU'RE ON BEFORE TRANSACTIONS

VERIFICATION

AFTER CHANGING THE NETWORK, YOU CAN VERIFY WHICH NETWORK IS ACTIVE BY:

  1. CONNECTING A WALLET
  2. CHECKING THE BROWSER CONSOLE LOGS - IT WILL SHOW: XAH LEDGER CLIENT CONNECTED TO [NETWORK]
  3. VERIFYING YOUR WALLET ADDRESS ON THE APPROPRIATE EXPLORER

DEFAULT CONFIGURATION

BY DEFAULT, XAHPAYROLL IS CONFIGURED TO USE MAINNET FOR PRODUCTION DEPLOYMENTS.

ENVIRONMENT VARIABLES REFERENCE

# BACKEND API URL
VITE_BACKEND_URL=HTTP://LOCALHOST:3001

# NETWORK CONFIGURATION
# OPTIONS: 'TESTNET' OR 'MAINNET'
VITE_XRPL_NETWORK=MAINNET

TROUBLESHOOTING

ISSUE: WALLET WON'T CONNECT AFTER SWITCHING NETWORKS

  • SOLUTION: DISCONNECT WALLET, CLEAR BROWSER CACHE/LOCALSTORAGE, AND RECONNECT

ISSUE: BALANCE SHOWS AS 0 ON TESTNET

  • SOLUTION: FUND YOUR TESTNET ACCOUNT USING A TESTNET FAUCET

ISSUE: CHANGES NOT TAKING EFFECT

  • SOLUTION: ENSURE YOU RESTARTED THE DEV SERVER AFTER CHANGING .ENV