LEZ Atomic Swaps: Difference between revisions

From Local Area Network
New tool page, source-checked against the project README
 
Plainer prose: fewer quotes, project claims attributed, glosses folded in
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Infobox tool
{{Infobox tool
| name        = LEZ Atomic Swaps
| name        = LEZ Atomic Swaps
| what        = Swap native Bitcoin and LEZ without handing settlement to a custodian, wrapped asset or bridge operator
| what        = Swaps native Bitcoin and LEZ without a custodian, wrapped asset or bridge operator
| stage      = Prototype
| stage      = Prototype
| licence    = MIT OR Apache-2.0
| licence    = MIT OR Apache-2.0
Line 10: Line 10:
| verified_against = README and commit of 4 November 2026
| verified_against = README and commit of 4 November 2026
}}
}}
'''LEZ Atomic Swaps''' is a protocol and pair of Basecamp apps for swapping native Bitcoin and LEZ, and it runs on the Logos Execution Zone (LEZ) and [[Logos Messaging]] (Logos Delivery and Logos Chat). The code is published by the GitHub account gateway-fm. The README does not say whether it is an official Logos project.
'''LEZ Atomic Swaps''' is a protocol and pair of Basecamp apps by the GitHub account gateway-fm for swapping native Bitcoin and LEZ. It runs on the Logos Execution Zone (LEZ), the Logos layer that runs on-chain programs, and on [[Logos Messaging]] through Logos Delivery and Logos Chat. The README does not say whether it is an official Logos project. It was built for RFP-003, a Logos request for proposals, and its <code>docs/implementation-plan.md</code> names the RFP-003 specification in the logos-co/rfp repository as its source of truth. Release v0.1.1 is titled "RFP-003 M1, M3, and M6 source release".


== What it does ==
== What it does ==
* It swaps native Bitcoin and LEZ with no custodian, wrapped asset or bridge operator.
* It swaps native Bitcoin and LEZ with no custodian, wrapped asset or bridge operator. So far it runs on a local Bitcoin test network (regtest) and a private LEZ development network.
* It uses Taproot and MuSig2 adaptor signatures on Bitcoin and a witnessed escrow on LEZ.
* On Bitcoin it uses Taproot and MuSig2 adaptor signatures, which can only be completed with a secret value and reveal that value once completed. On LEZ it uses a witnessed escrow.
* Makers publish signed offers over Logos Delivery. Takers negotiate in private over Logos Chat.
* Makers publish signed offers over Logos Delivery, and Takers negotiate in private over Logos Chat.
* The LEZ claim reveals the value the Maker needs to finish the Bitcoin signature, so the swap completes without another Taker message.
* The LEZ claim reveals the value the Maker needs to finish the Bitcoin signature, so the swap completes without another message from the Taker.
* If a swap stops, ordered refund windows let the second leg resolve before the first.
* If a swap stops, ordered refund windows let the second leg resolve before the first.
* It ships two Basecamp apps, LEZ / BTC Maker and LEZ / BTC Taker, with Rust services, local chains and explorers.
* It ships two Basecamp apps, LEZ / BTC Maker and LEZ / BTC Taker, along with Rust services, local chains and explorers.
* Developers can write their own trading policy against a documented owner API.
* Developers can write their own trading policy against a documented owner API.


Stage: Prototype. The README says "the private-local BTC/LEZ product path works end to end". It adds that "Public-network operation, production key management, and an independent cryptographic audit are still in progress."
Stage: Prototype. The README says "the private-local BTC/LEZ product path works end to end", and that public-network operation, production key management and an independent cryptographic audit are still in progress.


== Use it ==
== Use it ==
Line 33: Line 33:


== Build it ==
== Build it ==
* Build from source with <code>./scripts/from-scratch.sh</code> in <code>deploy/</code>.
* <code>./scripts/from-scratch.sh</code> in <code>deploy/</code> builds from source.
* Inspect the Rust workspace with <code>cargo metadata --locked --no-deps</code>.
* <code>cargo metadata --locked --no-deps</code> shows the Rust workspace.
* Run the offline test suite with <code>./scripts/run-public-offline-e2e.sh</code>. It runs in a Linux container with networking off.
* <code>./scripts/run-public-offline-e2e.sh</code> runs the offline test suite in a Linux container with networking off.
* CONTRIBUTING.md sets the rules for formatting, Clippy, licences and DCO sign-off.
* CONTRIBUTING.md sets the rules for formatting, Clippy, licences and DCO (Developer Certificate of Origin) sign-off.


