docs/02-architecture/README.md

# Architecture & Design

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

This directory contains core architecture and design documents.

## Documents

- **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** ⭐⭐⭐ - Complete network architecture with 6×/28 blocks, VLANs, NAT pools
- **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** ⭐⭐⭐ - Enterprise-grade deployment orchestration guide
- **[VMID_ALLOCATION_FINAL.md](VMID_ALLOCATION_FINAL.md)** ⭐⭐⭐ - Complete VMID allocation registry (11,000 VMIDs)

## Quick Reference

**Network Architecture:**
- 6× /28 public IP blocks with role-based NAT pools
- 19 VLANs with complete subnet plan
- Hardware role assignments (2× ER605, 3× ES216G, 1× ML110, 4× R630)

**Deployment Orchestration:**
- Phase-by-phase deployment workflow
- CCIP fleet deployment matrix (41-43 nodes)
- Proxmox cluster orchestration

## Related Documentation

- **[../03-deployment/](../03-deployment/)** - Deployment guides
- **[../04-configuration/](../04-configuration/)** - Configuration guides
- **[../05-network/](../05-network/)** - Network infrastructure details
- **[../07-ccip/](../07-ccip/)** - CCIP deployment specification
-												Refactor code for improved readability and performance

											
										
										
											2025-12-21 22:32:09 -08:00
+								# Architecture & Design
-												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
+								**Last Updated:** 2026-01-31
 								**Document Version:** 1.0
 								**Status:** Active Documentation
 								---
-												Refactor code for improved readability and performance

											
										
										
											2025-12-21 22:32:09 -08:00
+								This directory contains core architecture and design documents.
 								## Documents
 								- **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** ⭐⭐⭐ - Complete network architecture with 6×/28 blocks, VLANs, NAT pools
 								- **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** ⭐⭐⭐ - Enterprise-grade deployment orchestration guide
 								- **[VMID_ALLOCATION_FINAL.md](VMID_ALLOCATION_FINAL.md)** ⭐⭐⭐ - Complete VMID allocation registry (11,000 VMIDs)
 								## Quick Reference
 								**Network Architecture:**
 								- 6× /28 public IP blocks with role-based NAT pools
 								- 19 VLANs with complete subnet plan
 								- Hardware role assignments (2× ER605, 3× ES216G, 1× ML110, 4× R630)
 								**Deployment Orchestration:**
 								- Phase-by-phase deployment workflow
 								- CCIP fleet deployment matrix (41-43 nodes)
 								- Proxmox cluster orchestration
 								## Related Documentation
 								- **[../03-deployment/](../03-deployment/)** - Deployment guides
 								- **[../04-configuration/](../04-configuration/)** - Configuration guides
 								- **[../05-network/](../05-network/)** - Network infrastructure details
 								- **[../07-ccip/](../07-ccip/)** - CCIP deployment specification