MPTokenIssuanceHistory.hpp

#pragma once
 
#include "data/BackendInterface.hpp"
#include "data/Types.hpp"
#include "rpc/common/SpecBackend.hpp"
#include "rpc/common/Types.hpp"
#include "util/log/Logger.hpp"
 
#include <boost/json/array.hpp>
#include <boost/json/conversion.hpp>
#include <boost/json/object.hpp>
#include <boost/json/value.hpp>
#include <rpcspec/handlers/mptoken_issuance_history/Types.hpp>
#include <xrpl/basics/base_uint.h>
 
#include <atomic>
#include <cstdint>
#include <expected>
#include <memory>
#include <optional>
#include <string>
#include <utility>
 
namespace rpc {

class MPTokenIssuanceHistoryHandler
    : public rpc::HandlerFor<rpc::spec::handlers::mptoken_issuance_history::Input> {
    util::Logger log_{"RPC"};
    std::shared_ptr<BackendInterface> sharedPtrBackend_;

    std::shared_ptr<std::atomic_bool> migrated_ = std::make_shared<std::atomic_bool>(false);
 
public:
    static constexpr auto kLimitMin = rpc::spec::handlers::mptoken_issuance_history::kLimitMin;
    static constexpr auto kLimitMax = rpc::spec::handlers::mptoken_issuance_history::kLimitMax;
    static constexpr auto kLimitDefault =
        rpc::spec::handlers::mptoken_issuance_history::kLimitDefault;

    static constexpr char const* kMigratorName = "MPTokenIssuanceHistoryMigrator";

    using Marker = rpc::spec::handlers::mptoken_issuance_history::Marker;

    struct Output {
        std::string mptIssuanceID;
        uint32_t ledgerIndexMin{0};
        uint32_t ledgerIndexMax{0};
        std::optional<uint32_t> limit;
        std::optional<Marker> marker;
        boost::json::array transactions;
        bool validated = true;
    };
 
    using Result = HandlerReturnType<Output>;

    explicit MPTokenIssuanceHistoryHandler(std::shared_ptr<BackendInterface> sharedPtrBackend)
        : sharedPtrBackend_(std::move(sharedPtrBackend))
    {
    }

    [[nodiscard]] Result
    process(Input const& input, Context const& ctx) const;
 
private:
    struct SequenceRange {
        uint32_t min;
        uint32_t max;
    };

    [[nodiscard]] MaybeError
    verifyHistoryAvailable(Context const& ctx) const;

    [[nodiscard]] std::expected<SequenceRange, Status>
    resolveSequenceRange(Input const& input, Context const& ctx) const;

    [[nodiscard]] data::TransactionsAndCursor
    fetchTransactions(
        Input const& input,
        Context const& ctx,
        xrpl::uint192 const& mptIssuanceID,
        SequenceRange range
    ) const;

    void
    processTransactionsPage(
        Input const& input,
        Context const& ctx,
        SequenceRange range,
        data::TransactionsAndCursor const& page,
        Output& response
    ) const;

    [[nodiscard]] std::optional<boost::json::object>
    transactionToJsonIfTypeMatches(
        data::TransactionAndMetadata const& txnPlusMeta,
        Input const& input,
        Context const& ctx
    ) const;

    [[nodiscard]] boost::json::object
    expandedTransactionToJson(
        boost::json::object txn,
        boost::json::object meta,
        data::TransactionAndMetadata const& txnPlusMeta,
        Context const& ctx
    ) const;

    friend void
    tag_invoke(boost::json::value_from_tag, boost::json::value& jv, Output const& output);
};
 
}  // namespace rpc
 
namespace rpc::spec::handlers::mptoken_issuance_history {
 
void
tag_invoke(boost::json::value_from_tag, boost::json::value& jv, Marker const& marker);
 
}  // namespace rpc::spec::handlers::mptoken_issuance_history