Monitor LND wallet recovery after restoring a seed

During recovery, an initially small wallet balance can reflect an incomplete history scan. LND reports recovery state separately from ordinary chain synchronization.

Read the recovery status

Run the query on the recovering instance. Sample the result over time and retain the raw progress fraction. A value of 0.42 corresponds to roughly 42 percent of the reported scan.

lncli getrecoveryinfo | jq '{recovery_mode, recovery_finished, progress}'

Define the completion check

Use recovery_mode and recovery_finished alongside progress. A zero progress value outside recovery mode does not diagnose a stuck scan. Once recovery finishes, reconcile expected onchain outputs separately. The wallet recovery indicator alone cannot establish restoration of offchain channel state.

lightning.engineering get-recovery-info