/Users/eugenesiegel/btc/bitcoin/src/wallet/walletutil.h
| Line | Count | Source (jump to first uncovered line) | 
| 1 |  | // Copyright (c) 2017-2021 The Bitcoin Core developers | 
| 2 |  | // Distributed under the MIT software license, see the accompanying | 
| 3 |  | // file COPYING or http://www.opensource.org/licenses/mit-license.php. | 
| 4 |  |  | 
| 5 |  | #ifndef BITCOIN_WALLET_WALLETUTIL_H | 
| 6 |  | #define BITCOIN_WALLET_WALLETUTIL_H | 
| 7 |  |  | 
| 8 |  | #include <script/descriptor.h> | 
| 9 |  | #include <util/fs.h> | 
| 10 |  |  | 
| 11 |  | #include <vector> | 
| 12 |  |  | 
| 13 |  | namespace wallet { | 
| 14 |  |  | 
| 15 |  | enum WalletFlags : uint64_t { | 
| 16 |  |     // wallet flags in the upper section (> 1 << 31) will lead to not opening the wallet if flag is unknown | 
| 17 |  |     // unknown wallet flags in the lower section <= (1 << 31) will be tolerated | 
| 18 |  |  | 
| 19 |  |     // will categorize coins as clean (not reused) and dirty (reused), and handle | 
| 20 |  |     // them with privacy considerations in mind | 
| 21 |  |     WALLET_FLAG_AVOID_REUSE = (1ULL << 0), | 
| 22 |  |  | 
| 23 |  |     // Indicates that the metadata has already been upgraded to contain key origins | 
| 24 |  |     WALLET_FLAG_KEY_ORIGIN_METADATA = (1ULL << 1), | 
| 25 |  |  | 
| 26 |  |     // Indicates that the descriptor cache has been upgraded to cache last hardened xpubs | 
| 27 |  |     WALLET_FLAG_LAST_HARDENED_XPUB_CACHED = (1ULL << 2), | 
| 28 |  |  | 
| 29 |  |     // will enforce the rule that the wallet can't contain any private keys (only watch-only/pubkeys) | 
| 30 |  |     WALLET_FLAG_DISABLE_PRIVATE_KEYS = (1ULL << 32), | 
| 31 |  |  | 
| 32 |  |     //! Flag set when a wallet contains no HD seed and no private keys, scripts, | 
| 33 |  |     //! addresses, and other watch only things, and is therefore "blank." | 
| 34 |  |     //! | 
| 35 |  |     //! The main function this flag serves is to distinguish a blank wallet from | 
| 36 |  |     //! a newly created wallet when the wallet database is loaded, to avoid | 
| 37 |  |     //! initialization that should only happen on first run. | 
| 38 |  |     //! | 
| 39 |  |     //! A secondary function of this flag, which applies to descriptor wallets | 
| 40 |  |     //! only, is to serve as an ongoing indication that descriptors in the | 
| 41 |  |     //! wallet should be created manually, and that the wallet should not | 
| 42 |  |     //! generate automatically generate new descriptors if it is later | 
| 43 |  |     //! encrypted. To support this behavior, descriptor wallets unlike legacy | 
| 44 |  |     //! wallets do not automatically unset the BLANK flag when things are | 
| 45 |  |     //! imported. | 
| 46 |  |     //! | 
| 47 |  |     //! This flag is also a mandatory flag to prevent previous versions of | 
| 48 |  |     //! bitcoin from opening the wallet, thinking it was newly created, and | 
| 49 |  |     //! then improperly reinitializing it. | 
| 50 |  |     WALLET_FLAG_BLANK_WALLET = (1ULL << 33), | 
| 51 |  |  | 
| 52 |  |     //! Indicate that this wallet supports DescriptorScriptPubKeyMan | 
| 53 |  |     WALLET_FLAG_DESCRIPTORS = (1ULL << 34), | 
| 54 |  |  | 
| 55 |  |     //! Indicates that the wallet needs an external signer | 
| 56 |  |     WALLET_FLAG_EXTERNAL_SIGNER = (1ULL << 35), | 
| 57 |  | }; | 
| 58 |  |  | 
| 59 |  | //! Get the path of the wallet directory. | 
| 60 |  | fs::path GetWalletDir(); | 
| 61 |  |  | 
| 62 |  | /** Descriptor with some wallet metadata */ | 
| 63 |  | class WalletDescriptor | 
| 64 |  | { | 
| 65 |  | public: | 
| 66 |  |     std::shared_ptr<Descriptor> descriptor; | 
| 67 |  |     uint256 id; // Descriptor ID (calculated once at descriptor initialization/deserialization) | 
| 68 |  |     uint64_t creation_time = 0; | 
| 69 |  |     int32_t range_start = 0; // First item in range; start of range, inclusive, i.e. [range_start, range_end). This never changes. | 
| 70 |  |     int32_t range_end = 0; // Item after the last; end of range, exclusive, i.e. [range_start, range_end). This will increment with each TopUp() | 
| 71 |  |     int32_t next_index = 0; // Position of the next item to generate | 
| 72 |  |     DescriptorCache cache; | 
| 73 |  |  | 
| 74 |  |     void DeserializeDescriptor(const std::string& str) | 
| 75 | 0 |     { | 
| 76 | 0 |         std::string error; | 
| 77 | 0 |         FlatSigningProvider keys; | 
| 78 | 0 |         auto descs = Parse(str, keys, error, true); | 
| 79 | 0 |         if (descs.empty()) { | 
| 80 | 0 |             throw std::ios_base::failure("Invalid descriptor: " + error); | 
| 81 | 0 |         } | 
| 82 | 0 |         if (descs.size() > 1) { | 
| 83 | 0 |             throw std::ios_base::failure("Can't load a multipath descriptor from databases"); | 
| 84 | 0 |         } | 
| 85 | 0 |         descriptor = std::move(descs.at(0)); | 
| 86 | 0 |         id = DescriptorID(*descriptor); | 
| 87 | 0 |     } | 
| 88 |  |  | 
| 89 |  |     SERIALIZE_METHODS(WalletDescriptor, obj) | 
| 90 | 0 |     { | 
| 91 | 0 |         std::string descriptor_str; | 
| 92 | 0 |         SER_WRITE(obj, descriptor_str = obj.descriptor->ToString()); | Line | Count | Source |  | 147 | 0 | #define SER_WRITE(obj, code) ser_action.SerWrite(s, obj, [&](Stream& s, const Type& obj) { code; }) | 
 |         SER_WRITE(obj, descriptor_str = obj.descriptor->ToString()); | Line | Count | Source |  | 147 | 0 | #define SER_WRITE(obj, code) ser_action.SerWrite(s, obj, [&](Stream& s, const Type& obj) { code; }) | 
 | 
| 93 | 0 |         READWRITE(descriptor_str, obj.creation_time, obj.next_index, obj.range_start, obj.range_end); | Line | Count | Source |  | 145 | 0 | #define READWRITE(...) (ser_action.SerReadWriteMany(s, __VA_ARGS__)) | 
 |         READWRITE(descriptor_str, obj.creation_time, obj.next_index, obj.range_start, obj.range_end); | Line | Count | Source |  | 145 | 0 | #define READWRITE(...) (ser_action.SerReadWriteMany(s, __VA_ARGS__)) | 
 | 
| 94 | 0 |         SER_READ(obj, obj.DeserializeDescriptor(descriptor_str)); | Line | Count | Source |  | 146 | 0 | #define SER_READ(obj, code) ser_action.SerRead(s, obj, [&](Stream& s, std::remove_const_t<Type>& obj) { code; }) | 
 |         SER_READ(obj, obj.DeserializeDescriptor(descriptor_str)); | Line | Count | Source |  | 146 | 0 | #define SER_READ(obj, code) ser_action.SerRead(s, obj, [&](Stream& s, std::remove_const_t<Type>& obj) { code; }) | 
 | 
| 95 | 0 |     } Unexecuted instantiation: _ZN6wallet16WalletDescriptor16SerializationOpsI10DataStreamS0_17ActionUnserializeEEvRT0_RT_T1_Unexecuted instantiation: _ZN6wallet16WalletDescriptor16SerializationOpsI10DataStreamKS0_15ActionSerializeEEvRT0_RT_T1_ | 
| 96 |  |  | 
| 97 | 0 |     WalletDescriptor() = default; | 
| 98 | 0 |     WalletDescriptor(std::shared_ptr<Descriptor> descriptor, uint64_t creation_time, int32_t range_start, int32_t range_end, int32_t next_index) : descriptor(descriptor), id(DescriptorID(*descriptor)), creation_time(creation_time), range_start(range_start), range_end(range_end), next_index(next_index) { } | 
| 99 |  | }; | 
| 100 |  |  | 
| 101 |  | WalletDescriptor GenerateWalletDescriptor(const CExtPubKey& master_key, const OutputType& output_type, bool internal); | 
| 102 |  | } // namespace wallet | 
| 103 |  |  | 
| 104 |  | #endif // BITCOIN_WALLET_WALLETUTIL_H |