bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
Project Documentation
Last Updated: 2026-02-18
Status: Active Documentation
Changelog: 2026-02-18: Master docs: MASTER_INDEX 6.4 (08-monitoring peer/RPC runbooks, full-mesh changelog). 2026-02-16: Full docs review — README "See" links fixed; continued review: submodules (SUBMODULE_RELATIONSHIP_MAP, docs submodule section) (05-network, 07-ccip, 09-troubleshooting → own READMEs); Master docs updated; duplicate/archive candidates documented. 2026-02-08: Doc prune/archive (05-network superseded → archive/05-network-superseded; 10 00-meta → archive/00-meta-pruned). 2026-02-06: Master docs consistency (Option B, NETWORK_CONFIGURATION_MASTER, CLOUDFLARE_ROUTING_MASTER, RPC_ENDPOINTS_MASTER, OPERATIONAL_RUNBOOKS, 05-network README). 2026-02-05: MASTER_INDEX v5.8 (archive/00-meta-status, REMAINING_WORK_DETAILED_STEPS, ARCHIVE_CANDIDATES, PLACEHOLDERS); 32 files archived from 00-meta; REMAINING_WORK_DETAILED_STEPS completed; NETWORK_ARCHITECTURE, QUICK_REFERENCE_CARDS, 04-config, ENV_STANDARDIZATION, API_KEYS_REQUIRED, PLACEHOLDERS cross-links and refs updated. Earlier: E2E runbook, RPC 405 fix, CT 2301 resolved.
📚 Master Documentation Index
👉 Start here: MASTER_INDEX.md - Complete documentation index with all documents organized by category, priority, and cross-references.
🚀 Quick Navigation
First Time Here?
- 01-getting-started/README_START_HERE.md - Complete getting started guide
- 01-getting-started/PREREQUISITES.md - System requirements
- MASTER_INDEX.md - Browse all documentation
Common Tasks
📁 Directory Structure
docs/
├── MASTER_INDEX.md # Complete documentation index
├── README.md # This file
├── 00-meta/ # Documentation meta (style, reviews, task list)
│ ├── MASTER_PLAN.md
│ ├── REMAINING_WORK_DETAILED_STEPS.md # Step-by-step for each remaining task; "Can do now"
│ ├── E2E_COMPLETION_TASKS_DETAILED_LIST.md
│ ├── ARCHIVE_CANDIDATES.md # Archive consolidation; Batch 4 (2026-02-20) → archive/00-meta-pruned
│ ├── NEXT_STEPS_INDEX.md # Single entry: next steps by audience and granularity
│ ├── DOCUMENTATION_CONSOLIDATION_PLAN.md # Review/consolidate/prune plan
│ ├── PLACEHOLDERS_AND_REQUIRED_ADDITIONS_LIST.md
│ ├── DOCUMENTATION_STYLE_GUIDE.md
│ ├── DOCUMENTATION_QUALITY_REVIEW.md
│ ├── DOCUMENTATION_ENHANCEMENTS_RECOMMENDATIONS.md
│ ├── DOCUMENTATION_FIX_TASK_LIST.md
│ └── DOCUMENT_RELATIONSHIP_MAP.md
│
├── 01-getting-started/ # Getting started guides
│ ├── README.md
│ ├── README_START_HERE.md
│ └── PREREQUISITES.md
│
├── 02-architecture/ # Core architecture & design
│ ├── README.md
│ ├── NETWORK_ARCHITECTURE.md
│ ├── ORCHESTRATION_DEPLOYMENT_GUIDE.md
│ └── VMID_ALLOCATION_FINAL.md
│
├── 03-deployment/ # Deployment & operations
│ ├── README.md
│ ├── OPERATIONAL_RUNBOOKS.md
│ ├── VALIDATED_SET_DEPLOYMENT_GUIDE.md
│ ├── DEPLOYMENT_STATUS_CONSOLIDATED.md
│ ├── DEPLOYMENT_READINESS.md
│ ├── RUN_DEPLOYMENT.md
│ └── REMOTE_DEPLOYMENT.md
│
├── 04-configuration/ # Configuration & setup
│ ├── README.md
│ ├── MCP_SETUP.md
│ ├── ER605_ROUTER_CONFIGURATION.md
│ ├── cloudflare/
│ │ ├── CLOUDFLARE_ZERO_TRUST_GUIDE.md
│ ├── SECRETS_KEYS_CONFIGURATION.md
│ ├── ENV_STANDARDIZATION.md
│ ├── CREDENTIALS_CONFIGURED.md
│ ├── SSH_SETUP.md
│ └── FINALIZE_TOKEN.md
│
├── 05-network/ # Network infrastructure
│ ├── README.md
│ ├── NETWORK_STATUS.md
│ ├── NGINX_ARCHITECTURE_RPC.md
│ ├── CLOUDFLARE_NGINX_INTEGRATION.md
│ ├── RPC_NODE_TYPES_ARCHITECTURE.md
│ └── RPC_TEMPLATE_TYPES.md
│
├── 06-besu/ # Besu & blockchain
│ ├── README.md
│ ├── BESU_ALLOWLIST_RUNBOOK.md
│ ├── BESU_ALLOWLIST_QUICK_START.md
│ ├── BESU_NODES_FILE_REFERENCE.md
│ ├── BESU_OFFICIAL_REFERENCE.md
│ ├── BESU_OFFICIAL_UPDATES.md
│ ├── QUORUM_GENESIS_TOOL_REVIEW.md
│ ├── VALIDATOR_KEY_DETAILS.md
│ └── COMPREHENSIVE_CONSISTENCY_REVIEW.md
│
├── 07-ccip/ # CCIP & Chainlink
│ ├── README.md
│ └── CCIP_DEPLOYMENT_SPEC.md
│
├── 08-monitoring/ # Monitoring & observability
│ ├── README.md
│ ├── MONITORING_SUMMARY.md
│ └── BLOCK_PRODUCTION_MONITORING.md
│
├── 09-troubleshooting/ # Troubleshooting
│ ├── README.md
│ ├── TROUBLESHOOTING_FAQ.md
│ └── QBFT_TROUBLESHOOTING.md
│
├── 10-best-practices/ # Best practices
│ ├── README.md
│ ├── RECOMMENDATIONS_AND_SUGGESTIONS.md
│ ├── IMPLEMENTATION_CHECKLIST.md
│ ├── BEST_PRACTICES_SUMMARY.md
│ └── QUICK_WINS.md
│
├── 11-references/ # Technical references
│ ├── README.md
│ ├── APT_PACKAGES_CHECKLIST.md
│ ├── PATHS_REFERENCE.md
│ ├── SCRIPT_REVIEW.md
│ └── TEMPLATE_BASE_WORKFLOW.md
│
├── 12-quick-reference/ # Quick references
│ ├── README.md
│ ├── QUICK_REFERENCE.md
│ ├── VALIDATED_SET_QUICK_REFERENCE.md
│ └── QUICK_START_TEMPLATE.md
│
├── gru-m1/ # GRU M1 listing & validation
│ ├── README.md
│ ├── GRU_M1_MASTER_IMPLEMENTATION_PLAN.md
│ └── GRU_M1_REAL_DATA_DOMINANCE_ADDENDUM.md
│
└── archive/ # Historical documents
└── README.md
📖 Documentation Categories
🏗️ Core Architecture
Essential architecture and design documents:
- 02-architecture/NETWORK_ARCHITECTURE.md - Complete network architecture (6×/28 blocks, VLANs, NAT pools)
- 02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md - Enterprise deployment orchestration
- 02-architecture/VMID_ALLOCATION_FINAL.md - VMID allocation registry (11,000 VMIDs)
- 07-ccip/CCIP_DEPLOYMENT_SPEC.md - CCIP fleet deployment specification
See: 02-architecture/README.md
🚀 Deployment & Operations
Deployment guides and operational procedures:
- 02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md - Complete deployment orchestration
- 03-deployment/VALIDATED_SET_DEPLOYMENT_GUIDE.md - Validated set deployment
- 03-deployment/OPERATIONAL_RUNBOOKS.md - All operational procedures
- 03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md - Current deployment status
⚙️ Configuration & Setup
Setup and configuration guides:
- 04-configuration/MCP_SETUP.md - MCP Server configuration
- 04-configuration/ENV_STANDARDIZATION.md - Environment variables
- 04-configuration/SECRETS_KEYS_CONFIGURATION.md - Secrets and keys management
- 04-configuration/ER605_ROUTER_CONFIGURATION.md - Router configuration
- 04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md - Cloudflare Zero Trust
See: 04-configuration/README.md
🌐 Network Infrastructure
Network architecture and configuration:
- 02-architecture/NETWORK_ARCHITECTURE.md - Complete network architecture
- 04-configuration/ER605_ROUTER_CONFIGURATION.md - Router configuration
- 04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md - Cloudflare Zero Trust
- 05-network/NGINX_ARCHITECTURE_RPC.md - NGINX RPC architecture
See: 05-network/README.md
⛓️ Besu & Blockchain
Besu configuration and operations:
- 06-besu/BESU_ALLOWLIST_RUNBOOK.md - Allowlist management
- 06-besu/BESU_ALLOWLIST_QUICK_START.md - Quick start for allowlist
- 06-besu/BESU_NODES_FILE_REFERENCE.md - Nodes file reference
- 09-troubleshooting/QBFT_TROUBLESHOOTING.md - QBFT troubleshooting
See: 06-besu/README.md
🔗 CCIP & Chainlink
CCIP deployment and configuration:
- 07-ccip/CCIP_DEPLOYMENT_SPEC.md - CCIP deployment specification
- 05-network/RPC_TEMPLATE_TYPES.md - RPC template types
See: 07-ccip/README.md
📊 Monitoring & Observability
Monitoring setup and configuration:
- 08-monitoring/MONITORING_SUMMARY.md - Monitoring setup
- 08-monitoring/BLOCK_PRODUCTION_MONITORING.md - Block production monitoring
🔧 Troubleshooting
Troubleshooting guides and FAQs:
- 09-troubleshooting/TROUBLESHOOTING_FAQ.md - Common issues and solutions
- 09-troubleshooting/QBFT_TROUBLESHOOTING.md - QBFT consensus troubleshooting
- 06-besu/BESU_ALLOWLIST_QUICK_START.md - Allowlist troubleshooting
See: 09-troubleshooting/README.md
✅ Best Practices
Best practices and recommendations:
- 10-best-practices/RECOMMENDATIONS_AND_SUGGESTIONS.md - Comprehensive recommendations
- 10-best-practices/IMPLEMENTATION_CHECKLIST.md - Implementation checklist
- 10-best-practices/BEST_PRACTICES_SUMMARY.md - Best practices summary
See: 10-best-practices/README.md
📋 Quick Reference
Essential Documents
| Document | When to Use |
|---|---|
| MASTER_INDEX.md | Browse all documentation |
| 02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md | Deploy the system |
| 02-architecture/NETWORK_ARCHITECTURE.md | Understand network design |
| 03-deployment/OPERATIONAL_RUNBOOKS.md | Run operations |
| 09-troubleshooting/TROUBLESHOOTING_FAQ.md | Solve problems |
Quick Reference Guides
- 12-quick-reference/QUICK_REFERENCE.md - ProxmoxVE scripts quick reference
- 12-quick-reference/VALIDATED_SET_QUICK_REFERENCE.md - Validated set quick reference
- 12-quick-reference/QUICK_START_TEMPLATE.md - Quick start template
🔗 Related Documentation
Project Documentation
- ../README.md - Main project README
- ../PROJECT_STRUCTURE.md - Project structure
Submodule Documentation
- ../mcp-proxmox/README.md - MCP Server documentation
- ../ProxmoxVE/README.md - ProxmoxVE scripts documentation
- ../smom-dbis-138/README.md - Blockchain network / services (Chain 138)
- ../smom-dbis-138-proxmox/README.md - Deployment scripts (if present)
- ../explorer-monorepo/README.md - Blockchain explorer
- ../metamask-integration/README.md - MetaMask integration
- ../dbis_core/README.md - DBIS Core (when present)
- ../the-order/README.md - The Order monorepo (when present)
Full list and relationships: 11-references/SUBMODULE_RELATIONSHIP_MAP.md
📊 Documentation Statistics
- Total Active Documents: 48 (organized in 12 directories)
- Archived Documents: 75+
- Core Architecture: 3 documents
- Deployment Guides: 6 documents
- Troubleshooting Guides: 2 documents
- Best Practices: 4 documents
📝 Document Maintenance
Update Frequency
- Critical Documents: Updated weekly or as changes occur
- Reference Documents: Updated monthly or as needed
- Historical Documents: Archived, not updated
Review Cycle
- Quarterly: Architecture and design documents
- Monthly: Operational runbooks
- As Needed: Troubleshooting and quick references
🆘 Getting Help
Common Questions
- Where do I start? → 01-getting-started/README_START_HERE.md
- How do I deploy? → 02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md
- What's the network architecture? → 02-architecture/NETWORK_ARCHITECTURE.md
- I have a problem → 09-troubleshooting/TROUBLESHOOTING_FAQ.md
- What operations can I run? → 03-deployment/OPERATIONAL_RUNBOOKS.md
Support Resources
- 09-troubleshooting/TROUBLESHOOTING_FAQ.md - Common issues and solutions
- 03-deployment/OPERATIONAL_RUNBOOKS.md - Operational procedures
- MASTER_INDEX.md - Complete documentation index
📅 Recent Updates
- 2026-02-20: Documentation consolidation — NEXT_STEPS_INDEX and DOCUMENTATION_CONSOLIDATION_PLAN added; 12 one-off/dated 00-meta docs archived (Batch 4). See 00-meta/ARCHIVE_CANDIDATES.md, 00-meta/DOCUMENTATION_CONSOLIDATION_PLAN.md.
- 2026-02-16: Full documentation review — README "See" links fixed; Blitzkrieg dated exports archived; DOCUMENTATION_FIX_TASK_LIST reference. (20260216 review docs archived 2026-02-20.)
- 2026-01-31: Scripts: run-contract-verification-with-proxy.sh (orchestrated, starts proxy if needed); run-send-cross-chain.sh (CCIP bridge); deploy-dbis-frontend-to-container.sh (DBIS frontend); load-project-env.sh (shared env). Master docs, CONTRACT_DEPLOYMENT_RUNBOOK, BLOCKSCOUT_FIX_RUNBOOK, scripts/README, PROJECT_STRUCTURE, TODO_TASK_LIST_MASTER updated
- 2026-01-31: Forge Verification Proxy: defaults to BLOCKSCOUT_URL=192.168.11.140:4000; verify-contracts-blockscout.sh defaults to proxy 127.0.0.1:3080; Master docs updated (NETWORK_CONFIGURATION_MASTER, RPC_ENDPOINTS_MASTER, VMID_IP_FIXED_REFERENCE, runbooks)
- 2026-01-31: Documentation fix task list created; docs/README links and tree updated; SEARCH_GUIDE, PROJECT_STRUCTURE, OPERATIONAL_RUNBOOKS, MASTER_INDEX tree fixes
- 2026-01-31: Comprehensive documentation review and MASTER_INDEX meta/00-meta link fixes
- 2025-01-20: Complete documentation consolidation and upgrade
- 2025-01-20: Network architecture upgraded to v2.0
- 2025-01-20: Orchestration deployment guide created
- 2025-01-20: 75+ documents archived, organized structure
- 2025-01-20: Directory structure created with 12 organized categories
Last Updated: 2026-02-20
Maintained By: Infrastructure Team
Review Cycle: Monthly