== Releases ==
== Releases ==
Line 53: Line 53:
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/apps/basecamp/maker/metadata.json apps/basecamp/maker/metadata.json], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/apps/basecamp/maker/metadata.json apps/basecamp/maker/metadata.json], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/apps/basecamp/taker/metadata.json apps/basecamp/taker/metadata.json], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/apps/basecamp/taker/metadata.json apps/basecamp/taker/metadata.json], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/docs/implementation-plan.md docs/implementation-plan.md], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/blob/main/CONTRIBUTING.md CONTRIBUTING.md], GitHub
* [https://github.com/gateway-fm/lez-atomic-swaps/releases releases], GitHub


{{Page status|Stub}}
{{Page status|Stub}}

Latest revision as of 23:27, 4 November 2026

LEZ Atomic Swaps
What it does: Swaps native Bitcoin and LEZ without a custodian, wrapped asset or bridge operator
Stage: Prototype
Licence: MIT OR Apache-2.0
Verified on 4 November 2026 against README and commit of 4 November 2026.

LEZ Atomic Swaps is a protocol and pair of Basecamp apps by the GitHub account gateway-fm for swapping native Bitcoin and LEZ. It runs on the Logos Execution Zone (LEZ), the Logos layer that runs on-chain programs, and on Logos Messaging through Logos Delivery and Logos Chat. The README does not say whether it is an official Logos project. It was built for RFP-003, a Logos request for proposals, and its docs/implementation-plan.md names the RFP-003 specification in the logos-co/rfp repository as its source of truth. Release v0.1.1 is titled "RFP-003 M1, M3, and M6 source release".

What it does

  • It swaps native Bitcoin and LEZ with no custodian, wrapped asset or bridge operator. So far it runs on a local Bitcoin test network (regtest) and a private LEZ development network.
  • On Bitcoin it uses Taproot and MuSig2 adaptor signatures, which can only be completed with a secret value and reveal that value once completed. On LEZ it uses a witnessed escrow.
  • Makers publish signed offers over Logos Delivery, and Takers negotiate in private over Logos Chat.
  • The LEZ claim reveals the value the Maker needs to finish the Bitcoin signature, so the swap completes without another message from the Taker.
  • If a swap stops, ordered refund windows let the second leg resolve before the first.
  • It ships two Basecamp apps, LEZ / BTC Maker and LEZ / BTC Taker, along with Rust services, local chains and explorers.
  • Developers can write their own trading policy against a documented owner API.

Stage: Prototype. The README says "the private-local BTC/LEZ product path works end to end", and that public-network operation, production key management and an independent cryptographic audit are still in progress.

Use it

The packaged stack targets arm64, including Apple Silicon and arm64 Linux, and needs Docker with Compose.

  1. Prebuilt: download the lez-swap-stack arm64 bundle from the latest release, unpack it and run ./scripts/start.sh.
  2. From source: clone the repository, go to deploy/ and run ./scripts/from-scratch.sh. The README says the first build takes hours. Later starts use ./scripts/up.sh.
  3. Open the Basecamp desktop over VNC at 127.0.0.1:5901. The README gives the default password and how to change it.
  4. In LEZ / BTC Maker, publish an offer. In LEZ / BTC Taker, take it and follow the steps: lock BTC, the Maker funds LEZ, claim LEZ, the Maker claims Bitcoin.
  5. To install the two apps in Basecamp's package manager, add the module catalogue URL given in the README.
  6. Stop the stack with ./scripts/down.sh.

Build it

  • ./scripts/from-scratch.sh in deploy/ builds from source.
  • cargo metadata --locked --no-deps shows the Rust workspace.
  • ./scripts/run-public-offline-e2e.sh runs the offline test suite in a Linux container with networking off.
  • CONTRIBUTING.md sets the rules for formatting, Clippy, licences and DCO (Developer Certificate of Origin) sign-off.

Releases

  • Latest tag: v0.2.6, 8 October 2026.
  • Version in metadata.json: 0.2.5, for both Basecamp apps (lez_atomic_swap_maker and lez_atomic_swap_taker).
  • GitHub lists nine releases, v0.1.1 to v0.2.6. The latest is v0.2.6.

See also

Sources

Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.
Retrieved from "https://alienware-1.tailb5c716.ts.net/index.php?title=LEZ_Atomic_Swaps&oldid=853"