Track the list of "amendments". More...

Inheritance diagram for ripple::AmendmentTableImpl:

Collaboration diagram for ripple::AmendmentTableImpl:

[legend]

Public Member Functions
	AmendmentTableImpl (Application &app, std::chrono::seconds majorityTime, std::vector< FeatureInfo > const &supported, Section const &enabled, Section const &vetoed, beast::Journal journal)

uint256	find (std::string const &name) const override

bool	veto (uint256 const &amendment) override

bool	unVeto (uint256 const &amendment) override

bool	enable (uint256 const &amendment) override

bool	isEnabled (uint256 const &amendment) const override

bool	isSupported (uint256 const &amendment) const override

bool	hasUnsupportedEnabled () const override
	returns true if one or more amendments on the network have been enabled that this server does not support More...

std::optional< NetClock::time_point >	firstUnsupportedExpected () const override

Json::Value	getJson (bool isAdmin) const override

Json::Value	getJson (uint256 const &, bool isAdmin) const override
	Returns a Json::objectValue. More...

bool	needValidatedLedger (LedgerIndex seq) const override
	Called to determine whether the amendment logic needs to process a new validated ledger. More...

void	doValidatedLedger (LedgerIndex seq, std::set< uint256 > const &enabled, majorityAmendments_t const &majority) override

void	trustChanged (hash_set< PublicKey > const &allTrusted) override

std::vector< uint256 >	doValidation (std::set< uint256 > const &enabledAmendments) const override

std::vector< uint256 >	getDesired () const override

std::map< uint256, std::uint32_t >	doVoting (Rules const &rules, NetClock::time_point closeTime, std::set< uint256 > const &enabledAmendments, majorityAmendments_t const &majorityAmendments, std::vector< std::shared_ptr< STValidation > > const &validations) override

void	doValidatedLedger (std::shared_ptr< ReadView const > const &lastValidatedLedger)
	Called when a new fully-validated ledger is accepted. More...

void	doVoting (std::shared_ptr< ReadView const > const &lastClosedLedger, std::vector< std::shared_ptr< STValidation > > const &parentValidations, std::shared_ptr< SHAMap > const &initialPosition, beast::Journal j)

Private Member Functions
AmendmentState &	add (uint256 const &amendment, std::lock_guard< std::mutex > const &lock)

AmendmentState *	get (uint256 const &amendment, std::lock_guard< std::mutex > const &lock)

AmendmentState const *	get (uint256 const &amendment, std::lock_guard< std::mutex > const &lock) const

void	injectJson (Json::Value &v, uint256 const &amendment, AmendmentState const &state, bool isAdmin, std::lock_guard< std::mutex > const &lock) const

void	persistVote (uint256 const &amendment, std::string const &name, AmendmentVote vote) const

Private Attributes
std::mutex	mutex_

hash_map< uint256, AmendmentState >	amendmentMap_

std::uint32_t	lastUpdateSeq_

TrustedVotes	previousTrustedVotes_

std::chrono::seconds const	majorityTime_

std::unique_ptr< AmendmentSet >	lastVote_

bool	unsupportedEnabled_

std::optional< NetClock::time_point >	firstUnsupportedExpected_

beast::Journal const	j_

DatabaseCon &	db_

Detailed Description

Track the list of "amendments".

An "amendment" is an option that can affect transaction processing rules. Amendments are proposed and then adopted or rejected by the network. An Amendment is uniquely identified by its AmendmentID, a 256-bit key.

Definition at line 409 of file AmendmentTable.cpp.

Constructor & Destructor Documentation

◆ AmendmentTableImpl()

ripple::AmendmentTableImpl::AmendmentTableImpl	(	Application &	app,
		std::chrono::seconds	majorityTime,
		std::vector< FeatureInfo > const &	supported,
		Section const &	enabled,
		Section const &	vetoed,
		beast::Journal	journal
	)

Definition at line 532 of file AmendmentTable.cpp.

Member Function Documentation

◆ add()

AmendmentState & ripple::AmendmentTableImpl::add	(	uint256 const &	amendment,
		std::lock_guard< std::mutex > const &	lock
	)

