Inheritance diagram for ripple::SQLiteDatabaseImp:

[legend]

Collaboration diagram for ripple::SQLiteDatabaseImp:

[legend]

Public Types
using	AccountTx = std::pair< std::shared_ptr< Transaction >, std::shared_ptr< TxMeta > >

using	AccountTxs = std::vector< AccountTx >

using	txnMetaLedgerType = std::tuple< Blob, Blob, std::uint32_t >

using	MetaTxsList = std::vector< txnMetaLedgerType >

using	LedgerSequence = uint32_t

using	LedgerHash = uint256

using	LedgerShortcut = RPC::LedgerShortcut

using	LedgerSpecifier = std::variant< LedgerRange, LedgerShortcut, LedgerSequence, LedgerHash >

Public Member Functions
	SQLiteDatabaseImp (Application &app, Config const &config, JobQueue &jobQueue)

std::optional< LedgerIndex >	getMinLedgerSeq () override
	getMinLedgerSeq Returns the minimum ledger sequence in the Ledgers table.

std::optional< LedgerIndex >	getTransactionsMinLedgerSeq () override
	getTransactionsMinLedgerSeq Returns the minimum ledger sequence stored in the Transactions table.

std::optional< LedgerIndex >	getAccountTransactionsMinLedgerSeq () override
	getAccountTransactionsMinLedgerSeq Returns the minimum ledger sequence stored in the AccountTransactions table.

std::optional< LedgerIndex >	getMaxLedgerSeq () override
	getMaxLedgerSeq Returns the maximum ledger sequence in the Ledgers table.

void	deleteTransactionByLedgerSeq (LedgerIndex ledgerSeq) override
	deleteTransactionByLedgerSeq Deletes transactions from the ledger with the given sequence.

void	deleteBeforeLedgerSeq (LedgerIndex ledgerSeq) override
	deleteBeforeLedgerSeq Deletes all ledgers with a sequence number less than or equal to the given ledger sequence.

void	deleteTransactionsBeforeLedgerSeq (LedgerIndex ledgerSeq) override
	deleteTransactionsBeforeLedgerSeq Deletes all transactions with a sequence number less than or equal to the given ledger sequence.

void	deleteAccountTransactionsBeforeLedgerSeq (LedgerIndex ledgerSeq) override
	deleteAccountTransactionsBeforeLedgerSeq Deletes all account transactions with a sequence number less than or equal to the given ledger sequence.

std::size_t	getTransactionCount () override
	getTransactionCount Returns the number of transactions.

std::size_t	getAccountTransactionCount () override
	getAccountTransactionCount Returns the number of account transactions.

RelationalDatabase::CountMinMax	getLedgerCountMinMax () override
	getLedgerCountMinMax Returns the minimum ledger sequence, maximum ledger sequence and total number of saved ledgers.

bool	saveValidatedLedger (std::shared_ptr< Ledger const > const &ledger, bool current) override
	saveValidatedLedger Saves a ledger into the database.

std::optional< LedgerInfo >	getLedgerInfoByIndex (LedgerIndex ledgerSeq) override
	getLedgerInfoByIndex Returns a ledger by its sequence.

std::optional< LedgerInfo >	getNewestLedgerInfo () override
	getNewestLedgerInfo Returns the info of the newest saved ledger.

std::optional< LedgerInfo >	getLimitedOldestLedgerInfo (LedgerIndex ledgerFirstIndex) override
	getLimitedOldestLedgerInfo Returns the info of the oldest ledger whose sequence number is greater than or equal to the given sequence number.

std::optional< LedgerInfo >	getLimitedNewestLedgerInfo (LedgerIndex ledgerFirstIndex) override
	getLimitedNewestLedgerInfo Returns the info of the newest ledger whose sequence number is greater than or equal to the given sequence number.

std::optional< LedgerInfo >	getLedgerInfoByHash (uint256 const &ledgerHash) override
	getLedgerInfoByHash Returns the info of the ledger with given hash.

uint256	getHashByIndex (LedgerIndex ledgerIndex) override
	getHashByIndex Returns the hash of the ledger with the given sequence.

std::optional< LedgerHashPair >	getHashesByIndex (LedgerIndex ledgerIndex) override
	getHashesByIndex Returns the hashes of the ledger and its parent as specified by the ledgerIndex.

std::map< LedgerIndex, LedgerHashPair >	getHashesByIndex (LedgerIndex minSeq, LedgerIndex maxSeq) override
	getHashesByIndex Returns hashes of each ledger and its parent for all ledgers within the provided range.

