Security · Backups

The File Is There, but the Wallet Export Is Incomplete

Imagine this: the program reports a successful wallet export, the file appears on disk, and you put it aside until you need it. In fact, the write stopped halfway through.

EDITORIAL OVERVIEW · Prepared by the project editors from the sources listed below.

Where the error went unnoticed

A bug like this was fixed in the bitcoin-wallet utility. Previously, when exporting wallet records, the program checked whether it could open the file. But if an error occurred later—while writing or closing the file—the utility could still report success. An incomplete file would be left on disk.

The accepted change also checks that the write completes. If it fails, the utility reports an error and removes the incomplete file. The fix was merged into the main development branch on November 4. That is the date the code was accepted, not confirmation that it is already in the version a reader has installed. The discussion does not report any confirmed loss of funds.

When you need the copy

The most dangerous moment comes later, when the original is no longer available. That is why it is important to know in advance how to restore from a copy and to check the process safely using the method your wallet provides. The mere presence of a file in a folder tells you nothing about whether the restore will work.

Sources and verification

  1. Bitcoin Core PR #35492: description and history of the incomplete-write fix ↗

Information checked November 5, 2026. This article describes a fix in the main development branch, not an incident with a confirmed loss of funds.

Unless stated otherwise, the text, conclusions, structure and editorial arrangement were created by the project editors. Facts, quotations and source materials remain attributable to their authors and rights holders.

← Back to the rubric