CreateTicket.h

#ifndef XRPL_TX_CREATETICKET_H_INCLUDED
#define XRPL_TX_CREATETICKET_H_INCLUDED
 
#include <xrpld/app/ledger/Ledger.h>
#include <xrpld/app/tx/detail/Transactor.h>
 
namespace ripple {
 
class CreateTicket : public Transactor
{
public:
    static constexpr ConsequencesFactoryType ConsequencesFactory{Custom};
 
    constexpr static std::uint32_t minValidCount = 1;
 
    // A note on how the maxValidCount was determined.  The goal is for
    // a single TicketCreate transaction to not use more compute power than
    // a single compute-intensive Payment.
    //
    // Timing was performed using a MacBook Pro laptop and a release build
    // with asserts off.  20 measurements were taken of each of the Payment
    // and TicketCreate transactions and averaged to get timings.
    //
    // For the example compute-intensive Payment a Discrepancy unit test
    // unit test Payment with 3 paths was chosen.  With all the latest
    // amendments enabled, that Payment::doApply() operation took, on
    // average, 1.25 ms.
    //
    // Using that same test set up creating 250 Tickets in a single
    // CreateTicket::doApply() in a unit test took, on average, 1.21 ms.
    //
    // So, for the moment, a single transaction creating 250 Tickets takes
    // about the same compute time as a single compute-intensive payment.
    //
    // October 2018.
    constexpr static std::uint32_t maxValidCount = 250;
 
    // The maximum number of Tickets an account may hold.  If a
    // TicketCreate would cause an account to own more than this many
    // tickets, then the TicketCreate will fail.
    //
    // The number was chosen arbitrarily and is an effort toward avoiding
    // ledger-stuffing with Tickets.
    constexpr static std::uint32_t maxTicketThreshold = 250;
 
    explicit CreateTicket(ApplyContext& ctx) : Transactor(ctx)
    {
    }
 
    static TxConsequences
    makeTxConsequences(PreflightContext const& ctx);
 
    static NotTEC
    preflight(PreflightContext const& ctx);
 
    static TER
    preclaim(PreclaimContext const& ctx);
 
    TER
    doApply() override;
};
 
using TicketCreate = CreateTicket;
 
}  // namespace ripple
 
#endif