Sep 11th, 2010
- A proposed URI scheme for bitcoin. Revision t1, nearly not incomplete.
- (EBNF-like notion used)
- uri := schema (":" item)+
- schema := ["x-"] "btc"
- item := (thing [("?" label)+] ";")+ [action]
- thing := address | private_key | public_key | raw_transaction | value | custom
- address := "addr=" bitcoin_address
- private_key := "privkey=" encoded_private_key
- public_key := "pubkey=" encoded_public_key
- raw_transaction := "rawtxn=" encoded_raw_transaction
- value := "value=" decimal | "value=???"
- action := "send" | "store"
- custom := "x-" customParam "=" customParamValue
- encoded_raw_transaction is a base64url encoded transaction in Bitcoin network format.
- encoded_private_key is a base64url encoded private key used by Bitcoin.
- encoded_public_key is a base64url encoded public key used by Bitcoin.
- address is a Bitcoin address, as used by Bitcoin.
- value is the number of bitcoins associated with the data. This MUST be specified in the same way as 0.3.x versions of Bitcoin: nValue / 100,000,000.
- label is a short string describing the previous "thing". The Bitcoin client MAY display and/or record this label, but if it records the label it SHOULD allow the user to change or remove it first.
- action is "send" when the user is expected to send bitcoins to the specified public key or address, and "store" when the user is expected to store or import the data.
- If two of the same type of parameter are given in one "item", the Bitcoin client SHOULD give the user a choice of which value to actually use.
- Padding is NOT RECOMMENDED for base64url-encoded data.
- Send 50 BTC to address 1NX... (label "theymos").
- Send 50 BTC OR 0.01 BTC to 1NX...
- Send 50 BTC to address 1NX... (label "theymos") AND 100.20 BTC to address 1Gxy... (label "abc" OR "def").
- Store 1NXY... in your address book with the label "theymos".
- Open a "Send bitcoins" dialog for the public key Ad0a... You need to fill in any value and label information.
- Add public key Pm_W... to your wallet and rescan the block chain for transactions to it. Any bitcoins gotten with this keypair SHOULD be immediately and automatically sent to a new, secret address.
- Act as though you received the transaction AeOc... from one of your network peers.
Please, Sign In to add comment