std::vector< std::shared_ptr< Transaction > >	getTxHistory (LedgerIndex startIndex) override
	getTxHistory Returns the 20 most recent transactions starting from the given number.

AccountTxs	getOldestAccountTxs (AccountTxOptions const &options) override
	getOldestAccountTxs Returns the oldest transactions for the account that matches the given criteria starting from the provided offset.

AccountTxs	getNewestAccountTxs (AccountTxOptions const &options) override
	getNewestAccountTxs Returns the newest transactions for the account that matches the given criteria starting from the provided offset.

MetaTxsList	getOldestAccountTxsB (AccountTxOptions const &options) override
	getOldestAccountTxsB Returns the oldest transactions in binary form for the account that matches the given criteria starting from the provided offset.

MetaTxsList	getNewestAccountTxsB (AccountTxOptions const &options) override
	getNewestAccountTxsB Returns the newest transactions in binary form for the account that matches the given criteria starting from the provided offset.

std::pair< AccountTxs, std::optional< AccountTxMarker > >	oldestAccountTxPage (AccountTxPageOptions const &options) override
	oldestAccountTxPage Returns the oldest transactions for the account that matches the given criteria starting from the provided marker.

std::pair< AccountTxs, std::optional< AccountTxMarker > >	newestAccountTxPage (AccountTxPageOptions const &options) override
	newestAccountTxPage Returns the newest transactions for the account that matches the given criteria starting from the provided marker.

std::pair< MetaTxsList, std::optional< AccountTxMarker > >	oldestAccountTxPageB (AccountTxPageOptions const &options) override
	oldestAccountTxPageB Returns the oldest transactions in binary form for the account that matches the given criteria starting from the provided marker.

std::pair< MetaTxsList, std::optional< AccountTxMarker > >	newestAccountTxPageB (AccountTxPageOptions const &options) override
	newestAccountTxPageB Returns the newest transactions in binary form for the account that matches the given criteria starting from the provided marker.

std::variant< AccountTx, TxSearched >	getTransaction (uint256 const &id, std::optional< ClosedInterval< std::uint32_t > > const &range, error_code_i &ec) override

bool	ledgerDbHasSpace (Config const &config) override
	ledgerDbHasSpace Checks if the ledger database has available space.

bool	transactionDbHasSpace (Config const &config) override
	transactionDbHasSpace Checks if the transaction database has available space.

std::uint32_t	getKBUsedAll () override
	getKBUsedAll Returns the amount of space used by all databases.

std::uint32_t	getKBUsedLedger () override
	getKBUsedLedger Returns the amount of space space used by the ledger database.

std::uint32_t	getKBUsedTransaction () override
	getKBUsedTransaction Returns the amount of space used by the transaction database.

void	closeLedgerDB () override
	Closes the ledger database.

void	closeTransactionDB () override
	Closes the transaction database.

virtual std::variant< AccountTx, TxSearched >	getTransaction (uint256 const &id, std::optional< ClosedInterval< uint32_t > > const &range, error_code_i &ec)=0
	getTransaction Returns the transaction with the given hash.

Static Public Member Functions
static std::unique_ptr< RelationalDatabase >	init (Application &app, Config const &config, JobQueue &jobQueue)
	init Creates and returns an appropriate RelationalDatabase instance based on configuration.

Private Member Functions
bool	makeLedgerDBs (Config const &config, DatabaseCon::Setup const &setup, DatabaseCon::CheckpointerSetup const &checkpointerSetup)
	makeLedgerDBs Opens ledger and transaction databases for the node store, and stores their descriptors in private member variables.

bool	existsLedger ()
	existsLedger Checks if the node store ledger database exists.

bool	existsTransaction ()
	existsTransaction Checks if the node store transaction database exists.

auto	checkoutLedger ()
	checkoutTransaction Checks out and returns node store ledger database.

auto	checkoutTransaction ()
	checkoutTransaction Checks out and returns the node store transaction database.

Private Attributes
Application &	app_

bool const	useTxTables_

beast::Journal	j_

std::unique_ptr< DatabaseCon >	lgrdb_

std::unique_ptr< DatabaseCon >	txdb_

Detailed Description

Definition at line 13 of file SQLiteDatabase.cpp.

Member Typedef Documentation

◆ AccountTx

