Remembers manifests with the highest sequence number. More...

#include <Manifest.h>

Collaboration diagram for xrpl::ManifestCache:

[legend]

Public Member Functions
	ManifestCache (beast::Journal j=beast::Journal(beast::Journal::getNullSink()))
std::uint32_t	sequence () const
	A monotonically increasing number used to detect new manifests.
std::optional< PublicKey >	getSigningKey (PublicKey const &pk) const
	Returns master key's current signing key.
PublicKey	getMasterKey (PublicKey const &pk) const
	Returns ephemeral signing key's master public key.
std::optional< std::uint32_t >	getSequence (PublicKey const &pk) const
	Returns master key's current manifest sequence.
std::optional< std::string >	getDomain (PublicKey const &pk) const
	Returns domain claimed by a given public key.
std::optional< std::string >	getManifest (PublicKey const &pk) const
	Returns manifest corresponding to a given public key.
bool	revoked (PublicKey const &pk) const
	Returns true if master key has been revoked in a manifest.
ManifestDisposition	applyManifest (Manifest m)
	Add manifest to cache.
bool	load (DatabaseCon &dbCon, std::string const &dbTable, std::string const &configManifest, std::vector< std::string > const &configRevocation)
	Populate manifest cache with manifests in database and config.
void	load (DatabaseCon &dbCon, std::string const &dbTable)
	Populate manifest cache with manifests in database.
void	save (DatabaseCon &dbCon, std::string const &dbTable, std::function< bool(PublicKey const &)> const &isTrusted)
	Save cached manifests to database.
template<class Function>
void	forEachManifest (Function &&f) const
	Invokes the callback once for every populated manifest.
template<class PreFun, class EachFun>
void	forEachManifest (PreFun &&pf, EachFun &&f) const
	Invokes the callback once for every populated manifest.

Private Attributes
beast::Journal	j_
std::shared_mutex	mutex_
hash_map< PublicKey, Manifest >	map_
	Active manifests stored by master public key.
hash_map< PublicKey, PublicKey >	signingToMasterKeys_
	Master public keys stored by current ephemeral public key.
std::atomic< std::uint32_t >	seq_ {0}

Detailed Description

Remembers manifests with the highest sequence number.

Definition at line 235 of file Manifest.h.

Constructor & Destructor Documentation

◆ ManifestCache()

xrpl::ManifestCache::ManifestCache ( beast::Journal j = beast::Journal(beast::Journal::getNullSink()) )

explicit

Definition at line 250 of file Manifest.h.

Member Function Documentation

◆ sequence()

std::uint32_t xrpl::ManifestCache::sequence ( ) const

A monotonically increasing number used to detect new manifests.

Definition at line 256 of file Manifest.h.

◆ getSigningKey()

std::optional< PublicKey > xrpl::ManifestCache::getSigningKey ( PublicKey const & pk ) const

Returns master key's current signing key.

Parameters

pk	Master public key

Returns: pk if no known signing key from a manifest

Thread Safety

May be called concurrently

Definition at line 309 of file libxrpl/server/Manifest.cpp.

◆ getMasterKey()

PublicKey xrpl::ManifestCache::getMasterKey ( PublicKey const & pk ) const

Returns ephemeral signing key's master public key.

Parameters

pk	Ephemeral signing public key

Returns: pk if signing key is not in a valid manifest

Thread Safety

May be called concurrently

Definition at line 321 of file libxrpl/server/Manifest.cpp.

◆ getSequence()

std::optional< std::uint32_t > xrpl::ManifestCache::getSequence ( PublicKey const & pk ) const

Returns master key's current manifest sequence.

Returns: sequence corresponding to Master public key if configured or std::nullopt otherwise

Definition at line 332 of file libxrpl/server/Manifest.cpp.

◆ getDomain()

std::optional< std::string > xrpl::ManifestCache::getDomain ( PublicKey const & pk ) const

Returns domain claimed by a given public key.

Returns: domain corresponding to Master public key if present, otherwise std::nullopt

Definition at line 344 of file libxrpl/server/Manifest.cpp.

◆ getManifest()

std::optional< std::string > xrpl::ManifestCache::getManifest ( PublicKey const & pk ) const

Returns manifest corresponding to a given public key.

Returns: manifest corresponding to Master public key if present, otherwise std::nullopt

Definition at line 356 of file libxrpl/server/Manifest.cpp.

◆ revoked()

