Skip to content

qt: warn about rescan in wallet migration dialogs#943

Open
ShauryaaSharma wants to merge 1 commit into
bitcoin-core:masterfrom
ShauryaaSharma:fix-qt-migration-rescan-warning
Open

qt: warn about rescan in wallet migration dialogs#943
ShauryaaSharma wants to merge 1 commit into
bitcoin-core:masterfrom
ShauryaaSharma:fix-qt-migration-rescan-warning

Conversation

@ShauryaaSharma

Copy link
Copy Markdown

Problem

Fixes #930.

Migrating a legacy wallet triggers an automatic blockchain rescan
immediately after the conversion completes. Depending on chain size
and whether -blockfilterindex is enabled, this rescan can take
anywhere from minutes to hours. During this time the progress dialog
shows "Migrating Wallet…" with no indication that a rescan is
happening — only the debug log reveals what is going on.

Fix

Three changes, all in MigrateWalletActivity:

1 & 2 — Confirmation dialogs (migrate() and
restore_and_migrate()): append a rescan warning to the informative
text so users know what to expect before clicking Confirm:

After migration, the wallet will be rescanned for transactions.
Depending on the size of the blockchain and whether block filter
indexes are available, this rescan may take a significant amount of
time.

3 — Progress dialog (do_migrate()): update the label from the
bare "Migrating Wallet…" to also mention the rescan, so users who are
already in the waiting phase have context:

Migrating Wallet name

A blockchain rescan will follow and may take a significant amount of
time.

Notes

  • All changes are confined to src/qt/walletcontroller.cpp.
  • No behaviour or logic is changed — this is purely informational UI
    text.
  • The rescan itself is performed inside migrateWallet() as a single
    blocking call; separating migration from rescan would require wallet
    backend changes and is out of scope here.

Migrating a legacy wallet triggers a blockchain rescan
immediately after conversion. Depending on the chain
size and whether -blockfilterindex is active, this
rescan can take anywhere from minutes to hours, with no
visual indication that anything is happening.

Add a rescan warning to the informative text of both
migration confirmation dialogs (migrate and
restore-and-migrate) so users can plan accordingly
before clicking Confirm.

Also update the progress dialog label in do_migrate()
to state that a blockchain rescan will follow migration,
giving users context while the operation runs.

Fixes bitcoin-core#930
@DrahtBot

DrahtBot commented Jun 20, 2026

Copy link
Copy Markdown
Contributor

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Reviews

See the guideline for information on the review process.
A summary of reviews will appear here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Wallet migration includes rescan

2 participants