Skip to main content

Key modules in the governance system

This topic outlines the core components of the Chromia governance system, detailing how citizens interact with proposals, voting, and the veto mechanism.

Citizens​

Citizens play an essential role in governance, engaging in key processes such as registration and role management:

  • Registration: Citizens register using an external authentication mechanism, providing an authentication descriptor and a signature for account creation.

  • Role management: Administrators assign and manage roles, defining responsibilities within the governance system.

Proposals​

Proposals form the backbone of the governance process, structured into distinct phases:

  • Proposal creation
    Citizens draft and submit proposals to initiate governance decisions.

    • Draft submission: Eligible citizens create proposals by providing details such as title, category, and duration.
    • Validation and authorization: Only registered citizens can submit draft proposals.
    • Cooldown enforcement: A cooldown period may apply before a citizen can submit another proposal.

  • Draft verification
    Proposals undergo review before advancing.

    • Councilor review: A councilor evaluates each draft to ensure its readiness.
    • Status update: The system updates the draft’s status after review.

  • Voting
    Verified proposals move to the voting phase, allowing citizens to cast their votes.

  • Finalization
    The system processes and archives the final decision.

    • Completion: The system marks the proposal as finalized.
    • Outcome storage: Voting results and decisions are archived for future reference.

Votes​

The voting mechanism empowers citizens to shape governance outcomes:

  • Casting votes: Citizens select from available options on a proposal.
  • Finalizing votes: The system automatically concludes the voting phase once the deadline passes.

Veto mechanism​

The veto mechanism safeguards against potentially harmful proposals:

  • Veto period: There is a timeframe called the veto period during which a veto can be initiated after voting has concluded. For example, if the veto period is set to 12 hours, a permissioned group of citizens can veto within 12 hours after voting has finished.
  • Initiating a veto: Citizens can propose a veto against specific proposals or options.
  • Voting on a veto: Citizens decide whether to approve or reject the veto.
  • Finalizing a veto: If conditions are met, the system enforces the veto, preventing the proposal from proceeding.