vega-frontend-monorepo/specs/3002-PROP-propose.md
2023-08-07 08:41:25 +01:00

4.1 KiB

Propose

Background: Governance spec and docs.

Associate tokens

When looking to propose something, I...

  • must see see a link to detailed explanation of Governance in the docs (3002-PROP-001)
  • must see that the governance token is an ethereum ERC20 token and needs to attributed (or associated) to a Vega wallet for use on Vega (3002-PROP-002)
  • must see that I need some associated tokens, and a link to associate (3002-PROP-003)

... so I have a sufficient vote weight to propose.

Select proposal type

When making a proposal, I...

...so I get the appropriate form and information about rules for that type of proposal. e.g. min enactment and vote duration.

Populate a proposal form

When making a proposal, I...

  • must be able to see what they are to be used for on this site i.e. "Create proposal and download JSON to share" (3002-PROP-023)

  • must input a rationale title and description (3002-PROP-006)

  • must see the rules (min vote duration and enactment delay) for this proposal type (3002-PROP-008)

  • should see the minimum required tokens or LP vote required to make a proposal Spam protection and network parameters

  • if anything except market change: must be warned if the amount I have associated is less the the minimum required to propose for this proposal type (due to Spam protection or network parm, whichever is greater) (3002-PROP-009)

  • if market change: must be warned if the amount of tokens I have less than the minimum tokens required to propose a change (due to Spam protection or network params) (3002-PROP-020)

  • must see whether I have already voted or not on the card / list view (s) (3002-PROP-021)

  • should see the balance of associated Governance tokens

Detail on specific proposals

Go to the following for detail on each proposal type:

Submit proposal

  • must submit the proposal Vega transaction (3002-PROP-011)
  • must see the feedback on the Vega transaction (3002-PROP-012)
  • If there is an error on the proposal:
    • must be shown an error message will all of the error details from the API (3002-PROP-013)
    • must see the proposal form populated with all the same values just submitted (3002-PROP-014)
    • should see error messages highlighted on the inputs that require user attention
  • If the proposal was successful:
    • must be shown it was successful (3002-PROP-016)
    • should be prompted to vote on the proposal
    • should be prompted to share the proposal detail page to encourage others to vote
    • must see a link to the proposal detail page (3002-PROP-019)

...so that the proposal is listed on the chain and I and others can vote for or against it.