Skip to main content

importaddress

Command#

pacprotocol-cli 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.

Arguments#

address *#

(string, required)

The PAC address (or hex-encoded script)

label#

(string, optional, default="")

An optional label

rescan#

(boolean, optional, default=true)

Rescan the wallet for transactions

p2sh#

(boolean, optional, default=false)

Add the P2SH version of the script as well

Examples#

Note: This call can take over an hour 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.

Import an address with rescan

pacprotocol-cli importaddress "myaddress"

Import using a label without rescan

pacprotocol-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:1111/

Running following help command

pacprotocol-cli help importaddress

Will produce following output:

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.
Arguments:
1. "address" (string, required) The PAC 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
Note: This call can take over an hour 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.
Examples:
Import an address with rescan
> pacprotocol-cli importaddress "myaddress"
Import using a label without rescan
> pacprotocol-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:1111/