From daf64c4253fa920aa6086bba9a77ca81587b11f1 Mon Sep 17 00:00:00 2001 From: Jon Atack Date: Wed, 24 Sep 2025 10:45:24 -0600 Subject: [PATCH 1/2] BIP321: add reference implementation section --- bip-0321.mediawiki | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/bip-0321.mediawiki b/bip-0321.mediawiki index ea8810e2e8..025feddbb9 100644 --- a/bip-0321.mediawiki +++ b/bip-0321.mediawiki @@ -120,6 +120,12 @@ For payments completed on-chain, this is largely addressed by having the payment In order to avoid inadvertently revealing the sender's IP address or other information to the recipient, proof URIs must only be opened when they will simply switch to another locally-installed application (i.e. the application which initiated the payment). When clicking a URI from a website, the website should already have plenty of logic on its backend to process payment completion and a proof-of-payment callback is unnecessary. +== Reference Implementation == + +Documentation: https://docs.rs/bitcoin-payment-instructions + +Code repository: https://github.com/rust-bitcoin/bitcoin-payment-instructions + == Forward compatibility == Query parameter keys which are prefixed with a req- are considered required. If a client does not implement handling a query parameter which has a key prefixed with req-, it MUST consider the entire URI invalid. Any other query parameters which are not implemented, but which are not prefixed with a req-, can be safely ignored. From c16a33647aa831e9d894fef08b5325a2d5e52108 Mon Sep 17 00:00:00 2001 From: Jon Atack Date: Wed, 24 Sep 2025 10:36:34 -0600 Subject: [PATCH 2/2] BIP321: mention replacement of BIP21 rather than only modification, for consistency with the "Replaces: 21" header --- bip-0321.mediawiki | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bip-0321.mediawiki b/bip-0321.mediawiki index 025feddbb9..a917f617ec 100644 --- a/bip-0321.mediawiki +++ b/bip-0321.mediawiki @@ -24,7 +24,7 @@ This BIP proposes a URI scheme for describing Bitcoin payment instructions. The purpose of this URI scheme is to enable users to easily make payments by simply clicking links on webpages or scanning QR Codes. -This BIP is a modification of [[bip-0021.mediawiki|BIP 0021]] to add information about the modern usage of bitcoin: URIs (including standard query parameters and modern address types) as well as provide forward-looking guidance on how to incorporate new payment instructions. It further adds an optional extension to provide the payment initiator with proof of payment. BIP 21 was based on BIP 20, which was, in turn based on an earlier document by Nils Schneider. +This BIP is a modification and intended replacement of [[bip-0021.mediawiki|BIP 0021]] to add information about the modern usage of bitcoin: URIs (including standard query parameters and modern address types) as well as provide forward-looking guidance on how to incorporate new payment instructions. It further adds an optional extension to provide the payment initiator with proof of payment. BIP 21 was based on BIP 20, which was, in turn based on an earlier document by Nils Schneider. == Specification ==