highperfocused/bitcoin
1
0
Fork 0
mirror of https://github.com/bitcoin/bitcoin.git synced 2025-11-11 14:38:29 +01:00
Code Issues Packages Projects Releases Wiki Activity

wallet: Document blank flag use in descriptor wallets

Browse Source
This commit is contained in:
Ryan Ofsky
2023-06-08 07:03:22 -04:00
committed by Andrew Chow
parent 43310200dc
commit cdba23db35
1 changed files with 9 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
src/wallet/walletutil.h
View File

@@ -53,10 +53,18 @@ enum WalletFlags : uint64_t {
//! Flag set when a wallet contains no HD seed and no private keys, scripts, //! Flag set when a wallet contains no HD seed and no private keys, scripts,
//! addresses, and other watch only things, and is therefore "blank." //! addresses, and other watch only things, and is therefore "blank."
//! //!
//! The only function this flag serves is to distinguish a blank wallet from //! The main function this flag serves is to distinguish a blank wallet from
//! a newly created wallet when the wallet database is loaded, to avoid //! a newly created wallet when the wallet database is loaded, to avoid
//! initialization that should only happen on first run. //! initialization that should only happen on first run.
//! //!
//! A secondary function of this flag, which applies to descriptor wallets
//! only, is to serve as an ongoing indication that descriptors in the
//! wallet should be created manually, and that the wallet should not
//! generate automatically generate new descriptors if it is later
//! encrypted. To support this behavior, descriptor wallets unlike legacy
//! wallets do not automatically unset the BLANK flag when things are
//! imported.
//!
//! This flag is also a mandatory flag to prevent previous versions of //! This flag is also a mandatory flag to prevent previous versions of
//! bitcoin from opening the wallet, thinking it was newly created, and //! bitcoin from opening the wallet, thinking it was newly created, and
//! then improperly reinitializing it. //! then improperly reinitializing it.