This guide explains Bitcoin Core getdescriptorinfo 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.18.0 getdescriptorinfo analysed one output descriptor and returned a canonical descriptor without private keys, plus isrange, issolvable and hasprivatekeys flags. It helped normalise descriptor policy and detect accidental secret-bearing input, but it did not authenticate ownership, import anything, derive addresses or prove a wallet could sign.
- Why it matters: getdescriptorinfo is a descriptor linting and canonicalisation tool, not a wallet operation. Its safest use detects secrets early, preserves policy identity and keeps later derivation and signing controls separate.
- 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 getdescriptorinfo RPC in simple English
Bitcoin Core getdescriptorinfo RPC: Canonical output includes version-specific interpretation and checksum behaviour. Pin Bitcoin Core version and compare independent fixtures before using descriptors across releases.
Simple example
A miner is checking Bitcoin Core getdescriptorinfo RPC. Reject such input in public-only services and trigger secret-exposure handling if it entered routine logs.
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.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Input boundary
Accept one descriptor through a protected channel and retain a hash of the original. Descriptors can reveal branches, key origins, scripts and multisignature participants even without private keys.
Canonical output
The descriptor field rewrites the expression into canonical public form and removes private keys. Use that returned form for comparison, but do not assume redaction makes prior logs safe.
Private-key detection
hasprivatekeys reports whether the submitted descriptor contained at least one secret key. Reject such input in public-only services and trigger secret-exposure handling if it entered routine logs.
Ranged flag
isrange identifies wildcard derivation. It does not specify a safe range or allocate indexes; downstream derivation and address issuance need separate bounds and durable state.
Solvability
issolvable means enough public script information exists to construct an unsigned spend. It does not mean keys are present, funds exist or the selected wallet can sign.
Checksums and versions
Canonical output includes version-specific interpretation and checksum behaviour. Pin Bitcoin Core version and compare independent fixtures before using descriptors across releases.
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 getdescriptorinfo RPC?
Bitcoin Core getdescriptorinfo RPC: Canonical output includes version-specific interpretation and checksum behaviour. Pin Bitcoin Core version and compare independent fixtures before using descriptors across releases.
For Bitcoin Core getdescriptorinfo RPC, what should a beginner know about input boundary?
Accept one descriptor through a protected channel and retain a hash of the original.
For Bitcoin Core getdescriptorinfo RPC, what should a beginner know about canonical output?
The descriptor field rewrites the expression into canonical public form and removes private keys.
For Bitcoin Core getdescriptorinfo RPC, what should a beginner know about private-key detection?
hasprivatekeys reports whether the submitted descriptor contained at least one secret key.
Conclusion
getdescriptorinfo is a descriptor linting and canonicalisation tool, not a wallet operation. Its safest use detects secrets early, preserves policy identity and keeps later derivation and signing controls separate.
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.