Skip to main content

Create a proposal

Creating a proposal is the first step in Chromia Governance, which allows citizens to suggest changes or decisions for the network. This process ensures that ideas are presented and ready for community input. Follow the steps below to create a proposal:

Prerequisites

Before you begin, ensure you have the following:

  • Citizen registration: Ensure you are registered as a citizen within the Chromia Governance system via an external authentication mechanism like MetaMask.
  • MetaMask or compatible wallet: Install and configure MetaMask or use another supported Ethereum-compatible wallet.
  • Sufficient privileges: Ensure your citizen account has the required permissions to create proposals. Contact an administrator if needed.
  • Active citizen status: Ensure you are not under any cooldown period from recent actions.
  • Familiarity with proposal guidelines: Review the proposal parameters (e.g., duration, voting requirements, categories) to ensure compliance when drafting your proposal.

Step 1: Log in as a citizen

Ensure you are registered as a citizen and logged in using your authenticated wallet (e.g., MetaMask). Only registered citizens with the required privileges can create proposals.

MetaMask login

Step 2: Start the draft creation process

  1. Navigate to the Proposals section.
  2. Click Create proposal to begin drafting your proposal.
Create proposal

You will be prompted to fill in the following details:

  • Title: Provide a concise and descriptive name for your proposal.
  • Category: Select the category that best fits the type of decision your proposal addresses.
  • Vote options: Enter the the available options for the community to vote on. You might specify "Approve," "Reject," or any other alternatives depending on the proposal's nature. These options will guide the community’s decision-making process.
  • Duration: Specify how long the voting period should last.

Ensure all required fields are filled out accurately before proceeding.

Step 3: Send to verification

  1. Click Preview to see your proposal.

    Preview proposal
  2. Preview the details and click Send to verification to submit your proposal for verification.

    Verify proposal
  3. The system will automatically check the following conditions:

    • Eligibility: Only citizens with appropriate privileges can create a draft.

    • Cooldown period: If you have recently performed specific actions (e.g., submitted another proposal), you may be subject to a cooldown period before creating a new draft.

      If you meet all requirements, your draft will be submitted successfully.

      proposal submission success

      If not, the system will display an error message indicating the issue.

Step 4: Wait for verification

After submission, your draft enters the verification phase, where an administrator reviews it. During this phase:

  • Track the status of your draft under the My proposals section.

  • The draft may be approved, rejected, or sent back for modifications.

    My proposals status

Ensure your draft complies with governance guidelines to avoid delays in verification.

Step 5: Submit the proposal for voting

After the administrator has verified and approved your proposal, you can either submit it immediately for voting or schedule it for a later time.

Option 1: Submit for immediate voting

  1. Once the proposal is approved, you can submit it immediately for voting.

  2. Navigate to the My proposals section, where your proposal will appear with an Approved status.

  3. Click on the proposal, review it and Click Publish.

  4. If everything is correct, click Publish instantly to make the proposal available for citizens to vote on.

    Publish instantly
  5. The proposal will now be open for voting, and citizens can choose from the options provided.

Option 2: Schedule for future voting

  1. Once the proposal has been approved, navigate to the My proposals section if you prefer to schedule it for voting at a later time.

  2. Navigate to the scheduling section and choose a suitable voting period start date and time.

  3. Click Schedule a publication to finalize your selection.

    Schedule a publication
  4. Your proposal will be scheduled, and the voting period will begin automatically at the chosen time.

    Publish proposal