chaser_confirm.hpp

/**
 * Copyright (c) 2011-2025 libbitcoin developers (see AUTHORS)
 *
 * This file is part of libbitcoin.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
#ifndef LIBBITCOIN_NODE_CHASERS_CHASER_CONFIRM_HPP
#define LIBBITCOIN_NODE_CHASERS_CHASER_CONFIRM_HPP

#include <bitcoin/database.hpp>
#include <bitcoin/node/chasers/chaser.hpp>
#include <bitcoin/node/define.hpp>

namespace libbitcoin {
namespace node {

class full_node;

/// Chase down valid blocks for confirmation.
class BCN_API chaser_confirm
  : public chaser
{
public:
    DELETE_COPY_MOVE_DESTRUCT(chaser_confirm);

    chaser_confirm(full_node& node) NOEXCEPT;

    code start() NOEXCEPT override;

protected:
    using header_link = database::header_link;
    using header_links = database::header_links;
    using header_states = database::header_states;

    virtual bool handle_event(const code& ec, chase event_,
        event_value value) NOEXCEPT;

    virtual void do_regressed(height_t branch_point) NOEXCEPT;
    virtual void do_validated(height_t height) NOEXCEPT;
    virtual void do_bumped(height_t height) NOEXCEPT;
    virtual void do_bump(height_t height) NOEXCEPT;

    virtual void reorganize(header_states& fork, size_t top,
        size_t fork_point) NOEXCEPT;
    virtual void organize(header_states& fork, const header_links& popped,
        size_t fork_point) NOEXCEPT;
    virtual bool confirm_block(const header_link& link,
        size_t height, const header_links& popped, size_t fork_point) NOEXCEPT;
    virtual bool complete_block(const code& ec, const header_link& link,
        size_t height, bool bypassed) NOEXCEPT;

private:
    bool set_reorganized(const header_link& link,
        height_t confirmed_height) NOEXCEPT;
    bool set_organized(const header_link& link,
        height_t confirmed_height) NOEXCEPT;
    bool roll_back(const header_links& popped, size_t fork_point,
        size_t top) NOEXCEPT;
};

} // namespace node
} // namespace libbitcoin

#endif