GovernorPreventLateQuorum

Inherits: Governor

A module that ensures there is a minimum voting period after quorum is reached. This prevents a large voter from swaying a vote and triggering quorum at the last minute, by ensuring there is always time for other voters to react and try to oppose the decision. If a vote causes quorum to be reached, the proposal's voting period may be extended so that it does not end before at least a specified time has passed (the "vote extension" parameter). This parameter can be set through a governance proposal.

State Variables

_voteExtension

uint48 private _voteExtension;

_extendedDeadlines

mapping(uint256 proposalId => uint48) private _extendedDeadlines;

Functions

constructor

Initializes the vote extension parameter: the time in either number of blocks or seconds (depending on the governor clock mode) that is required to pass since the moment a proposal reaches quorum until its voting period ends. If necessary the voting period will be extended beyond the one set during proposal creation.

constructor(uint48 initialVoteExtension);

proposalDeadline

Returns the proposal deadline, which may have been extended beyond that set at proposal creation, if the proposal reached quorum late in the voting period. See Governor-proposalDeadline.

function proposalDeadline(uint256 proposalId) public view virtual override returns (uint256);

_tallyUpdated

Vote tally updated and detects if it caused quorum to be reached, potentially extending the voting period. May emit a ProposalExtended event.

function _tallyUpdated(uint256 proposalId) internal virtual override;

lateQuorumVoteExtension

Returns the current value of the vote extension parameter: the number of blocks that are required to pass from the time a proposal reaches quorum until its voting period ends.

function lateQuorumVoteExtension() public view virtual returns (uint48);

setLateQuorumVoteExtension

Changes the lateQuorumVoteExtension. This operation can only be performed by the governance executor, generally through a governance proposal. Emits a {LateQuorumVoteExtensionSet} event.

function setLateQuorumVoteExtension(uint48 newVoteExtension) public virtual onlyGovernance;

_setLateQuorumVoteExtension

Changes the lateQuorumVoteExtension. This is an internal function that can be exposed in a public function like {setLateQuorumVoteExtension} if another access control mechanism is needed. Emits a {LateQuorumVoteExtensionSet} event.

function _setLateQuorumVoteExtension(uint48 newVoteExtension) internal virtual;

Events

ProposalExtended

Emitted when a proposal deadline is pushed back due to reaching quorum late in its voting period.

event ProposalExtended(uint256 indexed proposalId, uint64 extendedDeadline);

LateQuorumVoteExtensionSet

Emitted when the lateQuorumVoteExtension parameter is changed.

event LateQuorumVoteExtensionSet(uint64 oldVoteExtension, uint64 newVoteExtension);