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>

docs/01-getting-started/CHAIN138_QUICK_START.md

@@ -1,5 +1,11 @@
 # ChainID 138 Configuration - Quick Start Guide
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 **Quick reference for configuring Besu nodes for ChainID 138**
 
 ---
@@ -146,8 +152,8 @@ pct exec <VMID> -- chmod 644 /var/lib/besu/permissions/permissioned-nodes.json
 
 ## 📖 Full Documentation
 
-- **Complete Guide:** [CHAIN138_BESU_CONFIGURATION.md](CHAIN138_BESU_CONFIGURATION.md)
-- **Summary:** [CHAIN138_CONFIGURATION_SUMMARY.md](CHAIN138_CONFIGURATION_SUMMARY.md)
+- **Complete Guide:** [CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md)
+- **Summary:** [CHAIN138_CONFIGURATION_SUMMARY.md](../archive/configuration/CHAIN138_CONFIGURATION_SUMMARY.md)
 
 ---
 
@@ -168,5 +174,5 @@ If you encounter issues:
 
 1. Check logs: `pct exec <VMID> -- journalctl -u besu*.service -n 50`
 2. Run verification: `./scripts/verify-chain138-config.sh`
-3. Review documentation: `docs/CHAIN138_BESU_CONFIGURATION.md`
+3. Review documentation: [CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md)
 

docs/01-getting-started/LIST_VMS_QUICK_START.md

