AddresslistVoting

Description

The majority voting implementation using a list of member addresses.

This contract inherits from MajorityVotingBase and implements the IMajorityVoting interface.

Implementation

internal variable ADDRESSLIST_VOTING_INTERFACE_ID

The ERC-165 interface ID of the contract.

bytes4 ADDRESSLIST_VOTING_INTERFACE_ID

public variable UPDATE_ADDRESSES_PERMISSION_ID

The ID of the permission required to call the addAddresses and removeAddresses functions.

bytes32 UPDATE_ADDRESSES_PERMISSION_ID

external function initialize

Initializes the component.

function initialize(contract IDAO _dao, struct MajorityVotingBase.VotingSettings _votingSettings, address[] _members) external

Input	Type	Description
_dao	contract IDAO	The IDAO interface of the associated DAO.
_votingSettings	struct MajorityVotingBase.VotingSettings	The voting settings.
_members	address[]

This method is required to support ERC-1822.

public function supportsInterface

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

function supportsInterface(bytes4 _interfaceId) public view virtual returns (bool)

Input	Type	Description
_interfaceId	bytes4	The ID of the interface.
Output
0	bool	Returns true if the interface is supported.

external function addAddresses

Adds new members to the address list.

function addAddresses(address[] _members) external

Input	Type	Description
_members	address[]	The addresses of members to be added.

This function is used during the plugin initialization.

external function removeAddresses

Removes existing members from the address list.

function removeAddresses(address[] _members) external

Input	Type	Description
_members	address[]	The addresses of the members to be removed.

public function totalVotingPower

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

function totalVotingPower(uint256 _blockNumber) public view returns (uint256)

Input	Type	Description
_blockNumber	uint256	The block number.
Output
0	uint256	The total voting power.

external function createProposal

Creates a new majority voting proposal.

function createProposal(bytes _metadata, struct IDAO.Action[] _actions, uint256 _allowFailureMap, uint64 _startDate, uint64 _endDate, enum IMajorityVoting.VoteOption _voteOption, bool _tryEarlyExecution) external returns (uint256 proposalId)

Input	Type	Description
_metadata	bytes	The metadata of the proposal.
_actions	struct IDAO.Action[]	The actions that will be executed after the proposal passes.
_allowFailureMap	uint256	Allows proposal to succeed even if an action reverts. Uses bitmap representation. If the bit at index x is 1, the tx succeeds even if the action at x failed. Passing 0 will be treated as atomic execution.
_startDate	uint64	The start date of the proposal vote. If 0, the current timestamp is used and the vote starts immediately.
_endDate	uint64	The end date of the proposal vote. If 0, _startDate + minDuration is used.
_voteOption	enum IMajorityVoting.VoteOption	The chosen vote option to be casted on proposal creation.
_tryEarlyExecution	bool	If true, early execution is tried after the vote cast. The call does not revert if early execution is not possible.
Output
proposalId	uint256	The ID of the proposal.

external function isMember

Checks if an account is a member of the DAO.

function isMember(address _account) external view returns (bool)

Input	Type	Description
_account	address	The address of the account to be checked.
Output
0	bool	Whether the account is a member or not.

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

internal function _vote

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

function _vote(uint256 _proposalId, enum IMajorityVoting.VoteOption _voteOption, address _voter, bool _tryEarlyExecution) internal

Input	Type	Description
_proposalId	uint256	The ID of the proposal.
_voteOption	enum IMajorityVoting.VoteOption	The chosen vote option to be casted on the proposal vote.
_voter	address
_tryEarlyExecution	bool	If true, early execution is tried after the vote cast. The call does not revert if early execution is not possible.

internal function _canVote

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

function _canVote(uint256 _proposalId, address _account, enum IMajorityVoting.VoteOption _voteOption) internal view returns (bool)

Input	Type	Description
_proposalId	uint256	The ID of the proposal.
_account	address
_voteOption	enum IMajorityVoting.VoteOption	Whether the voter abstains, supports or opposes the proposal.
Output
0	bool	Returns true if the given voter can vote on a certain proposal and false otherwise.