Files
proxmox/docs/archive/completion/CHAIN138_COMPLETE_FILE_LIST.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
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>
2026-02-12 15:46:57 -08:00

5.0 KiB

ChainID 138 Configuration - Complete File List

All files created and updated for ChainID 138 Besu node configuration


📝 New Files Created

Scripts (3 files)

  1. scripts/configure-besu-chain138-nodes.sh (18K)

    • Main configuration script
    • Collects enodes, generates config files, deploys to all nodes
    • Configures discovery settings
    • Restarts Besu services
  2. scripts/setup-new-chain138-containers.sh (4.9K)

    • Quick setup for new containers (1504, 2503)
    • Runs main configuration and verifies setup
  3. scripts/verify-chain138-config.sh (8.1K)

    • Verification script
    • Checks configuration files exist
    • Verifies discovery settings
    • Checks peer connections

Configuration Templates (2 files)

  1. smom-dbis-138/config/config-rpc-4.toml (1.8K)

    • Besu configuration for VMID 2503 (besu-rpc-4)
    • Discovery disabled (prevents connection to Ethereum mainnet while reporting chainID 0x1 to MetaMask for wallet compatibility)
    • Correct file paths configured
  2. smom-dbis-138-proxmox/templates/besu-configs/config-rpc-4.toml (1.8K)

    • Template version for Proxmox deployment

Documentation (3 files)

  1. docs/CHAIN138_BESU_CONFIGURATION.md (10K)

    • Comprehensive configuration guide
    • Node allocation and access matrix
    • Deployment process (automated and manual)
    • Verification steps
    • Troubleshooting guide
  2. docs/CHAIN138_CONFIGURATION_SUMMARY.md (6.3K)

    • Quick reference summary
    • Overview of created files
    • Node allocation table
    • Quick start guide
  3. docs/CHAIN138_QUICK_START.md (3.7K)

    • Quick start guide
    • Step-by-step instructions
    • Troubleshooting tips
    • Scripts reference

🔄 Updated Files

Configuration Templates (5 files)

  1. smom-dbis-138/config/config-rpc-core.toml

    • Updated paths to /var/lib/besu/static-nodes.json
    • Updated paths to /var/lib/besu/permissions/permissioned-nodes.json
  2. smom-dbis-138/config/config-rpc-perm.toml

    • Updated paths to /var/lib/besu/static-nodes.json
    • Updated paths to /var/lib/besu/permissions/permissioned-nodes.json
  3. smom-dbis-138-proxmox/templates/besu-configs/config-rpc-core.toml

    • Updated paths to use JSON format for permissioned nodes
  4. smom-dbis-138-proxmox/templates/besu-configs/config-rpc.toml

    • Updated paths to /var/lib/besu/static-nodes.json
    • Updated paths to /var/lib/besu/permissions/permissioned-nodes.json
  5. smom-dbis-138-proxmox/templates/besu-configs/config-sentry.toml

    • Updated paths to /var/lib/besu/static-nodes.json
    • Updated paths to /var/lib/besu/permissions/permissioned-nodes.json

📊 Summary

Total Files

  • New Files: 8

    • Scripts: 3
    • Configuration: 2
    • Documentation: 3
  • Updated Files: 5

    • Configuration templates: 5

File Sizes

  • Scripts: ~31K total
  • Configuration: ~3.6K total
  • Documentation: ~20K total

🎯 Key Features

Scripts

Automated Configuration

  • Collects enodes from all nodes
  • Generates configuration files
  • Deploys to all containers
  • Configures discovery settings
  • Restarts services

Verification

  • Checks file existence
  • Verifies discovery settings
  • Tests peer connections
  • Provides detailed reports

Configuration

Standardized Paths

  • /var/lib/besu/static-nodes.json
  • /var/lib/besu/permissions/permissioned-nodes.json

Discovery Control

  • Disabled for RPC nodes that report chainID 0x1 to MetaMask for wallet compatibility (prevents actual connection to Ethereum mainnet)
  • Enabled for all other nodes (with permissioning)

Documentation

Comprehensive Guides

  • Complete configuration guide
  • Quick start instructions
  • Troubleshooting tips
  • Reference documentation

🚀 Usage

Initial Configuration

# Run main configuration
./scripts/configure-besu-chain138-nodes.sh

# Verify configuration
./scripts/verify-chain138-config.sh

Quick Setup for New Containers

./scripts/setup-new-chain138-containers.sh

📍 File Locations

Scripts

/home/intlc/projects/proxmox/scripts/
├── configure-besu-chain138-nodes.sh
├── setup-new-chain138-containers.sh
└── verify-chain138-config.sh

Configuration

/home/intlc/projects/proxmox/smom-dbis-138/config/
└── config-rpc-4.toml

/home/intlc/projects/proxmox/smom-dbis-138-proxmox/templates/besu-configs/
└── config-rpc-4.toml

Documentation

/home/intlc/projects/proxmox/docs/
├── CHAIN138_BESU_CONFIGURATION.md
├── CHAIN138_CONFIGURATION_SUMMARY.md
├── CHAIN138_QUICK_START.md
└── CHAIN138_COMPLETE_FILE_LIST.md (this file)

Status

All files are:

  • Created and validated
  • Syntax checked
  • Ready for production use
  • Documented