Skip to content

Commit fb3863d

Browse files
authored
Merge pull request #1285 from Concordium/update-how-to-vote
updated page after review
2 parents d905592 + c71611a commit fb3863d

8 files changed

+23
-59
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading

source/mainnet/docs/voting/voting.rst

+23-59
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,11 @@
55
How to vote
66
===========
77

8-
The user flow for the voter is as follows. It assumes the user has a wallet on the Concordium blockchain with some CCD, enough to pay for transaction fees.
8+
To paritcipate in voting, voters need a wallet on the Concordium blockchain with enough CCD to cover transaction fees. Once this is set up, the voting process works as described below.
99

10-
For |cryptox|, |bw|, |mw-gen2| and |cryptox| wallet holders
11-
===========================================================
10+
For |cryptox| and |bw| wallet holders
11+
=====================================
1212

13-
Note that |mw-gen2| users with Android 14 might experience a technical bug preventing them from connecting to the voting dApp. They can import their account into the |bw| or the |cryptox| with their seed phrase, and vote from those wallets.
1413

1514
#. Navigate to the voting dApp.
1615

@@ -20,44 +19,47 @@ Note that |mw-gen2| users with Android 14 might experience a technical bug preve
2019
:alt: example voting dapp site
2120
:width: 100%
2221

23-
#. When the election is open, the user selects zero or more candidates for which they want to vote and selects **Submit**. They can vote multiple times.
22+
#. When the election is open, select zero or more candidates and then, select **Submit**. It is possible to vote multiple times.
2423

25-
#. The user is asked to **connect** the wallet to the voting dApp and send the update transaction to the smart contract. The voting weight that is shown is the average number of CCD in the account that is voting during the past three months.
24+
#. When prompted, **connect** the wallet to the voting dApp and send the update transaction to the smart contract. The voting weight is calculated based on the account's average CCD balance during the months, as specified in the `election rules <https://docs.concordium.com/governance/rules/ElectionRules2024.pdf>`_.
2625

2726
.. image:: ../images/voting/voting-dapp-connected.png
2827
:alt: voting dapp sidebar when connected to wallet
2928
:width: 100%
3029

31-
The voting dApp also has a separate page where the user can see the list of all their (encrypted) ballot submissions.
30+
The voting dApp also has a separate page where voters can see a list of all their (encrypted) ballot submissions.
3231

3332
Voting from multiple accounts
3433
-----------------------------
3534

36-
Since the votes are weighted by the number of CCD on the account, for a user to vote with their full weight they need to vote from all their accounts. For |cryptox| and |mw-gen2| wallet holders, it is sufficient to disconnect and reconnect: the user is then given the choice to connect with a different account. With the |bw|, disconnecting and connecting again will always reconnect with the same account. To change accounts, follow the instructions here below.
35+
Since the votes are weighted by the number of CCD on the account, for a user to vote with their full weight they need to vote from all their accounts.
36+
37+
For |cryptox| wallet users: Simply disconnect and reconnect to select a different account.
38+
39+
For |bw| users: Disconnecting and connecting will reconnect to the same account. To change accounts, follow the instructions below.
3740

3841
.. dropdown:: |bw|
3942

40-
#. In the wallet, click **connected** next to the account address. If you have an account open that is not connected, the button will say **not connected** instead. Clicking this is fine as well.
43+
#. In the wallet, click **See list** next to *Connected sites* for the account you want to vote with.
4144

42-
.. image:: ../images/voting/connected-account.png
45+
.. image:: ../images/voting/connected_account_new.png
4346
:alt: account connected to a dApp
4447
:width: 50%
4548

46-
#. This opens the **Allowlist** menu, where the user can check every account that is allowed to connect to the dApp.
49+
#. This opens the **Connected sites** page, showing which sites are connected to this account.
4750

48-
.. image:: ../images/voting/allow-list.png
51+
.. image:: ../images/voting/connected_files.png
4952
:alt: account connected to a dApp
5053
:width: 50%
5154

52-
#. Return to the main wallet window with the arrow or cross.
53-
#. Select the account in the wallet which should connect to the voting dApp.
54-
#. Disconnect and reconnect in the voting dApp. The user will now be connected to the account that is open in the wallet.
55-
#. Repeat the two last steps above to vote with all accounts.
55+
#. Return to the main wallet window by clicking **to Accounts list**.
56+
#. Disconnect and reconnect in the voting dApp. After reconnecting, you will be connected to the account that is currently open in the wallet.
57+
#. Repeat the steps above to vote with all accounts.
5658

57-
For Desktop wallet, |mw-gen1| and Concordium Client wallet holders
58-
==================================================================
59+
For Desktop wallet and Concordium Client wallet holders
60+
=======================================================
5961

60-
These older wallets do not have the capability to connect to dApps. But you do have an option to exercise your vote.
62+
These wallets do not have the capability to connect to dApps. But you do have an option to exercise your vote.
6163