@@ -1,5 +1,11 @@
 # Quick Start: List All Proxmox VMs
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 ## Quick Start (Python Script)
 
 ```bash

docs/01-getting-started/LIST_VMS_README.md

@@ -1,5 +1,11 @@
 # List Proxmox VMs Scripts
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 Two scripts to list all Proxmox VMs with VMID, Name, IP Address, FQDN, and Description.
 
 ## Scripts

docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md

@@ -1,5 +1,11 @@
 # MetaMask Quick Start Guide - ChainID 138
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 **Date**: $(date)  
 **Network**: SMOM-DBIS-138 (ChainID 138)  
 **Purpose**: Get started with MetaMask on ChainID 138 in 5 minutes
@@ -68,7 +74,7 @@ await window.ethereum.request({
    - **Decimals of Precision**: `18`
 3. Click "Add Custom Token"
 
-**Note**: If you see incorrect balances (like "6,000,000,000.0T"), ensure decimals are set to 18. See [WETH9 Display Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md) for details.
+**Note**: If you see incorrect balances (like "6,000,000,000.0T"), ensure decimals are set to 18. See [WETH9 Display Fix](../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md#token-balance-display-incorrect) for details.
 
 ---
 
@@ -210,7 +216,7 @@ getPrice();
 **Solution**: 
 - Remove token from MetaMask
 - Re-import with decimals set to `18`
-- See [WETH9 Display Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md) for details
+- See [WETH9 Display Fix](../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md#token-balance-display-incorrect) for details
 
 ### Price Feed Not Updating
 
@@ -235,10 +241,8 @@ getPrice();
 
 ## 📚 Additional Resources
 
-- [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md)
-- [Oracle Integration Guide](./METAMASK_ORACLE_INTEGRATION.md)
-- [WETH9 Display Bug Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md)
-- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)
+- [MetaMask Troubleshooting Guide](../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md) (integration, Oracle, WETH9 fixes)
+- [Contract Addresses Reference](../11-references/CONTRACT_ADDRESSES_REFERENCE.md)
 
 ---
 

docs/01-getting-started/PREREQUISITES.md

@@ -1,5 +1,11 @@
 # Prerequisites and Setup Requirements
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 Complete list of prerequisites and setup steps for the Proxmox workspace.
 
 ## System Prerequisites
@@ -21,7 +27,22 @@ Complete list of prerequisites and setup steps for the Proxmox workspace.
    - Check: `git --version`
    - Install: Usually pre-installed on Linux/Mac
 
-### Optional but Recommended
+### Optional but recommended (automation / jump host)
+
+Useful when running `scripts/push-templates-to-proxmox.sh`, verification, or SSH-based automation:
+
+- **sshpass** — Non-interactive SSH with password when keys are not set (optional; prefer SSH keys).
+- **rsync** — Efficient file sync for template push (script falls back to scp if missing).
+- **dnsutils**, **iproute2** — `dig`, `ss` for DNS/socket checks.
+- **screen** or **tmux** — Long-running deployment sessions.
+- **htop** — Process monitoring.
+- **shellcheck** — For `scripts/verify/run-shellcheck.sh`.
+- **parallel** — GNU parallel for batch operations.
+
+**Install (Debian/Ubuntu):** `sudo apt install -y sshpass rsync dnsutils iproute2 screen tmux htop shellcheck parallel`  
+**Full list:** [11-references/APT_PACKAGES_CHECKLIST.md](../11-references/APT_PACKAGES_CHECKLIST.md) § Automation / jump host.
+
+### Optional but recommended (deployment)
 
 - **Proxmox VE** (if deploying containers)
   - Version: 7.0+ or 8.4+/9.0+

docs/01-getting-started/README.md

@@ -1,5 +1,11 @@
 # Getting Started
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 This directory contains documentation for first-time setup and getting started with the project.
 
 ## Documents

docs/01-getting-started/README_START_HERE.md

@@ -1,5 +1,11 @@
 # 🚀 Quick Start Guide
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 Your Proxmox workspace is **fully configured and ready to use**!
 
 ## ✅ What's Configured
@@ -79,10 +85,9 @@ If you need to create or modify VMs:
 ## 📖 Documentation
 
 - **Main README**: [README.md](README.md)
-- **MCP Setup Guide**: [docs/MCP_SETUP.md](/docs/04-configuration/MCP_SETUP.md)
-- **Prerequisites**: [docs/PREREQUISITES.md](PREREQUISITES.md)
-- **Setup Status**: [SETUP_STATUS.md](SETUP_STATUS.md)
-- **Complete Setup**: [SETUP_COMPLETE_FINAL.md](SETUP_COMPLETE_FINAL.md)
+- **MCP Setup Guide**: [MCP_SETUP.md](../04-configuration/MCP_SETUP.md)
+- **Prerequisites**: [PREREQUISITES.md](PREREQUISITES.md)
+- **Documentation index**: [MASTER_INDEX.md](../MASTER_INDEX.md)
 
 ## 🛠️ Useful Commands
 

docs/01-getting-started/REMINING_STEPS_QUICK_REFERENCE.md

@@ -1,5 +1,11 @@
 # Remaining Steps - Quick Reference
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 ## ✅ Completed
 - All contracts deployed (7/7) ✅
 - All contracts have bytecode ✅

docs/01-getting-started/THIRDWEB_RPC_CLOUDFLARE_QUICKSTART.md

@@ -1,5 +1,11 @@
 # ThirdWeb RPC (VMID 2400) - Cloudflare Tunnel Quick Start
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 **Status:** Ready to Execute  
 **VMID:** 2400  
 **IP:** 192.168.11.240  

docs/01-getting-started/THIRDWEB_RPC_NEXT_STEPS.md

@@ -1,5 +1,11 @@
 # ThirdWeb RPC Nodes - Complete Next Steps
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 ## Overview
 This document lists all next steps to complete the ThirdWeb RPC node setup, from deployment to integration.
 

docs/01-getting-started/THIRDWEB_RPC_QUICKSTART.md

@@ -1,5 +1,11 @@
 # ThirdWeb RPC Nodes - Quick Start
 
+**Last Updated:** 2026-01-31  
+**Document Version:** 1.0  
+**Status:** Active Documentation
+
+---
+
 ## Summary
 
 Setup complete! Ready to deploy ThirdWeb RPC node LXC containers.