b8613905bd
- Submodule pins: dbis_core, cross-chain-pmm-lps, mcp-proxmox (local, push may be pending), metamask-integration, smom-dbis-138 - Atomic swap + cross-chain-pmm-lops-publish, deploy-portal workflow, phoenix deploy-targets, routing/aggregator matrices - Docs, token-lists, forge proxy, phoenix API, runbooks, verify scripts Made-with: Cursor
71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
# Atomic Swap dApp Submodule
|
|
|
|
**Last Updated:** 2026-04-19
|
|
**Purpose:** Defines the dedicated submodule for an ecosystem-wide swap + bridge dApp that can orchestrate atomic swap flows across the supported networks and assets.
|
|
|
|
---
|
|
|
|
## Location
|
|
|
|
- Submodule path: `atomic-swap-dapp/`
|
|
- Parent registration: `.gitmodules`
|
|
- Current bootstrap remote: local bare repo at `/home/intlc/projects/atomic-swap-dapp.git`
|
|
|
|
> Operational note: the current URL is a local bootstrap remote created to establish the submodule boundary and initial commit. Replace it with the canonical hosted remote before expecting other operators to clone it directly from the parent repo.
|
|
|
|
---
|
|
|
|
## What the submodule contains
|
|
|
|
- `README.md` — scope and usage
|
|
- `docs/ATOMIC_SWAP_EXECUTION_MODEL.md` — execution model for swap -> bridge -> destination swap flows
|
|
- `scripts/sync-ecosystem.mjs` — generates the dApp manifest from the parent repo's canonical machine-readable inventories
|
|
- `scripts/validate-manifest.mjs` — lightweight integrity check for the generated manifest
|
|
- `config/ecosystem-manifest.json` — generated coverage snapshot
|
|
|
|
---
|
|
|
|
## Canonical parent sources
|
|
|
|
The submodule intentionally derives coverage from the parent repo instead of maintaining a second source of truth:
|
|
|
|
- `config/aggregator-route-matrix.json`
|
|
- `config/routing-registry.json`
|
|
- `token-lists/lists/dbis-138.tokenlist.json`
|
|
- `cross-chain-pmm-lps/config/chains.json`
|
|
- `cross-chain-pmm-lps/config/token-map.json`
|
|
- `cross-chain-pmm-lps/config/deployment-status.json`
|
|
|
|
This lets the dApp surface:
|
|
|
|
- Chain 138 live same-chain swap routes
|
|
- bridge lanes across the routed ecosystem
|
|
- cW* and anchor-asset inventory on the public-chain mesh
|
|
- non-EVM network metadata where interoperability is modeled separately
|
|
|
|
---
|
|
|
|
## Working in the submodule
|
|
|
|
From the parent repo root:
|
|
|
|
```bash
|
|
cd atomic-swap-dapp
|
|
npm run sync:ecosystem
|
|
npm run validate:manifest
|
|
```
|
|
|
|
If the submodule is checked out outside the parent repo, set:
|
|
|
|
```bash
|
|
export PROXMOX_REPO_ROOT=/path/to/proxmox
|
|
```
|
|
|
|
---
|
|
|
|
## Immediate next build steps
|
|
|
|
1. Add the canonical hosted remote for the submodule and update `.gitmodules`.
|
|
2. Layer in a quote API and execution adapters for DODO PMM, CCIP, Alltra, and future non-EVM connectors.
|
|
3. Build UI surfaces on top of `config/ecosystem-manifest.json` so chain and asset coverage stays synced with repo-backed inventories.
|