Antminer X9
Monero ASIC Miner
1000KH
HASHRATE
2.47W/KH
EFFICIENCY
2470W
POWER
£870.20
EST. MONTHLY
203
DAYS
EST. ROI
This guide explains Bitcoin Core importaddress 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.16.0 importaddress added an address or hex script to a wallet for monitoring without adding spending capability. Optional label, rescan and P2SH wrapping controlled bookkeeping and historical discovery.
- Why it matters: importaddress is a watch-only wallet migration whose apparent success precedes historical completeness. Safe use controls script scope, rescan state, reporting limitations and post-import recovery.
- Current position: Bitcoin Core 0.16.0 importaddress added an address or hex script to a wallet for monitoring without adding spending capability.
Bitcoin Core importaddress RPC in simple English
Bitcoin Core importaddress RPC: The import recognises matching outputs but cannot spend them because no private key is added. Label all resulting balances watch-only and prove any external signer relationship separately.
Simple example
A miner is checking Bitcoin Core importaddress RPC. The documentation requires a new wallet backup after import. Use it only when that wrapping is intended and valid.
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.
Watch-only boundary
The import recognises matching outputs but cannot spend them because no private key is added. Label all resulting balances watch-only and prove any external signer relationship separately. Never present successful import as restored custody.
Address or script validation
The first argument accepts a network-valid address or hex script. Confirm network and exact script bytes before mutation. Non-standard raw scripts are historically treated as change and may be omitted from many wallet RPCs, so test the actual reporting path.
Label semantics
The optional label supports local bookkeeping and defaults empty. It is not a security boundary or customer identity proof. Sanitise labels and keep durable business mapping in an external ledger keyed by script and outpoint.
Rescan behaviour
rescan defaults true and can take minutes. During it the wallet may show the imported object but omit related transactions, producing incomplete balances and UTXOs. Suspend dependent automation until completion and independent reconciliation.
P2SH option
p2sh true adds the P2SH form of a raw script as well. Use it only when that wrapping is intended and valid. Importing more forms than required broadens monitored scope and can confuse attribution.
Backup requirement
The documentation requires a new wallet backup after import. Verify the pre-change backup, perform the import, complete rescan and reconciliation, then create and restore-test the post-change backup. Do not overwrite the only recovery copy.
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 importaddress RPC?
Bitcoin Core importaddress RPC: The import recognises matching outputs but cannot spend them because no private key is added.
For Bitcoin Core importaddress RPC, what should a beginner know about watch-only boundary?
The import recognises matching outputs but cannot spend them because no private key is added.
For Bitcoin Core importaddress RPC, what should a beginner know about address or script validation?
The first argument accepts a network-valid address or hex script. Confirm network and exact script bytes before mutation.
For Bitcoin Core importaddress RPC, what should a beginner know about label semantics?
The optional label supports local bookkeeping and defaults empty. It is not a security boundary or customer identity proof.
Conclusion
importaddress is a watch-only wallet migration whose apparent success precedes historical completeness. Safe use controls script scope, rescan state, reporting limitations and post-import recovery.
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.