Function getnewblockhex

src/rpc/mining.cpp:1292–1419

// ELEMENTS:

static RPCHelpMan getnewblockhex()
{
    return RPCHelpMan{"getnewblockhex",
                "\nGets hex representation of a proposed, unmined new block\n",
                {
                    {"min_tx_age", RPCArg::Type::NUM, RPCArg::Default{0}, "How many seconds a transaction must have been in the mempool to be included in the block proposal. This may help with faster block convergence among functionaries using compact blocks."},
                    {"proposed_parameters", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "Parameters to be used in dynamic federations blocks as proposals. During a period of `-dynamic_epoch_length` blocks, 4/5 of total blocks must signal these parameters for the proposal to become activated in the next epoch.",
                        {
                            {"signblockscript", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "Hex-encoded block signing script to propose"},
                            {"max_block_witness", RPCArg::Type::NUM, RPCArg::Optional::NO, "Total size in witness bytes that are allowed in the dynamic federations block witness for blocksigning"},
                            {"fedpegscript", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "Hex-encoded fedpegscript for dynamic block proposal. This is interpreted as a v0 segwit witnessScript, and fills out the fedpeg_program as such."},
                            {"extension_space", RPCArg::Type::ARR, RPCArg::Optional::NO, "Array of additional fields to embed in the dynamic blockheader. Has no consensus meaning aside from serialized size changes. This space is currently is only used for PAK enforcement.",
                                {
                                    {"", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "Hex encoded string for extension entries."},
                                },
                            },
                        },
                        "proposed_parameters"},
                    {"commit_data", RPCArg::Type::ARR, RPCArg::Optional::OMITTED, "Array of data in hex to be committed to in additional coinbase outputs.",
                        {
                            {"", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "Hex encoded string for commit data"},
                        },
                    },
                },
                RPCResult{
                    RPCResult::Type::STR_HEX, "blockhex", "the block hex",
                },
                RPCExamples{
                    HelpExampleCli("getnewblockhex", ""),
                },
        [&](const RPCHelpMan& self, const JSONRPCRequest& request) -> UniValue
{
    ChainstateManager& chainman = EnsureAnyChainman(request.context);

    int required_wait = !request.params[0].isNull() ? request.params[0].get_int() : 0;
    if (required_wait < 0) {
        throw JSONRPCError(RPC_INVALID_PARAMETER, "min_tx_age must be non-negative.");
    }

    // Construct proposed parameter entry, if any
    DynaFedParamEntry proposed;
    if (!request.params[1].isNull()) {
        if (!DeploymentActiveAfter(chainman.ActiveChain().Tip(), Params().GetConsensus(), Consensus::DEPLOYMENT_DYNA_FED)) {
            throw JSONRPCError(RPC_INVALID_PARAMETER, "Dynamic federations is not active on this network. Proposed parameters are not needed.");
        }

        UniValue prop = request.params[1].get_obj();

        std::string sbs_str = prop["signblockscript"].get_str();
        if (!IsHex(sbs_str)) {
            throw JSONRPCError(RPC_INVALID_PARAMETER, "signblockscript must be hex");
        }
        std::vector<unsigned char> signblock_bytes = ParseHex(sbs_str);
        proposed.m_signblockscript = CScript(signblock_bytes.begin(), signblock_bytes.end());

        int max_sbs_wit = prop["max_block_witness"].get_int();
        if (max_sbs_wit < 0) {
            throw JSONRPCError(RPC_INVALID_PARAMETER, "max_block_witness must be non-negative");