bitcoin-cliコマンド【getblock】

2018-11-02

getblock “blockhash” ( verbosity )

blockhashで指定したハッシュに該当するブロック情報を返却する。verbosity(オプション)に指定した値(”0″、”1″、”2″)で返却値が変わる。

引数

① blockhash (string, required)

取得したいブロックのハッシュを指定。

② verbosity (numeric, optional, default=1)

“0”、”1″、”2″ を指定する。

“0”:16進数でエンコードされたシリアルデータ
“1”:Object形式になる。トランザクションはIDのみ。
“2”:Object形式。トランザクション情報も全て出力される。

実行例

verbosity=0

$ bitcoin-cli getblock 00000000000000000013dbc84125e52112766bb5677099dbdece862cb41e66d7 0

00000020fa635b08ca923c84f06a27a96828c99e49de520c0523110000000000000000004802955cc4587859eb746aafe76ee5159e42ee1dec11d2be38537b0ac239f535ba37c65b91c12517eac35563fdb708010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff4503fb5408fabe6d6db0f2e71a4f29506de920b6e014659e1f5db55af19a828acb87d83bd18e20928101000000000000002b651000020009000d65c240bb062f736c7573682f000000000330c8634b000000001976a9147c154ed1dc59609e3d26abb2df2ea3d587cd8c4188ac00000000000000002c6a4c2952534b424c4f434b3a735323f5b0ca15a0b6b406ff5666cb9f93f9f0edcf97b35803d853574e70a34d0000000000000000266a24aa21a9ed5c526ff7e5c75d4b43444021b4cb45655968936f050672b3599e33e3bec54a770120000000000000000000000000000000000000000000000000000000000000000000000000020000
〜 省略 〜

verbosity=1

$ bitcoin-cli getblock 00000000000000000013dbc84125e52112766bb5677099dbdece862cb41e66d7 1

{
  "hash": "00000000000000000013dbc84125e52112766bb5677099dbdece862cb41e66d7",
  "confirmations": 20,
  "strippedsize": 936765,
  "size": 1182993,
  "weight": 3993288,
  "height": 546043,
  "version": 536870912,
  "versionHex": "20000000",
  "merkleroot": "35f539c20a7b5338bed211ec1dee429e15e56ee7af6a74eb597858c45c950248",
  "tx": [
    "5dcfa349b54fc361a2e9f447544d46b08e7f3c1823801c7f3a05a56e09948b9d",
    "5233c2542088b40e6170007d14092b3fc868eba9d7e7188bc03fd6b4cb1952be",
〜 中略 〜
    "e9cff9ae72a0c66842df7e05e2a9e9506bcb05918c67cb63eec579f52ab666cc",
    "cb821d78252c6b859592559913c04eca4e9c7b92a42b2b04806ad96c2d989eed"
  ],
  "time": 1539717050,
  "mediantime": 1539716351,
  "nonce": 1666565098,
  "bits": "1725c191",
  "difficulty": 7454968648263.241,
  "chainwork": "000000000000000000000000000000000000000003a2bd60f31caaa33aac9f20",
  "nTx": 2231,
  "previousblockhash": "0000000000000000001123050c52de499ec92868a9276af0843c92ca085b63fa",
  "nextblockhash": "00000000000000000019c487cadd3939c2a2fb8e085bee305d8192ce9b954631"
}

verbosity=2(tx部分のみ)

