docs: add startup script and testing guide

- scripts/run-xdc-mainnet.sh: One-command startup for XDC mainnet - docs/TESTING.md: Complete testing and configuration guide Usage: ./scripts/run-xdc-mainnet.sh Or with custom settings: DATADIR=/data/xdc PORT=30305 ./scripts/run-xdc-mainnet.sh
2026-07-19 11:20:45 +00:00 · 2026-01-29 05:48:13 +01:00 · 2026-01-29 05:48:13 +01:00 · 843e7ba8bc
commit 843e7ba8bc
parent 9b24b71513
2 changed files with 233 additions and 0 deletions
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@ -0,0 +1,159 @@
+# Testing XDC Part4 Node
+
+## Quick Start
+
+### 1. Build the node
+
+```bash
+cd /path/to/xdpos-part4
+go build -o build/bin/geth ./cmd/geth
+```
+
+### 2. Initialize with XDC mainnet genesis
+
+```bash
+./build/bin/geth init --datadir ~/.xdc-part4 genesis/xdc_mainnet.json
+```
+
+Expected output:
+```
+Successfully wrote genesis state  database=chaindata hash=4a9d74..42d6b1
+```
+
+### 3. Start the node
+
+Using the script:
+```bash
+chmod +x scripts/run-xdc-mainnet.sh
+./scripts/run-xdc-mainnet.sh
+```
+
+Or manually:
+```bash
+./build/bin/geth \
+    --datadir ~/.xdc-part4 \
+    --networkid 50 \
+    --port 30304 \
+    --bootnodes "enode://91e59fa1b034ae35e9f4e8a99cc6621f09d74e76a6220abb6c93b29ed41a9e1fc4e5b70e2c5fc43f883cffbdcd6f4f6cbc1d23af077f28c2aecc22403355d4b1@209.126.0.250:30304,enode://7524db6718828c2c7663e6585a5b1e066457b8b0235034b69358b36e584fea776666d36ed4fc43d0f8bf2a5c3b2a960b5600689b6c8f0c207e5a76f8b0ca432d@157.173.120.219:30304" \
+    --syncmode full \
+    --http \
+    --http.addr "0.0.0.0" \
+    --http.port 8545 \
+    --http.api "eth,net,web3,txpool,debug,admin" \
+    --http.corsdomain "*" \
+    --verbosity 3
+```
+
+## Configuration Options
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| DATADIR | ~/.xdc-part4 | Data directory |
+| PORT | 30304 | P2P port |
+| HTTP_PORT | 8545 | HTTP RPC port |
+| WS_PORT | 8546 | WebSocket port |
+| SYNCMODE | full | Sync mode (full/snap) |
+| VERBOSITY | 3 | Log verbosity (0-5) |
+
+Example with custom settings:
+```bash
+DATADIR=/data/xdc PORT=30305 HTTP_PORT=8546 ./scripts/run-xdc-mainnet.sh
+```
+
+## Verify Node Status
+
+### Check peer count
+```bash
+curl -X POST -H "Content-Type: application/json" \
+    --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' \
+    http://localhost:8545
+```
+
+### Check sync status
+```bash
+curl -X POST -H "Content-Type: application/json" \
+    --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' \
+    http://localhost:8545
+```
+
+### Check block number
+```bash
+curl -X POST -H "Content-Type: application/json" \
+    --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
+    http://localhost:8545
+```
+
+### Get node info
+```bash
+curl -X POST -H "Content-Type: application/json" \
+    --data '{"jsonrpc":"2.0","method":"admin_nodeInfo","params":[],"id":1}' \
+    http://localhost:8545
+```
+
+### List peers
+```bash
+curl -X POST -H "Content-Type: application/json" \
+    --data '{"jsonrpc":"2.0","method":"admin_peers","params":[],"id":1}' \
+    http://localhost:8545
+```
+
+## Using Console
+
+Attach to running node:
+```bash
+./build/bin/geth attach ~/.xdc-part4/geth.ipc
+```
+
+In console:
+```javascript
+// Check peers
+admin.peers.length
+
+// Check sync status  
+eth.syncing
+
+// Check block number
+eth.blockNumber
+
+// Node info
+admin.nodeInfo
+```
+
+## XDC Mainnet Details
+
+| Parameter | Value |
+|-----------|-------|
+| Network ID | 50 |
+| Chain ID | 50 |
+| Genesis Hash | 0x4a9d748bd78a8d0385b67788c2435dcdb914f98a96250b68863a1f8b7642d6b1 |
+| State Root | 0x49be235b0098b048f9805aed38a279d8c189b469ff9ba307b39c7ad3a3bc55ae |
+| P2P Port | 30304 |
+| Consensus | XDPoS |
+
+## Troubleshooting
+
+### No peers connecting
+- Check firewall allows port 30304 (TCP/UDP)
+- Verify bootnodes are reachable: `nc -vz 209.126.0.250 30304`
+- Check logs for peer discovery messages
+
+### Genesis hash mismatch
+- Re-initialize with correct genesis file
+- Delete datadir and start fresh: `rm -rf ~/.xdc-part4`
+
+### Node crashes on startup
+- Check disk space
+- Increase verbosity: `VERBOSITY=4 ./scripts/run-xdc-mainnet.sh`
+- Check system logs: `dmesg | tail`
+
+## Development
+
+Run tests:
+```bash
+go test ./core -run TestXDC -v
+```
+
+Build with race detector:
+```bash
+go build -race -o build/bin/geth ./cmd/geth
+```
--- a/scripts/run-xdc-mainnet.sh
+++ b/scripts/run-xdc-mainnet.sh
@ -0,0 +1,74 @@
+#!/bin/bash
+# XDC Mainnet Node Startup Script
+# Part4 Implementation (go-ethereum v1.15 based)
+
+set -e
+
+# Configuration
+DATADIR="${DATADIR:-$HOME/.xdc-part4}"
+NETWORK_ID=50
+PORT="${PORT:-30304}"
+HTTP_PORT="${HTTP_PORT:-8545}"
+WS_PORT="${WS_PORT:-8546}"
+VERBOSITY="${VERBOSITY:-3}"
+SYNCMODE="${SYNCMODE:-full}"
+
+# XDC Mainnet Bootnodes
+BOOTNODES="enode://91e59fa1b034ae35e9f4e8a99cc6621f09d74e76a6220abb6c93b29ed41a9e1fc4e5b70e2c5fc43f883cffbdcd6f4f6cbc1d23af077f28c2aecc22403355d4b1@209.126.0.250:30304,enode://91e59fa1b034ae35e9f4e8a99cc6621f09d74e76a6220abb6c93b29ed41a9e1fc4e5b70e2c5fc43f883cffbdcd6f4f6cbc1d23af077f28c2aecc22403355d4b1@209.126.4.150:30304,enode://91e59fa1b034ae35e9f4e8a99cc6621f09d74e76a6220abb6c93b29ed41a9e1fc4e5b70e2c5fc43f883cffbdcd6f4f6cbc1d23af077f28c2aecc22403355d4b1@144.126.150.58:30304,enode://91e59fa1b034ae35e9f4e8a99cc6621f09d74e76a6220abb6c93b29ed41a9e1fc4e5b70e2c5fc43f883cffbdcd6f4f6cbc1d23af077f28c2aecc22403355d4b1@162.250.190.246:30304,enode://7524db6718828c2c7663e6585a5b1e066457b8b0235034b69358b36e584fea776666d36ed4fc43d0f8bf2a5c3b2a960b5600689b6c8f0c207e5a76f8b0ca432d@157.173.120.219:30304"
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+GENESIS_FILE="$PROJECT_ROOT/genesis/xdc_mainnet.json"
+
+# Build if binary doesn't exist
+GETH_BIN="$PROJECT_ROOT/build/bin/geth"
+if [ ! -f "$GETH_BIN" ]; then
+    echo "Building geth..."
+    cd "$PROJECT_ROOT"
+    go build -o build/bin/geth ./cmd/geth
+fi
+
+# Initialize datadir if needed
+if [ ! -d "$DATADIR/geth/chaindata" ]; then
+    echo "Initializing datadir with XDC mainnet genesis..."
+    mkdir -p "$DATADIR"
+    "$GETH_BIN" init --datadir "$DATADIR" "$GENESIS_FILE"
+    echo ""
+    echo "Genesis initialized. Expected hash: 0x4a9d748bd78a8d0385b67788c2435dcdb914f98a96250b68863a1f8b7642d6b1"
+fi
+
+echo ""
+echo "========================================="
+echo "Starting XDC Mainnet Node (Part4)"
+echo "========================================="
+echo "Datadir:    $DATADIR"
+echo "Network ID: $NETWORK_ID"
+echo "P2P Port:   $PORT"
+echo "HTTP Port:  $HTTP_PORT"
+echo "WS Port:    $WS_PORT"
+echo "Sync Mode:  $SYNCMODE"
+echo "========================================="
+echo ""
+
+# Start the node
+exec "$GETH_BIN" \
+    --datadir "$DATADIR" \
+    --networkid $NETWORK_ID \
+    --port $PORT \
+    --bootnodes "$BOOTNODES" \
+    --syncmode "$SYNCMODE" \
+    --http \
+    --http.addr "0.0.0.0" \
+    --http.port $HTTP_PORT \
+    --http.api "eth,net,web3,txpool,debug,admin" \
+    --http.corsdomain "*" \
+    --http.vhosts "*" \
+    --ws \
+    --ws.addr "0.0.0.0" \
+    --ws.port $WS_PORT \
+    --ws.api "eth,net,web3,txpool" \
+    --ws.origins "*" \
+    --verbosity $VERBOSITY \
+    --nat "any" \
+    "$@"