MIME-Version: 1.0
From: Srintuar <srintuar@gmail.com>
Date: Thu, 18 Oct 2018 20:29:42 -0400
Message-ID: <CACUQsLKPk6n6DrXiuoLAKbYAEXrYZeJTs+1F8M6u5v0ReqQAeA@mail.gmail.com>
To: bitcoin-dev@lists.linuxfoundation.org
Content-Type: multipart/alternative; boundary="000000000000929cf605788a0083"
Subject: [bitcoin-dev] Reformatted BIP proposal for address backward
	compatibility
Precedence: list

--000000000000929cf605788a0083
Content-Type: text/plain; charset="UTF-8"

I have included the comma delimited list in the proposal this time.
It occurs to me that it is simpler to just include the desired destination
script, so I included that as well as an alternative.

Perhaps that should be included as an option in the spec, at the risk of
additional complexity. Alternatively, it could replace the entire
proposal....


---------------------------------------------------

A simple BIP writeup for a backward compatible URI scheme to help with
segwit adoption by online stores and metchants.


====


This BIP is a modification of an earlier [[bip-0021.mediawiki|BIP 0021]] by
Nils Schneider and Matt Corallo

==Abstract==
This BIP proposes a URI scheme which allows for backward compatibility with
native segwit (bech32) wallets and legacy wallets (base58)

==Motivation==
The purpose of this URI scheme is to enable all users to easily make
payments from any wallet, without allowing backward compatibility to be a
barrier to segwit adoption. This BIP allows a merchant to preferentially
receive payments to a bech32 address, while gracefully allowing older
clients to make base58 encoded payments.

A comma separated, ordered list of preferred addresses is supplied as
alternatives to the address field from BIP21. The list is ordered from most
preferred to least, with the BIP21 address implicitly last. Senders should
send to the first address which they know how to send to.

==Specification==

=== Query Keys ===

*address: an ordered list bitcoin destination which is preferred over the
"address" of the url, in order from most preferred to less, with the url
address value as least preferred

=== ABNF Grammar ===

    bitcoinaddress = base58 / bech32 / <future address format>
    bitcoinaddresslist = bitcoinaddress [ "," bitcoinaddresslist ]

== Appendix ==

=== Simpler syntax ===

 <nowiki>bitcoin:<address>[?amount=<amount>][?label=<label>][?message=<message>][?address=<bitcoinaddresslist>]</nowiki>

=== Examples ===

Just the address:
 bitcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?address=bc1q5u92yq20hss4rc99mfu23h4dxkxn4uuyqd5dzy
 QR size: ~370 bytes

The address and other fields:
 bitcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?addr=bc1q5u92yq20hss4rc99mfu23h4dxkxn4uuyqd5dzy&amount=50&label=Luke-Jr&message=Donation%20for%20project%20xyz
 QR size: ~470 bytes


Multiple addresses:
 bitcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?address=bc1qq82ajthl5mlm50h6x70esvxs7atp3vfnjwp8z5kjdepsjqqw3zcs9u4nnp,bc1q5u92yq20hss4rc99mfu23h4dxkxn4uuyqd5dzy

 QR size: ~540 bytes


== Reference Implementations ==

=== Bitcoin clients ===

* none yet

== Alternative Proposal ==

Just include the desired script itself, encoded as hex:

 bitcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?script=0014a70aa2014fbc2151e0a5da78a8dead358d3af384

=== Pros ===

* Infinite forward compatibility with any future script design
* Raw hex encoded scripts are short, and thus would make easy to scan images
* no need for list processing, or multiple alternatives

=== Cons ==

* address encoding features including checksum and network identification
would be absent
* errors in script formation not detectable by the sender; risk of funds
loss if the script is spendable but incorrect
* all error detection depends on the QR code or other transmission medium
* A separate top level uri scheme, such as bitcoinscript:<hex> might be
more appropriate, but would cost backwards compatibility

--000000000000929cf605788a0083
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div><br></div><div>I have included the c=
omma delimited list in the proposal this time. <br></div><div></div><div>It=
 occurs to me that it is simpler to just include the desired destination sc=
ript, so I included that as well as an alternative.</div><div><br></div><di=
v>Perhaps that should be included as an option in the spec, at the risk of =
additional complexity. Alternatively, it could replace the entire proposal.=
...<br></div><div><br></div><div><br></div><div><br></div><div><br></div><d=
iv>---------------------------------------------------</div><div><br></div>=
<div>A simple BIP writeup for a backward compatible URI scheme to help with=
 segwit adoption by online stores and metchants.<br></div><div><br></div><d=
