Encyclopedia How the network works · Entry 199
Bitcoin wallet rescan versus node reindex
In this article
At a glance
Key facts
Identify the missing or damaged information
Core stores block bodies, chainstate and wallets in separate places. If a wallet already knows a relevant script but has not searched the period when it received funds, a rescan can discover the transactions. It is not the same as rebuilding consensus state for every wallet.
If the node reports damaged chain databases, the appropriate recovery may involve reindexing. The cited v29.0 help defines reindex as rebuilding chainstate, block index and active optional indexes from block files.
A scan range can be smaller than the whole history
Suppose the earliest possible payment is at height 800,000 and the node has processed height 850,000. A documented scan from 800,000 through 850,000 covers 50,001 block heights inclusively. A mistaken start height after the receipt can miss it.
The RPC reports where scanning began and ended. Available block filters can speed a descriptor-wallet scan in the documented configuration, but speed is not proof that the wallet’s script or derivation information is complete.
Pruning and backups affect the recovery path
A pruned node may lack the historical block bodies required for a chosen operation. Core v29.0 explicitly treats pruning and reindex-chainstate as incompatible; a full rebuild path can require reacquiring data. Follow the installed release’s guidance rather than copying an old command blindly.
Preserve wallet recovery material before invasive maintenance. Neither downloading the chain again nor rebuilding its index can manufacture a key that no remaining backup contains.
Direct answers
Questions people ask
Will reindexing fix an incorrect seed or derivation path?
No. Reindexing rebuilds node data. The wallet must still contain the correct keys, scripts and derivation information before a scan can identify and spend the intended outputs.
Does a rescan send a Bitcoin transaction?
No. It searches local chain data for wallet-related history. It does not itself move funds, sign a payment or pay a network fee, although it can consume local computing resources.
Inspect the evidence
The answer and key facts have stable claim links. These records retain the scope and qualification when reused.
A wallet rescan searches available blockchain data for transactions relevant to known wallet keys or scripts. Reindexing rebuilds node databases from block files; reindex-chainstate has a narrower state-rebuild purpose in Core. These operations solve different problems and do not recreate a lost private key. Choose the documented operation for the actual error and installed version before initiating a lengthy rebuild.
Educational explanation. Product-specific behavior is scoped to the cited documentation, checked 2026-10-02.
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T19:29:20.637Z.
Link to this claimRescan target: Wallet-related transaction discovery
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T19:29:20.637Z.
Link to this claimReindex target: Node state and block/index databases
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T19:29:20.637Z.
Link to this claimNot recovered: Missing signing secrets
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T19:29:20.637Z.
Link to this claimRevision history
- — First publication after primary-source research and separate automated verification.
Source register
Sources and references
Retrieval dates and locators are recorded individually.- rescanblockchain RPCBitcoin Core
Rescan local blocks for wallet-related transactions within a height range.
Locator: Description; Arguments; Result · Version / scope: Bitcoin Core 29.0 RPC reference; not a recommendation to install an old release · Retrieved: 2026-10-02T18:53:55.698ZOpen source - Node initializationBitcoin Core
Definitions of reindex/chainstate rebuild and node configuration switches.
Locator: SetupServerArgs: assumevalid, reindex, reindex-chainstate, prune, listen, server; prune/reindex-chainstate compatibility check · Version / scope: Bitcoin Core v29.0 · Retrieved: 2026-10-02T18:53:55.958ZOpen source - FilesBitcoin Core
Wallet, block, chainstate and index files have different recovery purposes.
Locator: Data directory location and chain-specific paths; Data directory layout: blocks/, chainstate/, wallets/; Multi-wallet environment and backupwallet guidance · Version / scope: Bitcoin Core v29.0 · Retrieved: 2026-10-02T18:53:55.926ZOpen source - WalletsBitcoin developer documentation
Wallet types, generated keys, deterministic wallets and offline signing.
Locator: Wallet Programs; Full-Service Wallets; Signing-Only Wallets; Wallet Files; Hierarchical Deterministic Key Creation; Loose-Key Wallets · Version / scope: Developer guide; historical implementation details require qualification · Retrieved: 2026-10-02T18:53:53.756ZOpen source - Securing your walletBitcoin.org
Backup scope, online exposure, offline signing, custody and software update practices.
Locator: Be careful with online services; Backup your wallet; Encrypt your wallet; Offline wallet for savings; Hardware wallets; Keep your software up to date · Retrieved: 2026-10-02T18:53:53.659ZOpen source - Hierarchical Deterministic WalletsBitcoin Improvement Proposals
Deterministic key derivation, backup scope and public/private child derivation.
Locator: Motivation; Extended keys; Security · Version / scope: Pinned BIPs revision · Retrieved: 2026-10-02T18:53:54.013ZOpen source
Research and drafting use AI assistance. A separate automated review checks claims against primary sources; no external expert or named human review is implied. Publication, substantive editing, source retrieval and verification are recorded separately. This version was independently checked by an automated reviewer on 2 October 2026.
Editorial method and correctionsDegrees of Satoshi editorial project. “Bitcoin wallet rescan versus node reindex.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-rescan-vs-reindex/