BITCOIN MAINNETLive explorer status

Explorer Mempool Feed Forum Visualizer Receipts Tools Learn Code

Inside Bitcoin

Opening the selected file…

₿MyBitcoinExplorer

Bitcoin, in focus.
Explore the network. Understand the connections.

Explore Bitcoin with clarity.

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 server340 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.

bitcoin / bitcoinstable

Find a file

▤ arith_uint256.hGuide

▤ bitcoin-chainstate.cpp

▤ bitcoin-cli-res.rc

▤ bitcoin-cli.cppGuide

▤ bitcoin-res.rc

▤ bitcoin-tx-res.rc

▤ bitcoin-tx.cpp

▤ bitcoin-util-res.rc

▤ bitcoin-util.cpp

▤ bitcoin-wallet-res.rc

▤ blockencodings.cppGuide

▤ blockencodings.hGuide

▤ blockfilter.cppGuide

▤ blockfilter.hGuide

▤ chain.cppGuide

▤ chain.h

▤ chainparams.cppGuide

▤ chainparams.h

▤ chainparamsbase.cppGuide

▤ chainparamsbase.hGuide

▤ chainparamsseeds.h

▤ checkqueue.hGuide

▤ clientversion.cpp

▤ clientversion.hGuide

▤ cluster_linearize.h

▤ CMakeLists.txt

▤ coins.cppGuide

▤ coins.hGuide

▤ compressor.cppGuide

▤ deploymentstatus.cpp

▤ deploymentstatus.h

▤ dummywallet.cpp

▤ external_signer.cpp

▤ merkleblock.cppGuide

▤ merkleblock.hGuide

▤ musig.cpp

▤ musig.h

▤ net_permissions.cppGuide

▤ net_permissions.h

▤ net_processing.cppGuide

▤ netaddress.cppGuide

▤ private_broadcast.cpp

▤ private_broadcast.h

▤ threadsafety.hGuide

▤ tinyformat.h

▤ torcontrol.cppGuide

▤ validation.cppGuide

▤ validation.h

▤ validationinterface.cpp

▤ validationinterface.h

▤ versionbits_impl.h

▤ versionbits.cpp

▤ versionbits.h

▤ walletinitinterface.h

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / src / rest.cpp

Download source ↓

45,310 bytes · SHA-256 3c318d03f07bf3c5… · View upstream ↗

