bitcoin-cliコマンド【getmempoolancestors】

getmempoolancestors txid (verbose)

txid が mempool に存在する場合、mempool内のすべての祖先トランザクションを返します。

引数

① txid (string, required)

トランザクションID(mempool内に存在していなければならない)

② verbose (boolean, optional, default=false)

“true” の場合はjsonオブジェクトで返却。”false” の場合はトランザクションIDの配列で返却。

実行例

verbose=false

$ bitcoin-cli getmempoolancestors bbf560c933fc4831826a67fed66e9339b099219a35502086824d12cc98416ff1
[
  "05ac9614fd8d6def71b0ea922c03f09f1f88c905f63bcaca54ecff14d039e204",
  "309795bfc7ed1cd0822e96d034ae28bc18b9f0e5ac12d0f5ad8069a00b69371e",
  "eb314bb140e4b64cb04831c65462e1f433bdf27c6d47d39e6d93b3104ab89d24",
  "5e14d3f14408bb01378dafded3400f55476a6f0d21fbaf450442f0f704c33c25",
  "2290611ed076fef16a707a3debb7d50d3d20770310a5bf6dc2d7d73be7af543a",
  "afac6cb03443a7b1979d4f32ae8bfc85ebb661d55037cd70e1f40cd11bfa263e",
  "ff8144d269200a75c92c0d287d0ed9a4386da73a4b04133e7046e6fc664c3f40",
  "04119ef7b1fefdf13fbaaef561e2a6168c213adc99c84925f347c3dd8424d240",
  "e653069f77856330729e8fc70627c304c8a95e9ef53d1c4793e777186db5f748",
  "2a185077e71dd1caf8bfc0cf540bc0c2f8131938e77c61a464143f792e582d5a",
  "f0233a4f6093c268d52aa0d039259b1a8e23f01841b0bb3b284fd64e28556f5a",
  "f13056406d040593de08202e0e03087208a3047c49968d58a6f0a67fa00e835a",
  "5cbb5c15bb24786a5c160bd093031ebef7ced8f8b5a99ca3889fcadab1276c62",
  "bacbefbc31db2aa0da626295d0e43f316c266d60214d44720c93d8348c4588b4",
  "ef2f4cf3dc3fe753da602176d1a006f70bb86d55d93c035a1f693511c78d4ab6",
  "7307a62a54b9f7d192e05866b15a46788124dd986ec47429ff3525d759c389c7",
  "0f85d93eadbe5a03ea17032ea4188620ade2ccc492f0d5efda75608d6fa35dca",
  "13673ebef411e9a91a264a2ac0c7a6678d58099df57425f22fa075910381d5ce",
  "0576ba9899326bc4c67c31ca993584fbb3b10729f49947ba09317533640c2ddc",
  "1c8b31f429706e1927919066b1a43ba3ee15909f568483bab017b4a85b210fde",
  "a317407abb744e86a3ef2990910479dc28041fa1804264b291e89aeb423f61ec",
  "1e1e807b9e9f1255f30f0d3b9b1851f4f905e7865d53488fc9a50e758d8487f9",
  "4a5836616b613fa08f7b4b0ac3ec2ed2783e40de973ab8d0312016887f005dff"
]

verbose=true

