GitBook: [master] one page and 5 assets modified

governance.md

@@ -1,10 +1,95 @@
 # Governance
 
-_Tutorial written by_ [_**@bt11ba**_](https://torn.community/u/bt11ba/)_\*\*\*\*_
-
 ### How to suggest a proposal ?
 
+In order to participate in Tornado.Cash governance, users first need to lock tokens in the governance contract. If a user votes or creates a proposal, the tokens cannot be unlocked before the proposal execution period ends \(8.25 days from proposal creation\). The locked tokens can also be delegated to another address.
+
+To create a proposal, a user needs to have at least `1,000 TORN`. All proposals must be smart contracts with verified code that are executed from the [governance contract ](https://etherscan.io/address/0x5efda50f22d34F262c29268506C5Fa42cB56A1Ce)\(using `delegatecall`\). This way, it’s easy to audit and test any governance changes.
+
+The voting period for a proposal is 3 days. A proposal will succeed if it receives a simple majority of votes and there are at least `25,000 TORN` total votes \(if turnout is too low, the proposal automatically fails\).
+
+After a proposal succeeds, it is subject for a timelock of 2 days. After the timelock, any user is able to execute the proposal \(which initiates the changes\). If proposal is not executed for 3 days after that, it is considered _expired_ and can no longer be executed.
+
+All of these initial parameters are relatively small, since there won’t be many TORN tokens in circulation early on. But as the circulating supply increases, governance may adjust these thresholds.
+
+A proposal can be of the following nature:
+
+* Adding a new Tornado Cash pool in the proxy
+* Changing the AP reward rates parameters
+* Unpause/Pause the TORN token
+* Change some core mining contracts such as the `TornadoTrees` contract
+* A combination of all of the above
+
+And many more can be done. To find out exactly what can be changed through governance in the protocol, look for the functions with the modifier `onlyGovernance` in the smart contracts.
+
+The governance functions are represented by a red arrow in [this architecture diagram.](https://viewer.diagrams.net/?highlight=0000ff&edit=_blank&layers=1&nav=1&title=tornado-cash-contract-overview.drawio#Uhttps%3A%2F%2Fraw.githubusercontent.com%2FRezan-vm%2Ftornado-cash-edu%2Fmain%2Ftornado-cash-contract-overview.drawio)
+
+NOTE: Parts of this article was taken from [this medium post.](https://tornado-cash.medium.com/tornado-cash-governance-proposal-a55c5c7d0703) Credits goes to the Tornado cash team.
+
 ### How to vote ?
 
+You first need to deposit \(or lock\) TORN tokens into the governance contract.
+
+Go to: [https://app.tornado.cash/governance](https://app.tornado.cash/governance)
+
+Click `Manage` -> `Lock Tab`
+
+Approve the governance contract to transfer your TORN tokens by clicking on the `Approve` button. Once the approve is confirmed, chose the amount you want to deposit and click `Lock`. Confirm the transaction in your wallet and wait for the confirmation.
+
+![](.gitbook/assets/c05e5a1813edad280544b627b24002dc8d5adcf2.png)
+
+Before the vote, the next crucial step is to review the proposal.  
+ Legitimate proposals should have a dedicated post on [Torn.community ](https://torn.community/)under the category “Proposal”. The forum post will provide additional context and arguments on the proposal. Read the thread and make your own mind on the issue.
+
+Once a proposal was submitted it should appear on:  
+[https://app.tornado.cash/governance](https://app.tornado.cash/governance)  
+ Proposal are implemented in the form of a smart contract making changes to the system. It is therefore important to verify the address of the smart-contract and review its code. Find the address of the proposal contract here:
+
+![](.gitbook/assets/181d612b6c57964bab59c8e5b766f5247211083d.png)
+
+Look for the contract address on Etherscan and make sure that the source code is verified and readable.
+
+![](.gitbook/assets/d2d37d169a94f09156e76fa522b7974cb7c9ac3f.png)
+
+Read the source code and make sure that it matches what is described in the forum post.
+
+If you are not technical or not comfortable to read Solidity code, get someone you trust to review the contract for you.
+
+If you agree \(or disagree\) with the proposal code, it time to vote!
+
+A proposal have a voting windows of 3 days. This means that we have 3 days to reach the vote quorum of 25k TORN.
+
+Important: Once you voted, your tokens will be locked for 8.25 days from the moment the proposal was submitted \(the start of the 3 days voting period\). After the 8.25 you can withdraw your tokens from the governance contract. Note that you can vote on 2 proposal at the same time without incurring additional lockup period \(Only the most recently submitted proposal will matter for the 8.25 lockup\).
+
+To vote, simply click on the Green check mark or the the red cross depending whether you accept or reject the proposal. Confirm the transaction with Metamask and your vote is in!
+
 ### How to delegate the vote ?
 
+If you are a TORN token holder, you can delegate your voting power to someone else without having to send him the tokens.
+
+IMPORTANT: If you delegate your tokens and that your delegate votes or initiate a proposal, your tokens will be locked for 8.25 days from the moment the proposal that the delegate voted on started. Note that that you can always undelegate at any time.
+
+To achieve delegation, go to: [https://app.tornado.cash/governance](https://app.tornado.cash/governance)
+
+You first need to lock your tokens in the governance contract. Click **`Manage`** -> **`Lock`** tab
+
+Approve the governance contract to transfer your TORN tokens by clicking on the **`Approve`** button. Once the approve is confirmed, chose the amount you want to delegate and click **`Lock`**. Confirm the transaction in your wallet and wait for the confirmation.
+
+![](.gitbook/assets/c05e5a1813edad280544b627b24002dc8d5adcf2%20%281%29.png)
+
+The last step, is to make the actual delegation. Go again to [https://app.tornado.cash/governance](https://app.tornado.cash/governance)
+
+Click **`Manage`** -> **`Delegate`** tab
+
+Fill-in the address to which you want to delegate and click **`Delegate`**. Approve the transaction in your wallet and wait for confirmation.
+
+![](.gitbook/assets/43c05d176d7f75a336af7a865565c9b23786b98c.png)
+
+The totality of your locked balance will be delegated.
+
+You can undelegate at anytime. To undelegate simply use the `Undelegate` Button in `Manage` -> `Undelegate` Tab.
+
+
+
+_Tutorial written by_ [_@rezan_](https://torn.community/u/Rezan/summary)\_\_
+