Cowrie Research

peerswap-primary-sources-2026-05-03

2 min read

PeerSwap primary sources — 2026-05-03

Project status in this pass

  • No canonical standalone whitepaper or litepaper surfaced.
  • The clearest current source of truth was the official site, the repository README, and the published peer-protocol draft.
  • The materials consistently frame PeerSwap as direct-peer Lightning liquidity infrastructure, not as a coordinator-run swap marketplace.

Primary-source snapshots

1) Official project site

  • URL: https://www.peerswap.dev/
  • Key excerpt:
    • The site says PeerSwap enables Lightning Network nodes to balance channels by facilitating atomic swaps with direct peers.
    • It emphasizes “no centralized coordinator” and presents the project as letting nodes be their own swap provider.
    • It also highlights both CLN and LND support and contrasts PeerSwap with multi-hop balancing approaches.

2) Main repository README

  • URL: https://raw.githubusercontent.com/ElementsProject/peerswap/master/README.md
  • Key excerpt:
    • The README calls PeerSwap beta-grade software and says it can run as a Core Lightning plugin or as a standalone daemon/CLI with LND.
    • It says swaps are currently limited to allowlisted peers because the project does not yet have a proven fee model.
    • It defines two swap types: swap-in for onchain asset to Lightning outbound liquidity, and swap-out for onchain asset to Lightning inbound liquidity.
    • It also says an interoperable second implementation and protocol-upgrade discussions are underway.

3) Peer protocol draft

  • URL: https://raw.githubusercontent.com/ElementsProject/peerswap/master/docs/peer-protocol.md
  • Key excerpt:
    • The protocol document says PeerSwap describes on-chain to off-chain atomic swaps between direct Lightning peers.
    • It defines the primary use case as efficient balancing of Lightning channels.
    • It says the protocol uses Lightning custom messages with types in the 42069-42085 range and JSON-encoded payloads.
    • It specifies a protocol_version, unique swap_id, direct channel scoping, maker/taker roles, and opening/claim transaction flows.

4) Liquid emphasis in README

  • URL: https://raw.githubusercontent.com/ElementsProject/peerswap/master/README.md
  • Key excerpt:
    • The README explicitly says most of the benefits of PeerSwap come from using L-BTC.
    • It says L-BTC swaps are more private, faster, and avoid mainchain fee environments that can make swaps uneconomical.
    • That positioning is a useful clue that PeerSwap should be cataloged as Bitcoin-and-Liquid liquidity infrastructure rather than only as a generic Lightning plugin.

Working conclusion

PeerSwap is best cataloged as direct-peer Lightning liquidity-management infrastructure: a protocol and implementation stack for rebalancing channels through atomic BTC or L-BTC swaps with existing channel counterparties, without depending on a centralized swap coordinator or generic multi-hop rebalancing heuristics.

Graph View