diff --git a/guide/daily-spending-wallet/contacts.md b/guide/daily-spending-wallet/contacts.md index 6857358db..00a1fffcc 100644 --- a/guide/daily-spending-wallet/contacts.md +++ b/guide/daily-spending-wallet/contacts.md @@ -213,7 +213,7 @@ Whether we’re sending emails, physical mail, or following someone on social me Addresses, invoices, node IDs and other transaction endpoints in bitcoin are highly unintuitive. Abstracting them via a contact list can create a much smoother user experience. There are many [payment request formats]({{ '/guide/how-it-works/payment-request-formats/' | relative_url }}), each with unique properties and varying levels of maturity and adoption, requiring unique design solutions. This page will use a more approachable "address" as an umbrella term for various types of payment information. -Some payment request formats such as [silent payments (BIP-352)]({{ '/guide/how-it-works/silent-payments' | relative_url }}), [lightning offers (BOLT 12)]({{ '/guide/how-it-works/payment-request-formats/#offers' | relative_url }}) and [DNS payment instructions (BIP-353)]({{ '/guide/how-it-works/human-readable-addresses/#bip-353-dns-payment-instructions' | relative_url }}) are designed to be safely reused. This property makes them ideal for abstraction through contacts. +Some payment request formats such as [silent payments (BIP-352)]({{ '/guide/how-it-works/silent-payments' | relative_url }}), [lightning offers (BOLT 12)]({{ '/guide/how-it-works/payment-request-formats/#offers' | relative_url }}) and [DNS payment instructions (BIP-353)]({{ '/guide/how-it-works/human-readable-addresses/#human-bitcoin-address-bip-353' | relative_url }}) are designed to be safely reused. This property makes them ideal for abstraction through contacts. Let's go over common user interactions around managing contacts. This will illustrate how such a feature could work, and helps explain the underlying design problems and decisions. diff --git a/guide/designing-products/common-user-flows.md b/guide/designing-products/common-user-flows.md index 72a6f981e..4871edc7d 100644 --- a/guide/designing-products/common-user-flows.md +++ b/guide/designing-products/common-user-flows.md @@ -394,7 +394,7 @@ For the simplest form of base layer requests, the receiver only needs to share o While it is possible to re-use the same receiving address repeatedly, this practice is highly discouraged for privacy reasons. -For more information-rich base layer requests, [BIP 21](https://github.com/bitcoin/bips/blob/master/bip-0021.mediawiki) describes a URI scheme to turn requests into links that can be shared like any other link. On click, wallets that support this scheme can immediately show the send screen with the correct information pre-filled. Links can also be encoded and transmitted via QR code. Since the scheme also allows for the inclusion of an address label and transaction description, it allows both sender and recipient to stay organized. +For more information-rich base layer requests, [BIP 321](https://github.com/bitcoin/bips/blob/master/bip-0321.mediawiki) describes a URI scheme to turn requests into links that can be shared like any other link. On click, wallets that support this scheme can immediately show the send screen with the correct information pre-filled. Links can also be encoded and transmitted via QR code. Since the scheme also allows for the inclusion of an address label and transaction description, it allows both sender and recipient to stay organized. For requests on the lightning network, the receiver needs to create a lightning invoice that includes the amount, and then share the invoice with the sender. diff --git a/guide/designing-products/interoperability.md b/guide/designing-products/interoperability.md index 37ea11280..910cc3990 100644 --- a/guide/designing-products/interoperability.md +++ b/guide/designing-products/interoperability.md @@ -59,13 +59,13 @@ You should ensure your application is interoperable with the various techniques Supporting, generating, and reading as many [payment request formats]({{ '/guide/how-it-works/payment-request-formats/' | relative_url }}) as possible in your application will make it more interoperable with others. -It also matters how these formats are generated. Your applications should be able to read, and generate, [BIP 21](https://bips.xyz/21) encoded payment requests. +It also matters how these formats are generated. Your applications should be able to read, and generate, [BIP 321](https://github.com/bitcoin/bips/blob/master/bip-0321.mediawiki) encoded payment requests. -An evolving standard that improves payment usability between on-chain and lightning is being able to read and generate [unified bitcoin payment requests](https://bitcoinqr.dev/) that contain an on-chain address and lightning invoice inside a BIP 21 URI. +An evolving standard that improves payment usability between on-chain and lightning is being able to read and generate [unified bitcoin payment requests](https://bitcoinqr.dev/) that contain an on-chain address and lightning invoice inside a BIP 321 URI. When dealing with lightning invoice [amounts]({{ '/guide/daily-spending-wallet/requesting/#entering-an-amount' | relative_url }}), your application should be able to read and generate zero amount invoices. -Payment links, often using BIP 21, should be readable by your application. Forms should be automatically opened and filled when a user clicks a payment link or button. +Payment links, often using BIP 321, should be readable by your application. Forms should be automatically opened and filled when a user clicks a payment link or button. [Near-field communication](https://en.wikipedia.org/wiki/Near-field_communication) (NFC) should be supported for paying and sharing payment requests. diff --git a/guide/how-it-works/human-readable-addresses.md b/guide/how-it-works/human-readable-addresses.md index b73baffd7..2e0b86b85 100644 --- a/guide/how-it-works/human-readable-addresses.md +++ b/guide/how-it-works/human-readable-addresses.md @@ -123,15 +123,10 @@ From email and social media, we are familiar with addresses consisting of a username@ @@ -255,7 +255,7 @@ Static payment codes are great for use with [DNS-based human readable addresses] A unified payment request combines one or more of the formats listed above. This makes it easier to request a payment when you are unsure what formats the sender supports. -Unified payment requests use the BIP 21 `bitcoin:` URI to add multiple payment request formats to a single payment request. The more formats added, the larger the request becomes which can be an issue for lower end devices that can't scan complex QR codes. +Unified payment requests use the BIP 321 `bitcoin:` URI to add multiple payment request formats to a single payment request. The more formats added, the larger the request becomes which can be an issue for lower end devices that can't scan complex QR codes. You can learn more about unified payment requests [here](https://bitcoinqr.dev/). diff --git a/guide/how-it-works/wallet-selector.md b/guide/how-it-works/wallet-selector.md index 91d33057f..887b3bb59 100644 --- a/guide/how-it-works/wallet-selector.md +++ b/guide/how-it-works/wallet-selector.md @@ -82,7 +82,7 @@ We’ll outline each of those below. ### 1. Opening the default wallet -A widely supported standard is [BIP 21](https://github.com/bitcoin/bips/blob/master/bip-0021.mediawiki#Examples) (also see [Payment request formats](/guide/how-it-works/payment-request-formats/#uniform-resource-identifier-uris-schemes)), which defines a URI scheme for passing bitcoin payment information to other applications. +A widely supported standard is [BIP 321](https://github.com/bitcoin/bips/blob/master/bip-0321.mediawiki) (also see [Payment request formats](/guide/how-it-works/payment-request-formats/#uniform-resource-identifier-uris-schemes)), which defines a URI scheme for passing bitcoin payment information to other applications. For example, clicking a link or button with the following URI is opened in the default bitcoin wallet (if there is one installed): `bitcoin:16AgmhoCVSJoGeEkERPdrsdvJG3RWmum6T` diff --git a/guide/resources/learning-bootcamp.md b/guide/resources/learning-bootcamp.md index cdccea38f..761fb9cfb 100644 --- a/guide/resources/learning-bootcamp.md +++ b/guide/resources/learning-bootcamp.md @@ -271,7 +271,7 @@ Bitcoin Design Guide: **[Payment Request Formats]({{ '/guide/how-it-works/payment-request-formats/' | relative_url }})** - What are the key differences between a regular Lightning invoice and a Lightning address in terms of user experience and privacy? -- Why do unified payment requests use the BIP 21 bitcoin: URI scheme? What problem does this solve? +- Why do unified payment requests use the BIP 321 bitcoin: URI scheme? What problem does this solve? - Between LNURL, Offers (BOLT 12), and regular invoices, which would you choose for building a subscription service and why? **[Lightning Services]({{ '/guide/how-it-works/lightning-services/' | relative_url }})**