Skip to content

Commit c047e09

Browse files
authored
Merge pull request bitcoin-dot-org#2759 from jameshilliard/deprecate-bip70
Add BIP70 deprecation warnings
2 parents ec81a9f + fa9372f commit c047e09

File tree

5 files changed

+18
-3
lines changed

5 files changed

+18
-3
lines changed

_data/devdocs/en/examples/payment_processing.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ This file is licensed under the MIT License (MIT) available on
33
http://opensource.org/licenses/MIT.
44
{% endcomment %}
55
{% assign filename="_data/devdocs/en/examples/payment_processing.md" %}
6+
{% assign DEPRECATED='Deprecated' %}
67

78

89
## Payment Processing
@@ -16,6 +17,13 @@ http://opensource.org/licenses/MIT.
1617
To request payment using the payment protocol, you use an extended (but
1718
backwards-compatible) `bitcoin:` URI. For example:
1819

20+
![Warning icon](/img/icons/icon_warning.svg?{{site.time | date: '%s'}})
21+
**Warning:** The payment protocol is considered to be deprecated and will be removed in a later version of Bitcoin Core.
22+
The protocol has multiple security design flaws and implementation flaws in some wallets.
23+
Users will begin receiving deprecation warnings in Bitcoin Core version 0.18 when using BIP70 URI's.
24+
Merchants should transition away from BIP70 to more secure options such as BIP21.
25+
Merchants should never require BIP70 payments and should provide BIP21 fallbacks.
26+
1927
{% endautocrossref %}
2028

2129
~~~

_data/devdocs/en/guides/payment_processing.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -256,6 +256,13 @@ displayed on high-resolution screens.
256256

257257
{% autocrossref %}
258258

259+
![Warning icon](/img/icons/icon_warning.svg?{{site.time | date: '%s'}})
260+
**Warning:** The payment protocol is considered to be deprecated and will be removed in a later version of Bitcoin Core.
261+
The protocol has multiple security design flaws and implementation flaws in some wallets.
262+
Users will begin receiving deprecation warnings in Bitcoin Core version 0.18 when using BIP70 URI's.
263+
Merchants should transition away from BIP70 to more secure options such as BIP21.
264+
Merchants should never require BIP70 payments and should provide BIP21 fallbacks.
265+
259266
Bitcoin Core 0.9 supports the new [payment protocol][/en/glossary/payment-protocol]{:#term-payment-protocol}{:.term}. The payment protocol
260267
adds many important features to payment requests:
261268

_data/devdocs/en/guides/transactions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -259,7 +259,7 @@ that script does. Receivers do care about the script conditions and, if
259259
they want, they can ask spenders to use a particular pubkey script.
260260
Unfortunately, custom pubkey scripts are less convenient than short
261261
Bitcoin addresses and there was no standard way to communicate them
262-
between programs prior to widespread implementation of the BIP70 Payment
262+
between programs prior to widespread implementation of the now deprecated BIP70 Payment
263263
Protocol discussed later.
264264

265265
To solve these problems, pay-to-script-hash

_data/devdocs/en/references/p2p_networking.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ http://opensource.org/licenses/MIT.
1212

1313
This section describes the Bitcoin P2P network protocol (but it is [not a
1414
specification][]). It does not describe the discontinued direct [IP-to-IP
15-
payment protocol][], the [BIP70 payment protocol][/en/glossary/payment-protocol], the
15+
payment protocol][], the [deprecated BIP70 payment protocol][/en/glossary/payment-protocol], the
1616
[GetBlockTemplate mining protocol][section getblocktemplate], or any
1717
network protocol never implemented in an official version of Bitcoin Core.
1818

_data/glossary/en/payment-protocol.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ required:
77
title_max_40_characters_no_formatting: Payment Protocol, Payment Request, BIP70
88

99
summary_max_255_characters_no_formatting: >
10-
The protocol defined in BIP70 (and other BIPs) which lets
10+
The deprecated protocol defined in BIP70 (and other BIPs) which lets
1111
spenders get signed payment details from receivers.
1212
1313
synonyms_shown_in_glossary_capitalize_first_letter:

0 commit comments

Comments
 (0)