Files
proxmox/docs/03-deployment/ATOMIC_SWAP_DAPP_SUBMODULE.md
defiQUG b8613905bd
Some checks failed
Deploy to Phoenix / validate (push) Failing after 15s
Deploy to Phoenix / deploy (push) Has been skipped
chore: sync workspace — configs, docs, scripts, CI, pnpm, submodules
- 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
2026-04-21 22:01:33 -07:00

2.3 KiB

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:

cd atomic-swap-dapp
npm run sync:ecosystem
npm run validate:manifest

If the submodule is checked out outside the parent repo, set:

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.