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

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

▤ chainparamsbase.cppGuide

▤ chainparamsbase.hGuide

▤ chainparamsseeds.h

▤ checkqueue.hGuide

▤ clientversion.cppGuide

▤ clientversion.hGuide

▤ cluster_linearize.h

▤ CMakeLists.txt

▤ coins.cppGuide

▤ coins.hGuide

▤ compressor.cppGuide

▤ compressor.hGuide

▤ core_io.cpp

▤ core_io.hGuide

▤ core_memusage.hGuide

▤ cuckoocache.h

▤ dbwrapper.cpp

▤ dbwrapper.hGuide

▤ deploymentinfo.cppGuide

▤ deploymentinfo.hGuide

▤ deploymentstatus.cppGuide

▤ deploymentstatus.hGuide

▤ dummywallet.cppGuide

▤ external_signer.cpp

▤ external_signer.hGuide

▤ merkleblock.cppGuide

▤ merkleblock.hGuide

▤ musig.cpp

▤ musig.hGuide

▤ net_permissions.cppGuide

▤ net_permissions.hGuide

▤ net_processing.cppGuide

▤ netaddress.cppGuide

▤ netmessagemaker.hGuide

▤ noui.cppGuide

▤ noui.hGuide

▤ outputtype.cppGuide

▤ private_broadcast.cpp

▤ private_broadcast.h

▤ semaphore_grant.hGuide

▤ threadsafety.hGuide

▤ tinyformat.h

▤ torcontrol.cppGuide

▤ validation.cppGuide

▤ validation.h

▤ validationinterface.cpp

▤ validationinterface.h

▤ versionbits_impl.hGuide

▤ versionbits.cpp

▤ versionbits.hGuide

▤ walletinitinterface.hGuide

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / src / univalue / lib / univalue_read.cpp

Download source ↓

12,558 bytes · SHA-256 1945234b6bdd27cd… · View upstream ↗

