importmulti "requests" ( "options" )
Import addresses/scripts (with private or public keys, redeem script (P2SH)), optionally rescanning the blockchain from the earliest creation time of the imported scripts. Requires a new wallet backup.
If an address/script is imported without all of the private keys required to spend from that address, it will be watchonly. The 'watchonly' option must be set to true in this case or a warning will be returned.
Conversely, if all the private keys are provided and the address/script is spendable, the watchonly option must be set to false, or a warning will be returned.
Note: Use "getwalletinfo" to query the scanning progress.
Arguments:
1. requests (json array, required) Data to be imported
[
{ (json object)
"desc": "str", (string, optional) Descriptor to import. If using descriptor, do not also provide address/scriptPubKey, scripts, or pubkeys
"scriptPubKey": "<script>" | { "address":"<address>" }, (string / json, required) Type of scriptPubKey (string for script, json for address). Should not be provided if using a descriptor
"timestamp": timestamp | "now", (integer / string, required) Creation time of the key expressed in UNIX epoch time,
or the string "now" to substitute the current synced blockchain time. The timestamp of the oldest
key will determine how far back blockchain rescans need to begin for missing wallet transactions.
"now" can be specified to bypass scanning, for keys which are known to never have been used, and
0 can be specified to scan the entire blockchain. Blocks up to 2 hours before the earliest key
creation time of all keys being imported by the importmulti call will be scanned.
"redeemscript": "str", (string, optional) Allowed only if the scriptPubKey is a P2SH address/scriptPubKey
"pubkeys": [ (json array, optional, default=[]) Array of strings giving pubkeys to import. They must occur in P2PKH scripts. They are not required when the private key is also provided (see the "keys" argument).
"pubKey", (string)
...
],
"keys": [ (json array, optional, default=[]) Array of strings giving private keys to import. The corresponding public keys must occur in the output or redeemscript.
"key", (string)
...
],
"range": n or [n,n], (numeric or array, optional) If a ranged descriptor is used, this specifies the end or the range (in the form [begin,end]) to import
"internal": bool, (boolean, optional, default=false) Stating whether matching outputs should be treated as not incoming payments (also known as change)
"watchonly": bool, (boolean, optional, default=false) Stating whether matching outputs should be considered watchonly.
"label": "str", (string, optional, default="") Label to assign to the address, only allowed with internal=false
"keypool": bool, (boolean, optional, default=false) Stating whether imported public keys should be added to the keypool for when users request new addresses. Only allowed when wallet private keys are disabled
},
...
]
2. options (json object, optional) Options object that can be used to pass named arguments, listed below.
Named Arguments:
rescan (boolean, optional, default=true) Stating if should rescan the blockchain after all imports
Result:
[ (json array) Response is an array with the same size as the input that has the execution result
{ (json object)
"success" : true|false, (boolean)
"warnings" : [ (json array, optional)
"str", (string)
...
],
"error" : { (json object, optional)
... JSONRPC error
}
},
...
]
Examples:
> bitcoin-cli importmulti '[{ "scriptPubKey": { "address": "<my address>" }, "timestamp":1455191478 }, { "scriptPubKey": { "address": "<my 2nd address>" }, "label": "example 2", "timestamp": 1455191480 }]'
> bitcoin-cli importmulti '[{ "scriptPubKey": { "address": "<my address>" }, "timestamp":1455191478 }]' '{ "rescan": false}'