Difference between revisions of "BIP 0020"

From Bitcoin Wiki
Jump to: navigation, search
(BNF syntax)
m (copy paste error)
 
(82 intermediate revisions by 16 users not shown)
Line 1: Line 1:
I propose a scheme like this:
+
{{bip}}
  
[] means optional, <> are placeholders
+
<pre>
 +
  BIP: 20
 +
  Title: URI Scheme
 +
  Author: Luke Dashjr <luke+bip@dashjr.org>
 +
  Status: Replaced
 +
  Type: Standards Track
 +
  Created: 10-01-2011
 +
</pre>
  
bitcoin://[<host>]/<address>?amount=<size><unit>[&label=<label>][&message=<message>]
+
{{BipMoved|bip-0020.mediawiki}}
  
=== Variables ===
+
[[Category:Developer]]
 
+
[[Category:Technical]]
*label: Label for that address (e.g. name of receiver)
+
[[Category:BIP|D]]
*address: bitcoin address
 
*message: optional message that is shown to the user after scanning the QR code
 
*size: amount of $unit
 
*unit: BTC, [ᵗˢᵐᵇ]TBC[ᵗˢᵐᵇ], or null/omitted (which refers to the base unit)
 
 
 
== Examples ==
 
 
 
Just the address:
 
bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt
 
 
 
Address with name:BTC
 
bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?label=tcatm
 
 
 
Request to send 20.30 BTC to tcatm:
 
bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=20.30BTC&label=tcatm
 
 
 
Request to send 400 TBC to Luke:
 
bitcoin:///1KczVqwopWXQdFLe5sNQbpCq7yGSmXx2oo?amount=400TBC
 
 
 
Request to send 5 uBTC:
 
bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=500
 
 
 
Request to send 5 uBTC over the LAN to 192.168.1.2:
 
bitcoin://192.168.1.2/18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=500
 
 
 
Request to send 50 BTC with message:
 
bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8qztaWWXt?amount=50BTC&label=tcatm&message=Payment%20for%20product%20xyz
 
 
 
Characters must be URI encoded properly.
 
 
 
== BNF Syntax ==
 
 
 
bitcoinurl        = "bitcoin://" [ host ] "/" bitcoinaddress [ ";version=" bitcoinversion ] [ "?" bitcoinparams ]
 
bitcoinaddress = FIXME :)
 
bitcoinversion = "1.0"
 
bitcoinparams = *bitcoinparam
 
bitcoinparam = amountparam | labelparam | messageparam
 
amountparam = "amount=" digits bitcoinunit
 
bitcoinunit = "BTC" | "ᵇTBC" | "ᵐTBC" | "ˢTBC" | "ᵗTBC" | "TBC" | "TBCᵗ" | "TBCˢ" | "TBCᵐ" | "TBCᵇ"
 
labelparam = "label=" *uchar
 
messageparam = "label=" *uchar
 

Latest revision as of 13:42, 29 December 2015

This page describes a BIP (Bitcoin Improvement Proposal).
Please see BIP 2 for more information about BIPs and creating them. Please do not just create a wiki page.

  BIP: 20
  Title: URI Scheme
  Author: Luke Dashjr <luke+bip@dashjr.org>
  Status: Replaced
  Type: Standards Track
  Created: 10-01-2011

The full text of this BIP can be read here.