TokenVoting API

Initializes the component.

This method is required to support [ERC-1822](https://eips.ethereum.org/EIPS/eip-1822).

Reinitializes the TokenVoting after an upgrade from a previous build version. For each reinitialization step, use the _fromBuild version to decide which internal functions to call for reinitialization.

Checks if this or the parent contract supports an interface by its ID.

getter function for the voting token.

public function also useful for registering interfaceId and for distinguishing from majority voting interface.

Returns the total voting power checkpointed for a specific block number.

Creates a new majority voting proposal.

Requires the CREATE_PROPOSAL_PERMISSION_ID permission.

Creates a new proposal.

The human-readable abi format for extra params included in data of createProposal.

Used for UI to easily detect what extra params the contract expects.

Checks if an account is a member of the DAO.

This function must be implemented in the plugin contract that introduces the members to the DAO.

Internal function to cast a vote. It assumes the queried proposal exists.

Internal function to check if a voter can vote. It assumes the queried proposal exists.

Thrown if the voting power is zero

The [ERC-165](https://eips.ethereum.org/EIPS/eip-165) interface ID of the contract.

Initializes the component to be used by inheriting contracts.

This method is required to support [ERC-1822](https://eips.ethereum.org/EIPS/eip-1822).

Checks if this or the parent contract supports an interface by its ID.

Votes on a proposal and, optionally, executes the proposal.

_voteOption, 1 → abstain, 2 → yes, 3 → no

Executes a proposal.

Requires the EXECUTE_PROPOSAL_PERMISSION_ID permission.

Returns whether the account has voted for the proposal.

May return none if the _proposalId does not exist, or the _account does not have voting power.

Checks if an account can participate on a proposal. This can be because the vote - has not started, - has ended, - was executed, or - the voter doesn’t have voting powers.

Reverts if the proposal with the given _proposalId does not exist.

Checks if a proposal can be executed.

Reverts if the proposal with the given _proposalId does not exist.

Whether proposal succeeded or not.

Reverts if the proposal with the given _proposalId does not exist.

Checks if the support value defined as: \texttt{support} = \frac{N_\text{yes}}{N_\text{yes}+N_\text{no}} for a proposal is greater than the support threshold.

Checks if the worst-case support value defined as: \texttt{worstCaseSupport} = \frac{N_\text{yes}}{ N_\text{total}-N_\text{abstain}} for a proposal is greater than the support threshold.

Checks if the participation value defined as: \texttt{participation} = \frac{N_\text{yes}+N_\text{no}+N_\text{abstain}}{N_\text{total}} for a proposal is greater or equal than the minimum participation value.

Checks if the min approval value defined as: \texttt{minApproval} = \frac{N_\text{yes}}{N_\text{total}} for a proposal is greater or equal than the minimum approval value.

Returns the configured minimum approval value.

Returns the support threshold parameter stored in the voting settings.

Returns the minimum participation parameter stored in the voting settings.

Returns the minimum duration parameter stored in the voting settings.

Returns the minimum voting power required to create a proposal stored in the voting settings.

Returns the vote mode stored in the voting settings.

Returns the total voting power checkpointed for a specific block number.

Returns all information for a proposal by its ID.

Updates the voting settings.

Requires the UPDATE_VOTING_SETTINGS_PERMISSION_ID permission.

Updates the minimal approval value.

Requires the UPDATE_VOTING_SETTINGS_PERMISSION_ID permission.

Creates a new majority voting proposal.

Internal function to cast a vote. It assumes the queried proposal exists.

Internal function to execute a proposal. It assumes the queried proposal exists.

Internal function to check if a voter can vote. It assumes the queried proposal exists.

An internal function that checks if the proposal succeeded or not.

Internal function to check if a proposal can be executed. It assumes the queried proposal exists.

Threshold and minimal values are compared with > and >= comparators, respectively.

Internal function to check if a proposal is still open.

Internal function to update the plugin-wide proposal settings.

Internal function to update minimal approval value.

Validates and returns the proposal dates.

The ID of the permission required to call the updateVotingSettings function.

The ID of the permission required to call the createProposal functions.

The ID of the permission required to call the execute function.

Emitted when the voting settings are updated.

Emitted when the min approval value is updated.

Thrown if a date is out of bounds.

Thrown if the minimal duration value is out of bounds (less than one hour or greater than 1 year).

Thrown when a sender is not allowed to create a proposal.

Thrown when a proposal doesn’t exist.

Thrown if an account is not allowed to cast a vote. This can be because the vote - has not started, - has ended, - was executed, or - the account doesn’t have voting powers.

Thrown if the proposal execution is forbidden.

Thrown if the proposal with same actions and metadata already exists.

The [ERC-165](https://eips.ethereum.org/EIPS/eip-165) interface ID of the contract.

A mapping between proposal IDs and proposal information.

The contract constructor deploying the plugin implementation contract and receiving the governance token base contracts to clone from.

Prepares the installation of a plugin.

Prepares the update of a plugin.

Revoke the upgrade plugin permission to the DAO for all builds prior the current one (3).

Prepares the uninstallation of a plugin.

Unsatisfiably determines if the token is an IVotes interface.

Many tokens don’t use ERC165 even though they still support IVotes.

The address of the GovernanceERC20 base contract.

The address of the GovernanceWrappedERC20 base contract.

Thrown if the passed token address is not a token contract.

Thrown if token address is not ERC20.

Initializes the contract with the TokenVoting plugin address and fetches the associated token.

Checks if a call is permitted.

The function checks both the voting power and token balance to ensure _who meets the minimum voting threshold defined in the TokenVoting plugin. Returns false if the minimum requirement is unmet.