Function SubmitBlock

src/node/miner.cpp:388–419

} // namespace

bool SubmitBlock(ChainstateManager& chainman, const std::shared_ptr<const CBlock>& block, bool* new_block, std::string& reason, std::string& debug)
{
    reason.clear();
    debug.clear();

    // This follows the submitblock RPC's validation-state capture pattern, but
    // is intentionally kept separate from the RPC implementation. The RPC entry
    // point decodes hex, formats BIP22/JSONRPC results, and calls
    // UpdateUncommittedBlockStructures() for legacy witness handling. IPC
    // callers submit already-formed blocks and need bool + reason/debug
    // results, while submitSolution() preserves its duplicate-as-success
    // behavior.
    auto sc = std::make_shared<SubmitBlockStateCatcher>(block->GetHash());
    CHECK_NONFATAL(chainman.m_options.signals)->RegisterSharedValidationInterface(sc);
    bool accepted = chainman.ProcessNewBlock(block, /*force_processing=*/true, /*min_pow_checked=*/true, /*new_block=*/new_block);
    CHECK_NONFATAL(chainman.m_options.signals)->UnregisterSharedValidationInterface(sc);

    if (new_block && !*new_block && accepted) {
        reason = "duplicate";
    } else if (!sc->m_found) {
        // A block can be accepted and stored without being connected, for
        // example if it does not have more work than the current tip. In that
        // case no BlockChecked callback is emitted, so the validation result is
        // inconclusive. Mining::submitBlock treats this as an error for mining
        // clients, but it does not mean the block is invalid.
        reason = "inconclusive";
    } else if (!sc->m_state.IsValid()) {
        reason = sc->m_state.GetRejectReason();
        debug = sc->m_state.GetDebugMessage();
    }
    return accepted;
}

void InterruptWait(KernelNotifications& kernel_notifications, bool& interrupt_wait)
{