iv><br>=3D=3D=3D=3D<br><br><br>This BIP is a modification of an earlier [[b=
ip-0021.mediawiki|BIP 0021]] by Nils Schneider and Matt Corallo<br><br>=3D=
=3DAbstract=3D=3D<br>This BIP proposes a URI scheme which allows for backwa=
rd compatibility with native segwit (bech32) wallets and legacy wallets (ba=
se58)<br><br>=3D=3DMotivation=3D=3D<br>The purpose of this URI scheme is to=
 enable all users to easily make payments from any wallet, without allowing=
 backward compatibility to be a barrier to segwit adoption. This BIP allows=
 a merchant to preferentially receive payments to a bech32 address, while g=
racefully allowing older clients to make base58 encoded payments.<br><br>A =
comma separated, ordered list of preferred addresses is supplied as alterna=
tives to the address field from BIP21. The list is ordered from most prefer=
red to least, with the BIP21 address implicitly last. Senders should send t=
o the first address which they know how to send to.<br><br>=3D=3DSpecificat=
ion=3D=3D<br><br>=3D=3D=3D Query Keys =3D=3D=3D<br><br>*address: an ordered=
 list bitcoin destination which is preferred over the &quot;address&quot; o=
f the url, in order from most preferred to less, with the url address value=
 as least preferred<br><br>=3D=3D=3D ABNF Grammar =3D=3D=3D<br><br>=C2=A0=
=C2=A0=C2=A0 bitcoinaddress =3D base58 / bech32 / &lt;future address format=
&gt;<br>=C2=A0=C2=A0=C2=A0 bitcoinaddresslist =3D bitcoinaddress [ &quot;,&=
quot; bitcoinaddresslist ]<br><br>=3D=3D Appendix =3D=3D<br><br>=3D=3D=3D S=
impler syntax =3D=3D=3D<br><br>=C2=A0&lt;nowiki&gt;bitcoin:&lt;address&gt;[=
?amount=3D&lt;amount&gt;][?label=3D&lt;label&gt;][?message=3D&lt;message&gt=
;][?address=3D&lt;bitcoinaddresslist&gt;]&lt;/nowiki&gt;<br><br>=3D=3D=3D E=
xamples =3D=3D=3D<br><br>Just the address:<br>=C2=A0bitcoin:3BnsWZiTdYVrqiP=
h2RP3q9Y3ZqvhbCN2it?address=3Dbc1q5u92yq20hss4rc99mfu23h4dxkxn4uuyqd5dzy<br=
>=C2=A0QR size: ~370 bytes <br><br>The address and other fields:<br>=C2=A0b=
itcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?addr=3Dbc1q5u92yq20hss4rc99mfu23h=
4dxkxn4uuyqd5dzy&amp;amount=3D50&amp;label=3DLuke-Jr&amp;message=3DDonation=
%20for%20project%20xyz<br>=C2=A0QR size: ~470 bytes<br><br><br>Multiple add=
resses:<br>=C2=A0bitcoin:3BnsWZiTdYVrqiPh2RP3q9Y3ZqvhbCN2it?address=3Dbc1qq=
82ajthl5mlm50h6x70esvxs7atp3vfnjwp8z5kjdepsjqqw3zcs9u4nnp,bc1q5u92yq20hss4r=
c99mfu23h4dxkxn4uuyqd5dzy <br>=C2=A0QR size: ~540 bytes<br><br><br>=3D=3D R=
eference Implementations =3D=3D<br><br>=3D=3D=3D Bitcoin clients =3D=3D=3D<=
br><br>* none yet<br><br>=3D=3D Alternative Proposal =3D=3D<br><br>Just inc=
lude the desired script itself, encoded as hex:<br><br>=C2=A0bitcoin:3BnsWZ=
iTdYVrqiPh2RP3q9Y3ZqvhbCN2it?script=3D0014a70aa2014fbc2151e0a5da78a8dead358=
d3af384<br><br>=3D=3D=3D Pros =3D=3D=3D<br><br>* Infinite forward compatibi=
lity with any future script design<br>* Raw hex encoded scripts are short, =
and thus would make easy to scan images<br>* no need for list processing, o=
r multiple alternatives<br><br>=3D=3D=3D Cons =3D=3D<br><br>* address encod=
ing features including checksum and network identification would be absent<=
br>* errors in script formation not detectable by the sender; risk of funds=
 loss if the script is spendable but incorrect<br>* all error detection dep=
ends on the QR code or other transmission medium<br>* A separate top level =
uri scheme, such as bitcoinscript:&lt;hex&gt; might be more appropriate, bu=
t would cost backwards compatibility<br><br><br><br><br><br><br><br></div><=
/div></div>

--000000000000929cf605788a0083--