upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authormtg0001 <106211915+mtg0001@users.noreply.github.com>2026-08-01 14:45:26 -0300
committerGitHub <noreply@github.com>2026-08-01 14:45:26 -0300
commit9da2183bb16e4c32cafbb71eeadc7f112b48ab05 (patch)
tree090e5b471b13590c213d64259db21d6ed3a893c9 /README.md
parent07ba3481e2624d85eaf5ff5808bd2d0280bcbb22 (diff)
Add wallet safety backup panel (#89)
Co-authored-by: Gilcimar Duarte <ti@gpm.infra>
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 14 insertions, 9 deletions
diff --git a/README.md b/README.md
index 16e979f..28030f1 100644
--- a/README.md
+++ b/README.md
@@ -88,15 +88,20 @@ It loads the wallet, writes the copy, and exits without starting the node. If
88you would rather copy by hand, shut the node down first and take the **whole** 88you would rather copy by hand, shut the node down first and take the **whole**
89data directory, not just `wallet.dat`. 89data directory, not just `wallet.dat`.
90 90
91**Every backup is a snapshot, so repeat it.** Keys are generated when they are 91**Every backup is still a snapshot, but it now has a safety margin.** The wallet
92needed rather than derived from a seed, so a backup contains only the keys that 92keeps a pool of 100 pre-generated keys. A backup contains those keys, so it
93existed the moment it was taken. Mine a block or receive to a new address 93covers the next 100 mining rewards or receive addresses the node hands out after
94afterwards, and those coins sit on-chain at an address whose private key is in 94the backup. That makes a normal backup much safer than the original 0.1.0
95no backup you hold. Back up again whenever you use a new address. 95wallet, where the very next block could land on a key the backup did not have.
96 96
97The second point is the pre-BIP32 problem that deterministic wallets were 97It is not a seed phrase. Heavy use can drain the key pool, and deterministic
98invented to solve; see [#47](https://github.com/Bitflash-sh/bitflash/issues/47). 98wallet restore is still tracked in [#47](https://github.com/Bitflash-sh/bitflash/issues/47).
99Until that lands, repetition is the only defence. 99Back up again after mining for a while, after creating many receive addresses,
100and before moving the wallet to another machine.
101
102The GUI has a **Backup Wallet** button and a **Wallet Safety** view. Use that if
103you do not want to run the command by hand; it fills the key pool before writing
104the backup.
100 105
101### When wallet.dat itself will not open 106### When wallet.dat itself will not open
102 107