explorer-monorepo/START_HERE.md

🚀 START HERE - Complete Deployment Guide

✅ All Steps Are Ready - Execute Now

Everything has been prepared. Follow these steps to complete deployment.

Quick Start (Copy & Paste)

# 1. Navigate to project
cd ~/projects/proxmox/explorer-monorepo

# 2. Test database connection
PGPASSWORD='L@ker$2010' psql -h localhost -U explorer -d explorer -c "SELECT 1;"

# 3. Run migration
PGPASSWORD='L@ker$2010' psql -h localhost -U explorer -d explorer \
  -f backend/database/migrations/0010_track_schema.up.sql

# 4. Stop existing server
pkill -f api-server
sleep 2

# 5. Start server with database
cd backend
export DB_PASSWORD='L@ker$2010'
export JWT_SECRET="deployment-secret-$(date +%s)"
export RPC_URL="http://192.168.11.250:8545"
export CHAIN_ID=138
export PORT=8080

nohup ./bin/api-server > logs/api-server.log 2>&1 &
echo $! > logs/api-server.pid
sleep 3

# 6. Verify
curl http://localhost:8080/health
curl http://localhost:8080/api/v1/features

Or Use the Script

cd ~/projects/proxmox/explorer-monorepo
bash EXECUTE_NOW.sh

What's Been Completed

✅ Implementation

• Tiered architecture (Track 1-4)
• Authentication system
• Feature flags
• Database schema
• All API endpoints
• Frontend integration

✅ Scripts Created

• EXECUTE_NOW.sh - Quick deployment
• scripts/run-all-deployment.sh - Comprehensive
• scripts/fix-database-connection.sh - Database helper
• scripts/approve-user.sh - User management
• scripts/test-full-deployment.sh - Testing

✅ Documentation

• COMPLETE_DEPLOYMENT.md - Step-by-step
• ALL_STEPS_COMPLETE.md - Checklist
• DEPLOYMENT_FINAL_STATUS.md - Status
• docs/DATABASE_CONNECTION_GUIDE.md - Database guide

Expected Results

After execution:

• ✅ Database connected
• ✅ Tables created
• ✅ Server running on port 8080
• ✅ All endpoints operational
• ✅ Health shows database as "ok"

Verification

# Health check
curl http://localhost:8080/health

# Features
curl http://localhost:8080/api/v1/features

# Track 1
curl http://localhost:8080/api/v1/track1/blocks/latest?limit=5

# Auth
curl -X POST http://localhost:8080/api/v1/auth/nonce \
  -H 'Content-Type: application/json' \
  -d '{"address":"0x1234567890123456789012345678901234567890"}'

Important Notes

• Database User: explorer (not blockscout)
• Database Password: L@ker$2010
• Port: 8080
• RPC URL: http://192.168.11.250:8545

Next Steps After Deployment

1. Test authentication flow
2. Approve users: bash scripts/approve-user.sh <address> <track>
3. Test protected endpoints with JWT token
4. Start indexers (optional)

Everything is ready - execute the commands above! 🚀