Files

Deploy to Phoenix / deploy (push) Has been cancelled

Details

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

2026-03-02 11:37:34 -08:00

7.1 KiB

Raw Blame History

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, 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.

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.

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, ADDRESS_MATRIX_AND_STATUS

2.3 Token mapping (138↔Mainnet)

Item	Value
Source of truth	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

See: 07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.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 <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:

pvecm status

Expected: Cluster name, quorum status, node list (e.g. r630-01, r630-02).

pct list

Expected: Table with columns VMID, status, name, type (e.g. running, ubuntu-22).

See: OPERATIONAL_RUNBOOKS.md, QUICK_REFERENCE.md.

3.1 Documentation Index (ALL_IMPROVEMENTS 68–74)

#	Item	Link
68	Quick reference cards	This document; QUICK_REFERENCE.md, TROUBLESHOOTING_QUICK_REFERENCE.md
69	Decision trees	CONFIGURATION_DECISION_TREE.md
70	Configuration templates	ER605, RPC_ENDPOINTS_MASTER, .env.example in services
71	Examples and use cases	OPERATIONAL_RUNBOOKS.md, TROUBLESHOOTING_FAQ.md
72	Glossary and terminology	GLOSSARY.md
73	Visual elements	NETWORK_ARCHITECTURE.md, MASTER_INDEX.md
74	Organization (TOC, cross-links)	MASTER_INDEX.md, docs/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
RPC not responding	Check VMID 2400–2505, NGINX, Cloudflare tunnel
Cloudflare tunnel	CLOUDFLARE_ROUTING_MASTER.md

See: 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 (canonical); 04-configuration version (mermaid diagram) | | Config templates / examples | 04-configuration/README.md, INGRESS_SOURCE_OF_TRUTH.json |

CoinGecko / Snap / Explorer (W1-22–W1-24): CoinGecko listing: 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, FULL_PARALLEL_EXECUTION_ORDER.md.

MASTER_INDEX.md - Complete documentation index
VALIDATED_SET_QUICK_REFERENCE.md - Validated set reference
QUICK_REFERENCE.md - ProxmoxVE scripts quick reference

7.1 KiB Raw Blame History Unescape Escape