251
252enum expect_bits : unsigned {
253    EXP_OBJ_NAME = (1U << 0),
254    EXP_COLON = (1U << 1),
255    EXP_ARR_VALUE = (1U << 2),
256    EXP_VALUE = (1U << 3),
257    EXP_NOT_VALUE = (1U << 4),
258};
259
260#define expect(bit) (expectMask & (EXP_##bit))
261#define setExpect(bit) (expectMask |= EXP_##bit)
262#define clearExpect(bit) (expectMask &= ~EXP_##bit)
263
264bool UniValue::read(std::string_view json)
265{
266    UniValue parsed;
267    if (!parsed.read_impl(json)) {
268        setNull();
269        return false;
270    }
271    *this = std::move(parsed);
272    return true;
273}
274
275bool UniValue::read_impl(std::string_view str_in)
276{
277    clear();
278
279    uint32_t expectMask = 0;
280    std::vector<UniValue*> stack;
281
282    std::string tokenVal;
283    unsigned int consumed;
284    enum jtokentype tok = JTOK_NONE;
285    enum jtokentype last_tok = JTOK_NONE;
286    const char* raw{str_in.data()};
287    const char* end{raw + str_in.size()};
288    do {
289        last_tok = tok;
290
291        tok = getJsonToken(tokenVal, consumed, raw, end);
292        if (tok == JTOK_NONE || tok == JTOK_ERR)
293            return false;
294        raw += consumed;
295
296        bool isValueOpen = jsonTokenIsValue(tok) ||
297            tok == JTOK_OBJ_OPEN || tok == JTOK_ARR_OPEN;
298
299        if (expect(VALUE)) {
300            if (!isValueOpen)
301                return false;
302            clearExpect(VALUE);
303
304        } else if (expect(ARR_VALUE)) {
305            bool isArrValue = isValueOpen || (tok == JTOK_ARR_CLOSE);
306            if (!isArrValue)
307                return false;
308
309            clearExpect(ARR_VALUE);
310
311        } else if (expect(OBJ_NAME)) {
312            bool isObjName = (tok == JTOK_OBJ_CLOSE || tok == JTOK_STRING);
313            if (!isObjName)
314                return false;
315
316        } else if (expect(COLON)) {
317            if (tok != JTOK_COLON)
318                return false;
319            clearExpect(COLON);
320
321        } else if (!expect(COLON) && (tok == JTOK_COLON)) {
322            return false;
323        }
324
325        if (expect(NOT_VALUE)) {
326            if (isValueOpen)
327                return false;
328            clearExpect(NOT_VALUE);
329        }
330
331        switch (tok) {
332
333        case JTOK_OBJ_OPEN:
334        case JTOK_ARR_OPEN: {
335            VType utyp = (tok == JTOK_OBJ_OPEN ? VOBJ : VARR);
336            if (!stack.size()) {
337                if (utyp == VOBJ)
338                    setObject();
339                else
340                    setArray();
341                stack.push_back(this);
342            } else {
343                UniValue tmpVal(utyp);
344                UniValue *top = stack.back();
345                top->values.push_back(tmpVal);
346
347                UniValue *newTop = &(top->values.back());
348                stack.push_back(newTop);
349            }
350
351            if (stack.size() > MAX_JSON_DEPTH)
352                return false;
353
354            if (utyp == VOBJ)
355                setExpect(OBJ_NAME);
356            else
357                setExpect(ARR_VALUE);
358            break;
359            }
360
361        case JTOK_OBJ_CLOSE:
362        case JTOK_ARR_CLOSE: {
363            if (!stack.size() || (last_tok == JTOK_COMMA))
364                return false;
365
366            VType utyp = (tok == JTOK_OBJ_CLOSE ? VOBJ : VARR);
367            UniValue *top = stack.back();
368            if (utyp != top->getType())
369                return false;
370
371            stack.pop_back();
372            clearExpect(OBJ_NAME);
373            setExpect(NOT_VALUE);
374            break;
375            }
376
377        case JTOK_COLON: {
378            if (!stack.size())
379                return false;
380
381            UniValue *top = stack.back();
382            if (top->getType() != VOBJ)
383                return false;
384
385            setExpect(VALUE);
386            break;
387            }
388
389        case JTOK_COMMA: {
390            if (!stack.size() ||
391                (last_tok == JTOK_COMMA) || (last_tok == JTOK_ARR_OPEN))
392                return false;
393
394            UniValue *top = stack.back();
395            if (top->getType() == VOBJ)
396                setExpect(OBJ_NAME);
397            else
398                setExpect(ARR_VALUE);
399            break;
400            }
401
402        case JTOK_KW_NULL:
403        case JTOK_KW_TRUE:
404        case JTOK_KW_FALSE: {
405            UniValue tmpVal;
406            switch (tok) {
407            case JTOK_KW_NULL:
408                // do nothing more
409                break;
410            case JTOK_KW_TRUE:
411                tmpVal.setBool(true);
412                break;
413            case JTOK_KW_FALSE:
414                tmpVal.setBool(false);
415                break;
416            default: /* impossible */ break;
417            }
418
419            if (!stack.size()) {
420                *this = tmpVal;
421                break;
422            }
423
424            UniValue *top = stack.back();
425            top->values.push_back(tmpVal);
426
427            setExpect(NOT_VALUE);
428            break;
429            }
430
431        case JTOK_NUMBER: {
432            UniValue tmpVal(VNUM, tokenVal);
433            if (!stack.size()) {
434                *this = tmpVal;
435                break;
436            }
437
438            UniValue *top = stack.back();
439            top->values.push_back(tmpVal);
440
441            setExpect(NOT_VALUE);
442            break;
443            }
444
445        case JTOK_STRING: {
446            if (expect(OBJ_NAME)) {
447                UniValue *top = stack.back();
448                top->keys.push_back(tokenVal);
449                clearExpect(OBJ_NAME);
450                setExpect(COLON);
451            } else {
452                UniValue tmpVal(VSTR, tokenVal);
453                if (!stack.size()) {
454                    *this = tmpVal;
455                    break;
456                }
457                UniValue *top = stack.back();
458                top->values.push_back(tmpVal);
459            }
460
461            setExpect(NOT_VALUE);
462            break;
463            }
464
465        default:
466            return false;
467        }
468    } while (!stack.empty ());
469
470    /* Check that nothing follows the initial construct (parsed above).  */
471    tok = getJsonToken(tokenVal, consumed, raw, end);
472    if (tok != JTOK_NONE)
473        return false;
474
475    return true;
476}
477

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.

440 guided files · 2,580 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 2

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.