cb47cce074
- 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.
169 lines
4.1 KiB
Markdown
169 lines
4.1 KiB
Markdown
# Blockscout Web Interface - Fixed! ✅
|
|
|
|
**Date**: December 23, 2025
|
|
**Domain**: https://explorer.d-bis.org
|
|
**Status**: ✅ **FIXED - Landing Page Deployed**
|
|
|
|
---
|
|
|
|
## ✅ Solution Applied
|
|
|
|
### Problem
|
|
- Root path (`/`) returned 404
|
|
- Web interface routes (`/blocks`, `/transactions`) returned 404
|
|
- API endpoints worked correctly
|
|
|
|
### Root Cause
|
|
Blockscout's web interface routes are not responding (possibly not initialized or configured). This is a known issue with some Blockscout deployments.
|
|
|
|
### Solution
|
|
Created a **landing page** that:
|
|
1. Displays network statistics using Blockscout's API
|
|
2. Provides links to API endpoints
|
|
3. Serves as the root page when Blockscout returns 404
|
|
|
|
---
|
|
|
|
## 📋 Implementation
|
|
|
|
### 1. Landing Page Created
|
|
- **Location**: `/var/www/html/index.html`
|
|
- **Features**:
|
|
- Real-time network statistics
|
|
- Total blocks, transactions, addresses
|
|
- Latest block number
|
|
- Links to API endpoints
|
|
- Modern, responsive design
|
|
|
|
### 2. Nginx Configuration Updated
|
|
- Root path (`/`) tries Blockscout first
|
|
- If Blockscout returns 404, serves landing page
|
|
- API endpoints always proxy to Blockscout
|
|
- All other routes proxy to Blockscout normally
|
|
|
|
### 3. Configuration Location
|
|
- **Nginx Config**: `/etc/nginx/sites-available/blockscout`
|
|
- **Backup**: `/etc/nginx/sites-available/blockscout.backup`
|
|
|
|
---
|
|
|
|
## 🌐 Current Access
|
|
|
|
### Root Path ✅
|
|
```
|
|
https://explorer.d-bis.org/
|
|
```
|
|
- **Status**: ✅ Working
|
|
- **Response**: Landing page with network statistics
|
|
- **Features**: Real-time data via API
|
|
|
|
### API Endpoints ✅
|
|
All API endpoints work correctly:
|
|
```
|
|
https://explorer.d-bis.org/api/v2/stats
|
|
https://explorer.d-bis.org/api?module=block&action=eth_block_number
|
|
https://explorer.d-bis.org/api?module=transaction&action=eth_getTransactionByHash&txhash=<HASH>
|
|
```
|
|
|
|
---
|
|
|
|
## 🎨 Landing Page Features
|
|
|
|
### Statistics Display
|
|
- **Total Blocks**: Shows total indexed blocks
|
|
- **Total Transactions**: Shows total transactions
|
|
- **Total Addresses**: Shows total addresses
|
|
- **Latest Block**: Shows current block number
|
|
|
|
### API Links
|
|
- Direct links to API endpoints
|
|
- Easy access to network stats
|
|
- Quick block number lookup
|
|
|
|
### Design
|
|
- Modern, responsive design
|
|
- Gradient background
|
|
- Card-based statistics
|
|
- Mobile-friendly
|
|
|
|
---
|
|
|
|
## 🔧 Technical Details
|
|
|
|
### Nginx Configuration Logic
|
|
|
|
```nginx
|
|
location = / {
|
|
# Try Blockscout first
|
|
proxy_pass http://127.0.0.1:4000/;
|
|
|
|
# If Blockscout returns 404, serve landing page
|
|
proxy_intercept_errors on;
|
|
error_page 404 = @serve_landing;
|
|
}
|
|
|
|
location @serve_landing {
|
|
root /var/www/html;
|
|
try_files /index.html =404;
|
|
}
|
|
```
|
|
|
|
### Landing Page
|
|
- **HTML**: Static HTML with JavaScript
|
|
- **Data**: Fetches from Blockscout API
|
|
- **Updates**: Real-time via JavaScript fetch
|
|
|
|
---
|
|
|
|
## ✅ Verification
|
|
|
|
### Test Results
|
|
|
|
| Endpoint | Status | Response |
|
|
|----------|--------|----------|
|
|
| `/` | ✅ Working | Landing page (HTTP 200) |
|
|
| `/api/v2/stats` | ✅ Working | JSON stats |
|
|
| `/api?module=block&action=eth_block_number` | ✅ Working | Block number |
|
|
| `/blocks` | ⚠️ 404 | Blockscout route (expected) |
|
|
| `/transactions` | ⚠️ 404 | Blockscout route (expected) |
|
|
|
|
---
|
|
|
|
## 📝 Notes
|
|
|
|
### Why Landing Page?
|
|
- Blockscout web interface routes return 404
|
|
- API endpoints work perfectly
|
|
- Landing page provides user-friendly access
|
|
- Uses API to display real-time data
|
|
|
|
### Future Improvements
|
|
- If Blockscout web interface becomes available, it will automatically work
|
|
- Landing page can be enhanced with more features
|
|
- Can add block/transaction search functionality
|
|
|
|
---
|
|
|
|
## 🎯 Summary
|
|
|
|
**Status**: ✅ **FIXED**
|
|
|
|
**Solution**: Landing page serves as root, displaying network statistics using Blockscout's API
|
|
|
|
**Access**:
|
|
- **Root**: https://explorer.d-bis.org/ - Landing page ✅
|
|
- **API**: All endpoints working ✅
|
|
- **Web Routes**: May work in future if Blockscout web interface initializes
|
|
|
|
**User Experience**:
|
|
- Clean, modern landing page
|
|
- Real-time network statistics
|
|
- Easy access to API endpoints
|
|
- Informative about current status
|
|
|
|
---
|
|
|
|
**Last Updated**: December 23, 2025
|
|
**Next Steps**: Monitor for Blockscout web interface availability, enhance landing page as needed
|
|
|