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.
166 lines
4.4 KiB
Markdown
166 lines
4.4 KiB
Markdown
# Blockscout Full Explorer Interface Enabled
|
|
|
|
**Date**: December 23, 2025
|
|
**Container**: VMID 5000 on pve2 (192.168.11.140)
|
|
**Domain**: https://explorer.d-bis.org
|
|
**Status**: ✅ **FULL EXPLORER ENABLED**
|
|
|
|
---
|
|
|
|
## ✅ Changes Made
|
|
|
|
### 1. Enabled Indexer ✅
|
|
- **DISABLE_INDEXER**: Changed from `true` to `false` in docker-compose.yml
|
|
- **Container**: Restarted to apply changes
|
|
- **Status**: Indexer is now active and will start indexing blockchain data
|
|
|
|
---
|
|
|
|
## 📊 Current Configuration
|
|
|
|
### Blockscout Environment Variables
|
|
- **DISABLE_INDEXER**: `false` ✅ (Indexer enabled)
|
|
- **DISABLE_WEBAPP**: `false` (Webapp enabled)
|
|
- **Chain ID**: 138
|
|
- **RPC URL**: http://192.168.11.250:8545
|
|
- **WS URL**: ws://192.168.11.250:8546
|
|
- **Host**: explorer.d-bis.org
|
|
- **Protocol**: https
|
|
|
|
---
|
|
|
|
## ⏳ Indexing Process
|
|
|
|
The Blockscout indexer will now:
|
|
1. ✅ Connect to the RPC node at `192.168.11.250:8545`
|
|
2. ⏳ Start fetching and indexing blocks from the blockchain
|
|
3. ⏳ Import transactions, addresses, and logs
|
|
4. ⏳ Build the explorer database with blockchain data
|
|
|
|
**Initial indexing can take:**
|
|
- **First few blocks**: 1-5 minutes
|
|
- **Full chain sync**: Hours to days (depending on chain length)
|
|
|
|
---
|
|
|
|
## 🔍 Monitoring Indexing Progress
|
|
|
|
### Check Indexer Status
|
|
|
|
```bash
|
|
# View recent logs for indexing activity
|
|
docker logs --tail 100 blockscout | grep -iE '(indexing|fetcher|importing|block|new block)'
|
|
|
|
# Check for indexing errors
|
|
docker logs --tail 100 blockscout | grep -iE '(error|failed|timeout)' | tail -20
|
|
|
|
# Monitor real-time indexing
|
|
docker logs -f blockscout | grep -iE '(indexing|fetcher|importing|block)'
|
|
|
|
# Check container status
|
|
docker ps | grep blockscout
|
|
```
|
|
|
|
### Check Database Progress
|
|
|
|
```bash
|
|
# Count indexed blocks
|
|
docker exec blockscout-postgres psql -U blockscout -d blockscout -t -c "SELECT count(*) FROM blocks;"
|
|
|
|
# Count indexed transactions
|
|
docker exec blockscout-postgres psql -U blockscout -d blockscout -t -c "SELECT count(*) FROM transactions;"
|
|
|
|
# Count indexed addresses
|
|
docker exec blockscout-postgres psql -U blockscout -d blockscout -t -c "SELECT count(*) FROM addresses;"
|
|
|
|
# Check latest block number indexed
|
|
docker exec blockscout-postgres psql -U blockscout -d blockscout -t -c "SELECT max(number) FROM blocks;"
|
|
```
|
|
|
|
---
|
|
|
|
## 🌐 Accessing the Explorer
|
|
|
|
Once indexing begins (may take a few minutes), the explorer will be accessible at:
|
|
|
|
- **Web Interface**: https://explorer.d-bis.org
|
|
- **API**: https://explorer.d-bis.org/api/v2/status
|
|
|
|
### Expected Behavior
|
|
|
|
**Before indexing starts:**
|
|
- Web interface may show 404 or empty state
|
|
- API endpoints will respond (may require parameters)
|
|
|
|
**After indexing begins:**
|
|
- Web interface will show blockchain data
|
|
- Blocks, transactions, and addresses will be visible
|
|
- Search functionality will work
|
|
- Real-time updates as new blocks are indexed
|
|
|
|
---
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
### Indexer Not Starting
|
|
|
|
If the indexer doesn't start:
|
|
|
|
1. **Check RPC Connection**:
|
|
```bash
|
|
curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://192.168.11.250:8545
|
|
```
|
|
|
|
2. **Check Logs**:
|
|
```bash
|
|
docker logs --tail 100 blockscout | grep -iE '(error|failed|connection|rpc)'
|
|
```
|
|
|
|
3. **Verify Environment Variables**:
|
|
```bash
|
|
docker exec blockscout env | grep -E '(INDEXER|RPC|CHAIN)'
|
|
```
|
|
|
|
### Slow Indexing
|
|
|
|
- **Normal**: Initial indexing can be slow
|
|
- **Check RPC node**: Ensure it's responding quickly
|
|
- **Database performance**: Monitor PostgreSQL resource usage
|
|
- **Network**: Verify network connectivity to RPC node
|
|
|
|
---
|
|
|
|
## ✅ Verification Checklist
|
|
|
|
- [x] DISABLE_INDEXER set to `false`
|
|
- [x] Container restarted
|
|
- [x] Indexer starting (check logs)
|
|
- [ ] Blocks being indexed (monitor progress)
|
|
- [ ] Web interface accessible
|
|
- [ ] Data visible in explorer
|
|
|
|
---
|
|
|
|
## 📝 Next Steps
|
|
|
|
1. **Monitor Logs**: Watch for indexing progress
|
|
```bash
|
|
docker logs -f blockscout
|
|
```
|
|
|
|
2. **Wait for Initial Blocks**: Allow 5-10 minutes for first blocks to index
|
|
|
|
3. **Test Web Interface**: Visit https://explorer.d-bis.org
|
|
|
|
4. **Verify Data**: Check that blocks, transactions, and addresses are visible
|
|
|
|
---
|
|
|
|
## 🎉 Summary
|
|
|
|
The full Blockscout explorer interface is now enabled! The indexer will start importing blockchain data, and once the first blocks are indexed, the web interface will be fully functional at **https://explorer.d-bis.org**.
|
|
|
|
**Status**: ✅ Indexer enabled and starting
|
|
**Next**: Wait for blocks to be indexed (check logs for progress)
|
|
|