qubic/proposals-frontend

proposals-frontend

proposals-frontend's Issues

Creating proposals

• #1

UI/UX for Casting a Vote

1. As a Computor, I can cast a vote

If you are one of the 676 Computors you can cast your vote.
Computors can cast a vote for General Proposal, Donation Proposal and CCF Funding Request proposals

Notes

• Proposals are valid for one epoch
• Users can vote on the proposals for the whole epoch.

Technical information
The command to be used in Qubic CLI: -gqmpropvote

./qubic-cli -seed -nodeip -gqmpropvote 0 0

• first param is the proposal index
• second param is the option to vote for 0,1,2,3,4,5,6,7

2. As a Smart Contract shareholder, I can cast a vote for a Smart Contract Proposal

Not much information available yet, to be completed later

Casting a Vote

• #3

UI/UX for Creating Proposals

1. As a computor, I can create a General proposal

Computor proposals are needed if something should be changed on the protocol or if you want to add a new SC to Qubic.

Sample use cases:

• Request to allow a new SC
• Extend protocol features

Data needed to create the proposal:

To be stored in the SC:

• Number of votes: 2, 3, ..., 7, or 8
• URL containing information of the proposal

At the proposal application level:

• Text to describe what each of the votes means (i.e Yes, allow it /No)

2. As a computor, I can create a Computor Donation proposal

This proposal is used to ask the Computors for a relative donation to what they earn per epoch.
Yes/No proposals

Sample use cases:

• Ask to burn Qubics
• Ask to fund the CCF
• Ask to donate a long term project

To be stored in the SC:

• Number of votes: 2, 3, ..., 7, or 8
• URL containing information of the proposal
• Destination identity
• Amount for each voting option (one option less than the number of votes because first option means 0 donation)

Technical
This runs in the same SC for Computors proposals (see 1.)

3. As a user, I can create a CCF Funding Request proposal

If you have a project idea and want that the Qubic ecosystem fund (CCF) will help you to build it, then, this is the right place. Everyone needs to request single payouts.

Sample use cases are:

• Core Development needs funds to pay salaries
• Company X want's to integrate Qubic in their wallet
• The Grants program needs funds for their grants

Ccommunity announcement from 12.09.2024 (https://discord.com/channels/768887649540243497/1131697849457967167/1283856114567610400):

The Computor Controlled Fund (CCF) Smart Contract has been officially approved by Computors. The Initial Public Offering (IPO) started, 11th September 2024, with the Smart Contract going live on 18th September 2024.

What is the CCF Smart Contract?
The CCF introduces a decentralized funding mechanism, empowering the Qubic community to propose and vote on projects that will drive the ecosystem forward. Please note that this IPO will not provide shareholder profits.

Details here: https://qubic.org/blog-detail/computors-approve-ccf-smart-contract

More details here: https://github.com/qubic/proposal/blob/2e25df383dc95b937a3e0c56d11925b664770108/SmartContracts/2024-09-09-CCF.md
SC source code here: https://github.com/qubic/core/blob/develop/src/contracts/ComputorControlledFund.h

4. As a Smart Contract shareholder, I can create a proposal for the Smart Contract

A shareholder proposal is used to ask the shareholders of smart contracts for their votings.

Sample use cases:

• Adjust fees of a SC
• Change revenue address of a SC

General Notes

• SC that support 1. and 2. are ready in the Computor SC.
• SC for 3. going live on 18th September 2024
• 4. not available yet
• Only whitelisted domain will be allowed for the proposal URL (initially just github). However, the URL entered for the proposal is just a landing page for the proposal. This page should contain a full description of the proposal, but may also link to any other pages outside of GitHub.
• Further clarifications from JT:

1. Computor Donations
2. CCF

with 1. you can request recurring payments. this is what is used for SupplyWatcher, and maybe CCF and Qearn.
with 2. which is meant to be the Qubic Ecosystem Fund, everyone needs to request single payouts.

2. has the idea to build reserves and being long term funding for Qubic's growth. (see blog description https://qubic.org/blog-detail/introducing-the-protocol-extension-the-tech-backbone-of-project-x)
3. is a structural element of the protocol to support initiative like CCF SC.

Sources

https://github.com/qubic/proposal/tree/main
https://github.com/qubic/proposal/blob/main/general-computor-proposal-how-to.md
https://discord.com/channels/768887649540243497/1280875885703987271
https://discord.com/channels/768887649540243497/1280875885703987271/1282647748893736980

View Proposals

• #2

UI/UX for Viewing Proposals

1. As a user, I can see the list of active proposals

Technical information
The command to be use: -gqmpropgetproposals Example:

#> ./qubic-cli -seed -nodeip -gqmpropgetproposals active
Received list of 1 proposals
Proposal:
proposalIndex = 0
proposer = EQOTMBNINEBMWFTBFTHTMWWLKHNBBAUHJNHUEQKDOCRTCLQBTDCMFOFHNNPJ
url = https://github.com/qubic/proposal/blob/2e25df383dc95b937a3e0c56d11925b664770108/SmartContracts/2024-09-09-CCF.md
type = GeneralOptions with 2 options (vote value 0 ... 1)
epoch = 125
tick = 15796800

Existing 'deprecated' screens below (not sure why they display different data):

wallet.qubic.li

wallet.qubic.org

2. As a user, I can see the list of closed proposals

This will require to combine app local database stored data and SC contract data (there is a limit in the storage of historical proposals).

3. As a user, I can see the details of a proposal

This will require to combine proposals database stored data and SC contract data.
i.e the description of each option (except the first one that is rejection) is not stored in the smart contract for some proposals types but it might (optionally) be stored in the proposals database

4. As a user, I can see the voting results for a proposal

• A proposal is accepted if at least 2/3 of the computors have casted a vote.

Technical information
The command to be used in Qubic CLI is : -gqmpropgetresults
Example:

#> ./qubic-cli -seed -nodeip -gqmpropgetresults 0
Proposal:
proposalIndex = 0
proposer = EQOTMBNINEBMWFTBFTHTMWWLKHNBBAUHJNHUEQKDOCRTCLQBTDCMFOFHNNPJ
url = https://github.com/qubic/proposal/blob/2e25df383dc95b937a3e0c56d11925b664770108/SmartContracts/2024-09-09-CCF.md
type = GeneralOptions with 2 options (vote value 0 ... 1)
epoch = 125
tick = 15796800
Proposal voting results:
proposal index = 0
proposal tick = 15796800
total votes = 2 / 676
votes for option 0 = 2 (no change)
votes for option 1 = 0
most voted option = 0 (total votes not sufficient for acceptance of proposal)

Notes

The technical information above was collected for Computor proposals (general and donations).
It will be updated later to include the information for CCF and SC shareholders related ones.