This guide explains Bitcoin Core scantxoutset RPC in plain English. It shows what the command does, what its result means and what it cannot prove.
TL;DR
- What it is: Bitcoin Core 0.17.0 scantxoutset was explicitly experimental. It scanned the current UTXO set for scripts matched by output descriptors.
- Why it matters: scantxoutset is powerful wallet-independent discovery, but its experimental interface, cost and privacy footprint demand version pinning, bounded descriptors and active-chain reconciliation.
- Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.
Bitcoin Core scantxoutset RPC in simple English
Bitcoin Core scantxoutset RPC: Pin node version and parser to the 0.17 interface. Revalidate action names, descriptor grammar and result fields during every upgrade.
Simple example
A miner is checking Bitcoin Core scantxoutset RPC. A timeout is unknown, so query status before retrying or starting another scan. Range defaults to 1000 unless supplied in an object.
Key terms in plain English
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- RPC:
- A command that software sends to a node to request information or a local action.
- UTXO:
- An unspent transaction output: a piece of bitcoin that can be used as an input to a later transaction.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Experimental boundary
Pin node version and parser to the 0.17 interface. Revalidate action names, descriptor grammar and result fields during every upgrade; never promise this experimental response as a stable external API.
Descriptor scope
addr, raw, combo, pkh and script-wrapped multisignature forms describe scripts to match. Parse through the node. A match does not prove ownership, signing authority or complete wallet recovery.
HD range
Extended keys can use paths and wildcard endings. Range defaults to 1000 unless supplied in an object. Bound descriptor count and range because wide expansion consumes resources and reveals wallet structure.
Actions and concurrency
Serialize start, status and abort. Status reports progress; abort reports whether cancellation succeeded. A timeout is unknown, so query status before retrying or starting another scan.
Result evidence
Each unspent contains txid, vout, scriptPubKey, BTC amount and height, plus total_amount. Convert to satoshis and recheck each outpoint at the recorded chain tip.
Privacy
Prefer xpub or fixed public material and never routine xprv or WIF input. Descriptors and matches expose wallet clusters and balances, so restrict callers and redact logs.
How specialists test it
Operators test the command on a non-production node first. They check a normal reply, an invalid request, a timeout and a restart. This shows what the response means and prevents one local result from being mistaken for a network-wide outcome.
Frequently asked questions
What is the main point of Bitcoin Core scantxoutset RPC?
Bitcoin Core scantxoutset RPC: Pin node version and parser to the 0.17 interface. Revalidate action names, descriptor grammar and result fields during every upgrade.
For Bitcoin Core scantxoutset RPC, what should a beginner know about experimental boundary?
Pin node version and parser to the 0.17 interface. Revalidate action names, descriptor grammar and result fields during every upgrade.
For Bitcoin Core scantxoutset RPC, what should a beginner know about descriptor scope?
addr, raw, combo, pkh and script-wrapped multisignature forms describe scripts to match.
For Bitcoin Core scantxoutset RPC, what should a beginner know about hd range?
Extended keys can use paths and wildcard endings. Range defaults to 1000 unless supplied in an object.
Conclusion
scantxoutset is powerful wallet-independent discovery, but its experimental interface, cost and privacy footprint demand version pinning, bounded descriptors and active-chain reconciliation.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.