Files
proxmox/docs/04-configuration/PORT_4000_IMPLEMENTATION_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- 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>
2026-02-12 15:46:57 -08:00

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 tool
  • scripts/fix-blockscout-port-4000-complete.sh - Fix script
  • scripts/complete-port-4000-implementation.sh - Master implementation script
  • scripts/apply-direct-blockscout-route.sh - NPMplus update script

Documentation

  • docs/04-configuration/PORT_4000_INVESTIGATION_REPORT.md - Investigation
  • docs/04-configuration/PORT_4000_IMPLEMENTATION_GUIDE.md - Implementation guide
  • docs/04-configuration/PORT_4000_IMPLEMENTATION_STATUS.md - Status report
  • docs/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:

  1. Direct Network Access: http://192.168.11.140:4000
  2. 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