251        while (pindex != nullptr && active_chain.Contains(*pindex)) {
252            headers.push_back(pindex);
253            if (headers.size() == *parsed_count) {
254                break;
255            }
256            pindex = active_chain.Next(*pindex);
257        }
258    }
259
260    switch (rf) {
261    case RESTResponseFormat::BINARY: {
262        DataStream ssHeader{};
263        for (const CBlockIndex *pindex : headers) {
264            ssHeader << pindex->GetBlockHeader();
265        }
266
267        // Do not cache because chain extensions and reorgs can affect the response.
268        req->WriteHeader("Cache-Control", REST_CACHE_NO_STORE);
269        req->WriteHeader("Content-Type", "application/octet-stream");
270        req->WriteReply(HTTP_OK, ssHeader);
271        return true;
272    }
273
274    case RESTResponseFormat::HEX: {
275        DataStream ssHeader{};
276        for (const CBlockIndex *pindex : headers) {
277            ssHeader << pindex->GetBlockHeader();
278        }
279
280        std::string strHex = HexStr(ssHeader) + "\n";
281        req->WriteHeader("Cache-Control", REST_CACHE_NO_STORE);
282        req->WriteHeader("Content-Type", "text/plain");
283        req->WriteReply(HTTP_OK, strHex);
284        return true;
285    }
286    case RESTResponseFormat::JSON: {
287        UniValue jsonHeaders(UniValue::VARR);
288        for (const CBlockIndex *pindex : headers) {
289            jsonHeaders.push_back(blockheaderToJSON(*tip, *pindex, chainman.GetConsensus().powLimit));
290        }
291        std::string strJSON = jsonHeaders.write() + "\n";
292        req->WriteHeader("Cache-Control", REST_CACHE_NO_STORE);
293        req->WriteHeader("Content-Type", "application/json");
294        req->WriteReply(HTTP_OK, strJSON);
295        return true;
296    }
297    default: {
298        return RESTERR(req, HTTP_NOT_FOUND, "output format not found (available: " + AvailableDataFormatsString() + ")");
299    }
300    }
301}
302
303/**
304 * Serialize spent outputs as a list of per-transaction CTxOut lists using binary format.
305 */
306static void SerializeBlockUndo(DataStream& stream, const CBlockUndo& block_undo)
307{
308    WriteCompactSize(stream, block_undo.vtxundo.size() + 1);
309    WriteCompactSize(stream, 0); // block_undo.vtxundo doesn't contain coinbase tx
310    for (const CTxUndo& tx_undo : block_undo.vtxundo) {
311        WriteCompactSize(stream, tx_undo.vprevout.size());
312        for (const Coin& coin : tx_undo.vprevout) {
313            coin.out.Serialize(stream);
314        }
315    }
316}
317
318/**
319 * Serialize spent outputs as a list of per-transaction CTxOut lists using JSON format.
320 */
321static void BlockUndoToJSON(const CBlockUndo& block_undo, UniValue& result)
322{
323    result.push_back({UniValue::VARR}); // block_undo.vtxundo doesn't contain coinbase tx
324    for (const CTxUndo& tx_undo : block_undo.vtxundo) {
325        UniValue tx_prevouts(UniValue::VARR);
326        for (const Coin& coin : tx_undo.vprevout) {
327            UniValue prevout(UniValue::VOBJ);
328            prevout.pushKV("value", ValueFromAmount(coin.out.nValue));
329
330            UniValue script_pub_key(UniValue::VOBJ);
331            ScriptToUniv(coin.out.scriptPubKey, /*out=*/script_pub_key, /*include_hex=*/true, /*include_address=*/true);
332            prevout.pushKV("scriptPubKey", std::move(script_pub_key));
333
334            tx_prevouts.push_back(std::move(prevout));
335        }
336        result.push_back(std::move(tx_prevouts));
337    }
338}
339
340static bool rest_spent_txouts(const std::any& context, HTTPRequest* req, const std::string& uri_part)
341{
342    if (!CheckWarmup(req)) {
343        return false;
344    }
345    std::string param;
346    const RESTResponseFormat rf = ParseDataFormat(param, uri_part);
347    std::vector<std::string> path = SplitString(param, '/');
348
349    std::string hashStr;
350    if (path.size() == 1) {
351        // path with query parameter: /rest/spenttxouts/<hash>
352        hashStr = path[0];
353    } else {
354        return RESTERR(req, HTTP_BAD_REQUEST, "Invalid URI format. Expected /rest/spenttxouts/<hash>.<ext>");
355    }
356
357    auto hash{uint256::FromHex(hashStr)};
358    if (!hash) {
359        return RESTERR(req, HTTP_BAD_REQUEST, "Invalid hash: " + hashStr);
360    }
361
362    ChainstateManager* chainman = GetChainman(context, req);
363    if (!chainman) {
364        return false;
365    }
366
367    const CBlockIndex* pblockindex = WITH_LOCK(cs_main, return chainman->m_blockman.LookupBlockIndex(*hash));
368    if (!pblockindex) {
369        return RESTERR(req, HTTP_NOT_FOUND, hashStr + " not found");
370    }
371
372    CBlockUndo block_undo;
373    if (pblockindex->nHeight > 0 && !chainman->m_blockman.ReadBlockUndo(block_undo, *pblockindex)) {
374        return RESTERR(req, HTTP_NOT_FOUND, hashStr + " undo not available");
375    }
376
377    switch (rf) {
378    case RESTResponseFormat::BINARY: {
379        DataStream ssSpentResponse{};
380        SerializeBlockUndo(ssSpentResponse, block_undo);
381        req->WriteHeader("Cache-Control", REST_CACHE_IMMUTABLE);
382        req->WriteHeader("Content-Type", "application/octet-stream");
383        req->WriteReply(HTTP_OK, ssSpentResponse);
384        return true;
385    }
386
387    case RESTResponseFormat::HEX: {
388        DataStream ssSpentResponse{};
389        SerializeBlockUndo(ssSpentResponse, block_undo);
390        const std::string strHex{HexStr(ssSpentResponse) + "\n"};
391        req->WriteHeader("Cache-Control", REST_CACHE_IMMUTABLE);
392        req->WriteHeader("Content-Type", "text/plain");
393        req->WriteReply(HTTP_OK, strHex);
394        return true;
395    }
396
397    case RESTResponseFormat::JSON: {
398        UniValue result(UniValue::VARR);
399        BlockUndoToJSON(block_undo, result);
400        std::string strJSON = result.write() + "\n";
401        req->WriteHeader("Cache-Control", REST_CACHE_IMMUTABLE);
402        req->WriteHeader("Content-Type", "application/json");
403        req->WriteReply(HTTP_OK, strJSON);
404        return true;
405    }
406
407    default: {
408        return RESTERR(req, HTTP_NOT_FOUND, "output format not found (available: " + AvailableDataFormatsString() + ")");
409    }
410    }
411}
412
413/**
414 * This handler is used by multiple HTTP endpoints:
415 * - `/block/` via `rest_block_extended()`
416 * - `/block/notxdetails/` via `rest_block_notxdetails()`
417 * - `/blockpart/` via `rest_block_part()` (doesn't support JSON response, so `tx_verbosity` is unset)
418 */
419static bool rest_block(const std::any& context,
420                       HTTPRequest* req,
421                       const std::string& uri_part,
422                       std::optional<TxVerbosity> tx_verbosity,
423                       std::optional<std::pair<size_t, size_t>> block_part = std::nullopt)
424{
425    if (!CheckWarmup(req))
426        return false;
427    std::string hashStr;
428    const RESTResponseFormat rf = ParseDataFormat(hashStr, uri_part);
429
430    auto hash{uint256::FromHex(hashStr)};
431    if (!hash) {
432        return RESTERR(req, HTTP_BAD_REQUEST, "Invalid hash: " + hashStr);
433    }
434
435    FlatFilePos pos{};
436    const CBlockIndex* pblockindex = nullptr;
437    const CBlockIndex* tip = nullptr;
438    ChainstateManager* maybe_chainman = GetChainman(context, req);
439    if (!maybe_chainman) return false;
440    ChainstateManager& chainman = *maybe_chainman;
441    {
442        LOCK(cs_main);
443        tip = chainman.ActiveChain().Tip();
444        pblockindex = chainman.m_blockman.LookupBlockIndex(*hash);
445        if (!pblockindex) {
446            return RESTERR(req, HTTP_NOT_FOUND, hashStr + " not found");
447        }
448        if (!(pblockindex->nStatus & BLOCK_HAVE_DATA)) {
449            if (chainman.m_blockman.IsBlockPruned(*pblockindex)) {
450                return RESTERR(req, HTTP_NOT_FOUND, hashStr + " not available (pruned data)");
451            }
452            return RESTERR(req, HTTP_NOT_FOUND, hashStr + " not available (not fully downloaded)");
453        }
454        pos = pblockindex->GetBlockPos();
455    }
456
457    const auto block_data{chainman.m_blockman.ReadRawBlock(pos, block_part)};
458    if (!block_data) {
459        switch (block_data.error()) {
460        case node::ReadRawError::IO: return RESTERR(req, HTTP_INTERNAL_SERVER_ERROR, "I/O error reading " + hashStr);
461        case node::ReadRawError::BadPartRange:
462            assert(block_part);
463            return RESTERR(req, HTTP_BAD_REQUEST, strprintf("Bad block part offset/size %d/%d for %s", block_part->first, block_part->second, hashStr));
464        } // no default case, so the compiler can warn about missing cases
465        assert(false);
466    }
467
468    switch (rf) {
469    case RESTResponseFormat::BINARY: {
470        req->WriteHeader("Cache-Control", REST_CACHE_IMMUTABLE);
471        req->WriteHeader("Content-Type", "application/octet-stream");
472        req->WriteReply(HTTP_OK, *block_data);
473        return true;
474    }
475
476    case RESTResponseFormat::HEX: {
477        const std::string strHex{HexStr(*block_data) + "\n"};
478        req->WriteHeader("Cache-Control", REST_CACHE_IMMUTABLE);
479        req->WriteHeader("Content-Type", "text/plain");
480        req->WriteReply(HTTP_OK, strHex);
481        return true;
482    }
483
484    case RESTResponseFormat::JSON: {
485        if (tx_verbosity) {
486            CBlock block{};
487            SpanReader{*block_data} >> TX_WITH_WITNESS(block);
488            UniValue objBlock = blockToJSON(chainman.m_blockman, block, *tip, *pblockindex, *tx_verbosity, chainman.GetConsensus().powLimit);
489            std::string strJSON = objBlock.write() + "\n";
490            req->WriteHeader("Cache-Control", REST_CACHE_NO_STORE);
491            req->WriteHeader("Content-Type", "application/json");
492            req->WriteReply(HTTP_OK, strJSON);
493            return true;
494        }
495        return RESTERR(req, HTTP_BAD_REQUEST, "JSON output is not supported for this request type");
496    }
497
498    default: {
499        return RESTERR(req, HTTP_NOT_FOUND, "output format not found (available: " + AvailableDataFormatsString() + ")");
500    }

A READING COMPANION

Source available. Guide coming next.

This file is included in the stable source snapshot. A file-specific guide has not been published yet.

340 guided files · 2,680 pending. Guides cover key sections, not every line.

cmake/bitcoin-build-config.h.in src/consensus/amount.h src/consensus/consensus.h src/primitives/block.h src/primitives/transaction.h src/crypto/sha256.h src/util/moneystr.h src/clientversion.h src/uint256.h src/script/script.h src/policy/policy.h CMakeLists.txt README.md COPYING src/consensus/tx_check.cpp src/consensus/tx_verify.cpp src/consensus/merkle.cpp src/pow.cpp src/validation.cpp src/script/interpreter.cpp src/script/solver.cpp src/script/sign.cpp src/key_io.cpp src/net.cpp src/net_processing.cpp src/netaddress.cpp src/protocol.h src/wallet/wallet.cpp src/wallet/spend.cpp

← Previous 250 linesCode page 2Next 250 lines →

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

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.