jtx/TestHelpers.h

#pragma once
 
#include <test/jtx/Env.h>
 
#include <xrpld/app/misc/TxQ.h>
 
#include <xrpl/basics/base_uint.h>
#include <xrpl/beast/unit_test/suite.h>
#include <xrpl/json/json_value.h>
#include <xrpl/protocol/AccountID.h>
#include <xrpl/protocol/Quality.h>
#include <xrpl/protocol/STNumber.h>
#include <xrpl/protocol/TxFlags.h>
#include <xrpl/protocol/Units.h>
#include <xrpl/protocol/jss.h>
 
#include <source_location>
#include <vector>
 
namespace xrpl {
namespace test {
namespace jtx {
 
template <
    class SField,
    class StoredValue = typename SField::type::value_type,
    class OutputValue = StoredValue>
struct JTxField
{
    using SF = SField;
    using SV = StoredValue;
    using OV = OutputValue;
 
protected:
    SF const& sfield_;
    SV value_;
 
public:
    explicit JTxField(SF const& sfield, SV const& value) : sfield_(sfield), value_(value)
    {
    }
 
    virtual ~JTxField() = default;
 
    virtual OV
    value() const = 0;
 
    virtual void
    operator()(Env&, JTx& jt) const
    {
        jt.jv[sfield_.jsonName] = value();
    }
};
 
template <class SField, class StoredValue>
struct JTxField<SField, StoredValue, StoredValue>
{
    using SF = SField;
    using SV = StoredValue;
    using OV = SV;
 
protected:
    SF const& sfield_;
    SV value_;
 
public:
    explicit JTxField(SF const& sfield, SV const& value) : sfield_(sfield), value_(value)
    {
    }
 
    void
    operator()(Env&, JTx& jt) const
    {
        jt.jv[sfield_.jsonName] = value_;
    }
};
 
struct timePointField : public JTxField<SF_UINT32, NetClock::time_point, NetClock::rep>
{
    using SF = SF_UINT32;
    using SV = NetClock::time_point;
    using OV = NetClock::rep;
    using base = JTxField<SF, SV, OV>;
 
protected:
    using base::value_;
 
public:
    explicit timePointField(SF const& sfield, SV const& value) : JTxField(sfield, value)
    {
    }
 
    OV
    value() const override
    {
        return value_.time_since_epoch().count();
    }
};
 
struct uint256Field : public JTxField<SF_UINT256, uint256, std::string>
{
    using SF = SF_UINT256;
    using SV = uint256;
    using OV = std::string;
    using base = JTxField<SF, SV, OV>;
 
protected:
    using base::value_;
 
public:
    explicit uint256Field(SF const& sfield, SV const& value) : JTxField(sfield, value)
    {
    }
 
    OV
    value() const override
    {
        return to_string(value_);
    }
};
 
struct accountIDField : public JTxField<SF_ACCOUNT, AccountID, std::string>
{
    using SF = SF_ACCOUNT;
    using SV = AccountID;
    using OV = std::string;
    using base = JTxField<SF, SV, OV>;
 
protected:
    using base::value_;
 
public:
    explicit accountIDField(SF const& sfield, SV const& value) : JTxField(sfield, value)
    {
    }
 
    OV
    value() const override
    {
        return toBase58(value_);
    }
};
 
struct stAmountField : public JTxField<SF_AMOUNT, STAmount, Json::Value>
{
    using SF = SF_AMOUNT;
    using SV = STAmount;
    using OV = Json::Value;
    using base = JTxField<SF, SV, OV>;
 
protected:
    using base::value_;
 
public:
    explicit stAmountField(SF const& sfield, SV const& value) : JTxField(sfield, value)
    {
    }
 
    OV
    value() const override
    {
        return value_.getJson(JsonOptions::none);
    }
};
 
struct blobField : public JTxField<SF_VL, std::string>
{
    using SF = SF_VL;
    using SV = std::string;
    using base = JTxField<SF, SV, SV>;
 
    using JTxField::JTxField;
 
    explicit blobField(SF const& sfield, Slice const& cond) : JTxField(sfield, strHex(cond))
    {
    }
 
