https://github.com/makerdao/dss-gov

https://github.com/makerdao/dss-gov

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/makerdao/dss-gov
• Owner: makerdao
• License: agpl-3.0
• Created: 2020-02-19T14:52:39.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2021-02-02T15:42:53.000Z (almost 4 years ago)
• Last Synced: 2023-04-05T23:40:53.006Z (almost 2 years ago)
• Language: Solidity
• Size: 135 KB
• Stars: 4
• Watchers: 12
• Forks: 5
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# DSSGov

The Governor Contract, or `DssGov` for short, is a Dai Stablecoin System Contract that authorises Maker governance to make changes to the Maker protocol by supporting on-chain proposals.

## Description

This repository contains three main contracts:

- `DssGov`: actual governance contract

- `GovExec`: contract which acts as a delayer between proposals being approved and getting them executed.

- `GovMom`: contract that has authority to drop proposals in `DssGov`. It will be used together with a `GovExec` with 0 time delay.

## Authorization schema

![Authorization schema](docs/auth-schema.png)

## Public functions

### rely(address usr)

It is an `auth` function. Authorizes `usr` to execute `auth` functions.

### deny(address usr)

It is an `auth` function. Removes authorization of `usr` to execute `auth` functions.

### file(bytes32 what, uint256 data)

It is an `auth` function. Changes a governance setting.

### addProposer(address usr)

It is an `auth` function. Adds `usr` to the whitelist of regular proposers (which do not need to stake MKR to make a proposal).

### removeProposer(address usr)

It is an `auth` function. Removes `usr` from the whitelist of regular proposers.

### delegate(address owner, address newDelegated)

Delegates the MKR deposited by `owner` to `newDelegated`.

Requires:

- `msg.sender == owner` OR

- `msg.sender == oldDelegated` AND `newDelegated == address(0)` OR

- `msg.sender == ANYONE` AND `newDelegated == address(0)` AND `owner is inactive`

### lock(uint256 wad)

Deposits `wad` amount of MKR

### free(uint256 wad)

Withdraws `wad` amount of MKR

### clear(address usr)

Creates a new snapshot of `usr` with 0 voting weight. Removes the previous weight from total active MKR.

Requires `usr` has been inactive for a certain time and hasn't been already marked as inactive.

### ping()

Creates a new snapshot of `msg.sender` with its delegated amount. Adds this voting weight to total active MKR.

Requires `msg.sender` was previously marked as inactive or it is the first time calling this function.

### launch()

Launches the system. This function is meant to activate the system and just to be used once.

Requires that a minimum amount of MKR is deposited and active in the contract.

### propose(address exec, address action)

Makes a new proposal.

Requires:

- `msg.sender` is a whitelisted proposer and hasn't reached the daily maximum OR

- `msg.sender` has enough MKR deposited and is not a current locked account (due a previous proposal created)

### vote(uint256 id, uint256 snapshotIndex, uint256 wad)

Votes proposal number `id` with `wad` amount of MKR.

Requires passing the correct `snapshotIndex` and having `wad` <= voting rights at that `snapshotIndex`.

The correct `snapshotIndex` of a user is the last snapshot created for that user prior to the creation of the proposal to be voted on. (`snapshot.fromBlock < proposal.blockNum`).

### plot(uint256 id)

Schedules proposal number `id`

Requires it has enough votes supporting it.

### exec(uint256 id)

Executes proposal number `id`.

Requires that the proposal has already been scheduled and the delay has passed.

### drop(uint256 id)

It is an `auth` function. Cancels proposal number `id`.

## Some user flows

Users that want to deposit and start voting with their own `wad` amount of MKR:

- `MKR.approve(DssGov, wad)`

- `DssGov.lock(wad)`

- `DssGov.delegate(sender, sender)`

- `DssGov.ping()`

Users that want to deposit and delegate `wad` amount of MKR:

- `MKR.approve(DssGov, wad)`

- `DssGov.lock(wad)`

- `DssGov.delegate(sender, userToDelegate)`

Users that want to start voting with their delegated `wad` amount of MKR for the first time (or after being inactive):

- `DssGov.ping()`