Difference between revisions of "BIP 0020"

From Bitcoin Wiki
Jump to: navigation, search
(Fix URI compliance)
(woops, fix units)
Line 18: Line 18:
 
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt
 
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt
  
Address with name:
+
Address with name:BTC
 
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?label=tcatm
 
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?label=tcatm
  
 
Request to send 20.30 BTC to me:
 
Request to send 20.30 BTC to me:
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=20.30&label=tcatm
+
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=20.30BTC&label=tcatm
  
 
Request to send 50 BTC with message:
 
Request to send 50 BTC with message:
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=50&label=tcatm&message=Payment%20for%20product%20xyz
+
  bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=50BTC&label=tcatm&message=Payment%20for%20product%20xyz
  
 
Characters must be URI encoded properly.
 
Characters must be URI encoded properly.

Revision as of 00:50, 10 January 2011

I propose a scheme like this:

() means optional, $* are placeholders

bitcoin://($host)/$address?amount=$size$unit(&label=$label)(&message=$message)

Variables

  • label: Label for that address (e.g. name of receiver)
  • 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 me:

bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=20.30BTC&label=tcatm

Request to send 50 BTC with message:

bitcoin:///18pnDgDYFMAKsHTA3ZqyAi6t8q9ztaWWXt?amount=50BTC&label=tcatm&message=Payment%20for%20product%20xyz

Characters must be URI encoded properly.