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:
Diffstat (limited to 'README.md')
-rw-r--r--README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.md b/README.md
index 1720c46..da8183a 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,37 @@ backup — it holds your keys.
69 69
70--- 70---
71 71
72## Backing up your wallet
73
74Two things about this wallet will cost you money if you do not know them. Both
75are consequences of the 0.1.0 wallet format, and neither is obvious.
76
77**Copying `wallet.dat` on its own is not a backup.** Berkeley DB ties the file
78to the environment in the `database/` subdirectory beside it, so a lone
79`wallet.dat` will not open elsewhere — the keys are all still in there, and the
80file is refused anyway. Use the built-in command, which writes a copy that
81stands on its own:
82
83```
84bitflash -backupwallet=/path/to/wallet-backup.dat
85```
86
87It 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**
89data directory, not just `wallet.dat`.
90
91**Every backup is a snapshot, so repeat it.** Keys are generated when they are
92needed rather than derived from a seed, so a backup contains only the keys that
93existed the moment it was taken. Mine a block or receive to a new address
94afterwards, and those coins sit on-chain at an address whose private key is in
95no backup you hold. Back up again whenever you use a new address.
96
97The second point is the pre-BIP32 problem that deterministic wallets were
98invented to solve; see [#47](https://github.com/Bitflash-sh/bitflash/issues/47).
99Until that lands, repetition is the only defence.
100
101---
102
72## Mining 103## Mining
73 104
74Open **Options** from the menu bar. Under Mining Mode: 105Open **Options** from the menu bar. Under Mining Mode: