Function getblock

src/rpc/blockchain.cpp:805–890

}

static RPCMethod getblock()
{
    return RPCMethod{
        "getblock",
        "If verbosity is 0, returns a string that is serialized, hex-encoded data for block 'hash'.\n"
                "If verbosity is 1, returns an Object with information about block <hash>.\n"
                "If verbosity is 2, returns an Object with information about block <hash> and information about each transaction.\n"
                "If verbosity is 3, returns an Object with information about block <hash> and information about each transaction, including prevout information for inputs (only for unpruned blocks in the current best chain).\n",
                {
                    {"blockhash", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The block hash"},
                    {"verbosity|verbose", RPCArg::Type::NUM, RPCArg::Default{1}, "0 for hex-encoded data, 1 for a JSON object, 2 for JSON object with transaction data, and 3 for JSON object with transaction data including prevout information for inputs",
                     RPCArgOptions{.skip_type_check = true}},
                },
                {
                    RPCResult{"for verbosity = 0", RPCResult::Type::STR_HEX, "", "A string that is serialized, hex-encoded data for block 'hash'"},
                    RPCResult{"for verbosity = 1", RPCResult::Type::OBJ, "", "",
                        GetBlockFields({RPCResult::Type::ARR, "tx", "The transaction ids",
                            {{RPCResult::Type::STR_HEX, "", "The transaction id"}}})},
                    RPCResult{"for verbosity = 2", RPCResult::Type::OBJ, "", "",
                        GetBlockFields({RPCResult::Type::ARR, "tx", "",
                        {
                            {RPCResult::Type::OBJ, "", "",
                                TxDoc({.elision_mode = ElisionMode::WithSummary,
                                       .elision_summary = "The transactions in the format of the getrawtransaction RPC. Different from verbosity = 1 \"tx\" result",
                                       .fee = true, .hex = true,
                                       .fee_doc = "The transaction fee in " + CURRENCY_UNIT + ", omitted if block undo data is not available"})},
                        }}, /*elision_msg=*/"Same output as verbosity = 1")},
                    RPCResult{"for verbosity = 3", RPCResult::Type::OBJ, "", "",
                        GetBlockFields({RPCResult::Type::ARR, "tx", "",
                        {
                            {RPCResult::Type::OBJ, "", "",
                                TxDoc({.elision_mode = ElisionMode::Silent,
                                       .prevout = true,
                                       .prevout_optional = true,
                                       .fee = true,
                                       .hex = true,
                                       .vin_item_doc = "",
                                       .prevout_doc = "(Only if undo information is available)",
                                       .vin_inner_elision = "The same output as verbosity = 2"})},
                        }}, /*elision_msg=*/"Same output as verbosity = 2")},
                },
                RPCExamples{
                    HelpExampleCli("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
            + HelpExampleRpc("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
                },
        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
{
    uint256 hash(ParseHashV(request.params[0], "blockhash"));

    int verbosity{ParseVerbosity(request.params[1], /*default_verbosity=*/1, /*allow_bool=*/true)};

    const CBlockIndex* pblockindex;
    const CBlockIndex* tip;
    ChainstateManager& chainman = EnsureAnyChainman(request.context);
    {
        LOCK(cs_main);
        pblockindex = chainman.m_blockman.LookupBlockIndex(hash);
        tip = chainman.ActiveChain().Tip();