Ledger.h

#pragma once
 
#include <xrpld/core/Config.h>
#include <xrpld/core/TimeKeeper.h>
 
#include <xrpl/basics/CountedObject.h>
#include <xrpl/beast/utility/Journal.h>
#include <xrpl/ledger/CachedView.h>
#include <xrpl/ledger/View.h>
#include <xrpl/protocol/Indexes.h>
#include <xrpl/protocol/STLedgerEntry.h>
#include <xrpl/protocol/Serializer.h>
#include <xrpl/protocol/TxMeta.h>
#include <xrpl/shamap/SHAMap.h>
 
namespace xrpl {
 
class Application;
class Job;
class TransactionMaster;
 
class SqliteStatement;
 
struct create_genesis_t
{
    explicit create_genesis_t() = default;
};
extern create_genesis_t const create_genesis;
 
class Ledger final : public std::enable_shared_from_this<Ledger>,
                     public DigestAwareReadView,
                     public TxsRawView,
                     public CountedObject<Ledger>
{
public:
    Ledger(Ledger const&) = delete;
    Ledger&
    operator=(Ledger const&) = delete;
 
    Ledger(Ledger&&) = delete;
    Ledger&
    operator=(Ledger&&) = delete;
 
    Ledger(create_genesis_t, Config const& config, std::vector<uint256> const& amendments, Family& family);
 
    Ledger(LedgerHeader const& info, Config const& config, Family& family);
 
    Ledger(
        LedgerHeader const& info,
        bool& loaded,
        bool acquire,
        Config const& config,
        Family& family,
        beast::Journal j);
 
    Ledger(Ledger const& previous, NetClock::time_point closeTime);
 
    // used for database ledgers
    Ledger(std::uint32_t ledgerSeq, NetClock::time_point closeTime, Config const& config, Family& family);
 
    ~Ledger() = default;
 
    //
    // ReadView
    //
 
    bool
    open() const override
    {
        return false;
    }
 
    LedgerHeader const&
    header() const override
    {
        return header_;
    }
 
    void
    setLedgerInfo(LedgerHeader const& info)
    {
        header_ = info;
    }
 
    Fees const&
    fees() const override
    {
        return fees_;
    }
 
    Rules const&
    rules() const override
    {
        return rules_;
    }
 
    bool
    exists(Keylet const& k) const override;
 
    bool
    exists(uint256 const& key) const;
 
    std::optional<uint256>
    succ(uint256 const& key, std::optional<uint256> const& last = std::nullopt) const override;
 
    std::shared_ptr<SLE const>
    read(Keylet const& k) const override;
 
    std::unique_ptr<sles_type::iter_base>
    slesBegin() const override;
 
    std::unique_ptr<sles_type::iter_base>
    slesEnd() const override;
 
    std::unique_ptr<sles_type::iter_base>
    slesUpperBound(uint256 const& key) const override;
 
    std::unique_ptr<txs_type::iter_base>
    txsBegin() const override;
 
    std::unique_ptr<txs_type::iter_base>
    txsEnd() const override;
 
    bool
    txExists(uint256 const& key) const override;
 
    tx_type
    txRead(key_type const& key) const override;
 
    //
    // DigestAwareReadView
    //
 
    std::optional<digest_type>
    digest(key_type const& key) const override;
 
    //
    // RawView
    //
 
    void
    rawErase(std::shared_ptr<SLE> const& sle) override;
 
    void
    rawInsert(std::shared_ptr<SLE> const& sle) override;
 
    void
    rawErase(uint256 const& key);
 
    void
    rawReplace(std::shared_ptr<SLE> const& sle) override;
 
    void
    rawDestroyXRP(XRPAmount const& fee) override
    {
        header_.drops -= fee;
    }
 
    //
    // TxsRawView
    //
 
    void
    rawTxInsert(
        uint256 const& key,
        std::shared_ptr<Serializer const> const& txn,
        std::shared_ptr<Serializer const> const& metaData) override;
 
    // Insert the transaction, and return the hash of the SHAMap leaf node
    // holding the transaction. The hash can be used to fetch the transaction
    // directly, instead of traversing the SHAMap
    // @param key transaction ID
    // @param txn transaction
    // @param metaData transaction metadata
    // @return hash of SHAMap leaf node that holds the transaction
    uint256
    rawTxInsertWithHash(
        uint256 const& key,
        std::shared_ptr<Serializer const> const& txn,
        std::shared_ptr<Serializer const> const& metaData);
 
    //--------------------------------------------------------------------------
 
    void
    setValidated() const
    {
        header_.validated = true;
    }
 
    void
    setAccepted(NetClock::time_point closeTime, NetClock::duration closeResolution, bool correctCloseTime);
 
    void
    setImmutable(bool rehash = true);
 
    bool
    isImmutable() const
    {
        return mImmutable;
    }
 
    /*  Mark this ledger as "should be full".
 
        "Full" is metadata property of the ledger, it indicates
        that the local server wants all the corresponding nodes
        in durable storage.
 
        This is marked `const` because it reflects metadata
        and not data that is in common with other nodes on the
        network.
    */
    void
    setFull() const
    {
        txMap_.setFull();
        txMap_.setLedgerSeq(header_.seq);
        stateMap_.setFull();
        stateMap_.setLedgerSeq(header_.seq);
    }
 
    void
    setTotalDrops(std::uint64_t totDrops)
    {
        header_.drops = totDrops;
    }
 
    SHAMap const&
    stateMap() const
    {
        return stateMap_;
    }
 
    SHAMap&
    stateMap()
    {
        return stateMap_;
    }
 
    SHAMap const&
    txMap() const
    {
        return txMap_;
    }
 
    SHAMap&
    txMap()
    {
        return txMap_;
    }
 
    // returns false on error
    bool
    addSLE(SLE const& sle);
 
    //--------------------------------------------------------------------------
 
    void
    updateSkipList();
 
    bool
    walkLedger(beast::Journal j, bool parallel = false) const;
 
    bool
    assertSensible(beast::Journal ledgerJ) const;
 
    void
    invariants() const;
    void
    unshare() const;
 
    hash_set<PublicKey>
    negativeUNL() const;
 
    std::optional<PublicKey>
    validatorToDisable() const;
 
    std::optional<PublicKey>
    validatorToReEnable() const;
 
    void
    updateNegativeUNL();
 
    bool
    isFlagLedger() const;
 
    bool
    isVotingLedger() const;
 
    std::shared_ptr<SLE>
    peek(Keylet const& k) const;
 
private:
    class sles_iter_impl;
    class txs_iter_impl;
 
    bool
    setup();
 
    void
    defaultFees(Config const& config);
 
    bool mImmutable;
 
    // A SHAMap containing the transactions associated with this ledger.
    SHAMap mutable txMap_;
 
    // A SHAMap containing the state objects for this ledger.
    SHAMap mutable stateMap_;
 
    // Protects fee variables
    std::mutex mutable mutex_;
 
    Fees fees_;
    Rules rules_;
    LedgerHeader header_;
    beast::Journal j_;
};
 
using CachedLedger = CachedView<Ledger>;
 
std::uint32_t constexpr FLAG_LEDGER_INTERVAL = 256;
bool
isFlagLedger(LedgerIndex seq);
 
//------------------------------------------------------------------------------
//
// API
//
//------------------------------------------------------------------------------
 
extern bool
pendSaveValidated(Application& app, std::shared_ptr<Ledger const> const& ledger, bool isSynchronous, bool isCurrent);
 
std::shared_ptr<Ledger>
loadLedgerHelper(LedgerHeader const& sinfo, Application& app, bool acquire);
 
std::shared_ptr<Ledger>
loadByIndex(std::uint32_t ledgerIndex, Application& app, bool acquire = true);
 
std::shared_ptr<Ledger>
loadByHash(uint256 const& ledgerHash, Application& app, bool acquire = true);
 
// Fetch the ledger with the highest sequence contained in the database
extern std::tuple<std::shared_ptr<Ledger>, std::uint32_t, uint256>
getLatestLedger(Application& app);
 
std::shared_ptr<STTx const>
deserializeTx(SHAMapItem const& item);
 
std::pair<std::shared_ptr<STTx const>, std::shared_ptr<STObject const>>
deserializeTxPlusMeta(SHAMapItem const& item);
 
uint256
calculateLedgerHash(LedgerHeader const& info);
 
}  // namespace xrpl