using ripple::RelationalDatabase::AccountTx = std::pair<std::shared_ptr<Transaction>, std::shared_ptr<TxMeta> >

inherited

Definition at line 66 of file RelationalDatabase.h.

◆ AccountTxs

using ripple::RelationalDatabase::AccountTxs = std::vector<AccountTx>

inherited

Definition at line 68 of file RelationalDatabase.h.

◆ txnMetaLedgerType

using ripple::RelationalDatabase::txnMetaLedgerType = std::tuple<Blob, Blob, std::uint32_t>

inherited

Definition at line 69 of file RelationalDatabase.h.

◆ MetaTxsList

using ripple::RelationalDatabase::MetaTxsList = std::vector<txnMetaLedgerType>

inherited

Definition at line 70 of file RelationalDatabase.h.

◆ LedgerSequence

using ripple::RelationalDatabase::LedgerSequence = uint32_t

inherited

Definition at line 72 of file RelationalDatabase.h.

◆ LedgerHash

using ripple::RelationalDatabase::LedgerHash = uint256

inherited

Definition at line 73 of file RelationalDatabase.h.

◆ LedgerShortcut

using ripple::RelationalDatabase::LedgerShortcut = RPC::LedgerShortcut

inherited

Definition at line 74 of file RelationalDatabase.h.

◆ LedgerSpecifier

using ripple::RelationalDatabase::LedgerSpecifier = std::variant<LedgerRange, LedgerShortcut, LedgerSequence, LedgerHash>

inherited

Definition at line 75 of file RelationalDatabase.h.

Constructor & Destructor Documentation

◆ SQLiteDatabaseImp()

ripple::SQLiteDatabaseImp::SQLiteDatabaseImp	(	Application &	app,
		Config const &	config,
		JobQueue &	jobQueue
	)

Definition at line 16 of file SQLiteDatabase.cpp.

Member Function Documentation

◆ getMinLedgerSeq()

std::optional< LedgerIndex > ripple::SQLiteDatabaseImp::getMinLedgerSeq ( )

overridevirtual

getMinLedgerSeq Returns the minimum ledger sequence in the Ledgers table.

Returns: Ledger sequence or no value if no ledgers exist.

Implements ripple::RelationalDatabase.

Definition at line 232 of file SQLiteDatabase.cpp.

◆ getTransactionsMinLedgerSeq()

std::optional< LedgerIndex > ripple::SQLiteDatabaseImp::getTransactionsMinLedgerSeq ( )

overridevirtual

getTransactionsMinLedgerSeq Returns the minimum ledger sequence stored in the Transactions table.

Returns: Ledger sequence or no value if no ledgers exist.

Implements ripple::SQLiteDatabase.

Definition at line 246 of file SQLiteDatabase.cpp.

◆ getAccountTransactionsMinLedgerSeq()

std::optional< LedgerIndex > ripple::SQLiteDatabaseImp::getAccountTransactionsMinLedgerSeq ( )

overridevirtual

getAccountTransactionsMinLedgerSeq Returns the minimum ledger sequence stored in the AccountTransactions table.

Returns: Ledger sequence or no value if no ledgers exist.

Implements ripple::SQLiteDatabase.

Definition at line 261 of file SQLiteDatabase.cpp.

◆ getMaxLedgerSeq()

std::optional< LedgerIndex > ripple::SQLiteDatabaseImp::getMaxLedgerSeq ( )

overridevirtual

getMaxLedgerSeq Returns the maximum ledger sequence in the Ledgers table.

Returns: Ledger sequence or none if no ledgers exist.

Implements ripple::RelationalDatabase.

Definition at line 277 of file SQLiteDatabase.cpp.

◆ deleteTransactionByLedgerSeq()

void ripple::SQLiteDatabaseImp::deleteTransactionByLedgerSeq ( LedgerIndex ledgerSeq )

overridevirtual

deleteTransactionByLedgerSeq Deletes transactions from the ledger with the given sequence.

Parameters

ledgerSeq Ledger sequence.

Implements ripple::SQLiteDatabase.

Definition at line 289 of file SQLiteDatabase.cpp.

◆ deleteBeforeLedgerSeq()

void ripple::SQLiteDatabaseImp::deleteBeforeLedgerSeq ( LedgerIndex ledgerSeq )

overridevirtual

deleteBeforeLedgerSeq Deletes all ledgers with a sequence number less than or equal to the given ledger sequence.

Parameters

ledgerSeq Ledger sequence.

