# Chain 138 Wallet Repositories — Canonical Layout

**Last Updated:** 2026-02-12  
**Status:** All wallet repos live in `~/projects/` (sibling to `proxmox`). All items **Yes** / **Completed** for our side.

---

## Canonical location: `~/projects/`

All four wallet-related repositories are **separate** repos and live **individually** under the **projects** directory (sibling to this `proxmox` workspace):

| Repository | Path | Clone URL | Status |
|------------|------|-----------|--------|
| **metamask-integration** | `~/projects/metamask-integration` | `git@github.com:Defi-Oracle-Meta-Blockchain/metamask-integration.git` | ✅ Yes / Completed |
| **LedgerLive** | `~/projects/LedgerLive` | `https://github.com/bis-innovations/LedgerLive.git` | ✅ Yes / Completed |
| **app-ethereum** (Chain 138 fork) | `~/projects/app-ethereum` | `https://github.com/defiQUG/app-ethereum.git` | ✅ Yes / Completed |
| **TrustWallet-Integration** | `~/projects/TrustWallet-Integration` | `https://github.com/bis-innovations/TrustWallet_Integrations.git` | ✅ Yes / Completed |

**Projects directory:** `$HOME/projects` or `/home/<user>/projects` (e.g. `/home/intlc/projects`). This document lives in the `proxmox` repo; the repos above are **not** submodules of `proxmox` when using this layout — they are siblings.

---

## Clone into `~/projects/` (one-time setup)

From your home or projects directory:

```bash
cd ~/projects

# MetaMask Integration (Chain 138 Snap, provider, token lists)
git clone git@github.com:Defi-Oracle-Meta-Blockchain/metamask-integration.git metamask-integration

# Ledger Live — public code review repo for Ledger team (Chain 138 materials)
git clone https://github.com/bis-innovations/LedgerLive.git LedgerLive

# App-Ethereum — Chain 138 device app fork (network.c, defi_oracle.mk)
git clone https://github.com/defiQUG/app-ethereum.git app-ethereum

# Trust Wallet Integration (clone into TrustWallet-Integration for consistent local name)
git clone https://github.com/bis-innovations/TrustWallet_Integrations.git TrustWallet-Integration
```

---

## Checklist (all Yes / Completed)

| Item | Status |
|------|--------|
| metamask-integration repo in `~/projects/metamask-integration` | ✅ Yes / Completed |
| LedgerLive repo in `~/projects/LedgerLive` | ✅ Yes / Completed |
| app-ethereum repo in `~/projects/app-ethereum` | ✅ Yes / Completed |
| TrustWallet-Integration repo in `~/projects/TrustWallet-Integration` | ✅ Yes / Completed |
| Documentation and rationale (Snap, Ledger Live, Trust) | ✅ Yes / Completed |
| Ledger Live request submitted (Tally form) | ✅ Yes / Completed |
| Materials ready for Ledger (chain spec, RPCs, app-ethereum config) | ✅ Yes / Completed |
| Trust Wallet user workaround documented (Chainlist) | ✅ Yes / Completed |
| Trust Wallet PR materials (registry entry) in TrustWallet-Integration repo | ✅ Yes / Completed |

---

## Relation to `proxmox` workspace

- **proxmox** (`~/projects/proxmox`) — docs, runbooks, chain spec reference, and (optionally) **submodules** that point at the same repos above for convenience. If you use the canonical layout, you may keep submodules for a single workspace clone or remove them and use only the sibling repos under `~/projects/`.
- **Single source of truth for “where is the repo”:** `~/projects/<repo-name>`.

---

## See also

- [CHAIN138_WALLET_ECOSYSTEM_AND_RATIONALE.md](./CHAIN138_WALLET_ECOSYSTEM_AND_RATIONALE.md) — Why Snap, Ledger Live, Trust Wallet; links to all wallet docs.
- [ADD_CHAIN138_TO_LEDGER_LIVE.md](./ADD_CHAIN138_TO_LEDGER_LIVE.md) — Ledger Live request and materials.
- [ADD_CHAIN138_TO_TRUST_WALLET.md](./ADD_CHAIN138_TO_TRUST_WALLET.md) — Trust Wallet user steps and Wallet Core PR.