migratewallet

wallet wallet since 24.0.1

migrates Legacy (non-descriptor) wallets to Descriptor wallets. experimental

↑ shares the docs page. Use Share this query below for a link with your current arg values.

Wallet RPC, not available on our node. Wallet operation. Our node runs without a wallet, so this RPC is structurally unreachable here. Docs are kept for reference.

Call from your own code

Replace $BITCOIN_RPC_USER / $BITCOIN_RPC_PASSWORD with credentials from your bitcoind's bitcoin.conf, and replace localhost:8332 with your node's RPC address. You can't run this RPC against our node (we run wallet=0), but you can run it against your own bitcoind.

Help

migratewallet

EXPERIMENTAL warning: This call may not work as expected and may be changed in future releases

Migrate the wallet to a descriptor wallet.
A new wallet backup will need to be made.

The migration process will create a backup of the wallet before migrating. This backup
file will be named <wallet name>-<timestamp>.legacy.bak and can be found in the directory
for this wallet. In the event of an incorrect migration, the backup can be restored using restorewallet.
Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Result:
{                              (json object)
  "wallet_name" : "str",       (string) The name of the primary migrated wallet
  "watchonly_name" : "str",    (string, optional) The name of the migrated wallet containing the watchonly scripts
  "solvables_name" : "str",    (string, optional) The name of the migrated wallet containing solvable but not watched scripts
  "backup_path" : "str"        (string) The location of the backup of the original wallet
}

Examples:
> bitcoin-cli migratewallet 
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "migratewallet", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/

← back to all RPCs