- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
2.9 KiB
Port 4000 Implementation - COMPLETE ✅
Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation
Date: 2026-01-18
Status: ✅ IMPLEMENTATION COMPLETE
Implementation Summary
The port 4000 direct route for explorer.d-bis.org has been successfully implemented and verified.
✅ Verification Results
Port 4000 Direct Access
curl -I http://192.168.11.140:4000/api/v2/stats
Result: ✅ HTTP 200
Public Domain Access
curl -I https://explorer.d-bis.org/api/v2/stats
Result: ✅ HTTP 200
API Response
The Blockscout API is responding correctly with valid JSON data including:
- Total blocks: 1,048,760
- Total transactions: 13,156
- Network statistics
Implementation Steps Completed
✅ Step 1: Check Blockscout service status and configuration
✅ Step 2: Fix Blockscout to listen on 0.0.0.0:4000
✅ Step 3: Verify Blockscout is accessible on port 4000
✅ Step 4: Update NPMplus configuration
✅ Step 5: Verify public domain works
Current Configuration
Architecture
Internet → NPMplus → 192.168.11.140:4000 (Blockscout directly)
Old Route: NPMplus → 192.168.11.140:80 (nginx) → 127.0.0.1:4000 (Blockscout)
New Route: NPMplus → 192.168.11.140:4000 (Blockscout directly) ✅
Benefits Achieved
✅ Removed nginx proxy layer (one less hop)
✅ Reduced latency
✅ Fewer points of failure
✅ Simpler architecture
✅ Fixed 502 Bad Gateway errors
Files & Scripts Created
Scripts
scripts/diagnose-blockscout-port-4000.sh- Diagnostic toolscripts/fix-blockscout-port-4000-complete.sh- Fix scriptscripts/complete-port-4000-implementation.sh- Master implementation scriptscripts/apply-direct-blockscout-route.sh- NPMplus update script
Documentation
docs/04-configuration/PORT_4000_INVESTIGATION_REPORT.md- Investigationdocs/04-configuration/PORT_4000_IMPLEMENTATION_GUIDE.md- Implementation guidedocs/04-configuration/PORT_4000_IMPLEMENTATION_STATUS.md- Status reportdocs/04-configuration/PORT_4000_IMPLEMENTATION_COMPLETE.md- This file
Test Commands
Verify Direct Access
curl -I http://192.168.11.140:4000/api/v2/stats
Verify Public Domain
curl -I https://explorer.d-bis.org/api/v2/stats
Check API Response
curl -s https://explorer.d-bis.org/api/v2/stats | jq .
Conclusion
The direct route implementation is complete and operational. The explorer is now accessible via both:
- Direct Network Access:
http://192.168.11.140:4000 - Public Domain:
https://explorer.d-bis.org
Both routes are working correctly and returning HTTP 200 responses.
Implementation Date: 2026-01-18
Status: ✅ COMPLETE
Verified By: Implementation Scripts & Manual Testing