mirror of
https://github.com/logos-co/eth-lez-atomic-swaps.git
synced 2026-08-27 09:51:11 +00:00
Danish Arora
e3f400a7fd
The Prerequisites section told testers to install Basecamp **0.2.2**, which
is neither what this repo pins nor what CI tests. `scaffold.toml`'s
`[repos.basecamp].pin` has been `aa237766baf61404e12da86b7303cb41065464c9`
since 2026-08-05 (f69b5a0), and that rev is upstream's `0.2.3` tag exactly;
`scripts/basecamp-dev.sh:344` records the same mapping as
`validated_basecamp_version="0.2.3"`. The `basecamp-ui-runtime` CI job builds
that pin, installs swap/swap_ui into it, launches it and drives the UI, and is
green on master.
0.2.2 is kept as an accepted version rather than dropped: its flake.lock
resolves `logos-package`, `logos-package-manager`, `logos-capability-module`
and `logos-view-module-runtime` to identical revision sets (verified against
tags 0.2.2 = d41a72bc and 0.2.3 = aa237766), so every path an install touches
is unchanged between them. Nothing establishes 0.2.1 or earlier, so the page
says so instead of implying coverage it does not have. The note also states
the honest scope of the CI proof — linux-amd64, locally built `.lgx` — so a
tester does not read it as covering macOS or the catalog-download path.
Second fix: step 2 attributed the `delivery_module` dependency to `swap_ui`.
`swap-ui/metadata.json` declares only `swap`; it is `swap-module/metadata.json`
that declares `delivery_module`. The instruction to keep the built-in catalog
enabled is unchanged — it is still what supplies that dependency.
Swept the rest of the page against the repo: swap/swap_ui 0.4.4 and the
2026-08-18 publish dates, all-three builtVariants, the ubuntu-latest /
ubuntu-24.04-arm / macos-latest build matrix, the Sepolia HTLC address and
INTERFACE_VERSION 2, the LEZ program ID and its v0.2.2 client pin
(`d6e4ae69`), and the catalog URL all check out. No other doc repeats either
error.
ETH ↔ LEZ Atomic Swaps
Trustlessly swap Sepolia ETH ↔ LEZ, peer-to-peer, inside Logos Basecamp — no custodian.
Try it
- In Basecamp, open Settings → Repositories and add this catalog:
https://raw.githubusercontent.com/logos-co/eth-lez-atomic-swaps/master/logos-repo.json - Install swap, then swap_ui (current version 0.4.4). Keep the built-in
catalog enabled — it provides the
delivery_moduledependency. - In the app, the Setup tab walks you through it: generate an Ethereum key, create a LEZ account, fund it, get test ETH — then open Market and accept an offer.
Full walkthrough: Swap ETH and LEZ tokens in Logos Basecamp. Install details and endpoints: docs/community-install.md.
How it works
Each swap is a pair of hash time-locked contracts (HTLCs), one per chain. The taker locks ETH on Sepolia; the maker verifies it and locks LEZ; the taker claims the LEZ, revealing a secret; the maker uses that secret to claim the ETH. Both sides complete, or the timelocks let everyone refund — nobody can keep both assets.
taker locks ETH ──▶ maker locks LEZ ──▶ taker claims LEZ (reveals secret)
└─▶ maker claims ETH (using the secret)
Develop
make basecamp-dev # build the working tree and run it inside real Basecamp
make test # full test suite (contracts + integration, via lgs)
make preflight # fast local checks before you push — see docs/DEVELOPMENT.md
Where things live:
swap-module/— the core swap backend (C++ module wrapping the Rust orchestrator)swap-ui/— the Basecamp UIoffer-publisher/— the market-maker sidecar that keeps offers publisheddeploy/— the maker fleet (liquidity-bot container)
Toolchain setup, the two-peer local flow, and build notes: docs/DEVELOPMENT.md.
Links
- User walkthrough (journey doc)
- Report feedback · issues
- Running a market maker? Start at deploy/README.md.
Disclaimer
Testnet only (Sepolia + LEZ testnet), unaudited. This repository is part of an experimental development environment and is not intended for production use — see the Logos Core repository.