Implements ripple::SQLiteDatabase.

Definition at line 304 of file SQLiteDatabase.cpp.

◆ deleteTransactionsBeforeLedgerSeq()

void ripple::SQLiteDatabaseImp::deleteTransactionsBeforeLedgerSeq ( LedgerIndex ledgerSeq )

overridevirtual

deleteTransactionsBeforeLedgerSeq Deletes all transactions with a sequence number less than or equal to the given ledger sequence.

Parameters

ledgerSeq Ledger sequence.

Implements ripple::SQLiteDatabase.

Definition at line 316 of file SQLiteDatabase.cpp.

◆ deleteAccountTransactionsBeforeLedgerSeq()

void ripple::SQLiteDatabaseImp::deleteAccountTransactionsBeforeLedgerSeq ( LedgerIndex ledgerSeq )

overridevirtual

deleteAccountTransactionsBeforeLedgerSeq Deletes all account transactions with a sequence number less than or equal to the given ledger sequence.

Parameters

ledgerSeq Ledger sequence.

Implements ripple::SQLiteDatabase.

Definition at line 331 of file SQLiteDatabase.cpp.

◆ getTransactionCount()

std::size_t ripple::SQLiteDatabaseImp::getTransactionCount ( )

overridevirtual

getTransactionCount Returns the number of transactions.

Returns: Number of transactions.

Implements ripple::SQLiteDatabase.

Definition at line 347 of file SQLiteDatabase.cpp.

◆ getAccountTransactionCount()

std::size_t ripple::SQLiteDatabaseImp::getAccountTransactionCount ( )

overridevirtual

getAccountTransactionCount Returns the number of account transactions.

Returns: Number of account transactions.

Implements ripple::SQLiteDatabase.

Definition at line 362 of file SQLiteDatabase.cpp.

◆ getLedgerCountMinMax()

RelationalDatabase::CountMinMax ripple::SQLiteDatabaseImp::getLedgerCountMinMax ( )

overridevirtual

getLedgerCountMinMax Returns the minimum ledger sequence, maximum ledger sequence and total number of saved ledgers.

Returns: Struct CountMinMax which contains the minimum sequence, maximum sequence and number of ledgers.

Implements ripple::SQLiteDatabase.

Definition at line 377 of file SQLiteDatabase.cpp.

◆ saveValidatedLedger()

bool ripple::SQLiteDatabaseImp::saveValidatedLedger	(	std::shared_ptr< Ledger const > const &	ledger,
		bool	current
	)

overridevirtual

saveValidatedLedger Saves a ledger into the database.

Parameters

ledger	The ledger.
current	True if the ledger is current.

Returns: True if saving was successful.

Implements ripple::SQLiteDatabase.

Definition at line 389 of file SQLiteDatabase.cpp.

◆ getLedgerInfoByIndex()

std::optional< LedgerInfo > ripple::SQLiteDatabaseImp::getLedgerInfoByIndex ( LedgerIndex ledgerSeq )

overridevirtual

getLedgerInfoByIndex Returns a ledger by its sequence.

Parameters

ledgerSeq Ledger sequence.

Returns: The ledger if found, otherwise no value.

Implements ripple::RelationalDatabase.

Definition at line 404 of file SQLiteDatabase.cpp.

◆ getNewestLedgerInfo()

std::optional< LedgerInfo > ripple::SQLiteDatabaseImp::getNewestLedgerInfo ( )

overridevirtual

getNewestLedgerInfo Returns the info of the newest saved ledger.

Returns: Ledger info if found, otherwise no value.

Implements ripple::RelationalDatabase.

Definition at line 419 of file SQLiteDatabase.cpp.

◆ getLimitedOldestLedgerInfo()

std::optional< LedgerInfo > ripple::SQLiteDatabaseImp::getLimitedOldestLedgerInfo ( LedgerIndex ledgerFirstIndex )

overridevirtual

getLimitedOldestLedgerInfo Returns the info of the oldest ledger whose sequence number is greater than or equal to the given sequence number.

Parameters

ledgerFirstIndex Minimum ledger sequence.

Returns: Ledger info if found, otherwise no value.

Implements ripple::SQLiteDatabase.

Definition at line 434 of file SQLiteDatabase.cpp.

◆ getLimitedNewestLedgerInfo()

std::optional< LedgerInfo > ripple::SQLiteDatabaseImp::getLimitedNewestLedgerInfo ( LedgerIndex ledgerFirstIndex )

