2026-02-12 15:46:57 -08:00
|
|
|
|
# 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` |
|
2026-02-21 15:46:06 -08:00
|
|
|
|
| **Chain 138 Public RPC** | `RPC_URL_138_PUBLIC` — VMID 2201 (192.168.11.221:8545) |
|
2026-02-12 15:46:57 -08:00
|
|
|
|
| **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 |
|
|
|
|
|
|
|------|-------|
|
2026-02-21 15:46:06 -08:00
|
|
|
|
| **On-chain check** | `./scripts/verify/check-contracts-on-chain-138.sh` (uses `RPC_URL_138`, 36 addresses) |
|
2026-02-12 15:46:57 -08:00
|
|
|
|
| **Deploy (Forge)** | Always use `--with-gas-price 1000000000` on Chain 138 |
|
2026-03-02 11:37:34 -08:00
|
|
|
|
| **Addresses** | [CONTRACT_ADDRESSES_REFERENCE](../11-references/CONTRACT_ADDRESSES_REFERENCE.md), [ADDRESS_MATRIX_AND_STATUS](../11-references/ADDRESS_MATRIX_AND_STATUS.md) |
|
2026-02-12 15:46:57 -08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-02-21 15:46:06 -08:00
|
|
|
|
## 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).
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-02-12 15:46:57 -08:00
|
|
|
|
## 3. Common Proxmox Commands
|
|
|
|
|
|
|
|
|
|
|
|
| Task | Command |
|
|
|
|
|
|
|------|---------|
|
|
|
|
|
|
| List VMs/containers | `pct list` or `qm list` |
|
|
|
|
|
|
| Status | `pct status <vmid>` or `qm status <vmid>` |
|
|
|
|
|
|
| Start/stop | `pct start <vmid>`, `pct stop <vmid>` |
|
|
|
|
|
|
| Console | `pct console <vmid>` |
|
|
|
|
|
|
| Config | `pct config <vmid>` |
|
|
|
|
|
|
| Cluster status | `pvecm status` |
|
|
|
|
|
|
| Storage | `pvesm status` |
|
|
|
|
|
|
| Logs (container) | `journalctl -u pve-container@<vmid>` |
|
|
|
|
|
|
|
|
|
|
|
|
**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 <vmid>`, `pct config <vmid>`, `journalctl -u pve-container@<vmid>` |
|
|
|
|
|
|
| Service down | `systemctl status <service>`, 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` |
|
|
|
|
|
|
| E2E with Option B (RPC via tunnel) | `ACCEPT_ANY_DNS=1 bash scripts/verify/verify-end-to-end-routing.sh` |
|
|
|
|
|
|
| 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
|
