STTx.h

#pragma once
 
#include <xrpl/protocol/Feature.h>
#include <xrpl/protocol/PublicKey.h>
#include <xrpl/protocol/Rules.h>
#include <xrpl/protocol/STObject.h>
#include <xrpl/protocol/SecretKey.h>
#include <xrpl/protocol/SeqProxy.h>
#include <xrpl/protocol/TxFormats.h>
 
#include <boost/container/flat_set.hpp>
 
#include <expected>
#include <functional>
 
namespace xrpl {
 
enum class TxnSql : char {
    New = 'N',
    Conflict = 'C',
    Held = 'H',
    Validated = 'V',
    Included = 'I',
    Unknown = 'U'
};
 
class STTx final : public STObject, public CountedObject<STTx>
{
    uint256 tid_;
    TxType txType_;
 
public:
    static constexpr std::size_t kMinMultiSigners = 1;
    static constexpr std::size_t kMaxMultiSigners = 32;
 
    STTx() = delete;
    STTx(STTx const& other) = default;
    STTx&
    operator=(STTx const& other) = delete;
 
    explicit STTx(SerialIter& sit);
    explicit STTx(SerialIter&& sit);
    explicit STTx(STObject&& object);

    STTx(TxType type, std::function<void(STObject&)> assembler);
 
    // STObject functions.
    SerializedTypeID
    getSType() const override;
 
    std::string
    getFullText() const override;
 
    // Outer transaction functions / signature functions.
    static Blob
    getSignature(STObject const& sigObject);
 
    Blob
    getSignature() const
    {
        return getSignature(*this);
    }
 
    uint256
    getSigningHash() const;
 
    TxType
    getTxnType() const;
 
    Blob
    getSigningPubKey() const;
 
    SeqProxy
    getSeqProxy() const;

    std::uint32_t
    getSeqValue() const;
 
    AccountID
    getFeePayer() const;
 
    boost::container::flat_set<AccountID>
    getMentionedAccounts() const;
 
    uint256
    getTransactionID() const;
 
    json::Value
    getJson(JsonOptions options) const override;
 
    json::Value
    getJson(JsonOptions options, bool binary) const;
 
    void
    sign(
        PublicKey const& publicKey,
        SecretKey const& secretKey,
        std::optional<std::reference_wrapper<SField const>> signatureTarget = {});

    std::expected<void, std::string>
    checkSign(Rules const& rules) const;
 
    std::expected<void, std::string>
    checkBatchSign(Rules const& rules) const;
 
    // SQL Functions with metadata.
    static std::string const&
    getMetaSQLInsertReplaceHeader();
 
    std::string
    getMetaSQL(std::uint32_t inLedger, std::string const& escapedMetaData) const;
 
    std::string
    getMetaSQL(
        Serializer rawTxn,
        std::uint32_t inLedger,
        TxnSql status,
        std::string const& escapedMetaData) const;
 
    std::vector<uint256> const&
    getBatchTransactionIDs() const;
 
private:
    std::expected<void, std::string>
    checkSign(Rules const& rules, STObject const& sigObject) const;
 
    std::expected<void, std::string>
    checkSingleSign(STObject const& sigObject) const;
 
    std::expected<void, std::string>
    checkMultiSign(Rules const& rules, STObject const& sigObject) const;
 
    std::expected<void, std::string>
    checkBatchSingleSign(STObject const& batchSigner) const;
 
    std::expected<void, std::string>
    checkBatchMultiSign(STObject const& batchSigner, Rules const& rules) const;
 
    STBase*
    copy(std::size_t n, void* buf) const override;
    STBase*
    move(std::size_t n, void* buf) override;
 
    friend class detail::STVar;
    mutable std::vector<uint256> batchTxnIds_;
};
 
bool
passesLocalChecks(STObject const& st, std::string&);

std::shared_ptr<STTx const>
sterilize(STTx const& stx);

bool
isPseudoTx(STObject const& tx);
 
inline STTx::STTx(SerialIter&& sit)  // NOLINT(cppcoreguidelines-rvalue-reference-param-not-moved)
    : STTx(sit)
{
}
 
inline TxType
STTx::getTxnType() const
{
    return txType_;
}
 
inline Blob
STTx::getSigningPubKey() const
{
    return getFieldVL(sfSigningPubKey);
}
 
inline uint256
STTx::getTransactionID() const
{
    return tid_;
}
 
}  // namespace xrpl