upleb.uk

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

summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorbitflash <admin@bitflash.network>2026-08-19 15:09:32 -0300
committerbitflash <admin@bitflash.network>2026-08-19 15:10:33 -0300
commit61eac533f40ecfccfb051a8053b5cd52b2c7dff6 (patch)
tree051e41b2de97eb7863704ffc98cbb2c021f39d9a
parented18ab2eb0ee657f8ce1c57da41452288b0c6ef5 (diff)
readme: name the BIP44 derivation and the SQLite wallet default
- describe the recovery phrase as a BIP44 tree on m/44'/4346950'/0'/..., coin type 4346950 = 0x425446 "BTF", registered in SLIP-0044 - note the SQLite default in "The file" and that -backupwallet writes a matching self-contained copy; scope the Berkeley DB recovery notes to a legacy wallet.dat - at-a-glance: name BIP44 and add a wallet-storage row
-rw-r--r--README.md16
1 files changed, 12 insertions, 4 deletions
diff --git a/README.md b/README.md
index 907578e..9a0136c 100644
--- a/README.md
+++ b/README.md
@@ -186,8 +186,11 @@ bitflash -newphrase # create it, show it once, exit
186bitflash -restorephrase="twelve words here" # rebuild a wallet from it 186bitflash -restorephrase="twelve words here" # rebuild a wallet from it
187``` 187```
188 188
189`-newphrase` installs a BIP32 seed, derives the wallet's key pool and default 189`-newphrase` installs a BIP39/BIP32 seed and derives the wallet as a BIP44 tree
190receiving address from it, and prints the words once. It refuses if a phrase 190along `m/44'/4346950'/0'/…` — coin type **4346950** is `0x425446`, the ASCII
191bytes `BTF`, registered in [SLIP-0044](https://github.com/satoshilabs/slips/blob/master/slip-0044.md).
192It builds the key pool and default receiving address from the seed, and prints
193the words once. It refuses if a phrase
191already exists: replacing one silently would strand every coin on addresses the 194already exists: replacing one silently would strand every coin on addresses the
192written-down words no longer describe. 195written-down words no longer describe.
193 196
@@ -214,6 +217,10 @@ matter.
214 217
215### The file 218### The file
216 219
220Under the SQLite default the wallet is one self-contained `wallet.sqlite`, and
221`-backupwallet` writes a matching `.sqlite` copy that opens on its own — no
222sidecar directory. The Berkeley DB notes below apply to a legacy `wallet.dat`.
223
217**Copying `wallet.dat` on its own is not a backup.** Berkeley DB ties the file 224**Copying `wallet.dat` on its own is not a backup.** Berkeley DB ties the file
218to the environment in the `database/` subdirectory beside it, so a lone 225to the environment in the `database/` subdirectory beside it, so a lone
219`wallet.dat` will not open elsewhere — the keys are all still in there, and the 226`wallet.dat` will not open elsewhere — the keys are all still in there, and the
@@ -251,7 +258,7 @@ as a verdict to somebody who has just lost a wallet.
251 258
252### When wallet.dat itself will not open 259### When wallet.dat itself will not open
253 260
254Everything above still runs through Berkeley DB. If the database is the thing 261A legacy `wallet.dat` runs on Berkeley DB. If that database is the thing
255that is broken — a build that will not read it, a file truncated by a bad copy, 262that is broken — a build that will not read it, a file truncated by a bad copy,
256an environment beyond recovery — the keys are usually still fine, and you can 263an environment beyond recovery — the keys are usually still fine, and you can
257take them out as text: 264take them out as text:
@@ -493,7 +500,8 @@ windows-tor` to require the extra signature check.
493| Addressing | `.btf` rendezvous — see the caveats above | 500| Addressing | `.btf` rendezvous — see the caveats above |
494| Premine | None | 501| Premine | None |
495| Pool server | Built-in — `.btf` rendezvous only | 502| Pool server | Built-in — `.btf` rendezvous only |
496| Wallet recovery | Twelve-word phrase (BIP39 + BIP32), plus file backup | 503| Wallet recovery | Twelve-word phrase (BIP39 + BIP32 + BIP44, coin type 4346950), plus file backup |
504| Wallet storage | SQLite `wallet.sqlite` by default, or Berkeley DB `wallet.dat` |
497 505
498The halving interval is the number most people get wrong coming from Bitcoin. 506The halving interval is the number most people get wrong coming from Bitcoin.
499Same 210,000 blocks, but at two minutes instead of ten, so it arrives in about 507Same 210,000 blocks, but at two minutes instead of ten, so it arrives in about