Skip to main content

getmempoolancestors

Command#

pacprotocol-cli getmempoolancestors txid (verbose)

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

Arguments#

txid *#

(string, required)

The transaction id (must be in mempool)

verbose#

(boolean, optional, default=false)

True for a json object, false for array of transaction ids

Examples#

pacprotocol-cli getmempoolancestors "mytxid"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolancestors", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/

Result#

Result #(for verbose=false):
[ #(json array of strings)
"transactionid" #(string) The transaction id of an in-mempool ancestor transaction
,...
]
Result #(for verbose=true):
{ #(json object)
"transactionid" : { #(json object)
"size" : n, #(numeric) transaction size in bytes
"fee" : n, #(numeric) transaction fee in PAC #(DEPRECATED)
"modifiedfee" : n, #(numeric) transaction fee with fee deltas used for mining priority #(DEPRECATED)
"time" : n, #(numeric) local time transaction entered pool in seconds since 1 Jan 1970 GMT
"height" : n, #(numeric) block height when transaction entered pool
"descendantcount" : n, #(numeric) number of in-mempool descendant transactions #(including this one)
"descendantsize" : n, #(numeric) size of in-mempool descendants #(including this one)
"descendantfees" : n, #(numeric) modified fees #(see above) of in-mempool descendants #(including this one) #(DEPRECATED)
"ancestorcount" : n, #(numeric) number of in-mempool ancestor transactions #(including this one)
"ancestorsize" : n, #(numeric) size of in-mempool ancestors #(including this one)
"ancestorfees" : n, #(numeric) modified fees #(see above) of in-mempool ancestors #(including this one) #(DEPRECATED)
"fees" : {
"base" : n, #(numeric) transaction fee in PAC
"modified" : n, #(numeric) transaction fee with fee deltas used for mining priority in PAC
"ancestor" : n, #(numeric) modified fees #(see above) of in-mempool ancestors #(including this one) in PAC
"descendent" : n, #(numeric) number of in-mempool ancestor transactions #(including this one) in PAC
}
"depends" : [ #(array) unconfirmed transactions used as inputs for this transaction
"transactionid", #(string) parent transaction id
... ],
"spentby" : [ #(array) unconfirmed transactions spending outputs from this transaction
"transactionid", #(string) child transaction id
... ]
"instantlock" : true|false #(boolean) True if this transaction was locked via InstantSend
}, ...
}

Running following help command

pacprotocol-cli help getmempoolancestors

Will produce following output:

getmempoolancestors txid (verbose)
If txid is in the mempool, returns all in-mempool ancestors.
Arguments:
1. "txid" (string, required) The transaction id (must be in mempool)
2. verbose (boolean, optional, default=false) True for a json object, false for array of transaction ids
Result (for verbose=false):
[ (json array of strings)
"transactionid" (string) The transaction id of an in-mempool ancestor transaction
,...
]
Result (for verbose=true):
{ (json object)
"transactionid" : { (json object)
"size" : n, (numeric) transaction size in bytes
"fee" : n, (numeric) transaction fee in PAC (DEPRECATED)
"modifiedfee" : n, (numeric) transaction fee with fee deltas used for mining priority (DEPRECATED)
"time" : n, (numeric) local time transaction entered pool in seconds since 1 Jan 1970 GMT
"height" : n, (numeric) block height when transaction entered pool
"descendantcount" : n, (numeric) number of in-mempool descendant transactions (including this one)
"descendantsize" : n, (numeric) size of in-mempool descendants (including this one)
"descendantfees" : n, (numeric) modified fees (see above) of in-mempool descendants (including this one) (DEPRECATED)
"ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
"ancestorsize" : n, (numeric) size of in-mempool ancestors (including this one)
"ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one) (DEPRECATED)
"fees" : {
"base" : n, (numeric) transaction fee in PAC
"modified" : n, (numeric) transaction fee with fee deltas used for mining priority in PAC
"ancestor" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one) in PAC
"descendent" : n, (numeric) number of in-mempool ancestor transactions (including this one) in PAC
}
"depends" : [ (array) unconfirmed transactions used as inputs for this transaction
"transactionid", (string) parent transaction id
... ],
"spentby" : [ (array) unconfirmed transactions spending outputs from this transaction
"transactionid", (string) child transaction id
... ]
"instantlock" : true|false (boolean) True if this transaction was locked via InstantSend
}, ...
}
Examples:
> pacprotocol-cli getmempoolancestors "mytxid"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolancestors", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/