6264
.. dropdown:: Desktop wallet
6365

@@ -67,7 +69,7 @@ These older wallets do not have the capability to connect to dApps. But you do h
6769

6870
#. In the account from which you want to vote, click **Send**.
6971

70-
#. Enter any amount of CCD (1 micro-CCD is enough). The target account in |bw| or |cryptox| is the recipient (in the image below the recipient account has been added to the address book and named My vote delegation). Add a transaction memo that says **delegatevote2024**.
72+
#. Enter any amount of CCD (1 micro-CCD is enough). The target account in |bw| or |cryptox| is the recipient (in the image below the recipient account has been added to the address book and named My vote delegation). Add a transaction memo that says **delegatevote2025**.
7173

7274
.. image:: ../images/voting/dw-vote-delegation.png
7375
:alt: send CCD window in desktop wallet showing how to delegate vote
@@ -81,44 +83,6 @@ These older wallets do not have the capability to connect to dApps. But you do h
8183

8284
#. It is possible to check from the Voting DApp that the delegation worked. The window for delegating votes is the same as voting with the DApp.
8385

84-
.. dropdown:: |mw-gen1|
85-
86-
|mw-gen1| users are recommended to migrate to the |cryptox|, as this is actively maintained and supports walletconnect, which is required to interact with dApps such as the application used for voting in the election. The |cryptox| can be installed for either `Android <https://play.google.com/store/apps/details?id=com.pioneeringtechventures.wallet>`_ or `iOS <https://apps.apple.com/dk/app/cryptox-concordium-wallet/id1593386457>`_.
87-
88-
.. Note::
89-
For more information on how to create a backup in the |mw-gen1| and import this into a compatible wallet, see :ref:`backup and restore<mobile-wallet-recover>`
90-
91-
#. **Backup your wallet data** in in your |mw-gen1|. This creates an export file with all the identities and accounts in your wallet.
92-
93-
#. If you haven't already done so, download |cryptox| for either `Android <https://play.google.com/store/apps/details?id=com.pioneeringtechventures.wallet>`_ or `iOS <https://apps.apple.com/dk/app/cryptox-concordium-wallet/id1593386457>`_.
94-
95-
#. **Import the backup** created in step 1 into |cryptox|.
96-
97-
**Alternative route**
98-
99-
Alternatively, users need to create a new account in |bw| or |cryptox|, and delegate their vote from their |mw-gen1| account(s) to the new account, then vote from the new account. You can create the new account in |bw| or |cryptox| at any time before delegating your vote. But the memo transaction, which effectively delegates the vote, and the vote from the new account both need to take place within the official voting window.
100-
101-
#. Tap **Send** on the account to delegate from.
102-
103-
#. Enter any amount of CCD (1 micro-CCD is enough). Enter the recipient address which is the target account in |bw| or |cryptox|. You can paste the address after copying it, scan the QR code of the account, or select it from the address book. In **Optional: Add memo** add a memo that says **delegatevote2024**. Tap **Send amount**.
104-
105-
.. image:: ../images/voting/mwgen1-delegate-vote.png
106-
:alt: send CCD window in old mobile wallet showing how to delegate vote
107-
:width: 100%
108-
109-
#. Tap **Send funds**.
110-
111-
.. image:: ../images/voting/mwgen1-delegate-vote-confirm.png
112-
:alt: window in old mobile wallet asking user to confirm transaction
113-
:width: 100%
114-
115-
#. Tap **Finish**.
116-
117-
.. image:: ../images/voting/mwgen1-transaction-submitted.png
118-
:alt: window in old mobile wallet showing successful transaction submission
119-
:width: 100%
120-
121-
#. It is possible to check from the Voting DApp that the delegation worked. The window for delegating votes is the same as voting with the DApp.
12286

12387
.. dropdown:: Concordium Client
12488

@@ -130,7 +94,7 @@ These older wallets do not have the capability to connect to dApps. But you do h
13094
13195
$concordium-client --secure --grpc-ip grpc.mainnet.concordium.software transaction send --amount AMOUNT --receiver A --sender B --memo delegatevote2024
13296
133-
#. Enter the command above in the Concordium Client, where AMOUNT is the number of CCD to be sent (1 micro-CCD is enough), A is the name/address of the account to which the vote is delegated, and B is the sender name/address. Note the memo *delegatevote2024* for the delegation to be valid. Furthermore, there is no service license agreement for the grpc endpoint.
97+
#. Enter the command above in the Concordium Client, where AMOUNT is the number of CCD to be sent (1 micro-CCD is enough), A is the name/address of the account to which the vote is delegated, and B is the sender name/address. Note the memo *delegatevote2025* for the delegation to be valid. Furthermore, there is no service license agreement for the grpc endpoint.
13498

13599
#. Vote from the account that has received the delegation.
136100

0 commit comments

Comments
 (0)