migratewallet

Back to wallet

Wallet

Summary

Migrate the wallet to a descriptor wallet.

Description

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 -.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. Encrypted wallets must have the passphrase provided as an argument to this call.

This RPC may take a long time to complete. Increasing the RPC client timeout is recommended.

Arguments

  • wallet_name (STR): The name of the wallet to migrate. If provided both here and in the RPC endpoint, the two must be identical.
  • passphrase (STR): The wallet passphrase

Results

  • value (OBJ): No description.
  • wallet_name (STR): The name of the primary migrated wallet
  • watchonly_name (STR, optional): The name of the migrated wallet containing the watchonly scripts
  • solvables_name (STR, optional): The name of the migrated wallet containing solvable but not watched scripts
  • backup_path (STR): The location of the backup of the original wallet

Examples

qbit-cli migratewallet

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "migratewallet", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8352/