    template <size_t N>
    explicit blobField(SF const& sfield, std::array<std::uint8_t, N> const& c)
        : blobField(sfield, makeSlice(c))
    {
    }
};
 
template <class SField, class UnitTag, class ValueType>
struct valueUnitField : public JTxField<SField, unit::ValueUnit<UnitTag, ValueType>, ValueType>
{
    using SF = SField;
    using SV = unit::ValueUnit<UnitTag, ValueType>;
    using OV = ValueType;
    using base = JTxField<SF, SV, OV>;
 
    static_assert(std::is_same_v<OV, typename SField::type::value_type>);
 
protected:
    using base::value_;
 
public:
    using JTxField<SF, SV, OV>::JTxField;
 
    OV
    value() const override
    {
        return value_.value();
    }
};
 
template <class JTxField>
struct JTxFieldWrapper
{
    using JF = JTxField;
    using SF = typename JF::SF;
    using SV = typename JF::SV;
 
protected:
    SF const& sfield_;
 
public:
    explicit JTxFieldWrapper(SF const& sfield) : sfield_(sfield)
    {
    }
 
    JF
    operator()(SV const& value) const
    {
        return JTxField(sfield_, value);
    }
};
 
template <>
struct JTxFieldWrapper<blobField>
{
    using JF = blobField;
    using SF = JF::SF;
    using SV = JF::SV;
 
protected:
    SF const& sfield_;
 
public:
    explicit JTxFieldWrapper(SF const& sfield) : sfield_(sfield)
    {
    }
 
    JF
    operator()(SV const& cond) const
    {
        return JF(sfield_, makeSlice(cond));
    }
 
    JF
    operator()(Slice const& cond) const
    {
        return JF(sfield_, cond);
    }
 
