ビットコインのQRコードの仕様
今日の#bitcoin-devで、携帯電話での利用について面白い議論があった。中心になったのは、次の使い方だ。
- 客が実際の店に入り、品物をいくつか選んで、会計のためにレジへ行く
- レジ係が、客に向いた画面にQRコードを表示する
- 客が携帯電話でQRコードを撮る
- 携帯電話に「Big Box Store Corporation, Incが300 BTCの支払いを求めています。同意しますか? はい/いいえ」と表示される
- 客が同意する(か、買い物を取りやめる)と、客から店へBTCが送られる
そこで、tcatmとneliskyと私は、APIのメモをhttp://www.bitcoin.org/wiki/doku.php?id=phone_apiに書き始めた。支払いの要求については、tcatmかneliskyがその気になれば話してくれるだろう。私は、みんながすぐに使い始められるQRコードの仕様を決めることに絞りたかった。
どれも、RFC822のヘッダーの形式(「key: value」)のテキストの文字列で、「value」はさらにセミコロンで区切る。セミコロンや空白を含む文字列は、二重引用符で囲める。二重引用符そのものは、ごく普通に、バックスラッシュでエスケープする。
- ビットコインアドレス。いま述べた、携帯電話で買い物をする場面には直接関係しないが、当然必要だ。
bitcoin-address1: name="John Q. Public"; pubkey=1LGpwDU5djqsR1X14Tcass3y9fULTzxJq3
このQRコードを使えば、携帯電話でビットコインアドレスをほかの人に伝えられる。このQRコードをフォーラムや自分のウェブサイトに載せて、寄付用のビットコインアドレスを配ろう!
- 店からの、ビットコインのネットワークでの直接の支払いの要求。
btcpayment-request1: name=“My Bitcoin Inc.”; pubkey=1LGpwDU5djqsR1X14Tcass3y9fULTzxJq3; amount=300
このQRコードがあれば、携帯電話は、指定のビットコインアドレスのMy Bitcoin, Inc.に300 BTCを払うかどうかを、利用者に尋ねられる。携帯電話は、直接(軽量のビットコインクライアント)か、このような (http://mtgox.com/support/tradeAPI)支払いのAPIを通して間接に、ビットコインで支払えるものとする。
- 店からの、独自の決済処理業者を通す間接の支払いの要求。
payment-request1: merchant=1234; name=“My Bitcoin Inc.”; tx_id=1234bacd;
payment-processor=http://mtgox.com/apiv1; api=mtgox; amount=300; currency=BTC
このQRコードがあれば、携帯電話のアプリが「mtgox」というAPIを知っているかぎり、携帯電話は、指定された独自のWeb APIを使ってMy Bitcoin, Inc.に300 BTCを払うかどうかを、利用者に尋ねられる。
末尾の「1」は、そのQRコードのバージョン1を表す。互換性のない変更をするときは、「bitcoin-address1」を「bitcoin-address2」にする、という具合だ。