Files
proxmox/docs/11-references/README_EXPLORER_SUBMODULE.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

2.2 KiB

Explorer Monorepo Submodule

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


The Chain 138 Explorer is now organized as a monorepo and added as a git submodule.

📁 Location

The explorer monorepo is located at: explorer-monorepo/

🚀 Usage

Initial Setup

If cloning the main project fresh, initialize the submodule:

git submodule update --init --recursive

Updating the Explorer

To update the explorer to the latest version:

cd explorer-monorepo
git pull origin main  # or master
cd ..
git add explorer-monorepo
git commit -m "Update explorer submodule"

Making Changes to Explorer

  1. Navigate to the submodule:

    cd explorer-monorepo
    
  2. Make your changes

  3. Commit and push (if using remote repo):

    git add .
    git commit -m "Your change description"
    git push
    
  4. Update the parent project reference:

    cd ..
    git add explorer-monorepo
    git commit -m "Update explorer submodule reference"
    

Deploying Explorer

From the explorer monorepo directory:

cd explorer-monorepo
./scripts/deploy.sh

Or from the root:

cd explorer-monorepo && ./scripts/deploy.sh

📚 Documentation

See explorer-monorepo/README.md and explorer-monorepo/docs/ for detailed documentation.

🔗 Structure

proxmox/
├── explorer-monorepo/          # Explorer submodule
│   ├── frontend/               # Frontend code
│   ├── scripts/                # Deployment scripts
│   ├── docs/                   # Documentation
│   └── ...
├── scripts/                    # Main project scripts
├── docs/                       # Main project docs
└── ...

⚠️ Important Notes

  1. Submodule is Local: Currently, the submodule points to a local path. To use with a remote repository:

    • Create a remote repository for the explorer
    • Update .gitmodules with the remote URL
    • Push the explorer repo to remote
  2. Deployment: The explorer is deployed to 192.168.11.140:/var/www/html/

  3. Backups: The deploy script creates automatic backups before deployment