Payjoin primary sources — 2026-05-03
Project status in this pass
- No separate standalone whitepaper or litepaper surfaced.
- The clearest current source of truth was the official project site, BIP 78, BIP 77, the project FAQ, and the Rust-Payjoin / Payjoin Dev Kit implementation README.
- The materials show Payjoin evolving from a simple synchronous payment protocol into a broader async coordination and wallet-integration stack.
Primary-source snapshots
1) Official project site
- URL: https://payjoin.org/
- Key excerpt:
- The site says Payjoin preserves privacy by breaking the most common method used to spy on bitcoin users.
- It also says Payjoin can settle many transactions at once to lower fees and higher throughput.
- The site explicitly says Payjoin can augment Lightning by helping nodes fund and open channels in one transaction while maintaining privacy.
2) BIP 78 — A Simple Payjoin Proposal
- URL: https://raw.githubusercontent.com/bitcoin/bips/master/bip-0078.mediawiki
- Key excerpt:
- BIP 78 defines Payjoin as a protocol for two parties to negotiate a coinjoin transaction during a payment.
- It explains that the sender receives a BIP21 URI with a
pj=endpoint, posts an original PSBT, gets a Payjoin proposal PSBT back, then verifies, re-signs, and broadcasts. - The motivation section explicitly targets common-input ownership, change script-type, and round-amount heuristics.
3) BIP 77 — Async Payjoin
- URL: https://raw.githubusercontent.com/bitcoin/bips/master/bip-0077.md
- Key excerpt:
- BIP 77 says it is a backwards-compatible asynchronous version of Payjoin relative to BIP 78.
- It replaces the need for a receiver to host a secure public endpoint with an untrusted directory server, asynchronous protocol flow, authenticated encrypted payloads, and OHTTP-based request privacy.
- It explicitly says BIP 78’s public-facing-server and synchronous-communication requirements have been obstacles to adoption, especially for mobile and web wallets.
4) Project FAQ
- URL: https://raw.githubusercontent.com/payjoin/payjoin.org/master/docs/faq.md
- Key excerpt:
- The FAQ says Payjoin works on top of Bitcoin without consensus changes.
- It says limited wallet support has historically stemmed from lack of integration tooling and the old requirement for a receiver to be online behind an HTTPS server.
- It positions Payjoin Dev Kit as the de-facto library and notes that newer async Payjoin development opens the protocol to more wallet types.
5) Rust-Payjoin / Payjoin Dev Kit implementation README
- URL: https://raw.githubusercontent.com/payjoin/rust-payjoin/master/README.md
- Key excerpt:
- The README says the repository contains multiple crates implementing both BIP 77 Async Payjoin and BIP 78 Simple Payjoin.
- It says the stack also includes associated OHTTP Relay and Payjoin Directory infrastructure.
- It identifies the main
payjoincrate, a no-frills CLI reference implementation, a combined mailroom/directory component, test utilities, and FFI bindings.
Working conclusion
Payjoin is best cataloged as Bitcoin payment-coordination and wallet-interoperability infrastructure: a privacy-preserving batching protocol whose current practical surface includes both simple and async specifications plus a reusable Dev Kit and directory/relay tooling that lower the barrier for wallet adoption.