overridevirtual

getLimitedNewestLedgerInfo Returns the info of the newest ledger whose sequence number is greater than or equal to the given sequence number.

Parameters

ledgerFirstIndex Minimum ledger sequence.

Returns: Ledger info if found, otherwise no value.

Implements ripple::SQLiteDatabase.

Definition at line 450 of file SQLiteDatabase.cpp.

◆ getLedgerInfoByHash()

std::optional< LedgerInfo > ripple::SQLiteDatabaseImp::getLedgerInfoByHash ( uint256 const & ledgerHash )

overridevirtual

getLedgerInfoByHash Returns the info of the ledger with given hash.

Parameters

ledgerHash Hash of the ledger.

Returns: Ledger if found, otherwise no value.

Implements ripple::RelationalDatabase.

Definition at line 466 of file SQLiteDatabase.cpp.

◆ getHashByIndex()

uint256 ripple::SQLiteDatabaseImp::getHashByIndex ( LedgerIndex ledgerIndex )

overridevirtual

getHashByIndex Returns the hash of the ledger with the given sequence.

Parameters

ledgerIndex Ledger sequence.

Returns: Hash of the ledger.

Implements ripple::RelationalDatabase.

Definition at line 481 of file SQLiteDatabase.cpp.

◆ getHashesByIndex() [1/2]

std::optional< LedgerHashPair > ripple::SQLiteDatabaseImp::getHashesByIndex ( LedgerIndex ledgerIndex )

overridevirtual

getHashesByIndex Returns the hashes of the ledger and its parent as specified by the ledgerIndex.

Parameters

ledgerIndex Ledger sequence.

Returns: Struct LedgerHashPair which contains hashes of the ledger and its parent.

Implements ripple::RelationalDatabase.

Definition at line 496 of file SQLiteDatabase.cpp.

◆ getHashesByIndex() [2/2]

std::map< LedgerIndex, LedgerHashPair > ripple::SQLiteDatabaseImp::getHashesByIndex	(	LedgerIndex	minSeq,
		LedgerIndex	maxSeq
	)

overridevirtual

getHashesByIndex Returns hashes of each ledger and its parent for all ledgers within the provided range.

Parameters

minSeq	Minimum ledger sequence.
maxSeq	Maximum ledger sequence.

Returns: Container that maps the sequence number of a found ledger to the struct LedgerHashPair which contains the hashes of the ledger and its parent.

Implements ripple::RelationalDatabase.

Definition at line 511 of file SQLiteDatabase.cpp.

◆ getTxHistory()

std::vector< std::shared_ptr< Transaction > > ripple::SQLiteDatabaseImp::getTxHistory ( LedgerIndex startIndex )

overridevirtual

getTxHistory Returns the 20 most recent transactions starting from the given number.

Parameters

startIndex First number of returned entry.

Returns: Vector of shared pointers to transactions sorted in descending order by ledger sequence.

Implements ripple::RelationalDatabase.

Definition at line 526 of file SQLiteDatabase.cpp.

◆ getOldestAccountTxs()

RelationalDatabase::AccountTxs ripple::SQLiteDatabaseImp::getOldestAccountTxs ( AccountTxOptions const & options )

overridevirtual

getOldestAccountTxs Returns the oldest transactions for the account that matches the given criteria starting from the provided offset.

Parameters

options Struct AccountTxOptions which contains the criteria to match: the account, ledger search range, the offset of the first entry to return, the number of transactions to return, a flag if this number is unlimited.

Returns: Vector of pairs of found transactions and their metadata sorted in ascending order by account sequence.

Implements ripple::SQLiteDatabase.

Definition at line 544 of file SQLiteDatabase.cpp.

◆ getNewestAccountTxs()

RelationalDatabase::AccountTxs ripple::SQLiteDatabaseImp::getNewestAccountTxs ( AccountTxOptions const & options )

overridevirtual

getNewestAccountTxs Returns the newest transactions for the account that matches the given criteria starting from the provided offset.

Parameters

options Struct AccountTxOptions which contains the criteria to match: the account, the ledger search range, the offset of the first entry to return, the number of transactions to return, a flag if this number unlimited.

Returns: Vector of pairs of found transactions and their metadata sorted in descending order by account sequence.

Implements ripple::SQLiteDatabase.

Definition at line 562 of file SQLiteDatabase.cpp.

◆ getOldestAccountTxsB()

