> For the complete documentation index, see [llms.txt](https://docs.inverter.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inverter.network/contracts/technical-reference/modules/authorizer/role/aut_ext_votingroles_v1.sol.md).

# AUT\_EXT\_VotingRoles\_v1.sol

[Git Source](https://github.com/InverterNetwork/inverter-contracts/blob/649b450f02fc8b735c128ff0821467e71966c666/src/modules/authorizer/extensions/AUT_EXT_VotingRoles_v1.sol)

**Inherits:** IAUT\_EXT\_VotingRoles\_v1, Module\_v1

**Author:** Inverter Network

Facilitates voting and motion management within the Inverter Network, allowing designated voters to participate in governance through proposals, voting, and execution of decisions.

*Supports setting thresholds for decision-making, managing voter lists, creating motions, casting votes, and executing actions based on collective decisions. This structure enhances governance transparency and efficacy.*

### State Variables

#### MAX\_VOTING\_DURATION

The maximum voting duration.

```solidity
uint public constant MAX_VOTING_DURATION = 2 weeks;
```

#### MIN\_VOTING\_DURATION

The minimum voting duration.

```solidity
uint public constant MIN_VOTING_DURATION = 1 days;
```

#### isVoter

Checks whether an address is a voter.

```solidity
mapping(address => bool) public isVoter;
```

#### motions

Gets the motion data.

```solidity
mapping(bytes32 => Motion) public motions;
```

#### motionCount

Gets the number of motions.

```solidity
uint public motionCount;
```

#### voterCount

Gets the number of voters.

```solidity
uint public voterCount;
```

#### threshold

Gets the threshold.

```solidity
uint public threshold;
```

#### voteDuration

Gets the voting duration.

```solidity
uint public voteDuration;
```

#### \_\_gap

*Storage gap for future upgrades.*

```solidity
uint[50] private __gap;
```

### Functions

#### supportsInterface

*See {IERC165-supportsInterface}.*

```solidity
function supportsInterface(bytes4 interfaceId)
    public
    view
    virtual
    override(Module_v1)
    returns (bool);
```

#### onlySelf

*Reverts if caller is not the module itself.*

```solidity
modifier onlySelf();
```

#### onlyVoter

*Reverts if caller is not a voter.*

```solidity
modifier onlyVoter();
```

#### isValidVoterAddress

*Reverts if voter address is invalid.*

```solidity
modifier isValidVoterAddress(address voter);
```

**Parameters**

| Name    | Type      | Description           |
| ------- | --------- | --------------------- |
| `voter` | `address` | The address to check. |

#### init

```solidity
function init(
    IOrchestrator_v1 orchestrator_,
    Metadata memory metadata,
    bytes memory configData
) external override initializer;
```

#### getReceipt

Gets the receipt of a voter for a motion.

```solidity
function getReceipt(bytes32 _ID, address voter)
    public
    view
    returns (Receipt memory);
```

**Parameters**

| Name    | Type      | Description               |
| ------- | --------- | ------------------------- |
| `_ID`   | `bytes32` | The ID of the motion.     |
| `voter` | `address` | The address of the voter. |

**Returns**

| Name     | Type      | Description               |
| -------- | --------- | ------------------------- |
| `<none>` | `Receipt` | The receipt of the voter. |

#### setThreshold

Sets the threshold.

```solidity
function setThreshold(uint newThreshold) public onlySelf;
```

**Parameters**

| Name           | Type      | Description        |
| -------------- | --------- | ------------------ |
| `newThreshold` | `uint256` | The new threshold. |

#### setVotingDuration

Sets the voting duration.

```solidity
function setVotingDuration(uint newVoteDuration) external onlySelf;
```

**Parameters**

| Name              | Type      | Description              |
| ----------------- | --------- | ------------------------ |
| `newVoteDuration` | `uint256` | The new voting duration. |

#### addVoter

Adds a voter.

```solidity
function addVoter(address who) public onlySelf isValidVoterAddress(who);
```

**Parameters**

| Name  | Type      | Description         |
| ----- | --------- | ------------------- |
| `who` | `address` | The address to add. |

#### addVoterAndUpdateThreshold

Adds a voter and updates the threshold.

```solidity
function addVoterAndUpdateThreshold(address who, uint newThreshold) external;
```

**Parameters**

| Name           | Type      | Description         |
| -------------- | --------- | ------------------- |
| `who`          | `address` | The address to add. |
| `newThreshold` | `uint256` | The new threshold.  |

#### removeVoter

Removes a voter.

```solidity
function removeVoter(address who) public onlySelf;
```

**Parameters**

| Name  | Type      | Description            |
| ----- | --------- | ---------------------- |
| `who` | `address` | The address to remove. |

#### removeVoterAndUpdateThreshold

Removes a voter and updates the threshold.

```solidity
function removeVoterAndUpdateThreshold(address who, uint newThreshold)
    external
    onlySelf;
```

**Parameters**

| Name           | Type      | Description            |
| -------------- | --------- | ---------------------- |
| `who`          | `address` | The address to remove. |
| `newThreshold` | `uint256` | The new threshold.     |

#### \_removeVoter

*Removes a voter from the list of voters.*

```solidity
function _removeVoter(address who) internal;
```

**Parameters**

| Name  | Type      | Description                         |
| ----- | --------- | ----------------------------------- |
| `who` | `address` | The address of the voter to remove. |

#### createMotion

Creates a motion.

```solidity
function createMotion(address target, bytes calldata action)
    external
    onlyVoter
    returns (bytes32);
```

**Parameters**

| Name     | Type      | Description                                           |
| -------- | --------- | ----------------------------------------------------- |
| `target` | `address` | The address of the contract to execute the action on. |
| `action` | `bytes`   | The action data to execute on the target contract.    |

**Returns**

| Name     | Type      | Description                   |
| -------- | --------- | ----------------------------- |
| `<none>` | `bytes32` | The ID of the created motion. |

#### castVote

Casts a vote for a motion.

```solidity
function castVote(bytes32 motionId, uint8 support) external onlyVoter;
```

**Parameters**

| Name       | Type      | Description                                                    |
| ---------- | --------- | -------------------------------------------------------------- |
| `motionId` | `bytes32` | The ID of the motion.                                          |
| `support`  | `uint8`   | The value that indicates wether the voter supports the motion. |

#### executeMotion

Executes a motion.

```solidity
function executeMotion(bytes32 motionId) external;
```

**Parameters**

| Name       | Type      | Description           |
| ---------- | --------- | --------------------- |
| `motionId` | `bytes32` | The ID of the motion. |

#### \_validateThreshold

*Internal function to validate the threshold.*

```solidity
function _validateThreshold(uint _voters, uint _threshold) internal pure;
```

**Parameters**

| Name         | Type      | Description           |
| ------------ | --------- | --------------------- |
| `_voters`    | `uint256` | The number of voters. |
| `_threshold` | `uint256` | The threshold.        |