ビットコイン・インスティテュート

ビットコインのQRコードの仕様

1件のメッセージ BitcoinTalk ジェフ・ガージック 2010年12月2日 — 2010年12月2日

今日の#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」はさらにセミコロンで区切る。セミコロンや空白を含む文字列は、二重引用符で囲める。二重引用符そのものは、ごく普通に、バックスラッシュでエスケープする。

  1. ビットコインアドレス。いま述べた、携帯電話で買い物をする場面には直接関係しないが、当然必要だ。
bitcoin-address1: name="John Q. Public"; pubkey=1LGpwDU5djqsR1X14Tcass3y9fULTzxJq3

このQRコードを使えば、携帯電話でビットコインアドレスをほかの人に伝えられる。このQRコードをフォーラムや自分のウェブサイトに載せて、寄付用のビットコインアドレスを配ろう!

  1. 店からの、ビットコインのネットワークでの直接の支払いの要求。
btcpayment-request1: name=“My Bitcoin Inc.”; pubkey=1LGpwDU5djqsR1X14Tcass3y9fULTzxJq3; amount=300

このQRコードがあれば、携帯電話は、指定のビットコインアドレスのMy Bitcoin, Inc.に300 BTCを払うかどうかを、利用者に尋ねられる。携帯電話は、直接(軽量のビットコインクライアント)か、このような (http://mtgox.com/support/tradeAPI)支払いのAPIを通して間接に、ビットコインで支払えるものとする。

  1. 店からの、独自の決済処理業者を通す間接の支払いの要求。
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」にする、という具合だ。