private

Definition at line 674 of file AmendmentTable.cpp.

◆ get() [1/2]

AmendmentState * ripple::AmendmentTableImpl::get	(	uint256 const &	amendment,
		std::lock_guard< std::mutex > const &	lock
	)

private

Definition at line 683 of file AmendmentTable.cpp.

◆ get() [2/2]

AmendmentState const * ripple::AmendmentTableImpl::get	(	uint256 const &	amendment,
		std::lock_guard< std::mutex > const &	lock
	)		const

private

Definition at line 693 of file AmendmentTable.cpp.

◆ injectJson()

void ripple::AmendmentTableImpl::injectJson	(	Json::Value &	v,
		uint256 const &	amendment,
		AmendmentState const &	state,
		bool	isAdmin,
		std::lock_guard< std::mutex > const &	lock
	)		const

private

Definition at line 997 of file AmendmentTable.cpp.

◆ persistVote()

void ripple::AmendmentTableImpl::persistVote	(	uint256 const &	amendment,
		std::string const &	name,
		AmendmentVote	vote
	)		const

private

Definition at line 721 of file AmendmentTable.cpp.

◆ find()

uint256 ripple::AmendmentTableImpl::find ( std::string const & name ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 707 of file AmendmentTable.cpp.

◆ veto()

bool ripple::AmendmentTableImpl::veto ( uint256 const & amendment )

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 734 of file AmendmentTable.cpp.

◆ unVeto()

bool ripple::AmendmentTableImpl::unVeto ( uint256 const & amendment )

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 747 of file AmendmentTable.cpp.

◆ enable()

bool ripple::AmendmentTableImpl::enable ( uint256 const & amendment )

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 760 of file AmendmentTable.cpp.

◆ isEnabled()

bool ripple::AmendmentTableImpl::isEnabled ( uint256 const & amendment ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 781 of file AmendmentTable.cpp.

◆ isSupported()

bool ripple::AmendmentTableImpl::isSupported ( uint256 const & amendment ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 789 of file AmendmentTable.cpp.

◆ hasUnsupportedEnabled()

bool ripple::AmendmentTableImpl::hasUnsupportedEnabled ( ) const

overridevirtual

returns true if one or more amendments on the network have been enabled that this server does not support

Returns: true if an unsupported feature is enabled on the network

Implements ripple::AmendmentTable.

Definition at line 797 of file AmendmentTable.cpp.

◆ firstUnsupportedExpected()

std::optional< NetClock::time_point > ripple::AmendmentTableImpl::firstUnsupportedExpected ( ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 804 of file AmendmentTable.cpp.

◆ getJson() [1/2]

Json::Value ripple::AmendmentTableImpl::getJson ( bool isAdmin ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 1032 of file AmendmentTable.cpp.

◆ getJson() [2/2]

Json::Value ripple::AmendmentTableImpl::getJson	(	uint256 const &	amendment,
		bool	isAdmin
	)		const

overridevirtual

Returns a Json::objectValue.

Implements ripple::AmendmentTable.

Definition at line 1051 of file AmendmentTable.cpp.

◆ needValidatedLedger()

bool ripple::AmendmentTableImpl::needValidatedLedger ( LedgerIndex seq ) const

overridevirtual

Called to determine whether the amendment logic needs to process a new validated ledger.

(If it could have changed things.)

Implements ripple::AmendmentTable.

Definition at line 942 of file AmendmentTable.cpp.

◆ doValidatedLedger() [1/2]

void ripple::AmendmentTableImpl::doValidatedLedger	(	LedgerIndex	seq,
		std::set< uint256 > const &	enabled,
		majorityAmendments_t const &	majority
	)

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 953 of file AmendmentTable.cpp.

◆ trustChanged()

void ripple::AmendmentTableImpl::trustChanged ( hash_set< PublicKey > const & allTrusted )

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 990 of file AmendmentTable.cpp.

◆ doValidation()

std::vector< uint256 > ripple::AmendmentTableImpl::doValidation ( std::set< uint256 > const & enabledAmendments ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 811 of file AmendmentTable.cpp.

◆ getDesired()

std::vector< uint256 > ripple::AmendmentTableImpl::getDesired ( ) const

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 838 of file AmendmentTable.cpp.

◆ doVoting() [1/2]

std::map< uint256, std::uint32_t > ripple::AmendmentTableImpl::doVoting	(	Rules const &	rules,
		NetClock::time_point	closeTime,
		std::set< uint256 > const &	enabledAmendments,
		majorityAmendments_t const &	majorityAmendments,
		std::vector< std::shared_ptr< STValidation > > const &	validations
	)

overridevirtual

Implements ripple::AmendmentTable.

Definition at line 845 of file AmendmentTable.cpp.

◆ doValidatedLedger() [2/2]

void ripple::AmendmentTable::doValidatedLedger ( std::shared_ptr< ReadView const > const & lastValidatedLedger )

inherited

Called when a new fully-validated ledger is accepted.

Definition at line 92 of file AmendmentTable.h.

◆ doVoting() [2/2]

void ripple::AmendmentTable::doVoting	(	std::shared_ptr< ReadView const > const &	lastClosedLedger,
		std::vector< std::shared_ptr< STValidation > > const &	parentValidations,
		std::shared_ptr< SHAMap > const &	initialPosition,
		beast::Journal	j
	)

inherited

Definition at line 147 of file AmendmentTable.h.

Member Data Documentation

◆ mutex_

std::mutex ripple::AmendmentTableImpl::mutex_

mutableprivate

Definition at line 412 of file AmendmentTable.cpp.

◆ amendmentMap_

hash_map<uint256, AmendmentState> ripple::AmendmentTableImpl::amendmentMap_

private

Definition at line 414 of file AmendmentTable.cpp.

◆ lastUpdateSeq_

std::uint32_t ripple::AmendmentTableImpl::lastUpdateSeq_

private

Definition at line 415 of file AmendmentTable.cpp.

◆ previousTrustedVotes_

TrustedVotes ripple::AmendmentTableImpl::previousTrustedVotes_

private

Definition at line 418 of file AmendmentTable.cpp.

◆ majorityTime_

std::chrono::seconds const ripple::AmendmentTableImpl::majorityTime_

private

Definition at line 421 of file AmendmentTable.cpp.

◆ lastVote_

std::unique_ptr<AmendmentSet> ripple::AmendmentTableImpl::lastVote_

private

Definition at line 425 of file AmendmentTable.cpp.

◆ unsupportedEnabled_

bool ripple::AmendmentTableImpl::unsupportedEnabled_

private

Definition at line 428 of file AmendmentTable.cpp.

◆ firstUnsupportedExpected_

std::optional<NetClock::time_point> ripple::AmendmentTableImpl::firstUnsupportedExpected_

private

Definition at line 433 of file AmendmentTable.cpp.

◆ j_

beast::Journal const ripple::AmendmentTableImpl::j_

private

Definition at line 435 of file AmendmentTable.cpp.

◆ db_

DatabaseCon& ripple::AmendmentTableImpl::db_

private

Definition at line 438 of file AmendmentTable.cpp.

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ AmendmentTableImpl()

Member Function Documentation

◆ add()

◆ get() [1/2]

◆ get() [2/2]

◆ injectJson()

◆ persistVote()

◆ find()

◆ veto()

◆ unVeto()

◆ enable()

◆ isEnabled()

◆ isSupported()

◆ hasUnsupportedEnabled()

◆ firstUnsupportedExpected()

◆ getJson() [1/2]

◆ getJson() [2/2]

◆ needValidatedLedger()

◆ doValidatedLedger() [1/2]

◆ trustChanged()

◆ doValidation()

◆ getDesired()

◆ doVoting() [1/2]

◆ doValidatedLedger() [2/2]

◆ doVoting() [2/2]

Member Data Documentation

◆ mutex_

◆ amendmentMap_

◆ lastUpdateSeq_

◆ previousTrustedVotes_

◆ majorityTime_

◆ lastVote_

◆ unsupportedEnabled_

◆ firstUnsupportedExpected_

◆ j_

◆ db_