fuzz coverage

Coverage Report

Created: 2025-09-17 22:41

/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