Coinswap v0.2.1 Release Notes
This release focuses on protocol unification, marketplace reliability, operational tooling, and the broader Coinswap application ecosystem. Between January 1, 2026 and March 29, 2026, the core library and surrounding apps moved closer to a production-ready operator and client experience.
📋 Changelog Summary (v0.2.0 → v0.2.1)
- 🔧 44 Issues Closed across protocol, sync, wallet, testing, and maker operations: View on GitHub
- ✅ 48 Merged PRs in the core
coinswaprepo forv0.2.0 → v0.2.1: View on GitHub - 🧱 Core repo diff since v0.2.0: 149 files changed, 24k+ insertions, 21k+ deletions
Highlights of v0.2.1
The major highlights of this release are as follows:
- Unified Legacy and Taproot protocol support in the core library through a single code path, reducing duplicated logic and making downstream integrations easier to maintain.
- Maker Dashboard matured into the main operator experience, with onboarding checks, packaging, reporting, protocol unification support, and better maker management.
- Taker App received a major UX upgrade with better setup flows, richer swap reporting, improved balances/history views, better sync visibility, and protocol unification support.
- New public-facing Coinswap website launched to improve discoverability and project communication.
- Marketplace and offerbook reliability improved substantially through sync optimization, race-condition fixes, smarter polling/backoff, and reduced redundant wallet sync work.
- Swap reporting expanded for both makers and takers, including persisted reports and failed swap reporting.
Late-March Additions
The last few days of the release window also brought a few important core improvements that are worth calling out explicitly:
- Safer wallet and offerbook persistence now creates missing parent directories before writing state to disk, fixing late-cycle disk write failures during wallet saves and offerbook caching.
- Maker startup is safer around port conflicts by binding network and RPC ports before fidelity bond setup, retrying for a free port, and surfacing unusable port selections earlier.
- Default address generation now uses Taproot (
P2TR) for new receive, change, and maker funding flows, aligning the default wallet behavior with newer Taproot-first usage. - Project docs and announcements were refreshed with updated website, Maker Dashboard, and Deep Wiki references, plus corrected integration-test paths in the core docs.
Major Improvements in v0.2.1
| Type | Improvement | PR(s) | Contributor |
|---|---|---|---|
| Protocol | Unify Legacy and Taproot swap handling into a single code path and API surface. | #758 | stark-3k |
| Protocol | Add concurrent UTXO reservation/selection to prevent overlapping maker liquidity from breaking simultaneous swaps. | #789 | Godzilla-oss |
| Protocol | Improve offerbook sync logic with polling/backoff, smarter maker checking, and timestamp-aware updates. | #779 | 0xEgao |
| Protocol | Fix offerbook synchronization race conditions to make sync completion more reliable. | #792 | NeoZ666 |
| Wallet | Fix wallet and offerbook disk write failures by creating missing parent directories before persisting state. | #808 | 0xEgao |
| Wallet | Fix insufficient-funds edge cases by improving fee accounting and coin-selection calculations. | #795 | Godzilla-oss |
| Wallet | Optimize memory usage in wallet/state handling. | #786 | 0xEgao |
| Wallet | Switch default receive, change, and maker funding address generation from P2WPKH to Taproot (P2TR).
| #814 | stark-3k |
| Reporting | Add persisted swap reports for makers. | #740 | hulxv |
| Reporting | Add failed swap reports for takers and save them to disk for later inspection. | #781 | NeoZ666 |
| Reliability | Prevent stale fidelity bond announcements from continuing to broadcast on Nostr. | #769 | 0xEgao |
| Reliability | Add automatic fidelity renewal for Taproot makers. | #730 | stark-3k |
| Reliability | Enforce minimum maker liquidity and constrain maker fidelity timelock configuration for safer operation. | #733, #727 | 0xEgao |
| Operations | Bind maker network and RPC ports before fidelity bond setup, retry around conflicts, and fail earlier on unusable port selections. | #811 | Godzilla-oss |
| Sync | Reduce redundant sync calls and fix wallet rescan behavior. | #773, #734 | Godzilla-oss |
| Apps | Expose maker Tor hostname APIs needed by the dashboard and external integrations. | #793 | hulxv |
| Infrastructure | Fix cross-platform build issues and add macOS CI coverage. | #759, #763 | 0xEgao |
| Docs | Improve contributor guidance and add DeepWiki reference material. | #800 | 0xEgao |
Notable Issues Closed
The following issues were among the most important items addressed during the release window:
- #705: Unify V1 and V2 protocols.
- #720 and #772: Improve offerbook syncing and fix inconsistent sync behavior.
- #723 and #724: Persist swap reports for makers and takers.
- #752: Handle concurrent UTXO selection safely in multi-taker scenarios.
- #794: Fix insufficient-funds failures caused by fee-accounting edge cases.
- #701 and #718: Add automatic fidelity renewal for Taproot makers and supporting tests.
- #757 and #762: Restore cross-platform builds and extend CI coverage to macOS.
- #702: Stop stale fidelity bonds from being broadcast to the marketplace.
- #704 and #722: Remove redundant sync behavior and improve rescan handling.
- Late-cycle operational fixes: address disk write failures during wallet and offerbook persistence, improve maker startup behavior under port conflicts, and move default address generation to Taproot-first wallet flows.
Ecosystem Updates Beyond the Core Repo
This release also includes substantial work in the surrounding Coinswap ecosystem:
- Coinswap-FFI added broader downstream integration support, including the new Python package, Swift package / XCFramework workflows, and a major binding refactor to align with unified protocol support. CI and test pipelines were also streamlined for faster language-binding validation.
- Taker App improved substantially with richer swap history and reports, better wallet/balance handling, setup and connection UX improvements, startup log visibility, improved layouts, and unified protocol support throughout the desktop app.
- Maker Dashboard saw the largest app-layer leap this cycle, with maker onboarding checks, bitcoind controls, improved config management, swap report and earnings views, packaging for Umbrel and myNode, better defaults aligned with the core library, and unified protocol support.
- Coinswap Website launched as a new public-facing entrypoint for the project and is one of the major highlights of this release.
Documentation and References
Documentation also improved during this cycle:
- Project outlook and contributor references were refreshed in the core repo, including a DeepWiki link in
CONTRIBUTING.md. - README and contribution docs were refreshed again in late March to add the new website and Maker Dashboard links, standardize Deep Wiki references, and correct integration-test path references.
- Offerbook and backend configuration documentation advanced alongside sync and REST-related work.
- Maker Dashboard docs added packaging and deployment guidance for Umbrel and myNode.
- Taker App docs improved with updated README content and screenshots.
- Coinswap-FFI docs expanded around Python and Swift integration workflows for downstream wallets and apps.
Full Changelog: v0.2.0...v0.2.1
Weighted Contribution Ranking
Contributions reflects merged PR activity across coinswap, coinswap-ffi, taker-app, maker-dasboard, and website during the January 1, 2026 → March 29, 2026 release cycle. Contribution share is weighted by PR size using additions + deletions, with the full release volume normalized to 100%.
This is an approximate activity-based ranking and may not reflect actual project impact exactly, since smaller PRs can still have outsized product, architectural, or operational significance.
| Rank | Contributor | Merged PRs | Contribution % |
|---|---|---|---|
| 1 | NeoZ666 | 33 | 43.2% |
| 2 | stark-3k | 11 | 24.1% |
| 3 | keraliss | 33 | 16.8% |
| 4 | hulxv | 24 | 9.8% |
| 5 | 0xEgao | 20 | 4.3% |
| 6 | Godzilla-oss | 9 | 1.1% |
| 7 | mojoX911 | 6 | 0.5% |
| 8 | Wukong247 | 4 | 0.1% |
| 9 | oGranny | 1 | 0.1% |
| 10 | ajey35 | 2 | 0.0% |
| 11 | GitHappens2Me | 1 | 0.0% |
| 12 | Abhay349 | 1 | 0.0% |
Major References
- Project overview, contribution and guidelines: Readme
- Manuals and Demo Docs: Doc Folder
- Protocol Specifications: Spec Repo
- Coinswap Docker: Setup Instructions
- Coinswap-FFI: Repository
- Taker App: Build From Source
- Maker Dashboard: Repository
- Coinswap Website: Visit Website