Proposal Creation

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

To suggest a proposal:

👉 Open a thread on Discourse. 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

The option is only available for whitelisted members.

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

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).

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

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)

Other information like quorum that are inherited from the platform, and not specific for the proposal.

Step 2

Preview and publish the proposal.

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.

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.

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.

💡 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.

To avoid being blocked, make sure you delete content between [...] (brackets included).

Example of template customization.

📅 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.

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)

✏️ 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.

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

Example of a Draft proposal in the landing page.

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.

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.

Last updated