From c1e07423083cd2a7e3f2b28f69a573ea1837af4d Mon Sep 17 00:00:00 2001
From: Albert <github@albert.sh>
Date: Fri, 28 Feb 2020 13:46:31 +0800
Subject: [PATCH] doc: Warn about wallet.dat re-use and backups

See discussion in #18205 and https://github.com/bitcoin/bitcoin/pull/18219#issuecomment-594871230.
---
 doc/files.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/files.md b/doc/files.md
index c2296b45fa..cd23d547bb 100644
--- a/doc/files.md
+++ b/doc/files.md
@@ -78,6 +78,10 @@ Subdirectory | File(s)           | Description
 
 3. A wallet database path can be specified by `-wallet` option.
 
+4. `wallet.dat` files must not be shared across different node instances, as that can result in key-reuse and double-spends due the lack of synchronization between instances.
+
+5. Any copy or backup of the wallet should be done through a `backupwallet` call in order to update and lock the wallet, preventing any file corruption caused by updates during the copy.
+
 ## GUI settings
 
 `bitcoin-qt` uses [`QSettings`](https://doc.qt.io/qt-5/qsettings.html) class; this implies platform-specific [locations where application settings are stored](https://doc.qt.io/qt-5/qsettings.html#locations-where-application-settings-are-stored).