This guide explains Bitcoin Core getaddressinfo 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 getaddressinfo returned structural and wallet-relative information for a Bitcoin address. Results included address and scriptPubKey, ismine, iswatchonly, script and witness details, optional redeem or public keys, label records and optional HD metadata.
- Why it matters: getaddressinfo is a detailed wallet-context and script diagnostic. It becomes safe operational evidence only when node and wallet identity are fixed and its ownership, label and HD fields are kept within their local scope.
- 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 getaddressinfo RPC in simple English
Bitcoin Core getaddressinfo RPC: When known, the response may contain redeem script, public keys, signature threshold and raw public key. Absence can reflect wallet knowledge, not invalidity.
Simple example
A miner is checking Bitcoin Core getaddressinfo RPC. Compare the returned address and scriptPubKey with the payment or wallet record. Record wallet identity and keep these fields away from untrusted enumeration.
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.
Address and network
Pass the exact required address to a node on the intended network. Compare the returned address and scriptPubKey with the payment or wallet record. Structural validity cannot authenticate a recipient, so confirm destination through an independent trusted channel.
Wallet-relative ownership
ismine and iswatchonly apply to the selected loaded wallet. Ismine false does not mean no one controls the address, and watch-only true does not grant signing authority. Record wallet identity and keep these fields away from untrusted enumeration.
Script and witness detail
isscript, iswitness, witness version, witness program and optional embedded information describe the destination. Unknown witness forms may still be structurally represented. Gate business use on explicitly supported script policies rather than a stale list of familiar address prefixes.
Known script material
When known, the response may contain redeem script, public keys, signature threshold and raw public key. Absence can reflect wallet knowledge, not invalidity. Treat exposed multisignature structure as security-sensitive and never publish a full diagnostic response.
Labels and account transition
The labels array carries name and send or receive purpose. The single account field was deprecated and only appeared when deprecated account RPCs were enabled. Migrate consumers to labels without assuming either system provides balances or custody boundaries.
HD metadata
Optional timestamp, HD key path and seed identifier reveal wallet structure and recovery details. The historical hdmasterkeyid alias was retained only for compatibility and scheduled for removal. Minimise retention and version response parsers for absent or renamed fields.
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 getaddressinfo RPC?
Bitcoin Core getaddressinfo RPC: When known, the response may contain redeem script, public keys, signature threshold and raw public key.
For Bitcoin Core getaddressinfo RPC, what should a beginner know about address and network?
Pass the exact required address to a node on the intended network.
For Bitcoin Core getaddressinfo RPC, what should a beginner know about wallet-relative ownership?
ismine and iswatchonly apply to the selected loaded wallet. Ismine false does not mean no one controls the address, and watch-only true does not grant signing authority.
For Bitcoin Core getaddressinfo RPC, what should a beginner know about script and witness detail?
isscript, iswitness, witness version, witness program and optional embedded information describe the destination.
Conclusion
getaddressinfo is a detailed wallet-context and script diagnostic. It becomes safe operational evidence only when node and wallet identity are fixed and its ownership, label and HD fields are kept within their local scope.
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.