    template <size_t N>
    JF
    operator()(std::array<std::uint8_t, N> const& c) const
    {
        return operator()(makeSlice(c));
    }
};
 
template <class SField, class UnitTag, class ValueType = typename SField::type::value_type>
using valueUnitWrapper = JTxFieldWrapper<valueUnitField<SField, UnitTag, ValueType>>;
 
template <class SField, class StoredValue = typename SField::type::value_type>
using simpleField = JTxFieldWrapper<JTxField<SField, StoredValue>>;
 
auto const data = JTxFieldWrapper<blobField>(sfData);
 
auto const amount = JTxFieldWrapper<stAmountField>(sfAmount);
 
// TODO We only need this long "requires" clause as polyfill, for C++20
// implementations which are missing <ranges> header. Replace with
// `std::ranges::range<Input>`, and accordingly use std::ranges::begin/end
// when we have moved to better compilers.
template <typename Input>
auto
make_vector(Input const& input)
    requires requires(Input& v) {
        std::begin(v);
        std::end(v);
    }
{
    return std::vector(std::begin(input), std::end(input));
}
 
// Functions used in debugging
Json::Value
getAccountOffers(Env& env, AccountID const& acct, bool current = false);
 
inline Json::Value
getAccountOffers(Env& env, Account const& acct, bool current = false)
{
    return getAccountOffers(env, acct.id(), current);
}
 
Json::Value
getAccountLines(Env& env, AccountID const& acctId);
 
inline Json::Value
getAccountLines(Env& env, Account const& acct)
{
    return getAccountLines(env, acct.id());
}
 
template <typename... IOU>
Json::Value
getAccountLines(Env& env, AccountID const& acctId, IOU... ious)
{
    auto jrr = getAccountLines(env, acctId);
    Json::Value res;
    for (auto const& line : jrr[jss::lines])
    {
        for (auto const& iou : {ious...})
        {
            if (line[jss::currency].asString() == to_string(iou.currency))
            {
                Json::Value v;
                v[jss::currency] = line[jss::currency];
                v[jss::balance] = line[jss::balance];
                v[jss::limit] = line[jss::limit];
                v[jss::account] = line[jss::account];
                res[jss::lines].append(v);
            }
        }
    }
    if (!res.isNull())
        return res;
    return jrr;
}
 
[[nodiscard]] bool
checkArraySize(Json::Value const& val, unsigned int size);
 
// Helper function that returns the owner count on an account.
std::uint32_t
ownerCount(test::jtx::Env const& env, test::jtx::Account const& account);
 
[[nodiscard]]
inline bool
checkVL(Slice const& result, std::string const& expected)
{
    Serializer s;
    s.addRaw(result);
    return s.getString() == expected;
}
 
[[nodiscard]]
inline bool
checkVL(std::shared_ptr<SLE const> const& sle, SField const& field, std::string const& expected)
{
    return strHex(expected) == strHex(sle->getFieldVL(field));
}
 
/* Path finding */
/******************************************************************************/
void
stpath_append_one(STPath& st, Account const& account);
 
template <class T>
std::enable_if_t<std::is_constructible<Account, T>::value>
stpath_append_one(STPath& st, T const& t)
{
    stpath_append_one(st, Account{t});
}
 
void
stpath_append_one(STPath& st, STPathElement const& pe);
 
template <class T, class... Args>
void
stpath_append(STPath& st, T const& t, Args const&... args)
{
    stpath_append_one(st, t);
    if constexpr (sizeof...(args) > 0)
        stpath_append(st, args...);
}
 
template <class... Args>
void
stpathset_append(STPathSet& st, STPath const& p, Args const&... args)
{
    st.push_back(p);
    if constexpr (sizeof...(args) > 0)
        stpathset_append(st, args...);
}
 
bool
equal(STAmount const& sa1, STAmount const& sa2);
 
// Issue path element
STPathElement
IPE(Issue const& iss);
 
template <class... Args>
STPath
stpath(Args const&... args)
{
    STPath st;
    stpath_append(st, args...);
    return st;
}
 
template <class... Args>
bool
same(STPathSet const& st1, Args const&... args)
{
    STPathSet st2;
    stpathset_append(st2, args...);
    if (st1.size() != st2.size())
        return false;
 
    for (auto const& p : st2)
    {
        if (std::find(st1.begin(), st1.end(), p) == st1.end())
            return false;
    }
    return true;
}
 
/******************************************************************************/
 
XRPAmount
txfee(Env const& env, std::uint16_t n);
 
PrettyAmount
xrpMinusFee(Env const& env, std::int64_t xrpAmount);
 
bool
expectHolding(
    Env& env,
    AccountID const& account,
    STAmount const& value,
    bool defaultLimits = false);
 
template <typename... Amts>
bool
expectHolding(Env& env, AccountID const& account, STAmount const& value, Amts const&... amts)
{
    return expectHolding(env, account, value, false) && expectHolding(env, account, amts...);
}
 
bool
expectHolding(Env& env, AccountID const& account, None const& value);
 
bool
expectOffers(
    Env& env,
    AccountID const& account,
    std::uint16_t size,
    std::vector<Amounts> const& toMatch = {});
 
Json::Value
ledgerEntryRoot(Env& env, Account const& acct);
 
Json::Value
ledgerEntryState(
    Env& env,
    Account const& acct_a,
    Account const& acct_b,
    std::string const& currency);
 
Json::Value
accountBalance(Env& env, Account const& acct);
 
[[nodiscard]] bool
expectLedgerEntryRoot(Env& env, Account const& acct, STAmount const& expectedValue);
 
/* Payment Channel */
/******************************************************************************/
namespace paychan {
 
Json::Value
create(
    AccountID const& account,
    AccountID const& to,
    STAmount const& amount,
    NetClock::duration const& settleDelay,
    PublicKey const& pk,
    std::optional<NetClock::time_point> const& cancelAfter = std::nullopt,
    std::optional<std::uint32_t> const& dstTag = std::nullopt);
 
inline Json::Value
create(
    Account const& account,
    Account const& to,
    STAmount const& amount,
    NetClock::duration const& settleDelay,
    PublicKey const& pk,
    std::optional<NetClock::time_point> const& cancelAfter = std::nullopt,
    std::optional<std::uint32_t> const& dstTag = std::nullopt)
{
    return create(account.id(), to.id(), amount, settleDelay, pk, cancelAfter, dstTag);
}
 
Json::Value
fund(
    AccountID const& account,
    uint256 const& channel,
    STAmount const& amount,
    std::optional<NetClock::time_point> const& expiration = std::nullopt);
 
Json::Value
claim(
    AccountID const& account,
    uint256 const& channel,
    std::optional<STAmount> const& balance = std::nullopt,
    std::optional<STAmount> const& amount = std::nullopt,
    std::optional<Slice> const& signature = std::nullopt,
    std::optional<PublicKey> const& pk = std::nullopt);
 
uint256
channel(AccountID const& account, AccountID const& dst, std::uint32_t seqProxyValue);
 
inline uint256
channel(Account const& account, Account const& dst, std::uint32_t seqProxyValue)
{
    return channel(account.id(), dst.id(), seqProxyValue);
}
 
STAmount
channelBalance(ReadView const& view, uint256 const& chan);
 
bool
channelExists(ReadView const& view, uint256 const& chan);
 
}  // namespace paychan
 
/* Crossing Limits */
/******************************************************************************/
 
void
n_offers(Env& env, std::size_t n, Account const& account, STAmount const& in, STAmount const& out);
 
/* Pay Strand */
/***************************************************************/
 
// Currency path element
STPathElement
cpe(Currency const& c);
 
// All path element
STPathElement
allPathElements(AccountID const& a, Issue const& iss);
/***************************************************************/
 
/* Check */
/***************************************************************/
namespace check {
 
template <typename A>
    requires std::is_same_v<A, AccountID>
Json::Value
create(A const& account, A const& dest, STAmount const& sendMax)
{
    Json::Value jv;
    jv[sfAccount.jsonName] = to_string(account);
    jv[sfSendMax.jsonName] = sendMax.getJson(JsonOptions::none);
    jv[sfDestination.jsonName] = to_string(dest);
    jv[sfTransactionType.jsonName] = jss::CheckCreate;
    return jv;
}
 
inline Json::Value
create(jtx::Account const& account, jtx::Account const& dest, STAmount const& sendMax)
{
    return create(account.id(), dest.id(), sendMax);
}
 
}  // namespace check
 
static constexpr FeeLevel64 baseFeeLevel{TxQ::baseLevel};
static constexpr FeeLevel64 minEscalationFeeLevel = baseFeeLevel * 500;
 
template <class Suite>
void
checkMetrics(
    Suite& test,
    jtx::Env& env,
    std::size_t expectedCount,
    std::optional<std::size_t> expectedMaxCount,
    std::size_t expectedInLedger,
    std::size_t expectedPerLedger,
    std::uint64_t expectedMinFeeLevel = baseFeeLevel.fee(),
    std::uint64_t expectedMedFeeLevel = minEscalationFeeLevel.fee(),
    std::source_location const location = std::source_location::current())
{
    int const line = location.line();
    char const* file = location.file_name();
    FeeLevel64 const expectedMin{expectedMinFeeLevel};
    FeeLevel64 const expectedMed{expectedMedFeeLevel};
    auto const metrics = env.app().getTxQ().getMetrics(*env.current());
    using namespace std::string_literals;
 
    metrics.referenceFeeLevel == baseFeeLevel
        ? test.pass()
        : test.fail(
              "reference: "s + std::to_string(metrics.referenceFeeLevel.value()) + "/" +
                  std::to_string(baseFeeLevel.value()),
              file,
              line);
 
    metrics.txCount == expectedCount
        ? test.pass()
        : test.fail(
              "txCount: "s + std::to_string(metrics.txCount) + "/" + std::to_string(expectedCount),
              file,
              line);
 
    metrics.txQMaxSize == expectedMaxCount
        ? test.pass()
        : test.fail(
              "txQMaxSize: "s + std::to_string(metrics.txQMaxSize.value_or(0)) + "/" +
                  std::to_string(expectedMaxCount.value_or(0)),
              file,
              line);
 
    metrics.txInLedger == expectedInLedger
        ? test.pass()
        : test.fail(
              "txInLedger: "s + std::to_string(metrics.txInLedger) + "/" +
                  std::to_string(expectedInLedger),
              file,
              line);
 
    metrics.txPerLedger == expectedPerLedger
        ? test.pass()
        : test.fail(
              "txPerLedger: "s + std::to_string(metrics.txPerLedger) + "/" +
                  std::to_string(expectedPerLedger),
              file,
              line);
 
    metrics.minProcessingFeeLevel == expectedMin
        ? test.pass()
        : test.fail(
              "minProcessingFeeLevel: "s + std::to_string(metrics.minProcessingFeeLevel.value()) +
                  "/" + std::to_string(expectedMin.value()),
              file,
              line);
 
    metrics.medFeeLevel == expectedMed
        ? test.pass()
        : test.fail(
              "medFeeLevel: "s + std::to_string(metrics.medFeeLevel.value()) + "/" +
                  std::to_string(expectedMed.value()),
              file,
              line);
 
    auto const expectedCurFeeLevel = expectedInLedger > expectedPerLedger
        ? expectedMed * expectedInLedger * expectedInLedger /
            (expectedPerLedger * expectedPerLedger)
        : metrics.referenceFeeLevel;
 
    metrics.openLedgerFeeLevel == expectedCurFeeLevel
        ? test.pass()
        : test.fail(
              "openLedgerFeeLevel: "s + std::to_string(metrics.openLedgerFeeLevel.value()) + "/" +
                  std::to_string(expectedCurFeeLevel.value()),
              file,
              line);
}
 
/* LoanBroker */
/******************************************************************************/
 
namespace loanBroker {
 
Json::Value
set(AccountID const& account, uint256 const& vaultId, std::uint32_t flags = 0);
 
// Use "del" because "delete" is a reserved word in C++.
Json::Value
del(AccountID const& account, uint256 const& brokerID, std::uint32_t flags = 0);
 
Json::Value
coverDeposit(
    AccountID const& account,
    uint256 const& brokerID,
    STAmount const& amount,
    std::uint32_t flags = 0);
 
Json::Value
coverWithdraw(
    AccountID const& account,
    uint256 const& brokerID,
    STAmount const& amount,
    std::uint32_t flags = 0);
 
// Must specify at least one of loanBrokerID or amount.
Json::Value
coverClawback(AccountID const& account, std::uint32_t flags = 0);
 
auto const loanBrokerID = JTxFieldWrapper<uint256Field>(sfLoanBrokerID);
 
auto const managementFeeRate = valueUnitWrapper<SF_UINT16, unit::TenthBipsTag>(sfManagementFeeRate);
 
auto const debtMaximum = simpleField<SF_NUMBER>(sfDebtMaximum);
 
auto const coverRateMinimum = valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfCoverRateMinimum);
 
auto const coverRateLiquidation =
    valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfCoverRateLiquidation);
 
auto const destination = JTxFieldWrapper<accountIDField>(sfDestination);
 
}  // namespace loanBroker
 
/* Loan */
/******************************************************************************/
namespace loan {
 
Json::Value
set(AccountID const& account,
    uint256 const& loanBrokerID,
    Number principalRequested,
    std::uint32_t flags = 0);
 
auto const counterparty = JTxFieldWrapper<accountIDField>(sfCounterparty);
 
// For `CounterPartySignature`, use `sig(sfCounterpartySignature, ...)`
 
auto const loanOriginationFee = simpleField<SF_NUMBER>(sfLoanOriginationFee);
 
auto const loanServiceFee = simpleField<SF_NUMBER>(sfLoanServiceFee);
 
auto const latePaymentFee = simpleField<SF_NUMBER>(sfLatePaymentFee);
 
auto const closePaymentFee = simpleField<SF_NUMBER>(sfClosePaymentFee);
 
auto const overpaymentFee = valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfOverpaymentFee);
 
auto const interestRate = valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfInterestRate);
 
auto const lateInterestRate = valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfLateInterestRate);
 
auto const closeInterestRate = valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfCloseInterestRate);
 
auto const overpaymentInterestRate =
    valueUnitWrapper<SF_UINT32, unit::TenthBipsTag>(sfOverpaymentInterestRate);
 
auto const paymentTotal = simpleField<SF_UINT32>(sfPaymentTotal);
 
auto const paymentInterval = simpleField<SF_UINT32>(sfPaymentInterval);
 
auto const gracePeriod = simpleField<SF_UINT32>(sfGracePeriod);
 
Json::Value
manage(AccountID const& account, uint256 const& loanID, std::uint32_t flags);
 
Json::Value
del(AccountID const& account, uint256 const& loanID, std::uint32_t flags = 0);
 
Json::Value
pay(AccountID const& account,
    uint256 const& loanID,
    STAmount const& amount,
    std::uint32_t flags = 0);
 
}  // namespace loan
 
}  // namespace jtx
}  // namespace test
}  // namespace xrpl