Feature/governance (#53)

* Add governance-token content * add image * add governance links * add mission * roadmap content * Update vePuffer.png * update route * link to vePUFFER contract * update routes * add instructions on how to mint vePUFFER * Add instructions on how to vote
PufferFinance · Oct 13, 2024 · 9b6303d · 9b6303d
1 parent 8cf4b62
commit 9b6303d
Show file tree

Hide file tree

Showing 10 changed files with 50 additions and 9 deletions.
diff --git a/docs/governance-mission.md b/docs/governance-mission.md
@@ -1,6 +1,6 @@
 ---
 title: Mission
-slug: /protocol/governance-mission
+slug: /governance/mission
 ---
 
 ### Our Vision

diff --git a/docs/governance-roadmap.md b/docs/governance-roadmap.md
@@ -1,6 +1,6 @@
 ---
 title: Governance Roadmap
-slug: /protocol/governance-roadmap
+slug: /governance/roadmap
 ---
 
 # Puffer Governance Roadmap

diff --git a/docs/governance-token.md b/docs/governance-token.md
@@ -1,13 +1,13 @@
 ---
 title: PUFFER Token
-slug: /protocol/puffer-token
+slug: /governance/token
 ---
 
 # $PUFFER Token
 
-The [PUFFER token](https://etherscan.io/address/0x4d1C297d39C5c1277964D0E3f8Aa901493664530)  is the native governance token of the Puffer Protocol and UniFi ecosystem.
+The PUFFER token  is the native governance token of the Puffer Protocol and UniFi ecosystem.
 
-### The Role of $PUFFER
+### The Role of [$PUFFER](https://etherscan.io/address/0x4d1C297d39C5c1277964D0E3f8Aa901493664530)
 
 #### Puffer LRT
 - Govern key protocol parameters (fees, limits, bond requirements)
@@ -27,7 +27,7 @@ The [PUFFER token](https://etherscan.io/address/0x4d1C297d39C5c1277964D0E3f8Aa90
 - Manage treasury funds for long-term sustainability
 - Steer rollup upgrade decisions and feature prioritization
 
-### vePUFFER
+### [vePUFFER](https://etherscan.io/address/0xA55eD5808aeCDF23AE3782C1443185f5D2363ce7)
 
 #### What is vePUFFER?
 ![alt text](/img/vePuffer.png)

diff --git a/docs/governance-voting.md b/docs/governance-voting.md
@@ -1,8 +1,49 @@
 ---
 title: Voting
-slug: /protocol/governance-voting
+slug: /governance/voting
 ---
 
-:::caution Under Construction 🚧
-👷‍♂️ Puffer's governance is under construction ~ working with the brightest minds to design something resilient and decentralized 👷‍♀️
+Voting will occur on the [Puffer Governance Hub](https://vote.puffer.fi) and requires you to have staked vePUFFER. See the [vePUFFER](governance-token.md#what-is-vepuffer) section for more information.
+
+## Minting vePUFFER
+:::note
+Instructions are subject to change.
+:::
+To mint vePUFFER, first claim your PUFFER tokens from the official [claims page](https://claims.puffer.fi).
+![alt text](/img/token-claim.png)
+
+Once you have claimed your tokens, you will need to approve the [vePUFFER contract](https://etherscan.io/address/0xA55eD5808aeCDF23AE3782C1443185f5D2363ce7) to spend your [PUFFER tokens](https://etherscan.io/address/0x4d1C297d39C5c1277964D0E3f8Aa901493664530). Your vePUFFER voting power will start proportional to the amount of PUFFER you stake and increase the longer you hold the NFT.
+
+:::note
+The minimum stake amount is 100 PUFFER as outlined in the [vePUFFER parameters](governance-token.md#vepuffer-parameters).
+:::
+![alt text](/img/token-approve.png)
+
+Once you have approved the vePUFFER contract, you can stake your PUFFER tokens. The vePUFFER NFT will be sent to your wallet.
+![alt text](/img/token-stake.png)
+
+Congratulations! You now have vePUFFER and can participate in governance.
+:::note
+There is a three day warmup period after minting your vePUFFER tokens before you can start voting - see the [vePUFFER](governance-token.md#vepuffer-parameters) section for more details.
+:::
+![alt text](/img/token-complete.png)
+
+## How to Vote
+
+Proposals are first created and discussed on the [Governance Forum](https://governance.puffer.fi) and then posted to the [Puffer DAO Hub](https://vote.puffer.fi) for voting.
+
+1. Navigate to [vote.puffer.fi](https://vote.puffer.fi)
+2. Connect your wallet
+3. View proposals on the `Latest proposals` window or via the `Community` tab
+![alt text](/img/vote-latest.png)
+4. Select the proposal to read more about it
+![alt text](/img/vote-proposal.png)
+5. Vote on proposals by clicking the `Vote` button
+
+The proposal passes unless rejections outnumber approvals after the voting period has ended. Specifically, a proposal is approved if:
+   - Approvals exceed or equal rejections
+   - No votes are cast (effectively treated as equal approvals and vetoes)
+
+:::note
+Initially the votes will be cast using Snapshot voting. In our next phase we will transition to fully on-chain voting. 
 :::
diff --git a/static/img/token-approve.png b/static/img/token-approve.png
diff --git a/static/img/token-claim.png b/static/img/token-claim.png
diff --git a/static/img/token-complete.png b/static/img/token-complete.png
diff --git a/static/img/token-stake.png b/static/img/token-stake.png
diff --git a/static/img/vote-latest.png b/static/img/vote-latest.png
diff --git a/static/img/vote-proposal.png b/static/img/vote-proposal.png