Skip to content

docs(apps): run the atomic swaps sample app locally (v0.1 draft)#315

Draft
danisharora099 wants to merge 3 commits into
mainfrom
docs/atomic-swaps-sample-app-v0.1
Draft

docs(apps): run the atomic swaps sample app locally (v0.1 draft)#315
danisharora099 wants to merge 3 commits into
mainfrom
docs/atomic-swaps-sample-app-v0.1

Conversation

@danisharora099

@danisharora099 danisharora099 commented Jun 5, 2026

Copy link
Copy Markdown

Summary

Status

Not ready for review. R&D draft (quality:unverified). Scaffold migration (eth-lez-atomic-swaps#27) explicitly out of scope.

Handoff

Docs should edit

  • Apply writing rules, linters, and GitBook structure pass
  • Align tone with LEZ wallet quickstart (quality bar — not the older AMM tutorial)
  • Resolve whether Refund tab hashlock sourcing belongs in happy-path verification or a footnote
  • Cross-link Install Basecamp without duplicating Nix install prose

SME must verify

  • Happy path still works at pinned commit 608179e7c5285a10d35cc9f5cd727e3d56f6a27a
  • First-run timing table is still realistic on cold cache
  • Nix flakes guidance (~/.config/nix/nix.conf vs /etc/nix/nix.conf) matches each platform
  • Optional CLI status --hashlock steps and log-grep path are correct
  • Troubleshooting rows match real failure modes (Delivery warmup, env load, infra restart)

Red Team should rerun

  • Clean machine: Apple Silicon macOS or Linux x86_64/aarch64 (Intel Mac expected fail — document gap)
  • git checkout 608179e7c5285a10d35cc9f5cd727e3d56f6a27a then full happy path
  • Confirm four-terminal layout; make infra terminal stays running
  • Capture on failure: infra output, .basecamp/maker/basecamp.log, .basecamp/taker/basecamp.log (redacted)
  • Record actual wall-clock for first cold make swap-lgx-build
  • Sign off UI success signals + optional CLI check

Test plan

Dogfooded happy-path doc for the Basecamp maker/taker flow. Draft only —
not ready for editorial or Red Team review yet.

Co-authored-by: Cursor <cursoragent@cursor.com>
danisharora099 and others added 2 commits June 5, 2026 15:50
Note that users should quit Basecamp windows and stop make infra when
done, to avoid leaving ports and wallets running.

Co-authored-by: Cursor <cursoragent@cursor.com>
Pin dogfood commit, document environment and log paths, reconcile Nix
flake config per platform, clarify CLI verification, and expand
troubleshooting for Delivery, env load, and infra restart.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant