Skip to main content

User and proposal flows

User flow​

Learning​

Users begin by exploring the Chromia Governance DApp, where they can access essential information about the governance system and its processes.

Registration​

Users register with a MetaMask wallet, which automatically creates:

  • A citizen account
  • An FT4 account

Rank advancement​

Users can progress in governance by actively participating:

  • Citizens may be promoted to counselors through an admin decision or a successful governance proposal.

Ban (upcoming feature)​

A ban list will allow admins to remove non-compliant users from the governance system.

Cooldown periods​

To prevent spam and maintain fair governance, cooldown mechanisms regulate actions:

  • Proposal creation cooldown: Limits how often users can submit proposals.
    • Default setting: Disabled in the demo.
    • Admins and counselors can enable and configure cooldowns.
  • Veto execution cooldown: Restricts how frequently veto actions can be performed.

Proposal flow​

Creating a proposal​

Citizens draft proposals by providing:

  • Title
  • Category
  • Description
  • Duration
  • Voting options and commands

Validation​

  • The system automatically validates proposals when saved.
  • It checks for compliance with predefined rules, such as character limits and content flags.
  • Validation logic is configurable.

Approval​

  • Proposals require admin or counselor approval via a voting process.
  • Demo setting: Admins must manually save a draft before clicking approve.

Verification​

  • The system verifies if a proposal meets quorum requirements.
  • Verification occurs after each approve or disapprove vote.
  • Demo rule: At least 50% of counselors must approve a proposal for verification.

Voting​

Citizens vote based on:

  • Token balance or stake
  • Voting power strategies such as linear, quadratic, or hybrid models

The voting period ends when:

  • The set time limit expires.
  • A predefined threshold is met.
  • Demo feature: Admins can manually end voting.

Veto​

  • Admins and counselors can veto proposals within a defined period.
  • The veto process is separate from regular voting:
    • Counselors first vote as citizens using their voting power.
    • During the veto period, they can override decisions using their counselor or admin status.
  • Upcoming feature: Veto functionality is currently in development.

Execution​

  • The system executes commands from the winning proposal.
  • After execution, participants receive a refund of their voting power.