RelationalDatabase::MetaTxsList ripple::SQLiteDatabaseImp::getOldestAccountTxsB ( AccountTxOptions const & options )

overridevirtual

getOldestAccountTxsB Returns the oldest transactions in binary form for the account that matches the given criteria starting from the provided offset.

Parameters

options Struct AccountTxOptions which contains the criteria to match: the account, the ledger search range, the offset of the first entry to return, the number of transactions to return, a flag if this number unlimited.

Returns: Vector of tuples of found transactions, their metadata and account sequences sorted in ascending order by account sequence.

Implements ripple::SQLiteDatabase.

Definition at line 580 of file SQLiteDatabase.cpp.

◆ getNewestAccountTxsB()

RelationalDatabase::MetaTxsList ripple::SQLiteDatabaseImp::getNewestAccountTxsB ( AccountTxOptions const & options )

overridevirtual

getNewestAccountTxsB Returns the newest transactions in binary form for the account that matches the given criteria starting from the provided offset.

Parameters

options Struct AccountTxOptions which contains the criteria to match: the account, the ledger search range, the offset of the first entry to return, the number of transactions to return, a flag if this number is unlimited.

Returns: Vector of tuples of found transactions, their metadata and account sequences sorted in descending order by account sequence.

Implements ripple::SQLiteDatabase.

Definition at line 595 of file SQLiteDatabase.cpp.

◆ oldestAccountTxPage()

std::pair< RelationalDatabase::AccountTxs, std::optional< RelationalDatabase::AccountTxMarker > > ripple::SQLiteDatabaseImp::oldestAccountTxPage ( AccountTxPageOptions const & options )

overridevirtual

oldestAccountTxPage Returns the oldest transactions for the account that matches the given criteria starting from the provided marker.

Parameters

options Struct AccountTxPageOptions which contains the criteria to match: the account, the ledger search range, the marker of first returned entry, the number of transactions to return, a flag if this number is unlimited.

Returns: Vector of pairs of found transactions and their metadata sorted in ascending order by account sequence and a marker for the next search if the search was not finished.

Implements ripple::SQLiteDatabase.

Definition at line 612 of file SQLiteDatabase.cpp.

◆ newestAccountTxPage()

std::pair< RelationalDatabase::AccountTxs, std::optional< RelationalDatabase::AccountTxMarker > > ripple::SQLiteDatabaseImp::newestAccountTxPage ( AccountTxPageOptions const & options )

overridevirtual

newestAccountTxPage Returns the newest transactions for the account that matches the given criteria starting from the provided marker.

Parameters

options Struct AccountTxPageOptions which contains the criteria to match: the account, the ledger search range, the marker of the first returned entry, the number of transactions to return, a flag if this number unlimited.

Returns: Vector of pairs of found transactions and their metadata sorted in descending order by account sequence and a marker for the next search if the search was not finished.

Implements ripple::SQLiteDatabase.

Definition at line 646 of file SQLiteDatabase.cpp.

◆ oldestAccountTxPageB()

std::pair< RelationalDatabase::MetaTxsList, std::optional< RelationalDatabase::AccountTxMarker > > ripple::SQLiteDatabaseImp::oldestAccountTxPageB ( AccountTxPageOptions const & options )

overridevirtual

oldestAccountTxPageB Returns the oldest transactions in binary form for the account that matches the given criteria starting from the provided marker.

Parameters

options Struct AccountTxPageOptions which contains criteria to match: the account, the ledger search range, the marker of the first returned entry, the number of transactions to return, a flag if this number unlimited.

Returns: Vector of tuples of found transactions, their metadata and account sequences sorted in ascending order by account sequence and a marker for the next search if the search was not finished.

Implements ripple::SQLiteDatabase.

Definition at line 680 of file SQLiteDatabase.cpp.

◆ newestAccountTxPageB()

std::pair< RelationalDatabase::MetaTxsList, std::optional< RelationalDatabase::AccountTxMarker > > ripple::SQLiteDatabaseImp::newestAccountTxPageB ( AccountTxPageOptions const & options )

overridevirtual

newestAccountTxPageB Returns the newest transactions in binary form for the account that matches the given criteria starting from the provided marker.

Parameters

options Struct AccountTxPageOptions which contains the criteria to match: the account, the ledger search range, the marker of the first returned entry, the number of transactions to return, a flag if this number is unlimited.

Returns: Vector of tuples of found transactions, their metadata and account sequences sorted in descending order by account sequence and a marker for the next search if the search was not finished.