$ bitcoin-cli getmempoolancestors bbf560c933fc4831826a67fed66e9339b099219a35502086824d12cc98416ff1 true
{
  "05ac9614fd8d6def71b0ea922c03f09f1f88c905f63bcaca54ecff14d039e204": {
    "fees": {
      "base": 0.00000678,
      "modified": 0.00000678,
      "ancestor": 0.00013560,
      "descendant": 0.00004068
    },
    "size": 226,
    "fee": 0.00000678,
    "modifiedfee": 0.00000678,
    "time": 1541399551,
    "height": 548832,
    "descendantcount": 6,
    "descendantsize": 1351,
    "descendantfees": 4068,
    "ancestorcount": 20,
    "ancestorsize": 4512,
    "ancestorfees": 13560,
    "wtxid": "05ac9614fd8d6def71b0ea922c03f09f1f88c905f63bcaca54ecff14d039e204",
    "depends": [
      "5e14d3f14408bb01378dafded3400f55476a6f0d21fbaf450442f0f704c33c25"
    ],
    "spentby": [
      "1c8b31f429706e1927919066b1a43ba3ee15909f568483bab017b4a85b210fde"
    ]
  },
〜 中略 〜
  "1e1e807b9e9f1255f30f0d3b9b1851f4f905e7865d53488fc9a50e758d8487f9": {
    "fees": {
      "base": 0.00000678,
      "modified": 0.00000678,
      "ancestor": 0.00003390,
      "descendant": 0.00014238
    },
    "size": 226,
    "fee": 0.00000678,
    "modifiedfee": 0.00000678,
    "time": 1541399540,
    "height": 548832,
    "descendantcount": 21,
    "descendantsize": 4734,
    "descendantfees": 14238,
    "ancestorcount": 5,
    "ancestorsize": 1129,
    "ancestorfees": 3390,
    "wtxid": "1e1e807b9e9f1255f30f0d3b9b1851f4f905e7865d53488fc9a50e758d8487f9",
    "depends": [
      "2290611ed076fef16a707a3debb7d50d3d20770310a5bf6dc2d7d73be7af543a"
    ],
    "spentby": [
      "f13056406d040593de08202e0e03087208a3047c49968d58a6f0a67fa00e835a"
    ]
  },
  "4a5836616b613fa08f7b4b0ac3ec2ed2783e40de973ab8d0312016887f005dff": {
    "fees": {
      "base": 0.00000678,
      "modified": 0.00000678,
      "ancestor": 0.00010848,
      "descendant": 0.00006780
    },
    "size": 226,
    "fee": 0.00000678,
    "modifiedfee": 0.00000678,
    "time": 1541399549,
    "height": 548832,
    "descendantcount": 10,
    "descendantsize": 2253,
    "descendantfees": 6780,
    "ancestorcount": 16,
    "ancestorsize": 3610,
    "ancestorfees": 10848,
    "wtxid": "4a5836616b613fa08f7b4b0ac3ec2ed2783e40de973ab8d0312016887f005dff",
    "depends": [
      "7307a62a54b9f7d192e05866b15a46788124dd986ec47429ff3525d759c389c7"
    ],
    "spentby": [
      "04119ef7b1fefdf13fbaaef561e2a6168c213adc99c84925f347c3dd8424d240"
    ]
  }
}

既にブロックに取り込まれたトランザクションを指定してもエラーとなる。試しに実行したい場合、現在のmempool内のトランザクションを getrawmempool で取得するのが良い。

出力内容

verbose=false

transactionid (string)

mempool内の祖先トランザクションID。

verbose=true

transactionid { } (json object)

fees { } (json object)

base (numeric)

トランザクション手数料(BTC)

modified (numeric)

マイニングのプライオリティに使用される fee deltas のトランザクション手数料(BTC)

ancestor (numeric)

mempool内の祖先の modifiedfee(このトランザクションを含む)(BTC)

descendant (numeric)

mempool内の子孫の modifiedfee(このトランザクションを含む)(BTC)

size (numeric)

BIP141で定義された virtual transaction size。witnessデータが含まれないため、witness transaction とはサイズが相違する。

Virtual transaction size is defined as Transaction weight / 4 (rounded up to the next integer).

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

fee (numeric) ※廃止予定

トランザクション手数料(BTC)

modifiedfee (numeric) ※廃止予定

マイニングのプライオリティに使用される fee deltas のトランザクション手数料

“fee deltas” というのはトランザクションの優先度を変えるために上乗せする架空の手数料…らしい。マイナーが個人的な送金をするために利用するのかな?あまり詳しい説明は見つからなかった。

time (numeric)

トランザクションが pool に入った時のローカルタイム(UNIX時間)

height (numeric)

トランザクションが pool に入った時のブロック高

descendantcount (numeric)

mempool内の子孫トランザクション数(このトランザクションを含む)

descendantsize (numeric)

mempool内の子孫の virtual transaction size(このトランザクションを含む)

descendantfees (numeric) ※廃止予定

mempool内の子孫の modifiedfee(このトランザクションを含む)

ancestorcount (numeric)

mempool内の祖先トランザクション数(このトランザクションを含む)

ancestorsize (numeric)

mempool内の祖先の virtual transaction size(このトランザクションを含む)

ancestorfees (numeric) ※廃止予定

mempool内の祖先の modifiedfee(このトランザクションを含む)

wtxid (string)

シリアル化されたトランザクションハッシュ(witnessデータ含む)

depends [ ] (array)

このトランザクションの input として使用されている未承認トランザクション

transactionid (string)

親トランザクションID

spentby [ ] (array)

このトランザクションからの output を使用している未承認トランザクション

transactionid (string)

子トランザクションID