# Quick Reference Cards **Last Updated:** 2026-02-12 **Document Version:** 1.1 **Status:** Active Documentation --- ## 1. Network Quick Reference | Item | Value | |------|-------| | Management VLAN | 11 (192.168.11.0/24) | | Gateway | 192.168.11.1 | | Proxmox hosts | ml110 192.168.11.10, r630-01 .11, r630-02 .12 | | NPMplus (VMID 10233) | 192.168.11.166, 192.168.11.167 (only .167 in UDM Pro) | | UDM Pro (edge) | 76.53.10.34 | | Public ingress | 76.53.10.36:80/443 → 192.168.11.167:80/443 | | Besu Validator VLAN | 110 (10.110.0.0/24) | | Besu Sentry VLAN | 111 (10.111.0.0/24) | | Besu RPC VLAN | 112 (10.112.0.0/24) | | CCIP Commit VLAN | 132 (10.132.0.0/24) | | CCIP Execute VLAN | 133 (10.133.0.0/24) | | CCIP RMN VLAN | 134 (10.134.0.0/24) | **See:** [NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md), [NETWORK_CONFIGURATION_MASTER.md](../11-references/NETWORK_CONFIGURATION_MASTER.md). --- ## 2. VMID Ranges Quick Reference | Range | Purpose | |-------|---------| | 100–130 | Infrastructure, monitoring | | 1000–1499 | Besu validators | | 1500–1999 | Besu sentries | | 2101, 2201, 2301–2308 | RPC nodes | | 2400–2505 | RPC / NGINX public (2506–2508 destroyed 2026-02-08) | | 5000 | Explorer (Blockscout) | | 7810–7811 | MIM4U | | 10233 | NPMplus LXC | **See:** [VMID_ALLOCATION_FINAL.md](../02-architecture/VMID_ALLOCATION_FINAL.md). --- ## 2.1 CCIP Relay Service (Chain 138 → Mainnet) | Item | Value | |------|-------| | **Host** | r630-01 (192.168.11.11) | | **Path** | `/opt/smom-dbis-138/services/relay` | | **Chain 138 Public RPC** | `RPC_URL_138_PUBLIC` — VMID 2201 (192.168.11.221:8545) | | **Logs** | `ssh root@192.168.11.11 "tail -f /opt/smom-dbis-138/services/relay/relay-service.log"` | **See:** [07-ccip/CCIP_RELAY_DEPLOYMENT.md](../07-ccip/CCIP_RELAY_DEPLOYMENT.md). --- ## 2.2 Chain 138 contract check & deploy | Item | Value | |------|-------| | **On-chain check** | `./scripts/verify/check-contracts-on-chain-138.sh` (uses `RPC_URL_138`, 36 addresses) | | **Deploy (Forge)** | Always use `--with-gas-price 1000000000` on Chain 138 | | **Addresses** | [CONTRACT_ADDRESSES_REFERENCE](../11-references/CONTRACT_ADDRESSES_REFERENCE.md), [ADDRESS_MATRIX_AND_STATUS](../11-references/ADDRESS_MATRIX_AND_STATUS.md) | --- ## 2.3 Token mapping (138↔Mainnet) | Item | Value | |------|-------| | **Source of truth** | [config/token-mapping.json](../../config/token-mapping.json) | | **Relay-supported** | WETH9 only (Mainnet CCIPRelayBridge); LINK mapped for future use | | **When adding tokens** | Update token-mapping.json; optionally [CHAIN138_TOKEN_ADDRESSES](../11-references/CHAIN138_TOKEN_ADDRESSES.md) | **See:** [07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md](../07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md), [07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md](../07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md). --- ## 3. Common Proxmox Commands | Task | Command | |------|---------| | List VMs/containers | `pct list` or `qm list` | | Status | `pct status ` or `qm status ` | | Start/stop | `pct start `, `pct stop ` | | Console | `pct console ` | | Config | `pct config ` | | Cluster status | `pvecm status` | | Storage | `pvesm status` | | Logs (container) | `journalctl -u pve-container@` | **Example with expected output:** ```bash pvecm status ``` Expected: Cluster name, quorum status, node list (e.g. `r630-01`, `r630-02`). ```bash pct list ``` Expected: Table with columns VMID, status, name, type (e.g. `running`, `ubuntu-22`). **See:** [OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md), [QUICK_REFERENCE.md](QUICK_REFERENCE.md). --- ## 3.1 Documentation Index (ALL_IMPROVEMENTS 68–74) | # | Item | Link | |---|------|------| | 68 | Quick reference cards | This document; [QUICK_REFERENCE.md](QUICK_REFERENCE.md), [TROUBLESHOOTING_QUICK_REFERENCE.md](TROUBLESHOOTING_QUICK_REFERENCE.md) | | 69 | Decision trees | [CONFIGURATION_DECISION_TREE.md](../10-best-practices/CONFIGURATION_DECISION_TREE.md) | | 70 | Configuration templates | [ER605](../04-configuration/ER605_ROUTER_CONFIGURATION.md), [RPC_ENDPOINTS_MASTER](../04-configuration/RPC_ENDPOINTS_MASTER.md), [.env.example](../04-configuration/) in services | | 71 | Examples and use cases | [OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md), [TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md) | | 72 | Glossary and terminology | [GLOSSARY.md](../11-references/GLOSSARY.md) | | 73 | Visual elements | [NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md), [MASTER_INDEX.md](../MASTER_INDEX.md) | | 74 | Organization (TOC, cross-links) | [MASTER_INDEX.md](../MASTER_INDEX.md), [docs/README.md](../README.md) | --- ## 4. Troubleshooting Quick Reference | Symptom | First checks | |---------|----------------| | Container won't start | `pct status `, `pct config `, `journalctl -u pve-container@` | | Service down | `systemctl status `, logs | | Network / no connectivity | `ping`, `curl`, DNS, firewall | | Consensus / QBFT | [QBFT_TROUBLESHOOTING.md](../09-troubleshooting/QBFT_TROUBLESHOOTING.md) | | RPC not responding | Check VMID 2400–2505, NGINX, Cloudflare tunnel | | Cloudflare tunnel | [CLOUDFLARE_ROUTING_MASTER.md](../05-network/CLOUDFLARE_ROUTING_MASTER.md) | **See:** [TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md). --- ## 5. Verification & E2E | Task | Command / Location | |------|--------------------| | Full verification (deps + E2E) | `bash scripts/verify/run-full-verification.sh` | | E2E routing only | `bash scripts/verify/verify-end-to-end-routing.sh --profile=public` | | E2E with Option B (RPC via tunnel) | `ACCEPT_ANY_DNS=1 bash scripts/verify/verify-end-to-end-routing.sh --profile=public` | | Dependencies check | `bash scripts/verify/check-dependencies.sh` | | NPMplus RPC fix (from LAN) | `bash scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh` | | NPMplus backup | `bash scripts/verify/backup-npmplus.sh` | | Config & decision trees | [CONFIGURATION_DECISION_TREE.md](../10-best-practices/CONFIGURATION_DECISION_TREE.md) (canonical); [04-configuration version](../04-configuration/CONFIGURATION_DECISION_TREE.md) (mermaid diagram) | | Config templates / examples | [04-configuration/README.md](../04-configuration/README.md), [INGRESS_SOURCE_OF_TRUTH.json](../04-configuration/INGRESS_SOURCE_OF_TRUTH.json) | **CoinGecko / Snap / Explorer (W1-22–W1-24):** CoinGecko listing: [smom-dbis-138/services/token-aggregation/docs/COINGECKO_SUBMISSION.md](../../smom-dbis-138/services/token-aggregation/docs/COINGECKO_SUBMISSION.md). Chain 138 Snap (market data, swap, bridge): `metamask-integration/chain138-snap/`. Explorer (dark mode, network selector, sync): `explorer-monorepo/`. **See:** [E2E_CLOUDFLARE_DOMAINS_RUNBOOK.md](../05-network/E2E_CLOUDFLARE_DOMAINS_RUNBOOK.md), [FULL_PARALLEL_EXECUTION_ORDER.md](../00-meta/FULL_PARALLEL_EXECUTION_ORDER.md). --- ## Related Documentation - [MASTER_INDEX.md](../MASTER_INDEX.md) - Complete documentation index - [VALIDATED_SET_QUICK_REFERENCE.md](VALIDATED_SET_QUICK_REFERENCE.md) - Validated set reference - [QUICK_REFERENCE.md](QUICK_REFERENCE.md) - ProxmoxVE scripts quick reference