Skip to content

Commit 4aa18ce

Browse files
committed
Merge bitcoin/bitcoin#28974: doc: explain what the wallet password does
55b13ec doc: explain what the wallet password does (Brandon Odiwuor) Pull request description: Fixes bitcoin/bitcoin#18085 Add a document explaining what the wallet `passphrase` does ACKs for top commit: fjahr: ACK 55b13ec achow101: ACK 55b13ec Tree-SHA512: 6cc621269fe51ba7bd5d859427906a520e989bebcb274b08017c9900a4d781a165fc62dea46ed45aa48239cacd3c1f6eb4dd0c916be940d680a03266109716b0
2 parents 2cecbbb + 55b13ec commit 4aa18ce

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

doc/managing-wallets.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,22 @@ $ bitcoin-cli -rpcwallet="restored-wallet" getwalletinfo
122122

123123
The restored wallet can also be loaded in the GUI via `File` ->`Open wallet`.
124124

125+
## Wallet Passphrase
126+
127+
Understanding wallet security is crucial for safely storing your Bitcoin. A key aspect is the wallet passphrase, used for encryption. Let's explore its nuances, role, encryption process, and limitations.
128+
129+
- **Not the Seed:**
130+
The wallet passphrase and the seed are two separate components in wallet security. The seed, or HD seed, functions as a master key for deriving private and public keys in a hierarchical deterministic (HD) wallet. In contrast, the passphrase serves as an additional layer of security specifically designed to secure the private keys within the wallet. The passphrase serves as a safeguard, demanding an additional layer of authentication to access funds in the wallet.
131+
132+
- **Protection Against Unauthorized Access:**
133+
The passphrase serves as a protective measure, securing your funds in situations where an unauthorized user gains access to your unlocked computer or device while your wallet application is active. Without the passphrase, they would be unable to access your wallet's funds or execute transactions. However, it's essential to be aware that someone with access can potentially compromise the security of your passphrase by installing a keylogger.
134+
135+
- **Doesn't Encrypt Metadata or Public Keys:**
136+
It's important to note that the passphrase primarily secures the private keys and access to funds within the wallet. It does not encrypt metadata associated with transactions or public keys. Information about your transaction history and the public keys involved may still be visible.
137+
138+
- **Risk of Fund Loss if Forgotten or Lost:**
139+
If the wallet passphrase is too complex and is subsequently forgotten or lost, there is a risk of losing access to the funds permanently. A forgotten passphrase will result in the inability to unlock the wallet and access the funds.
140+
125141
## Migrating Legacy Wallets to Descriptor Wallets
126142

127143
Legacy wallets (traditional non-descriptor wallets) can be migrated to become Descriptor wallets

0 commit comments

Comments
 (0)