ApplyContext.h

#pragma once
 
#include <xrpl/beast/utility/Journal.h>
#include <xrpl/core/ServiceRegistry.h>
#include <xrpl/ledger/ApplyViewImpl.h>
#include <xrpl/protocol/STTx.h>
#include <xrpl/protocol/XRPAmount.h>
 
#include <optional>
 
namespace xrpl {

class ApplyContext
{
public:
    explicit ApplyContext(
        ServiceRegistry& registry,
        OpenView& base,
        std::optional<uint256 const> const& parentBatchId,
        STTx const& tx,
        TER preclaimResult,
        XRPAmount baseFee,
        ApplyFlags flags,
        beast::Journal journal = beast::Journal{beast::Journal::getNullSink()});
 
    explicit ApplyContext(
        ServiceRegistry& registry,
        OpenView& base,
        STTx const& tx,
        TER preclaimResult,
        XRPAmount baseFee,
        ApplyFlags flags,
        beast::Journal journal = beast::Journal{beast::Journal::getNullSink()})
        : ApplyContext(registry, base, std::nullopt, tx, preclaimResult, baseFee, flags, journal)
    {
        XRPL_ASSERT((flags & TapBatch) == 0, "Batch apply flag should not be set");
    }
 
    std::reference_wrapper<ServiceRegistry> registry;
    STTx const& tx;
    TER const preclaimResult;
    XRPAmount const baseFee;
    beast::Journal const journal;
 
    ApplyView&
    view()
    {
        return *view_;  // NOLINT(bugprone-unchecked-optional-access) view_ emplaced in constructor
    }
 
    [[nodiscard]] ApplyView const&
    view() const
    {
        return *view_;  // NOLINT(bugprone-unchecked-optional-access) view_ emplaced in constructor
    }
 
    // VFALCO Unfortunately this is necessary
    RawView&
    rawView()
    {
        return *view_;  // NOLINT(bugprone-unchecked-optional-access) view_ emplaced in constructor
    }
 
    [[nodiscard]] ApplyFlags const&
    flags() const
    {
        return flags_;
    }

    void
    deliver(STAmount const& amount)
    {
        // NOLINTNEXTLINE(bugprone-unchecked-optional-access) view_ emplaced in constructor
        view_->deliver(amount);
    }

    void
    discard();

    std::optional<TxMeta> apply(TER);

    std::size_t
    size();

    void
    visit(
        std::function<void(
            uint256 const& key,
            bool isDelete,
            SLE::const_ref before,
            SLE::const_ref after)> const& func);
 
    void
    destroyXRP(XRPAmount const& fee)
    {
        // NOLINTNEXTLINE(bugprone-unchecked-optional-access) view_ emplaced in constructor
        view_->rawDestroyXRP(fee);
    }

    TER
    checkInvariants(TER const result, XRPAmount const fee);
 
private:
    static TER
    failInvariantCheck(TER const result);
 
    template <std::size_t... Is>
    TER
    checkInvariantsHelper(TER const result, XRPAmount const fee, std::index_sequence<Is...>);
 
    OpenView& base_;
    ApplyFlags flags_;
    std::optional<ApplyViewImpl> view_;
 
    // The ID of the batch transaction we are executing under, if seated.
    std::optional<uint256 const> parentBatchId_;
};
 
}  // namespace xrpl