bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
2.5 KiB
2.5 KiB
Master Documentation Index — Source of Truth
Last Updated: 2026-02-12
Purpose: Treat these documents as the Bible for URL, VMID, and port mappings. When fixing placeholders or cleaning up projects, use them as the verifiably correct source.
Domain → VMID:port and infrastructure
| Document | Scope | Use when |
|---|---|---|
| ALL_VMIDS_ENDPOINTS.md | Complete VMID, IP, hostname, port, and public domain mapping | Resolving which VMID:port a domain or service must use; checking that only explorer points to Blockscout. |
| RPC_ENDPOINTS_MASTER.md | RPC URLs, public domain → NPMplus backend, canonical .env values | Setting RPC_* in .env, configuring NPMplus proxy hosts, Chain 138 / ThirdWeb / DBIS / Sankofa / MIM4U. |
| DNS_NPMPLUS_VM_COMPREHENSIVE_ARCHITECTURE.md | DNS → NPMplus → VM table | Aligning NPMplus backend targets with VMIDs; must match ALL_VMIDS and RPC_ENDPOINTS_MASTER. |
Critical rule: Explorer vs other services
Only the Explorer (Blockscout) should be pointed at 192.168.11.140 (VMID 5000):
explorer.d-bis.org→ 192.168.11.140:80 (web), :4000 (API) ✅
All other domains must point to their correct VMID and port (see the master docs above). Examples of incorrect routing (do not use):
sankofa.nexus,phoenix.sankofa.nexus→192.168.11.140❌- Correct:
sankofa.nexus→ 192.168.11.51:3000 (VMID 7801),phoenix.sankofa.nexus→ 192.168.11.50:4000 (VMID 7800).
When reviewing or fixing documentation and NPMplus config:
- Resolve every domain from ALL_VMIDS_ENDPOINTS or RPC_ENDPOINTS_MASTER.
- Update any doc or script that points a non-explorer domain to 192.168.11.140.
- Ensure placeholder lists (e.g. PLACEHOLDERS_AND_COMPLETION_MASTER_LIST.md, GAPS_AND_RECOMMENDATIONS_CONSOLIDATED.md) reference these master docs and the correct targets.
Related
- PLACEHOLDERS_AND_COMPLETION_MASTER_LIST.md — What to complete for each placeholder
- REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md — Remaining tasks and recommendations
- NETWORK_CONFIGURATION_MASTER.md — Network and IP reference