getmempoolancestors

Back to blockchain

Summary

If txid is in the mempool, returns all in-mempool ancestors.

Description

If txid is in the mempool, returns all in-mempool ancestors.

Arguments

  • txid (STR_HEX, required): The transaction id (must be in mempool)
  • verbose (BOOL): True for a json object, false for array of transaction ids

Results

  • value (ARR): No description.
  • value (STR_HEX): The transaction id of an in-mempool ancestor transaction
  • value (OBJ_DYN): No description.

  • transactionid (OBJ): No description.

    • vsize (NUM): sigops-adjusted virtual transaction size used for fee and policy checks; qbit does not discount witness data.
    • weight (NUM): transaction weight; qbit fully counts witness data.
    • time (NUM_TIME): local time transaction entered pool in seconds since 1 Jan 1970 GMT
    • height (NUM): block height when transaction entered pool
    • descendantcount (NUM): number of in-mempool descendant transactions (including this one)
    • descendantsize (NUM): virtual transaction size of in-mempool descendants (including this one)
    • ancestorcount (NUM): number of in-mempool ancestor transactions (including this one)
    • ancestorsize (NUM): virtual transaction size of in-mempool ancestors (including this one)
    • wtxid (STR_HEX): hash of serialized transaction, including witness data
    • fees (OBJ): No description.
    • base (STR_AMOUNT): transaction fee, denominated in QBT
    • modified (STR_AMOUNT): transaction fee with fee deltas used for mining priority, denominated in QBT
    • ancestor (STR_AMOUNT): transaction fees of in-mempool ancestors (including this one) with fee deltas used for mining priority, denominated in QBT
    • descendant (STR_AMOUNT): transaction fees of in-mempool descendants (including this one) with fee deltas used for mining priority, denominated in QBT
    • depends (ARR): unconfirmed transactions used as inputs for this transaction
    • transactionid (STR_HEX): parent transaction id
    • spentby (ARR): unconfirmed transactions spending outputs from this transaction
    • transactionid (STR_HEX): child transaction id

    • bip125-replaceable (BOOL): Whether this transaction signals BIP125 replaceability or has an unconfirmed ancestor signaling BIP125 replaceability. (DEPRECATED)

    • unbroadcast (BOOL): Whether this transaction is currently unbroadcast (initial broadcast not yet acknowledged by any peers)

Examples

qbit-cli getmempoolancestors "mytxid"

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getmempoolancestors", "params": ["mytxid"]}' -H 'content-type: application/json' http://127.0.0.1:8352/