d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details

Browse Source 
- 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>
This commit is contained in:
defiQUG
2026-02-12 15:46:57 -08:00
parent cc8dcaf356
commit fbda1b4beb
5114 changed files with 498901 additions and 4567 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/12-quick-reference/QUICK_REFERENCE.md
View File

@@ -1,5 +1,24 @@
# ProxmoxVE Scripts - Quick Reference
**Last Updated:** 2026-02-05
**Document Version:** 1.0
**Status:** Active Documentation
---
## Parallel run & verification
| What | Where |
|------|--------|
| Execution order (Wave 0→1→2→3) | [FULL_PARALLEL_EXECUTION_ORDER.md](../00-meta/FULL_PARALLEL_EXECUTION_ORDER.md) |
| Wave 1 task status | [WAVE1_COMPLETION_SUMMARY.md](../00-meta/WAVE1_COMPLETION_SUMMARY.md) |
| Wave 2/3 operator checklist | [WAVE2_WAVE3_OPERATOR_CHECKLIST.md](../00-meta/WAVE2_WAVE3_OPERATOR_CHECKLIST.md) |
| Run log | [FULL_PARALLEL_RUN_LOG.md](../00-meta/FULL_PARALLEL_RUN_LOG.md) |
| Full verification | `bash scripts/verify/run-full-verification.sh` |
| E2E routing only | `bash scripts/verify/verify-end-to-end-routing.sh` |
---
## Repository Setup
```bash

152
docs/12-quick-reference/QUICK_REFERENCE_CARDS.md Normal file
View File

@@ -0,0 +1,152 @@
# 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 RPC** | 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 http://192.168.11.211:8545` (36 addresses) |
| **Deploy (Forge)** | Always use `--with-gas-price 1000000000` on Chain 138 |
| **Addresses** | [CONTRACT_ADDRESSES_REFERENCE](../11-references/CONTRACT_ADDRESSES_REFERENCE.md), [CONTRACT_INVENTORY_AND_VERIFICATION](../11-references/CONTRACT_INVENTORY_AND_VERIFICATION.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:**
```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

6
docs/12-quick-reference/QUICK_START_TEMPLATE.md
View File

@@ -1,5 +1,11 @@
# Quick Start: Using Template as Base for All LXCs
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
## Step 1: Choose Your Base Template
Run the template script to see available options:

10
docs/12-quick-reference/README.md
View File

@@ -1,13 +1,17 @@
# Quick Reference
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
This directory contains quick reference guides for common tasks.
## Documents
### Quick Reference Cards
- **[NETWORK_QUICK_REFERENCE.md](NETWORK_QUICK_REFERENCE.md)** ⭐⭐⭐ - Network configuration quick reference (VLANs, IPs, gateways)
- **[VMID_QUICK_REFERENCE.md](VMID_QUICK_REFERENCE.md)** ⭐⭐⭐ - VMID allocation quick reference (ranges, assignments, lookup)
- **[COMMANDS_QUICK_REFERENCE.md](COMMANDS_QUICK_REFERENCE.md)** ⭐⭐⭐ - Common Proxmox commands quick reference
- **[QUICK_REFERENCE_CARDS.md](QUICK_REFERENCE_CARDS.md)** ⭐⭐⭐ - Network, VMID, commands, and troubleshooting quick reference cards
- **[TROUBLESHOOTING_QUICK_REFERENCE.md](TROUBLESHOOTING_QUICK_REFERENCE.md)** ⭐⭐⭐ - Common issues and solutions quick reference
### Other References

2
docs/12-quick-reference/TROUBLESHOOTING_QUICK_REFERENCE.md
View File

@@ -188,7 +188,7 @@ pct restart 102
## Related Documentation
- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Complete troubleshooting FAQ
- **[../09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md](../09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md)** ⭐⭐ - Troubleshooting decision tree
- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐ - Troubleshooting FAQ and flow
- **[../03-deployment/OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** ⭐⭐ - Operational runbooks
---

6
docs/12-quick-reference/VALIDATED_SET_QUICK_REFERENCE.md
View File

@@ -1,5 +1,11 @@
# Validated Set Deployment - Quick Reference
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
## One-Command Deployment
```bash