GITBOOK-493: change request with no subject merged in GitBook

Author: bonustrack

.gitbook/assets/Screenshot 2023-03-20 at 11.20.56.png

@@ -91,6 +91,11 @@
 ## Snapshot X
 
 * [Overview](snapshot-x/overview.md)
+* [User guides](snapshot-x/user-guides/README.md)
+  * [Create a space](snapshot-x/user-guides/create-a-space.md)
+  * [Proposals](snapshot-x/user-guides/proposals.md)
+  * [Voting](snapshot-x/user-guides/voting.md)
+  * [Safe execution setup](snapshot-x/user-guides/safe-execution-setup.md)
 * [Protocol](snapshot-x/protocol/README.md)
   * [Overview](snapshot-x/protocol/overview.md)
   * [Space actions](snapshot-x/protocol/space-actions.md)

.gitbook/assets/Screenshot 2023-04-03 at 13.58.47.png

@@ -11,7 +11,7 @@ This is all handled seamlessly by the Snapshot X protocol by taking advantage of
 This diagram represents the flow of a proposal that will get executed on L1, with voters using their regular EVM account to vote.\
 
 
-<figure><img src="../../.gitbook/assets/image.png" alt=""><figcaption></figcaption></figure>
+<figure><img src="../../.gitbook/assets/image (7).png" alt=""><figcaption></figcaption></figure>
 
 [https://whimsical.com/storageproofs-7kjLqMvsR3okzFgMrad9Fu](https://whimsical.com/storageproofs-7kjLqMvsR3okzFgMrad9Fu)
 

.gitbook/assets/Screenshot 2023-04-03 at 14.05.50.png

@@ -0,0 +1,2 @@
+# User guides
+

.gitbook/assets/Screenshot 2023-04-03 at 14.11.17.png

@@ -0,0 +1,157 @@
+---
+description: Learn how to create a new space for your organization.
+---
+
+# Create a space
+
+Head to the [Create space page](https://snapshot.box/#/create) and follow the below steps:
+
+## 1. Organization's details
+
+Provide the profile information like `name`, `description`, social links or handles and `treasury`.
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 10.19.09.png" alt=""><figcaption></figcaption></figure>
+
+In order to set your Treasury select the network first.
+
+{% hint style="info" %}
+**Treasury** is the address of your organisation's main account.
+{% endhint %}
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-03 at 13.58.47.png" alt=""><figcaption></figcaption></figure>
+
+## 2. Select network
+
+Choose the network for your organisation. At the moment Snapshot X works with Ethereum.
+
+ℹ️ _Starknet implementation is coming soon._
+
+## 3. Voting strategies
+
+Voting Strategies calculate the **Voting Power** of each user.
+
+{% hint style="info" %}
+If you are not familiar with what a Voting Strategy is head to [Broken link](broken-reference "mention") to learn more.
+{% endhint %}
+
+Select a Voting Strategy from the list of available options and provide the required details.
+
+For example for the **Delegated Compound Token** you have to provide the token contract address, its decimals and the symbol:
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 10.21.13.png" alt=""><figcaption></figcaption></figure>
+
+## 4. Authenticators
+
+Choose how users will be authenticated in order to create a proposal or cast a vote.
+
+{% hint style="info" %}
+If you are not familiar with what Authenticators are head to [Broken link](broken-reference "mention")to learn more.
+{% endhint %}
+
+The two authenticators provided by Snapshot X are:
+
+#### [Ethereum signature](broken-reference)
+
+It will authenticate a user based on a message signed by an Ethereum private key.
+
+#### [Ethereum transaction](broken-reference)
+
+Users have to submit a transaction on Ethereum. Authentication is proving that the sender's address is valid.
+
+## 5. Proposal validation
+
+Proposal Validation is setting **requirements** that user needs to meet in order to **create a new proposal.**
+
+{% hint style="info" %}
+If you are not familiar with what a Proposal Validation is head to [Broken link](broken-reference "mention") to learn more.
+{% endhint %}
+
+Define the minimum Voting Power required to create a new proposal.
+
+**⚠️ We highly recommend setting a high threshold to avoid scam proposals. ⚠️**
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-03 at 14.05.50.png" alt=""><figcaption></figcaption></figure>
+
+Once you have defined the required Voting Power, you can then select the Voting Strategies which will be used to calculate the voting power of proposal creators and assess the eligibility to create a new one:
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-03 at 14.11.17.png" alt=""><figcaption></figcaption></figure>
+
+## 6. Execution
+
+Execution Strategies have two key roles:
+
+1. determining **the status** of a proposal at any time,
+2. and **executing the payload** of a proposal if it has been accepted.
+
+{% hint style="info" %}
+If you are not familiar with what Execution Strategies are head to [Broken link](broken-reference "mention") to learn more.
+{% endhint %}
+
+When selecting the execution strategy you have to provide a **quorum** - minimum number of votes required for a proposal to pass.
+
+### Execution strategies
+
+Currently Snapshot X provides two Execution Strategies:
+
+#### Avatar
+
+-> ideal solution for treasuries on [Safe](https://safe.global/)
+
+-> executes transactions on an [Avatar contract](https://github.com/gnosis/zodiac/blob/master/contracts/interfaces/IAvatar.sol)
+
+-> uses simple quorum
+
+{% hint style="info" %}
+Avatar contract is any contract which implements the `IAvatar`interface.\
+**Safe** is an example of an Avatar contract.
+{% endhint %}
+
+{% hint style="warning" %}
+To set the Avatar Execution Strategy up fully you have to enable it on your Safe account after you have created your space.\
+\
+**Follow this guide to complete the setup:**\
+[Broken link](broken-reference "mention")
+{% endhint %}
+
+#### Timelock
+
+-> adds additional **security layer** to review or cancel transactions before they get executed
+
+-> executes transactions after a delay specified in **seconds**
+
+-> uses simple quorum
+
+{% hint style="info" %}
+When a proposal with this strategy is executed, the proposal transactions are queued in the Timelock for `timelockDelay` seconds before they can be executed.
+{% endhint %}
+
+### 7. Voting
+
+Customize the setup for voting which will affect **all proposals** in your space:
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 10.46.38.png" alt=""><figcaption></figcaption></figure>
+
+* **Voting delay** - The delay between when a proposal is created, and when the voting starts. A value of 0 means that as soon as the proposal is created anyone can vote while a value of 3600 means that voting will start 3600 seconds after the proposal is created.
+* **Minimum voting duration** - The minimum duration of the voting period. It is **impossible to execute a proposal before** **this period** has elapsed.
+* **Maximum voting duration** - The maximum duration of the voting period, it is **impossible to cast a vote after this period** has passed. The **`minimum voting duration`** must be less than or equal to this value.
+
+{% hint style="info" %}
+We highly recommend implementing a Voting Delay to allow more time to review proposal's content and identify malicious proposals before voting starts.
+{% endhint %}
+
+### 7. Controller
+
+Space controller is a user that has a **full control over the space settings.**
+
+The address can differ from your own, you can for example set a multisig account as the controller.
+
+### 8. Sign transaction(s)
+
+Click **Create** and sign transaction(s) in your wallet. You will have to sign multiple transactions, each for individual contracts to be deployed:
+
+* Space contract
+* Execution strategy contracts - each space has its execution strategy deployed as an individual contract
+
+<figure><img src="../../.gitbook/assets/image (3).png" alt=""><figcaption></figcaption></figure>
+
+And that's it! 🎉

.gitbook/assets/Screenshot 2023-04-26 at 10.19.09.png

@@ -0,0 +1,92 @@
+---
+description: Learn what a proposal is and how to create one.
+---
+
+# Proposals
+
+## ​​What is a proposal? 
+
+Proposal is the key element of the voting system. It presents a change suggestion related to a specific organization and enables eligible users to cast their vote.
+
+Voting power for each user is calculated on the basis of the voting strategies selected in the [space settings](broken-reference).​
+
+Each proposal has the same voting system which provides three choices: **accept**, **reject**, **abstain**.
+
+## Who can create a proposal? <a href="#who-can-create-a-proposal" id="who-can-create-a-proposal"></a>
+
+Users who:
+
+* authenticate themselves via Authenticators[^1] whitelisted by the space,&#x20;
+* and are eligible according to the [Proposal validation strategy](#user-content-fn-2)[^2] selected by the space.
+
+## Create a proposal <a href="#create-a-proposal" id="create-a-proposal"></a>
+
+### 1. Open space settings.
+
+Head to the space which you wish to create your proposal for.
+
+Make sure the connected wallet is **where you hold the tokens relevant** to the specific space.&#x20;
+
+### 2. Click the New proposal icon
+
+Click the new proposal icon in the top right corner:\
+
+
+<figure><img src="../../.gitbook/assets/image.png" alt=""><figcaption></figcaption></figure>
+
+### 3. Provide proposal details
+
+Provide the necessary details - title, description and discussion link if there is one.
+
+### 4. Choose the execution strategy
+
+Select the [Execution strategy](#user-content-fn-3)[^3] you would like to use:\
+
+
+<figure><img src="../../.gitbook/assets/image (1).png" alt=""><figcaption></figcaption></figure>
+
+### 5. Specify transaction details
+
+Define what should happen if the proposal passes by choosing one of the execution options:
+
+<figure><img src="../../.gitbook/assets/image (2).png" alt=""><figcaption></figcaption></figure>
+
+A modal will open with the **transaction details** to fill in:\
+
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.44.20.png" alt=""><figcaption></figcaption></figure>
+
+### 6. Publish your proposal
+
+Click `Publish`​ and authenticate yourself via your wallet. Depending on the [space settings](broken-reference) you will have to sign a gasless Ethereum message and/or sign a transaction to confirm your action.
+
+{% hint style="info" %}
+When you create a proposal by default the **timestamp** will be populated with the latest block synced from our node. The voting power of each user will be calculated for the **state of the blockchain at this specific timestamp**. \
+\
+It means that if user acquires required tokens **after** the proposal has been created, they will not be taken into account for their voting power calculation.​
+{% endhint %}
+
+### 7. Give it a minute..
+
+Wait for the transaction to succeed. You can see it's pending in the top right corner, just next to your avatar:\
+
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.57.20.png" alt=""><figcaption></figcaption></figure>
+
+
+
+Once the icon with the pending transaction disappears, you can reload the page to view your proposal.
+
+And that's it! You have created a new proposal :tada:
+
+### Executing proposals <a href="#proposals-limitations" id="proposals-limitations"></a>
+
+Once the proposal has reached a quorum and passed, anyone can execute the transactions specified for it by clicking the **Execute transactions** button:
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-03-20 at 11.20.56.png" alt=""><figcaption></figcaption></figure>
+
+[^1]: Authenticators define how users can authenticate themselves to take specific actions. You can learn more about them [here](../protocol/authenticators.md).
+
+[^2]: A proposal validation strategy defines the minimum Voting power required to create a new proposal. Learn more [here](../protocol/proposal-validations.md).
+
+[^3]: Execution strategies determine the status of the proposal and are responsible for execution of the proposal payload once it has passed. If you want to learn more, check [here](../protocol/execution-strategies.md).

.gitbook/assets/Screenshot 2023-04-26 at 10.21.13.png

@@ -0,0 +1,45 @@
+---
+description: >-
+  If you added the Safe execution strategy to your space you have to enable it
+  on your Safe account after creating the space.
+---
+
+# Safe execution setup
+
+## 1. Copy the address of your Safe execution
+
+Head to your space settings and scroll down to the bottom of the page and click the Safe address on the right side of the screen.
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.11.39.png" alt=""><figcaption></figcaption></figure>
+
+A new tab will open on the Etherscan explorer.&#x20;
+
+**Copy the address of the contract:**
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.14.28.png" alt=""><figcaption></figcaption></figure>
+
+## 2. Open Safe dashboard of your Treasury account
+
+Click the `App` tab in the sidebar to open the list of available Safe applications.
+
+<figure><img src="../../.gitbook/assets/image (4).png" alt=""><figcaption></figcaption></figure>
+
+## 3. Select the Zodiac app
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 10.54.41.png" alt=""><figcaption></figcaption></figure>
+
+
+
+## 4. Add your Safe execution strategy contract
+
+Click on `Custom Module.`
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.04.24.png" alt=""><figcaption></figcaption></figure>
+
+Paste the contract's address you copied in the first step in the `Module Address` field.
+
+<figure><img src="../../.gitbook/assets/Screenshot 2023-04-26 at 11.00.24.png" alt=""><figcaption></figcaption></figure>
+
+As a last step you will have to sign a transaction.
+
+**And that's it, your proposals can now be executed!** :tada:

.gitbook/assets/Screenshot 2023-04-26 at 10.46.38.png

@@ -0,0 +1,52 @@
+---
+description: Learn how you can cast a vote on a proposal.
+---
+
+# Voting
+
+## Who can vote on proposals? <a href="#who-can-vote-on-proposals" id="who-can-vote-on-proposals"></a>
+
+There are several aspects that define if you are eligible to vote on a specific proposal.
+
+### Voting strategies <a href="#voting-strategies" id="voting-strategies"></a>
+
+Each space specifies their [Voting strategies](../protocol/voting-strategies.md) in its settings. You can see the custom setup by opening the space settings. This setup can define if you are eligible to take part in the voting and what is your Voting Power calculated at the timestamp of proposal creation.
+
+One of the most common questions we receive on our support channels is **Why can't I vote?**
+
+More often than not the answer is - **you did not hold the sufficient amount of specified token at the time of proposal creation.**
+
+## Cast a vote <a href="#cast-a-vote" id="cast-a-vote"></a>
+
+### 1. Connect your wallet
+
+Click the `Connect wallet` button in the top right corner.
+
+Connect with the wallet provider where you **hold the tokens relevant for the space** you want to vote in.
+
+### 2. Find the proposal
+
+Go to the space page on Snapshot. You can vote directly from this view or go to the proposal you are interested in to read more details before you vote.
+
+In the proposal page you can see your Voting Power. If it shows `0` it means you cannot vote on the selected proposal. \
+
+
+<figure><img src="../../.gitbook/assets/image (5).png" alt=""><figcaption></figcaption></figure>
+
+### 3. Vote!
+
+Select the option you want to vote for - **Accept, Reject, Abstain**.
+
+Depending on the space settings you will have to sign a gasless Ethereum message and/or sign a transaction to confirm your action.
+
+{% hint style="info" %}
+If you are using MetaMask you'll need to scroll to the end of the signature and click on the arrow down for the Sign button to become active. Voting on Snapshot doesn't affect your account or the funds that are associated to it.
+{% endhint %}
+
+You will notice that a new icon has appeared in the top right corner, just next to your avatar:
+
+<figure><img src="../../.gitbook/assets/image (6).png" alt=""><figcaption></figcaption></figure>
+
+The number indicates the number of pending transactions. Once it disappeared you can reload to page to view your vote.\
+\
+Voilà! You have just cast a vote 🎉​

.gitbook/assets/Screenshot 2023-04-26 at 10.54.41.png

@@ -62,7 +62,7 @@ A new pop-up window will open where you can toggle the different options:
 
  
 
-<figure><img src="../.gitbook/assets/image (5).png" alt=""><figcaption></figcaption></figure>
+<figure><img src="../.gitbook/assets/image (5) (1).png" alt=""><figcaption></figcaption></figure>
 
 ## How to unsubscribe?