Create a freeform proposal
Freeform proposals allow the community to propose and vote on matters which don't change any of the behaviour of the currently running Vega blockchain.
At enactment time, no changes are effected on the system, but the record of how token holders voted will be stored on chain.
Requirements
You will need:
- A connected Vega wallet, with your wallet name and public key to hand
- A minimum of whichever is larger, associated with that public key: 👀1 token or 👀1 token
- Familiarity with governance on Vega
Templates and submitting
In the tabs below you'll see an annotated example, which describes what each field is for, a JSON example that can be used to submit on the governance dApp, and command line examples for different operating systems. You'll need to replace the example data with the relevant details before submitting.
- Annotated example
- Governance dApp (JSON)
- Command line (Linux / OSX)
- Command line (Windows)
{
rationale: {
title: "An example freeform proposal",
description: "I propose that everyone evaluate the following IPFS document and vote Yes if they agree. [bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si](https://dweb.link/ipfs/bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si)"
}
},
terms: {
newFreeform: {
// This object remains empty, but is required
},
// Timestamp (Unix time in seconds) when voting closes for this proposal,
// constrained by `minClose` and `maxClose` network parameters (int64 as string})
closingTimestamp: 1680534013000,
}
}
- Copy the JSON example below into a text editor.
- Replace the placeholder values with those you want for the market.
- Submit your proposal from the New Proposal area of the governance dApp.
- Check you can see your proposal on Open Proposals area of the governance dApp.
{
"rationale": {
"title": "An example freeform proposal",
"description": "I propose that everyone evaluate the following IPFS document and vote Yes if they agree. [bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si](https://dweb.link/ipfs/bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si)"
},
"terms": {
"newFreeform": {},
"closingTimestamp": 1680534013000
}
}
- Copy the command line example below into a text editor.
- Replace the placeholder values with those you want in the proposal.
- Use the command line to submit your proposal.
- Check you can see your proposal on Open Proposals area of the governance dApp.
./vegawallet transaction send --wallet your_walletname --pubkey your_public_key --network fairground '{
"proposalSubmission": {
"rationale": {
"title": "An example freeform proposal",
"description": "I propose that everyone evaluate the following IPFS document and vote Yes if they agree. [bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si](https://dweb.link/ipfs/bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si)"
},
"terms": {
"newFreeform": {},
"closingTimestamp": 1680534013000
}
}
}'
- Copy the command line example below into a text editor.
- Replace the placeholder values with those you want in the proposal.
- Use the command line to submit your proposal.
- Check you can see your proposal on Open Proposals area of the governance dApp.
vegawallet.exe transaction send --wallet your_walletname --pubkey your_public_key --network fairground ^
"{^
\"proposalSubmission\": {^
\"rationale\": {^
\"title\": \"An example freeform proposal\",^
\"description\": \"I propose that everyone evaluate the following IPFS document and vote Yes if they agree. [bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si](https://dweb.link/ipfs/bafybeigwwctpv37xdcwacqxvekr6e4kaemqsrv34em6glkbiceo3fcy4si)\"^
},^
\"terms\": {^
\"newFreeform\": {},^
\"closingTimestamp\": 1680534013000^
}^
}^
}"
Voting and enactment
All proposals are voted on by the community. To vote, community members need, at a minimum, the larger of 👀1000000000000000000 tokens or 👀1 token, associated to their Vega key.
Your proposal will need participation of 👀30% and a voting majority of 👀66%, so having community support is essential.
Building support is down to you. Share your proposal in the Free Form Proposals forum ↗ on Vega community. You may also wish to share on Discord ↗.
Proposers who invite feedback, engage with comments, and make revisions to meet the needs of the community are more likely to be successful.