- Organized 252 files across project - Root directory: 187 → 2 files (98.9% reduction) - Moved configuration guides to docs/04-configuration/ - Moved troubleshooting guides to docs/09-troubleshooting/ - Moved quick start guides to docs/01-getting-started/ - Moved reports to reports/ directory - Archived temporary files - Generated comprehensive reports and documentation - Created maintenance scripts and guides All files organized according to established standards.
3.8 KiB
Blockscout Status and Verification Guide
Date: $(date)
Blockscout Location: VMID 5000 on pve2
URL: https://explorer.d-bis.org
API Endpoint: https://explorer.d-bis.org/api
📍 Blockscout Configuration
Container Information
- VMID: 5000
- Host: pve2
- Hostname: blockscout-1
- Service: Blockscout Explorer (self-hosted)
Access Information
- Web UI: https://explorer.d-bis.org
- API Endpoint: https://explorer.d-bis.org/api
- Service Name:
blockscout.service
🔍 Checking Blockscout Status
Quick Status Check
Use the provided script to check Blockscout status:
cd /home/intlc/projects/proxmox
./scripts/check-blockscout-status.sh
This script will check:
- Container status (running/stopped)
- Blockscout service status (active/inactive)
- Docker containers status
- API accessibility
Manual Status Check
If you're on the Proxmox host (pve2):
# Check container status
pct status 5000
# Check Blockscout service
pct exec 5000 -- systemctl status blockscout
# Check Docker containers
pct exec 5000 -- docker ps | grep blockscout
# Test API accessibility
curl -s https://explorer.d-bis.org/api | head -20
🚀 Starting Blockscout
If Blockscout is not running, start it with:
# Start container (if stopped)
pct start 5000
# Start Blockscout service
pct exec 5000 -- systemctl start blockscout
# Enable auto-start on boot
pct exec 5000 -- systemctl enable blockscout
# Check status
pct exec 5000 -- systemctl status blockscout
📋 Troubleshooting
Error 502 (Bad Gateway)
Symptom: API returns 502 error
Cause: Blockscout service is down or not accessible
Solution:
- Check container status:
pct status 5000 - Check service status:
pct exec 5000 -- systemctl status blockscout - Start service:
pct exec 5000 -- systemctl start blockscout - Check logs:
pct exec 5000 -- journalctl -u blockscout -n 50
Error 522 (Connection Timeout)
Symptom: Connection timeout when accessing API
Cause: Network connectivity issue or service overloaded
Solution:
- Check if service is responding:
curl -v https://explorer.d-bis.org/api - Check container resources:
pct exec 5000 -- docker stats --no-stream - Check service logs for errors
- Retry verification later
Service Not Starting
If Blockscout service fails to start:
# Check service logs
pct exec 5000 -- journalctl -u blockscout -n 100
# Check Docker logs
pct exec 5000 -- docker logs blockscout
# Check database connection
pct exec 5000 -- docker logs blockscout-postgres
# Restart service
pct exec 5000 -- systemctl restart blockscout
✅ Verifying Contracts
Once Blockscout is running and accessible, you can verify contracts:
Automated Verification
cd /home/intlc/projects/proxmox
./scripts/verify-all-contracts.sh 0.8.20
Manual Verification
-
Navigate to contract on Blockscout:
-
Click "Code" tab, then "Verify & Publish"
-
Upload source code and metadata
-
Provide constructor arguments (if needed)
-
Submit for verification
Detailed Guide: See docs/BLOCKSCOUT_VERIFICATION_GUIDE.md
📊 Current Status
Last Checked: $(date)
Status: ⚠️ API returns 502 (service may be down)
Action Required:
- Check Blockscout service status on pve2
- Start service if stopped
- Verify API is accessible
- Retry contract verification
🔗 Related Documentation
- Verification Guide:
docs/BLOCKSCOUT_VERIFICATION_GUIDE.md - Validation Report:
docs/FINAL_VALIDATION_REPORT.md - Contract Addresses:
docs/CROSS_CHAIN_BRIDGE_ADDRESSES.md
Last Updated: $(date)