Implements ripple::SQLiteDatabase.

Definition at line 713 of file SQLiteDatabase.cpp.

◆ getTransaction() [1/2]

std::variant< RelationalDatabase::AccountTx, TxSearched > ripple::SQLiteDatabaseImp::getTransaction	(	uint256 const &	id,
		std::optional< ClosedInterval< std::uint32_t > > const &	range,
		error_code_i &	ec
	)

override

Definition at line 744 of file SQLiteDatabase.cpp.

◆ ledgerDbHasSpace()

bool ripple::SQLiteDatabaseImp::ledgerDbHasSpace ( Config const & config )

overridevirtual

ledgerDbHasSpace Checks if the ledger database has available space.

Parameters

config Config object.

Returns: True if space is available.

Implements ripple::RelationalDatabase.

Definition at line 762 of file SQLiteDatabase.cpp.

◆ transactionDbHasSpace()

bool ripple::SQLiteDatabaseImp::transactionDbHasSpace ( Config const & config )

overridevirtual

transactionDbHasSpace Checks if the transaction database has available space.

Parameters

config Config object.

Returns: True if space is available.

Implements ripple::RelationalDatabase.

Definition at line 774 of file SQLiteDatabase.cpp.

◆ getKBUsedAll()

std::uint32_t ripple::SQLiteDatabaseImp::getKBUsedAll ( )

overridevirtual

getKBUsedAll Returns the amount of space used by all databases.

Returns: Space in kilobytes.

Implements ripple::SQLiteDatabase.

Definition at line 789 of file SQLiteDatabase.cpp.

◆ getKBUsedLedger()

std::uint32_t ripple::SQLiteDatabaseImp::getKBUsedLedger ( )

overridevirtual

getKBUsedLedger Returns the amount of space space used by the ledger database.

Returns: Space in kilobytes.

Implements ripple::SQLiteDatabase.

Definition at line 800 of file SQLiteDatabase.cpp.

◆ getKBUsedTransaction()

std::uint32_t ripple::SQLiteDatabaseImp::getKBUsedTransaction ( )

overridevirtual

getKBUsedTransaction Returns the amount of space used by the transaction database.

Returns: Space in kilobytes.

Implements ripple::SQLiteDatabase.

Definition at line 811 of file SQLiteDatabase.cpp.

◆ closeLedgerDB()

void ripple::SQLiteDatabaseImp::closeLedgerDB ( )

overridevirtual

Closes the ledger database.

Implements ripple::SQLiteDatabase.

Definition at line 825 of file SQLiteDatabase.cpp.

◆ closeTransactionDB()

void ripple::SQLiteDatabaseImp::closeTransactionDB ( )

overridevirtual

Closes the transaction database.

Implements ripple::SQLiteDatabase.

Definition at line 831 of file SQLiteDatabase.cpp.

◆ makeLedgerDBs()

bool ripple::SQLiteDatabaseImp::makeLedgerDBs	(	Config const &	config,
		DatabaseCon::Setup const &	setup,
		DatabaseCon::CheckpointerSetup const &	checkpointerSetup
	)

private

makeLedgerDBs Opens ledger and transaction databases for the node store, and stores their descriptors in private member variables.

Parameters

config	Config object.
setup	Path to the databases and other opening parameters.
checkpointerSetup	Checkpointer parameters.

Returns: True if node databases opened successfully.

Definition at line 219 of file SQLiteDatabase.cpp.

◆ existsLedger()

bool ripple::SQLiteDatabaseImp::existsLedger ( )

private

existsLedger Checks if the node store ledger database exists.

Returns: True if the node store ledger database exists.

Definition at line 179 of file SQLiteDatabase.cpp.

◆ existsTransaction()

bool ripple::SQLiteDatabaseImp::existsTransaction ( )

private

existsTransaction Checks if the node store transaction database exists.

Returns: True if the node store transaction database exists.

Definition at line 190 of file SQLiteDatabase.cpp.

◆ checkoutLedger()

auto ripple::SQLiteDatabaseImp::checkoutLedger ( )

private

checkoutTransaction Checks out and returns node store ledger database.

Returns: Session to the node store ledger database.

Definition at line 201 of file SQLiteDatabase.cpp.

◆ checkoutTransaction()

auto ripple::SQLiteDatabaseImp::checkoutTransaction ( )

private

checkoutTransaction Checks out and returns the node store transaction database.

Returns: Session to the node store transaction database.

