Governance FIO App

Owned by Pawel Mastalerz
Last updated: Nov 19, 2024 by George Worrell
5 min read

Table of Contents

UX

https://www.figma.com/design/UzJyp5DM8xvfWRI4Iy44hU/New-FIO-Design-Concepts?node-id=201-13517&t=FFmu4aeKZwSayOOj-0

UX Flow

Made with Overflow

Governance

Visual

Functionality

Visual

Functionality

Common

 

  • FIO Foundation Board of Directors next Vote Count

    • Automatically show the next count date. The counts are 3 times a year:

      • April 15th 2PM (UTC-5)

      • August 16th 2PM (UTC-5)

      • December 15th 2PM (UTC-5)

Overview

image-20240819-211804.png

 

  • Display

    • FIO Foundation Board of Directors next Vote Count

    • Your Wallets & Voting Power

      • Display for every wallet attached to user:

        • Wallet Name

          • User assigned wallet name

        • Current voting power

        • FIO Board Vote

          • Run /get_sent_fio_requests if user has a request to vote@fio show VOTED, else show NOT VOTED

            • DEV NOTE: The user may have many sent request, so paging may be required. Consider, making this process asynchronous and store result in db.

        • Block Producer vote

          • Run /get_table_rows where lower_bound and upper_bound are hashes of account name

            { "json": true, "code": "eosio", "scope": "eosio", "table": "voters", "lower_bound": "15904889575112793648", "upper_bound": "15904889575112793648", "index_position": 3, "key_type": "i64" }

          • If record not found show NOT VOTED

          • If record found and ( is_auto_proxy : 1 OR proxy is not empty) show PROXIED, update FIO Board Vote to PROXIED as well irrespective of the request query

    • Links

      • View Foundation Board Directors

        • On click

          • Display Block Producers Page

      • For each wallet

        • View (per wallet)

          • On click

            • Display Wallet’s Voting Details Page

        • ? next to PROXIED only

          • On click display “If you proxy your tokens, they count towards your proxy's vote, not your own. Staked tokens may be automatically proxied. To stop proxying, vote for block producers.”

      • Learn More

        • On click

          • Display Voting Help Page

FIO Foundation Board of Directors

image-20240821-202441.png

 

 

 

  • Display

    • FIO Foundation Board of Directors next Vote Count

    • Upcoming election candidates

    • No associated FIO Handle warning if no FIO Handles registered

    • Links

      • My Current Votes

        • On click

          • Display Wallet’s Voting Details Page (for first wallet) and default to FIO Foundation Board of Directors tab

      • View Current Board of Directors

      • View (per candidate)

        • On click

          • Display Board Candidate Details Page

      • Cast Vote

        • Disabled if no FIO Handles registered

        • Disabled if the user has only one wallet and the wallet has a 0 FIO Balance

        • Disabled if the user has only one wallet and the wallet has been proxied

        • On click

      • Learn More

        • On click

          • Display Voting Help Page

Board Candidate Details

  • Display

    • Display from https://jira.fio.net/search?jql=filter=10080&maxResults=1000 for specific id

      • Name: issues → fields → summary

      • Last Vote Count: issues → fields → customfield_10183

      • Url: issues → fields → customfield_10181

      • Image: issues → fields → customfield_10178

      • Label: issues → fields → status → name

      • Candidate: issues → id (remove “FB-”)

      • Country: issues → fields → customfield_10176

      • Text: issues → customfield_10180 → content[0] → content[0] → text

      • Links

        • Twitter: issues → fields → customfield_10179

        • LinkedIn: issues → fields → customfield_10177

        • Web: issues → fields → customfield_10181

Cast Board Vote

 

 

 

 

  • Collect

    • Wallet

    • FIO Handle

      • Show warning if no handles

    • Candidates (see above for field mapping)

      • X removes candidate from list

        • Show warning if all removed

  • Links

    • Vote Now

      • Disable if all candidates removed

      • Disable if no voting power - 0 FIO Balance

      • Disable if wallet is proxied

      • Send a FIO Request

        • To: vote@fio

        • chain_code: FIO

        • token_code: FIO

        • amount: 1

        • memo: id’s of candidates separated by comma, e.g. “1,34,40,50”

Board Vote Confirmation

 

  • Display

    • Receiving Vote Handle

    • Voting Wallet Name

    • Candidates (see above for field mapping)

    • Voting Handle

    • Transaction Details

      • Bundles paid (or fee paid)

      • ID - blockchain tx id

    • Links

      • X or Close

        • On click

          • Display FIO Foundation Board of Directors Page

Block Producers

 

 

  • Display

    • Current Block Producers

    • Links

      • My Current Votes

        • On click

          • Display Wallet’s Voting Details Page (for first wallet) and default to Block producers tab

      • Would you rather proxy your vote

        • On click

          • Display Proxy Page

      • View (per BP)

        • Do not show for now

      • Cast Vote

        • On click

          • Display Cast BP Vote Page

          • Disable Cast BP Vote Page if the user has 1 wallet and that wallet has a 0 FIO Balance.

      • Learn More

        • On click

          • Display Voting Help Page

Cast BP Vote

 

 

 

 

  • Collect

    • Wallet

    • FIO Handle

      • If not available or none selected, warning shown and fee will be charged

    • Selected BPs

      • X removes BP from list

        • Show warning if all removed

  • Links

    • Vote Now

BP Vote Confirmation

 

  • Display

    • Voting Wallet Name

    • FIO Handles of BPs in vote

    • Transaction Details

      • Bundles paid (or fee paid)

      • ID - blockchain tx id

    • Links

      • X or Close

        • On click

          • Display Block Producers Page

Wallet’s Voting Details

FIO Foundation Board of Directors

Direct Vote

Proxy vote

Block Producers

Direct Vote

Proxy vote

  • Display

    • FIO Foundation Board of Directors

    • FIO Block Producers

      • Direct vote

        • Run /get_table_rows where lower_bound and upper_bound are hashes of account name (see Overview above for details) and display producers

      • Proxy vote

        • Run direct vote for account to which tokens are proxied.

Proxies

Proxy Details

  • Display (from voters table)

    • owner

    • FIO Handle: fioaddress

    • Last Vote Weight: last_vote_weight/1000000000

    • Proxied Vote Weight: proxied_vote_weight/1000000000

    • Producer Voting: producers

Proxy Votes

  • Collect

    • Wallet

    • FIO Handle

      • If not available or none selected, warning shown and fee will be charged

    • Selected proxy

  • Links

Proxy Vote Confirmation Page

 

  • Display

    • FIO Handle of proxy

    • Voting Wallet Name

    • Proxy account name

    • Transaction Details

      • Bundles paid (or fee paid)

      • ID - blockchain tx id

    • Links

      • X or Close

        • On click

          • Display Proxies Page

Voting Help