monero.loveA little love for the network.

Monero glossary / Wallets and keys

Wallet synchronization: finding your payments

How a wallet scans blockchain data to find its incoming outputs and update its records. It gets this data from a local or remote node.

Also called: wallet scan, wallet sync.

The node and wallet have different jobs

A node obtains blockchain data from peers and checks it under Monero consensus rules. A wallet uses data from a local or remote node to recognize outputs belonging to its keys and maintain its transaction records.

A fully synchronized node can serve a wallet that is still scanning. The node has the chain data, but the wallet has not finished checking the relevant history for your payments.

References: Daemon options and console commands · Monero source: wallet/wallet2.cpp

A restored wallet needs to scan again

Restoring keys gives the wallet the information it needs to recognize its outputs. It still needs to examine blockchain data. A long-used wallet can have years of history between its restore height and the current chain tip.

Connecting a newly restored wallet to an up-to-date remote node avoids downloading a local node database. It does not remove the wallet scan. The wallet still requests data and processes it.

References: Monero source: wallet/wallet2.cpp · CLI wallet reference

What to check when scanning stops

First check whether the wallet can reach its selected node. Then compare the node and wallet synchronization indicators provided by the application. A node missing recent blocks cannot supply them to the wallet.

If the node is current and the wallet scan is advancing, allow it to finish before interpreting the balance. If progress has stopped, note the error and check the connection settings. The remote-node guide below covers the address, port and transport settings.

A different node may help with an unavailable server. It will not correct a restore height that excludes old payments or keys for a different wallet.

References: CLI wallet reference · Remote node documentation · Monero wallet restoration guide

Synchronization is not spendability

Finding a payment and being able to spend it are separate events. A wallet can finish scanning while some outputs remain locked. Its total balance and unlocked balance can differ.

A view-only wallet has another limitation. Without the relevant key images, it may not know which outputs the signer has spent. Importing those key images supplies information that another scan alone cannot recover.

References: Wallet RPC reference · Monero view-only wallet guide

Related glossary terms

Practical guides

Technical baseline: v0.18.5.4. Reviewed 2026-11-20 UTC.

Find Wallet synchronization in the A-Z glossary

Support Monero Love

Help keep the public nodes and packages running. Send any amount of XMR.

Scan with a Monero wallet to donate to Monero Love.89hGTKxRVA3AUeKAbCRBt5TMSzq3MQZooNNsezCpNFjp2oeJPRx8AJeGKA8ziHZNqab78f4Vr1ntxhPDxX5298nnGZjHkhm