bitcoin-cliコマンド【getaddressinfo】

2018-11-01

getaddressinfo “address”

指定したビットコインアドレスに関する情報を返却する。自分のウォレット内のアドレスかどうかで返却情報が変わる。

引数

① address (string, required)

情報を取得したいビットコインアドレスを指定する。

実行例

$ bitcoin-cli -regtest getaddressinfo 2N5XCV67fmR2RtGq4v1osJFgHoyKbVStv6n
{
  "address": "2N5XCV67fmR2RtGq4v1osJFgHoyKbVStv6n",
  "scriptPubKey": "a91486a6e8ec0357e8d0cacacf8b0b5838f71aeef75487",
  "ismine": true,
  "iswatchonly": false,
  "isscript": true,
  "iswitness": false,
  "script": "witness_v0_keyhash",
  "hex": "0014b99dab2622f0eb845745d5c590bfea398921c710",
  "pubkey": "03e363f42ea67323dd2e6b67b6950acdb1dafdc77c897e9098492a88f7dfcbb515",
  "embedded": {
    "isscript": false,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "b99dab2622f0eb845745d5c590bfea398921c710",
    "pubkey": "03e363f42ea67323dd2e6b67b6950acdb1dafdc77c897e9098492a88f7dfcbb515",
    "address": "bcrt1qhxw6kf3z7r4cg4696hzep0l28xyjr3cs0gn4dm",
    "scriptPubKey": "0014b99dab2622f0eb845745d5c590bfea398921c710"
  },
  "label": "",
  "timestamp": 1539697411,
  "hdkeypath": "m/0'/0'/1'",
  "hdseedid": "c0e36912c1d87f273a7e9f8450a26c4472c4f977",
  "hdmasterkeyid": "c0e36912c1d87f273a7e9f8450a26c4472c4f977",
  "labels": [
    {
      "name": "",
      "purpose": "receive"
    }
  ]
}

出力内容

address (string)

ビットコインアドレス(引数で指定したものと同じ)

scriptPubKey (string)

アドレスから生成されたscriptPubKey(16進数)

ismine (boolean)

指定したアドレスが自分のものであれば “true” が表示される

iswatchonly (boolean)

指定したアドレスが参照のみであれば “true” が表示される

isscript (boolean)

キーがスクリプトであれば “true” が表示される

iswitness (boolean)

指定したアドレスがwitnessアドレスであれば “true” が表示される

witness_version (numeric)

witnessプログラムのバージョン。

witness_program (string)

witnessプログラム(16進数)

script (string)

出力スクリプトの種類。 “isscript” が “true” かつ redeemScript がわかっている場合に表示される。以下が対象のタイプ。
nonstandard, pubkey, pubkeyhash, scripthash, multisig, nulldata, witness_v0_keyhash, witness_v0_scripthash, witness_unknown

hex (string)

P2SH アドレスのredeemScript

pubkeys [ ] (object)

redeemScript に関連付けられた公開鍵の配列( “script” が “multisig” の場合のみ表示される)

pubkey (string)

公開鍵

sigsrequired (numeric)

multisig に必要な署名の数( “script” が “multisig” の場合のみ表示される)

pubkey (string)

single-keyアドレスの公開鍵の生データ(16進数) 。P2SHまたはP2WSHに埋め込まれている可能性がある。

embedded (object)

P2SHまたはP2WSHに埋め込まれたアドレスに関する情報。 出力されるのは、”getaddressinfo” の出力情報と同じだが、メタデータ(”timestamp”, “hdkeypath”, “hdseedid”)と、ウォレット関係(”ismine”, “iswatchonly”, “account”)が除かれたものになる。

iscompressed (boolean)

アドレスが圧縮されていれば “true” が表示される。

label (string)

アドレスに関連付けられたラベル。”” はデフォルトのラベル。

account (string)

非推奨のフィールドでv0.18で削除される。
アドレスに関連付けられているアカウント。 “” はデフォルトのアカウント。

timestamp (number)

キー作成時の時間。UNIX時間。

hdkeypath (string)

HDが利用可能な場合のHDキーパス
※HD:Hierarchy Deterministic (階層的決定性)

hdseedid (string)

HDシードのHASH160

hdmasterkeyid (string)

v0.18で削除される。
下位互換性用に残されている “hdseedid” の別名。出力内容は “hdseedid” と同じ

labels [ ] (object)

アドレスに関連づけられたラベルの配列

name (string)

ラベル名

purpose (string)

目的 (“send”, “receive”)

scriptPubKey, redeemscript, witness program,compress がいまいち理解できていない。redeemScriptについての現状の理解は、「支払い時に施したロックを解除するためのスクリプト」