bool xrpl::ManifestCache::revoked ( PublicKey const & pk ) const

Returns true if master key has been revoked in a manifest.

Parameters

pk	Master public key

Thread Safety

May be called concurrently

Definition at line 368 of file libxrpl/server/Manifest.cpp.

◆ applyManifest()

ManifestDisposition xrpl::ManifestCache::applyManifest ( Manifest m )

Add manifest to cache.

Parameters

m	Manifest to add

Returns: ManifestDisposition::accepted if successful, or stale or invalid otherwise

Thread Safety

May be called concurrently

Definition at line 380 of file libxrpl/server/Manifest.cpp.

◆ load() [1/2]

bool xrpl::ManifestCache::load	(	DatabaseCon &	dbCon,
		std::string const &	dbTable,
		std::string const &	configManifest,
		std::vector< std::string > const &	configRevocation )

Populate manifest cache with manifests in database and config.

Parameters

dbCon	Database connection with dbTable
dbTable	Database table
configManifest	Base64 encoded manifest for local node's validator keys
configRevocation	Base64 encoded validator key revocation from the config

Thread Safety

May be called concurrently

Definition at line 544 of file libxrpl/server/Manifest.cpp.

◆ load() [2/2]

void xrpl::ManifestCache::load	(	DatabaseCon &	dbCon,
		std::string const &	dbTable )

Populate manifest cache with manifests in database.

Parameters

dbCon	Database connection with dbTable
dbTable	Database table

Thread Safety

May be called concurrently

Definition at line 537 of file libxrpl/server/Manifest.cpp.

◆ save()

void xrpl::ManifestCache::save	(	DatabaseCon &	dbCon,
		std::string const &	dbTable,
		std::function< bool(PublicKey const &)> const &	isTrusted )

Save cached manifests to database.

Parameters

dbCon	Database connection with ValidatorManifests table
isTrusted	Function that returns true if manifest is trusted

Thread Safety

May be called concurrently

Definition at line 599 of file libxrpl/server/Manifest.cpp.

◆ forEachManifest() [1/2]

template<class Function>

void xrpl::ManifestCache::forEachManifest ( Function && f ) const

Invokes the callback once for every populated manifest.

Note: Do not call ManifestCache member functions from within the callback. This can re-lock the mutex from the same thread, which is UB.; Do not write ManifestCache member variables from within the callback. This can lead to data races.

Parameters

f	Function called for each manifest

Thread Safety

May be called concurrently

Definition at line 403 of file Manifest.h.

◆ forEachManifest() [2/2]

template<class PreFun, class EachFun>

void xrpl::ManifestCache::forEachManifest	(	PreFun &&	pf,
		EachFun &&	f ) const

Invokes the callback once for every populated manifest.

Note: Do not call ManifestCache member functions from within the callback. This can re-lock the mutex from the same thread, which is UB.; Do not write ManifestCache member variables from within the callback. This can lead to data races.

Parameters

pf	Pre-function called with the maximum number of times f will be called (useful for memory allocations)
f	Function called for each manifest

Thread Safety

May be called concurrently

Definition at line 431 of file Manifest.h.

Member Data Documentation

◆ j_

beast::Journal xrpl::ManifestCache::j_

private

Definition at line 238 of file Manifest.h.

◆ mutex_

std::shared_mutex xrpl::ManifestCache::mutex_

mutableprivate

Definition at line 239 of file Manifest.h.

◆ map_

hash_map<PublicKey, Manifest> xrpl::ManifestCache::map_

private

Active manifests stored by master public key.

Definition at line 242 of file Manifest.h.

◆ signingToMasterKeys_

hash_map<PublicKey, PublicKey> xrpl::ManifestCache::signingToMasterKeys_

private

Master public keys stored by current ephemeral public key.

Definition at line 245 of file Manifest.h.

◆ seq_

std::atomic<std::uint32_t> xrpl::ManifestCache::seq_ {0}

private

Definition at line 247 of file Manifest.h.

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ManifestCache()

Member Function Documentation

◆ sequence()

◆ getSigningKey()

◆ getMasterKey()

◆ getSequence()

◆ getDomain()

◆ getManifest()

◆ revoked()

◆ applyManifest()

◆ load() [1/2]

◆ load() [2/2]

◆ save()

◆ forEachManifest() [1/2]

◆ forEachManifest() [2/2]

Member Data Documentation

◆ j_

◆ mutex_

◆ map_

◆ signingToMasterKeys_

◆ seq_