0.7のgettransaction/getblockのRPC
「生のトランザクション」 (https://gist.github.com/2839617)のAPIの作業をしていて、gettransactionとgetblockのRPCについて、じっくり考えることになった。この二つが返す情報を、新しいcreaterawtxなどのAPIで使いやすくしたい。
まず、バージョン0.6.3までのgettransactionは、自分のウォレットにあるトランザクションの情報しか返さず、トランザクションの情報の全部を返すわけでもなかった。
1、2か月前に、ピーターとLukeが、gettransactionとgetblockを変えて、ブロックチェーンにあるどのトランザクションの情報でも返すようにするコードを書いた。そして、この二つのRPCに、「decompositions」というObjectの引数が新しく加わった。トランザクションの入力と出力の情報の取り方を、5通り(no/hash/hex/asm/obj)から指定できる。たとえば、こう使う。
gettransaction 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 '{"script":hex}'
情報を取る(「no」を指定すれば取らない)方法が5通りというのは、4つ多すぎると思う。そこで、コードを次のように変えている。
- getblockはバージョン0.6から変えない。トランザクションIDの一覧を、「tx」という配列で返す。
- gettransactionに、真偽値の引数を一つ足す。既定は0(偽)だ。0以外を渡すと、出力が詳しくなり、トランザクションの入力と出力の情報を、用意されている形式の全部で出す(decompositionの「obj」と同じ)。
- 「生のトランザクション」のAPIと合わせるため、gettransactionは、直列化して16進数にしたトランザクションの全データを、「rawtx」という新しい項目でいつも返す。
RPCを使う人は、最小限の情報を早くほしいか、全部の情報がほしくて余分な情報が付いてきてもあまり気にしないかの、どちらかだろうという考えだ。全部の情報をできるだけ早くほしい人は、「rawtx」を自分で解読するコードを書けばいい。
こうすると、あるブロックの全部のトランザクションについて全部の情報を取るには、RPCを2回以上呼ぶことになる。ただ、ジェフがJSON-2.0の「バッチ」呼び出しのプルリクエストを出している。それが入れば、RPCの往復は2回で済む(getblockを1回、それからgettransactionをまとめて入れたバッチを1回)。
はっきりさせておく。この変更は、バージョン0.6.3までのgetblockとgettransactionと、100%後方互換にするつもりだ。変わるのは、引数が増えることと、返ってくるJSONのオブジェクトの情報が増えることだけだ。
テストネットの、込み入ったマルチシグのトランザクションでの出力例:
短い出力(ウォレットにあるトランザクション):
$ ./bitcoind -testnet gettransaction 4ec492788efb3c9e4e23972f095bd575217288c9f6b8237922145aeff8dae8d5
{
"rawtx" : "0100000001c6660657eb258f9e58d246d767f5aaa15980d4d26ee496e7e24fabf72f2cc3440000000048473044022026b2e3d408a7848ad18b35042163c0efb358c456c6006a0cd13c077ec213aeab02202115a38de465e0c927f858cbb83fca45bddb0e469524667e39fd0c54ab5007d701ffffffff0100f2052a0100000017a914b6cb85e6fa58b2bff3da23074eb0f1a0ddb23e1f8700000000",
"amount" : -50.00000000,
"fee" : 0.00000000,
"confirmations" : 2,
"blockhash" : "0000000003abdd41db27190bb4f19e36497f647d1ea586ef543c44f7ccd40015",
"blockindex" : 1,
"txid" : "4ec492788efb3c9e4e23972f095bd575217288c9f6b8237922145aeff8dae8d5",
"time" : 1339001503,
"details" : [
{
"account" : "",
"address" : "2N9uknE7Zy9M3cPxWvkHu9HQiArL3pnbcUF",
"category" : "send",
"amount" : -50.00000000,
"fee" : 0.00000000
}
]
}
詳しい出力:
$ ./bitcoind -testnet gettransaction 4ec492788efb3c9e4e23972f095bd575217288c9f6b8237922145aeff8dae8d5 1
{
"rawtx" : "0100000001c6660657eb258f9e58d246d767f5aaa15980d4d26ee496e7e24fabf72f2cc3440000000048473044022026b2e3d408a7848ad18b35042163c0efb358c456c6006a0cd13c077ec213aeab02202115a38de465e0c927f858cbb83fca45bddb0e469524667e39fd0c54ab5007d701ffffffff0100f2052a0100000017a914b6cb85e6fa58b2bff3da23074eb0f1a0ddb23e1f8700000000",
"version" : 1,
"locktime" : 0,
"vin" : [
{
"prevout" : {
"hash" : "44c32c2ff7ab4fe2e796e46ed2d48059a1aaf567d746d2589e8f25eb570666c6",
"n" : 0
},
"scriptSig" : {
"asm" : "3044022026b2e3d408a7848ad18b35042163c0efb358c456c6006a0cd13c077ec213aeab02202115a38de465e0c927f858cbb83fca45bddb0e469524667e39fd0c54ab5007d701",
"hex" : "473044022026b2e3d408a7848ad18b35042163c0efb358c456c6006a0cd13c077ec213aeab02202115a38de465e0c927f858cbb83fca45bddb0e469524667e39fd0c54ab5007d701",
"type" : "pubkey",
"addresses" : [
"n4DUWe93vkdfAiSVDaMP3okaU7upK2wtrr"
]
},
"sequence" : 4294967295
}
],
"vout" : [
{
"value" : 50.00000000,
"scriptPubKey" : {
"asm" : "OP_HASH160 b6cb85e6fa58b2bff3da23074eb0f1a0ddb23e1f OP_EQUAL",
"hex" : "a914b6cb85e6fa58b2bff3da23074eb0f1a0ddb23e1f87",
"reqSigs" : 1,
"type" : "scripthash",
"addresses" : [
"2N9uknE7Zy9M3cPxWvkHu9HQiArL3pnbcUF"
]
}
}
],
"amount" : -50.00000000,
"fee" : 0.00000000,
"confirmations" : 2,
"blockhash" : "0000000003abdd41db27190bb4f19e36497f647d1ea586ef543c44f7ccd40015",
"blockindex" : 1,
"txid" : "4ec492788efb3c9e4e23972f095bd575217288c9f6b8237922145aeff8dae8d5",
"time" : 1339001503,
"details" : [
{
"account" : "",
"address" : "2N9uknE7Zy9M3cPxWvkHu9HQiArL3pnbcUF",
"category" : "send",
"amount" : -50.00000000,
"fee" : 0.00000000
}
]
}
一つだけ気になっている機能は、トランザクションの入力について「addresses」と「type」を報告することだ。気になる理由は二つある。
-
そのデータを取ってくるのは高くつく。前のトランザクションをブロックチェーンから探して、ディスクから読み込むことになるからだ。「使っていない機能のために、負担がかかってはならない」という原則に反する。
-
「私たち」が、使用済みの入力の刈り込みを実装すると(ピーターが、早くも素晴らしい結果を出している)、そのデータがもうないことがある。
gettransactionの出力から「addresses」と「type」の情報を外して、gettransactionが前のトランザクションを調べなくて済むようにするほうが良いと思う。
前のトランザクションの情報が要る人は、vin.prevout.hashを使って、もう一度gettransactionを呼んで調べることになる(ここでも、JSON-2.0の「バッチ」の機能を使えば、前のトランザクションを全部、RPCの1往復で調べられる)。
トランザクションの刈り込みが入れば(入るとして)、動作の決まりははっきりしている。前のトランザクションが刈り込まれていたら、gettransactionはエラーを返す。