READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server440 file guides

Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.

14,711 bytes · SHA-256 f64bd97b1bd98302… · View upstream ↗

1// Copyright (c) 2021-present 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#include <base58.h>
6#include <key.h>
7#include <key_io.h>
8#include <primitives/block.h>
9#include <primitives/transaction.h>
10#include <psbt.h>
11#include <rpc/request.h>
12#include <rpc/server.h>
13#include <span.h>
14#include <streams.h>
15#include <test/fuzz/FuzzedDataProvider.h>
16#include <test/fuzz/fuzz.h>
17#include <test/fuzz/util.h>
18#include <test/util/setup_common.h>
19#include <test/util/time.h>
20#include <tinyformat.h>
21#include <uint256.h>
22#include <univalue.h>
23#include <util/strencodings.h>
24#include <util/string.h>
25#include <util/time.h>
26
27#include <algorithm>
28#include <cassert>
29#include <cstdint>
30#include <cstdlib>
31#include <exception>
32#include <iostream>
33#include <memory>
34#include <optional>
35#include <stdexcept>
36#include <utility>
37#include <vector>
38
39enum class ChainType;
40
41namespace {
42struct RPCFuzzTestingSetup : public TestingSetup {
43    RPCFuzzTestingSetup(const ChainType chain_type, TestOpts opts) : TestingSetup{chain_type, opts}
44    {
45    }
46
47    void CallRPC(const std::string& rpc_method, UniValue&& params)
48    {
49        JSONRPCRequest request;
50        request.context = &m_node;
51        request.strMethod = rpc_method;
52        request.params = std::move(params);
53        tableRPC.execute(request);
54    }
55
56    std::vector<std::string> GetRPCCommands() const
57    {
58        return tableRPC.listCommands();
59    }
60};
61
62RPCFuzzTestingSetup* rpc_testing_setup = nullptr;
63std::string g_limit_to_rpc_command;
64
65// RPC commands which are not appropriate for fuzzing: such as RPC commands
66// reading or writing to a filename passed as an RPC parameter, RPC commands
67// resulting in network activity, etc.
68const std::vector<std::string> RPC_COMMANDS_NOT_SAFE_FOR_FUZZING{
69    "addconnection",  // avoid DNS lookups
70    "addnode",        // avoid DNS lookups
71    "addpeeraddress", // avoid DNS lookups
72    "dumptxoutset",   // avoid writing to disk
73    "enumeratesigners",
74    "echoipc",              // avoid assertion failure (Assertion `"EnsureAnyNodeContext(request.context).init" && check' failed.)
75    "exportasmap",          // avoid writing to disk
76    "generatetoaddress",    // avoid prohibitively slow execution (when `num_blocks` is large)
77    "generatetodescriptor", // avoid prohibitively slow execution (when `nblocks` is large)
78    "gettxoutproof",        // avoid prohibitively slow execution
79    "importmempool",        // avoid reading from disk
80    "loadtxoutset",         // avoid reading from disk
81    "loadwallet",           // avoid reading from disk
82    "savemempool",          // disabled as a precautionary measure: may take a file path argument in the future
83    "setban",               // avoid DNS lookups
84    "stop",                 // avoid shutdown state
85};
86
87// RPC commands which are safe for fuzzing.
88const std::vector<std::string> RPC_COMMANDS_SAFE_FOR_FUZZING{
89    "abortprivatebroadcast",
90    "analyzepsbt",
91    "clearbanned",
92    "combinepsbt",
93    "combinerawtransaction",
94    "converttopsbt",
95    "createmultisig",
96    "createpsbt",
97    "createrawtransaction",
98    "decodepsbt",
99    "decoderawtransaction",
100    "decodescript",
101    "deriveaddresses",
102    "descriptorprocesspsbt",
103    "disconnectnode",
104    "echo",
105    "echojson",
106    "estimaterawfee",
107    "estimatesmartfee",
108    "finalizepsbt",
109    "generate",
110    "generateblock",
111    "getaddednodeinfo",
112    "getaddrmaninfo",
113    "getbestblockhash",
114    "getblock",
115    "getblockchaininfo",
116    "getblockcount",
117    "getblockfilter",
118    "getblockfrompeer", // when no peers are connected, no p2p message is sent
119    "getblockhash",
120    "getblockheader",
121    "getblockstats",
122    "getblocktemplate",
123    "getchaintips",
124    "getchainstates",
125    "getchaintxstats",
126    "getconnectioncount",
127    "getdeploymentinfo",
128    "getdescriptoractivity",
129    "getdescriptorinfo",
130    "getdifficulty",
131    "getindexinfo",
132    "getmemoryinfo",
133    "getmempoolancestors",
134    "getmempooldescendants",
135    "getmempoolentry",
136    "getmempoolfeeratediagram",
137    "getmempoolcluster",
138    "getmempoolinfo",
139    "getmininginfo",
140    "getnettotals",
141    "getnetworkhashps",
142    "getnetworkinfo",
143    "getnodeaddresses",
144    "getopenrpcinfo",
145    "getorphantxs",
146    "getpeerinfo",
147    "getprioritisedtransactions",
148    "getprivatebroadcastinfo",
149    "getrawaddrman",
150    "getrawmempool",
151    "getrawtransaction",
152    "getrpcinfo",
153    "gettxout",
154    "gettxoutsetinfo",
155    "gettxspendingprevout",
156    "help",
157    "invalidateblock",
158    "joinpsbts",
159    "listbanned",
160    "logging",
161    "mockscheduler",
162    "ping",
163    "preciousblock",
164    "prioritisetransaction",
165    "pruneblockchain",
166    "reconsiderblock",
167    "rpc.discover",
168    "scanblocks",
169    "scantxoutset",
170    "sendmsgtopeer", // when no peers are connected, no p2p message is sent
171    "sendrawtransaction",
172    "setmocktime",
173    "setnetworkactive",
174    "signmessagewithprivkey",
175    "signrawtransactionwithkey",
176    "submitblock",
177    "submitheader",
178    "submitpackage",
179    "syncwithvalidationinterfacequeue",
180    "testmempoolaccept",
181    "uptime",
182    "utxoupdatepsbt",
183    "validateaddress",
184    "verifychain",
185    "verifymessage",
186    "verifytxoutproof",
187    "waitforblock",
188    "waitforblockheight",
189    "waitfornewblock",
190};
191
192UniValue ConsumeBasicRPCArgument(FuzzedDataProvider& fuzzed_data_provider, bool& good_data)
193{
194    const size_t max_string_length = 4096;
195    const size_t max_base58_bytes_length{64};
196    UniValue r{};
197    CallOneOf(
198        fuzzed_data_provider,
199        [&] {
200            // arbitrary JSON argument
201            if (!r.read(fuzzed_data_provider.ConsumeRandomLengthString(max_string_length))) {
202                good_data = false;
203            }
204        },
205        [&] {
206            // null argument
207            r = UniValue{UniValue::VNULL};
208        },
209        [&] {
210            // string argument
211            r = UniValue{fuzzed_data_provider.ConsumeRandomLengthString(max_string_length)};
212        },
213        [&] {
214            // base64 argument
215            r = UniValue{EncodeBase64(fuzzed_data_provider.ConsumeRandomLengthString(max_string_length))};
216        },
217        [&] {
218            // hex argument
219            r = UniValue{HexStr(fuzzed_data_provider.ConsumeRandomLengthString(max_string_length))};
220        },
221        [&] {
222            // bool argument
223            r = UniValue{fuzzed_data_provider.ConsumeBool()};
224        },
225        [&] {
226            // integral argument (int64_t)
227            r = UniValue{fuzzed_data_provider.ConsumeIntegral<int64_t>()};
228        },
229        [&] {
230            // integral argument (uint64_t)
231            r = UniValue{fuzzed_data_provider.ConsumeIntegral<uint64_t>()};
232        },
233        [&] {
234            // floating point argument
235            r = UniValue{fuzzed_data_provider.ConsumeFloatingPoint<double>()};
236        },
237        [&] {
238            // tx destination argument
239            r = UniValue{EncodeDestination(ConsumeTxDestination(fuzzed_data_provider))};
240        },
241        [&] {
242            // uint160 argument
243            r = UniValue{ConsumeUInt160(fuzzed_data_provider).ToString()};
244        },
245        [&] {
246            // uint256 argument
247            r = UniValue{ConsumeUInt256(fuzzed_data_provider).ToString()};
248        },
249        [&] {
250            // base32 argument

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.cpp

Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.

Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.