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)
|
||
|
|
|