Changeset View
Changeset View
Standalone View
Standalone View
doc/0.21.12/rpc/wallet/importaddress.md
- This file was added.
--- | |||||
name: importaddress | |||||
version: 0.21.12 | |||||
group: wallet | |||||
permalink: doc/0.21.12/rpc/wallet/importaddress/ | |||||
--- | |||||
importaddress "address" ( "label" rescan p2sh ) | |||||
Adds an address or script (in hex) that can be watched as if it were in your wallet but cannot be used to spend. Requires a new wallet backup. | |||||
Note: This call can take minutes to complete if rescan is true, during that time, other rpc calls | |||||
may report that the imported address exists but related transactions are still missing, leading to temporarily incorrect/bogus balances and unspent outputs until rescan completes. | |||||
If you have the full public key, you should call importpubkey instead of this. | |||||
Note: If you import a non-standard raw script in hex form, outputs sending to it will be treated | |||||
as change, and not show up in many RPCs. | |||||
Arguments: | |||||
1. address (string, required) The Bitcoin address (or hex-encoded script) | |||||
2. label (string, optional, default="") An optional label | |||||
3. rescan (boolean, optional, default=true) Rescan the wallet for transactions | |||||
4. p2sh (boolean, optional, default=false) Add the P2SH version of the script as well | |||||
Examples: | |||||
Import an address with rescan | |||||
> bitcoin-cli importaddress "myaddress" | |||||
Import using a label without rescan | |||||
> bitcoin-cli importaddress "myaddress" "testing" false | |||||
As a JSON-RPC call | |||||
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "importaddress", "params": ["myaddress", "testing", false] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/ | |||||