# Proposal Creation

Only users with the `WHITELISTED_ROLE` can submit proposals on-chain.

To suggest a proposal:

👉 Open a thread on [Discourse](https://vechain.discourse.group/latest). You can use the same channel to get some help to:

* Review your proposal
* Get some endorsement
* Format it correctly
* Funnel it to a whitelisted member (`WHITELISTED_ROLE`)

### Create a proposal in VeVote

{% hint style="info" %}
The option is only available for whitelisted members.
{% endhint %}

To create a new proposal head to [https://vevote.vechain.org](https://vevote.vechain.org/) and connect your wallet.  

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FlNj4n4A8jKjYDuj6GPJs%2Fimage.png?alt=media&#x26;token=a50db3bb-b6d1-425a-83a6-cedbc4dc4a18" alt=""><figcaption></figcaption></figure>

If it's the first time you login, or if you do it from another browser, you will be requested to accept the platform policies (terms of use, privacy policy and cookie policy).

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FfBaEacb5IsAqFt8VdJgG%2Fimage.png?alt=media&#x26;token=e6259b59-dc1a-4bc6-a143-9d394317d4ab" alt=""><figcaption></figcaption></figure>

If you are allowed to create new proposals, you will see the **Create Proposal** button above the list of all proposals, on the right.&#x20;

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FasHEzJf3fVksf617kjJt%2Fimage.png?alt=media&#x26;token=26fead4a-0a75-47f2-8266-d3a51a3ab5b9" alt=""><figcaption></figcaption></figure>

### Proposal creation form

The proposal creation is a 2-step process:

#### Step 1

Filling the following information:

* Title
* Description
* Discourse topic
* Start and end date (and time)
* A header image (optional, not used at the moment)

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FQcQM8VODOgPZPjtw1qqj%2Fimage.png?alt=media&#x26;token=9b557de3-d01e-4e4f-8ba9-893fecdf6379" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Other information like **quorum** that are inherited from the platform, and not specific for the proposal.
{% endhint %}

#### Step 2

Preview and publish the proposal.

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FKGuCzGrDIq8UE0PymuXP%2Fimage.png?alt=media&#x26;token=0f523ae0-0e7e-4cd7-8b26-f43c2c6fcc6f" alt=""><figcaption></figcaption></figure>

### Fill the Description

You will find a template in the **Description** providing some sections that will act as guidelines to make the content of all proposal consistent and easier to read.

Make sure to replace the content of each section with yours. Select and start typing,  or use right click and select "**Paste and Match Style**" if you have something ready. This step is to make sure the format is consistent with throughout the platform.&#x20;

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FkhpC2Mo74G6WjmxzKWdl%2Fimage.png?alt=media&#x26;token=0b76e586-0f81-4e4c-8b0b-0e9934ab0a96" alt=""><figcaption></figcaption></figure>

You can proceed with the other sections in the same way.\
Once you are done, you can make the final adjustments like (i.e.) removing *Italics* if you like.

{% hint style="warning" %}
There are some rules the platform will check to help you avoid forgetting to fill in all the information.
{% endhint %}

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FspPXWhsMgKxc04oQtf3m%2Fimage.png?alt=media&#x26;token=99b9da60-de10-40f1-b4ac-4203ec46f285" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For your proposal, some sections may seem redundant. It's up to the creator to decide what to keep or change on a case-by-case.&#x20;
{% endhint %}

#### :bulb: Delete or replace a section

The platform will check the template, and may seem impossible to change it at first glance. But the creator can actually remove whole sections or create new ones.&#x20;

To avoid being blocked, make sure you delete content between *\[...]* (brackets included).&#x20;

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FbzxGL5drcEo7F1e0g99Z%2Fimage.png?alt=media&#x26;token=da44f831-e1e5-4c9a-8877-324d83469600" alt=""><figcaption><p>Example of template customization.</p></figcaption></figure>

#### :date: Customizing the voting window

One of the most essential parts of a proposal is the moment in which people can start voting, and of course, when the outcome is decided.

{% hint style="warning" %}
The start time of a proposal will identify the **snapshot** block, the point in time in which voting power for the proposal is considered. Buying or selling nodes after this block won't affect your voting power.
{% endhint %}

The time window can be customised using the controls under **Voting Calendar**.

Rules do apply also for the dates:

* dates can't be in the past
* time between the creation and the Start time can't be less than 7 days (currently)
* time between the Start and End time can't be less than 7 days (currently)

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FuwqTUBFDdr5klbRWdlQx%2Fimage.png?alt=media&#x26;token=1b52a2b3-dd19-4677-aacb-3f6eb7ccb440" alt=""><figcaption></figcaption></figure>

### :pencil2: Draft Proposals

if you are not ready to publish, because you want to wait for a specific date or keep open the possibility of editing some details, hitting **Exit** will give you the chance to save the proposal locally as **Draft**.

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2F9bMFRGHXGuapIO0xp445%2Fimage.png?alt=media&#x26;token=12610dff-0bcb-4482-9345-348bc9694c45" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Only Draft proposals are editable.&#x20;
{% endhint %}

To edit a Draft proposal, go to the landing page and select it.

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2F63Ce0zPPfhKUh00jkX5t%2Fimage.png?alt=media&#x26;token=20241858-b485-4648-8d21-289aa9211bd5" alt=""><figcaption><p>Example of a Draft proposal in the landing page.</p></figcaption></figure>

In the header you will have the choice either to Delete or Edit. Once you hit Edit, you will see again the Proposal creation for of **Step 1**, already filled with all your information.&#x20;

<figure><img src="https://1425937327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3QdkPGhXv2bH9qBt7pf6%2Fuploads%2FXDG18PywE0v4Hyqun9xV%2Fimage.png?alt=media&#x26;token=8ce60ffb-4c2f-40c8-96f5-9289c862eeb8" alt=""><figcaption></figcaption></figure>

### The Smart Contract side

Proposal Creation Format:

| Field          | Type      | Description                            |
| -------------- | --------- | -------------------------------------- |
| `description`  | `string`  | IPFS CID for full Markdown content     |
| `startBlock`   | `uint256` | Block when voting starts (after delay) |
| `voteDuration` | `uint256` | Duration in seconds                    |

The format is taken care by the platform when the proposal is submitted using the portal.