Definition at line 212 of file SQLiteDatabase.cpp.

◆ getTransaction() [2/2]

virtual std::variant< AccountTx, TxSearched > ripple::SQLiteDatabase::getTransaction	(	uint256 const &	id,
		std::optional< ClosedInterval< uint32_t > > const &	range,
		error_code_i &	ec
	)

pure virtualinherited

getTransaction Returns the transaction with the given hash.

If a range is provided but the transaction is not found, then check if all ledgers in the range are present in the database.

Parameters

id	Hash of the transaction.
range	Range of ledgers to check, if present.
ec	Default error code value.

Returns: Transaction and its metadata if found, otherwise TxSearched::all if a range is provided and all ledgers from the range are present in the database, TxSearched::some if a range is provided and not all ledgers are present, TxSearched::unknown if the range is not provided or a deserializing error occurred. In the last case the error code is returned via the ec parameter, in other cases the default error code is not changed.

◆ init()

std::unique_ptr< RelationalDatabase > ripple::RelationalDatabase::init	(	Application &	app,
		Config const &	config,
		JobQueue &	jobQueue
	)

staticinherited

init Creates and returns an appropriate RelationalDatabase instance based on configuration.

Parameters

app	Application object.
config	Config object.
jobQueue	JobQueue object.

Returns: Unique pointer to the interface.

Definition at line 11 of file RelationalDatabase.cpp.

Member Data Documentation

◆ app_

Application& ripple::SQLiteDatabaseImp::app_

private

Definition at line 155 of file SQLiteDatabase.cpp.

◆ useTxTables_

bool const ripple::SQLiteDatabaseImp::useTxTables_

private

Definition at line 156 of file SQLiteDatabase.cpp.

◆ j_

beast::Journal ripple::SQLiteDatabaseImp::j_

private

Definition at line 157 of file SQLiteDatabase.cpp.

◆ lgrdb_

std::unique_ptr<DatabaseCon> ripple::SQLiteDatabaseImp::lgrdb_

private

Definition at line 158 of file SQLiteDatabase.cpp.

◆ txdb_

std::unique_ptr<DatabaseCon> ripple::SQLiteDatabaseImp::txdb_

private

Definition at line 158 of file SQLiteDatabase.cpp.

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ AccountTx

◆ AccountTxs

◆ txnMetaLedgerType

◆ MetaTxsList

◆ LedgerSequence

◆ LedgerHash

◆ LedgerShortcut

◆ LedgerSpecifier

Constructor & Destructor Documentation

◆ SQLiteDatabaseImp()

Member Function Documentation

◆ getMinLedgerSeq()

◆ getTransactionsMinLedgerSeq()

◆ getAccountTransactionsMinLedgerSeq()

◆ getMaxLedgerSeq()

◆ deleteTransactionByLedgerSeq()

◆ deleteBeforeLedgerSeq()

◆ deleteTransactionsBeforeLedgerSeq()

◆ deleteAccountTransactionsBeforeLedgerSeq()

◆ getTransactionCount()

◆ getAccountTransactionCount()

◆ getLedgerCountMinMax()

◆ saveValidatedLedger()

◆ getLedgerInfoByIndex()

◆ getNewestLedgerInfo()

◆ getLimitedOldestLedgerInfo()

◆ getLimitedNewestLedgerInfo()

◆ getLedgerInfoByHash()

◆ getHashByIndex()

◆ getHashesByIndex() [1/2]

◆ getHashesByIndex() [2/2]

◆ getTxHistory()

◆ getOldestAccountTxs()

◆ getNewestAccountTxs()

◆ getOldestAccountTxsB()

◆ getNewestAccountTxsB()

◆ oldestAccountTxPage()

◆ newestAccountTxPage()

◆ oldestAccountTxPageB()

◆ newestAccountTxPageB()

◆ getTransaction() [1/2]

◆ ledgerDbHasSpace()

◆ transactionDbHasSpace()

◆ getKBUsedAll()

◆ getKBUsedLedger()

◆ getKBUsedTransaction()

◆ closeLedgerDB()

◆ closeTransactionDB()

◆ makeLedgerDBs()

◆ existsLedger()

◆ existsTransaction()

◆ checkoutLedger()

◆ checkoutTransaction()

◆ getTransaction() [2/2]

◆ init()

Member Data Documentation

◆ app_

◆ useTxTables_

◆ j_

◆ lgrdb_

◆ txdb_