$ bitcoin-cli getblock 00000000000000000013dbc84125e52112766bb5677099dbdece862cb41e66d7 2
{
〜 中略 〜
  "tx": [
    {
      "txid": "5dcfa349b54fc361a2e9f447544d46b08e7f3c1823801c7f3a05a56e09948b9d",
      "hash": "c06d4f9965dc016bf1a3e31d8ea0fb6f49923c0dcdcbbe3a5728d94b8923078f",
      "version": 1,
      "size": 290,
      "vsize": 263,
      "weight": 1052,
      "locktime": 0,
      "vin": [
        {
          "coinbase": "03fb5408fabe6d6db0f2e71a4f29506de920b6e014659e1f5db55af19a828acb87d83bd18e20928101000000000000002b651000020009000d65c240bb062f736c7573682f",
          "sequence": 0
        }
      ],
      "vout": [
        {
          "value": 12.64830512,
          "n": 0,
          "scriptPubKey": {
            "asm": "OP_DUP OP_HASH160 7c154ed1dc59609e3d26abb2df2ea3d587cd8c41 OP_EQUALVERIFY OP_CHECKSIG",
            "hex": "76a9147c154ed1dc59609e3d26abb2df2ea3d587cd8c4188ac",
            "reqSigs": 1,
            "type": "pubkeyhash",
            "addresses": [
              "1CK6KHY6MHgYvmRQ4PAafKYDrg1ejbH1cE"
            ]
          }
        },
        {
          "value": 0.00000000,
          "n": 1,
          "scriptPubKey": {
            "asm": "OP_RETURN 52534b424c4f434b3a735323f5b0ca15a0b6b406ff5666cb9f93f9f0edcf97b35803d853574e70a34d",
            "hex": "6a4c2952534b424c4f434b3a735323f5b0ca15a0b6b406ff5666cb9f93f9f0edcf97b35803d853574e70a34d",
            "type": "nulldata"
          }
        },
        {
          "value": 0.00000000,
          "n": 2,
          "scriptPubKey": {
            "asm": "OP_RETURN aa21a9ed5c526ff7e5c75d4b43444021b4cb45655968936f050672b3599e33e3bec54a77",
            "hex": "6a24aa21a9ed5c526ff7e5c75d4b43444021b4cb45655968936f050672b3599e33e3bec54a77",
            "type": "nulldata"
          }
        }
      ],
      "hex": "010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff4503fb5408fabe6d6db0f2e71a4f29506de920b6e014659e1f5db55af19a828acb87d83bd18e20928101000000000000002b651000020009000d65c240bb062f736c7573682f000000000330c8634b000000001976a9147c154ed1dc59609e3d26abb2df2ea3d587cd8c4188ac00000000000000002c6a4c2952534b424c4f434b3a735323f5b0ca15a0b6b406ff5666cb9f93f9f0edcf97b35803d853574e70a34d0000000000000000266a24aa21a9ed5c526ff7e5c75d4b43444021b4cb45655968936f050672b3599e33e3bec54a770120000000000000000000000000000000000000000000000000000000000000000000000000"
    },
〜 中略 〜
    {
      "txid": "cb821d78252c6b859592559913c04eca4e9c7b92a42b2b04806ad96c2d989eed",
      "hash": "cb821d78252c6b859592559913c04eca4e9c7b92a42b2b04806ad96c2d989eed",
      "version": 1,
      "size": 224,
      "vsize": 224,
      "weight": 896,
      "locktime": 0,
      "vin": [
        {
          "txid": "c227ddb19fd0c206a77967a842b3e5288809634cec134c80458487a0cd2541cd",
          "vout": 1,
          "scriptSig": {
            "asm": "3045022100e4e5a1c9f112ba24f3d6fbe55b7dcf15b3a70af04e0c40219672d3ab61496de802207add0a375550a193f72d2c21215416a406556c0d968776448db019768db16c58[ALL] 02120e16386679b2020328cae67c46a403727d084a6190e0789de03e9a3d71b955",
            "hex": "483045022100e4e5a1c9f112ba24f3d6fbe55b7dcf15b3a70af04e0c40219672d3ab61496de802207add0a375550a193f72d2c21215416a406556c0d968776448db019768db16c58012102120e16386679b2020328cae67c46a403727d084a6190e0789de03e9a3d71b955"
          },
          "sequence": 4294967295
        }
      ],
      "vout": [
        {
          "value": 0.00246453,
          "n": 0,
          "scriptPubKey": {
            "asm": "OP_DUP OP_HASH160 d907a172a576fa918376557f3808111934eb4f2a OP_EQUALVERIFY OP_CHECKSIG",
            "hex": "76a914d907a172a576fa918376557f3808111934eb4f2a88ac",
            "reqSigs": 1,
            "type": "pubkeyhash",
            "addresses": [
              "1LnYmpEoa4Fxian36odbit7rwajApnKMTA"
            ]
          }
        },
        {
          "value": 0.00155400,
          "n": 1,
          "scriptPubKey": {
            "asm": "OP_HASH160 083d10a6a63b58d9ae6c603f6f8ea8f77b3d27ac OP_EQUAL",
            "hex": "a914083d10a6a63b58d9ae6c603f6f8ea8f77b3d27ac87",
            "reqSigs": 1,
            "type": "scripthash",
            "addresses": [
              "32SaUxAe7fXsByNWBUqJy9q3XiygYXWRdo"
            ]
          }
        }
      ],
      "hex": "0100000001cd4125cda0878445804c13ec4c63098828e5b342a86779a706c2d09fb1dd27c2010000006b483045022100e4e5a1c9f112ba24f3d6fbe55b7dcf15b3a70af04e0c40219672d3ab61496de802207add0a375550a193f72d2c21215416a406556c0d968776448db019768db16c58012102120e16386679b2020328cae67c46a403727d084a6190e0789de03e9a3d71b955ffffffff02b5c20300000000001976a914d907a172a576fa918376557f3808111934eb4f2a88ac085f02000000000017a914083d10a6a63b58d9ae6c603f6f8ea8f77b3d27ac8700000000"
    }
  ],
〜 中略 〜
}

出力内容

verbosity=0

data (string)

16進数でエンコードされたシリアルデータ。

verbosity=1

hash (string)

このブロックのブロックハッシュ(引数で指定したものと同じになる)

confirmations (numeric)

confirmation数。ブロックがメインチェーン上にない場合は -1 になる。

strippedsize (numeric)

witnessデータを除いたブロックサイズ

size (numeric)

ブロックサイズ

weight (numeric)

BIP141で定義されたブロック重量

Block weight is defined as Base size * 3 + Total size. (rationale[3])

https://github.com/bitcoin/bips/blob/master/bip-0141.mediawiki

height (numeric)

ブロック高(ブロック番号)

version (numeric)

ブロックバージョン

versionHex (string)

16進数にフォーマットされたブロックバージョン

merkleroot (string)

Merkleルートのハッシュ値

tx [ ] (array of string)

トランザクションデータの配列

transactionid (string)

トランザクションID

time (numeric)

ブロック時間(UNIX時間)。マイナーが設定。

mediantime (numeric)

ブロック時間(UNIX時間)。”time” との違いは、過去11ブロックのタイムスタンプの中央値を採用するため、 過去のブロックよりも必ず増加した時間になる。

“time”と”mediantime”の違いについて
Difference between “time” and “mediantime” in getblock?

nonce (numeric)

ノンス

bits (string)

ビッツ(= 0.000001BTC)

difficulty (numeric)

難易度

chainwork (string)

このブロックまでチェーンを生成するのに必要なハッシュの予測値(16進数)

nTx (numeric)

ブロック内のトランザクションの数。

previousblockhash (string)

前のブロックハッシュ

nextblockhash (string)

次のブロックハッシュ

strippedsizeとweightの違いについて

verbosity=2

txの部分以外はverbosity=1と同じ。tx配列のフォーマットはgetrawtransactionを参照。