scantxoutset

scantxoutset “action” [scanobjects,…]

EXPERIMENTAL warning: this call may be removed or changed in future releases.

Scans the unspent transaction output set for entries that match certain output descriptors. Examples of output descriptors are: addr(

) Outputs whose scriptPubKey corresponds to the specified address (does not include P2PK) raw() Outputs whose scriptPubKey equals the specified hex scripts combo() P2PK, P2PKH, P2WPKH, and P2SH-P2WPKH outputs for the given pubkey pkh() P2PKH outputs for the given pubkey sh(multi(,,,…)) P2SH-multisig outputs for the given threshold and pubkeys

In the above, either refers to a fixed public key in hexadecimal notation, or to an xpub/xprv optionally followed by one or more path elements separated by ”/”, and optionally ending in ”/” (unhardened), or ”/’” or ”/*h” (hardened) to specify all unhardened or hardened child keys. In the latter case, a range needs to be specified by below if different from 1000. For more information on output descriptors, see the documentation in the doc/descriptors.md file.

Arguments:

action (string, required) The action to execute “start” for starting a scan “abort” for aborting the current scan (returns true when abort was successful) “status” for progress report (in %) of the current scan
scanobjects (json array, required) Array of scan objects Every scan object is either a string descriptor or an object: [ “descriptor”, (string) An output descriptor { (json object) An object with output descriptor and metadata “desc”: “str”, (string, required) An output descriptor “range”: n or [n,n], (numeric or array, optional, default=1000) The range of HD chain indexes to explore (either end or [begin,end]) }, … ]

Result: { “success”: true|false, (boolean) Whether the scan was completed “txouts”: n, (numeric) The number of unspent transaction outputs scanned “height”: n, (numeric) The current block height (index) “bestblock”: “hex”, (string) The hash of the block at the tip of the chain “unspents”: [ { “txid”: “hash”, (string) The transaction id “vout”: n, (numeric) The vout value “scriptPubKey”: “script”, (string) The script key “desc”: “descriptor”, (string) A specialized descriptor for the matched scriptPubKey “amount”: x.xxx, (numeric) The total amount in BTC of the unspent output “height”: n, (numeric) Height of the unspent transaction output } ,…], “total_amount”: x.xxx, (numeric) The total amount of all found unspent outputs in BTC ]