explorer-monorepo/docs/QUICK_FIX_GUIDE.md

Quick Fix Guide - Explorer Errors

Status: 🔴 Backend API Server Not Running

---

Problem

All API endpoints are returning HTTP 000 (connection refused) because the backend server is not running.

Quick Fix (5 minutes)

Step 1: Set Database Environment Variables

export DB_HOST=localhost
export DB_PORT=5432
export DB_USER=explorer
export DB_PASSWORD=your_password_here
export DB_NAME=explorer
export CHAIN_ID=138
export PORT=8080

Step 2: Start the Backend Server

Option A: Using the startup script (Recommended)

cd /home/intlc/projects/proxmox/explorer-monorepo
./scripts/start-backend.sh

Option B: Manual start

cd /home/intlc/projects/proxmox/explorer-monorepo/backend/api/rest
go run main.go

Step 3: Verify It's Working

In another terminal:

# Check health endpoint
curl http://localhost:8080/health

# Check stats endpoint
curl http://localhost:8080/api/v2/stats

# Check blocks endpoint
curl http://localhost:8080/api/v1/blocks?page=1&page_size=1

Step 4: Re-run Diagnostics

cd /home/intlc/projects/proxmox/explorer-monorepo
./scripts/check-logs-and-errors.sh

---

Expected Results

After starting the backend:

✅ /health returns: {"status":"healthy",...}
✅ /api/v2/stats returns statistics
✅ /api/v1/blocks returns block list
✅ /api/v1/transactions returns transaction list
✅ Frontend loads data correctly

---

Troubleshooting

Database Connection Error

If you see: Failed to connect to database

1. Check if PostgreSQL is running:

   sudo systemctl status postgresql
   

2. Verify database exists:

   psql -h localhost -U explorer -l | grep explorer
   

3. Test connection:

   psql -h localhost -U explorer -d explorer -c "SELECT 1;"
   

Port Already in Use

If port 8080 is already in use:

# Find process using port 8080
lsof -i :8080

# Kill it
kill $(lsof -t -i:8080)

# Or use a different port
export PORT=8081

Go Module Errors

If you see Go module errors:

cd /home/intlc/projects/proxmox/explorer-monorepo/backend
go mod download
go mod tidy

---

Running as a Service (Optional)

To run the backend as a systemd service:

1. Create service file: /etc/systemd/system/explorer-api.service
2. See docs/ERROR_REPORT_AND_FIXES.md for service configuration
3. Enable and start:

   sudo systemctl daemon-reload
   sudo systemctl enable explorer-api
   sudo systemctl start explorer-api
   

---

Full Error Report

For complete error analysis, see: docs/ERROR_REPORT_AND_FIXES.md