# Governance process

This document outlines the governance process that the Nation3 citizens, the [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") and the proposers must follow to engage with Nation3 governance. This document adheres to the [Nation3 Constitution](https://linked.md/v?u=ipfs://bafybeidfupkrpzch3gwryqnaevratjc2nabhfoibygn5mmdpaylzbmajqu/Constitution.linked.md).

### Kinds of proposals

The different kinds of proposals are specified in the [Nation3 Constitution](https://linked.md/v?u=https://linked.md/api/github/nation3/law/main/Constitution.linked.md#Meta%20Proposal).

### Stages of a proposal

{% @mermaid/diagram content="flowchart LR
REVIEW\[Community review] --> FINAL\[Final proposal]
FINAL --> OFFVOTE\[Off-chain vote]
OFFVOTE --> ONVOTE\[On-chain enactment]" %}

1. **Community review**: The community provides feedback on a published proposal for the proposer to consider. The proposer must explain how the proposal helps Nation3 advance its North Star metrics. After the minimum duration required for this stage, the proposer can freeze their proposal, advancing it to the next stage. After freeze, any further modifications to the proposal require restarting the process.
   * **Duration**: >24h.
   * **Platform**: [Forum](https://forum.nation3.org).
2. **Off-chain vote**: Citizens can vote. The [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") is responsible for creating the proposal on Snapshot.
   * **Duration**: 48h.
   * **Platform**: [Snapshot](https://snapshot.org/#/nation3.eth).
   * **Census**: All Nation3 citizens.
   * **Voting weight**: Token-weighted by $veNATION balance.
   * **Voting system**: *Single Choice*.
   * **Voting threshold**: Simple majority.
3. **On-chain enactment**: $veNATION holders can ratify the proposal. The [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") is responsible for creating the proposal on Aragon.
   * **Duration**: 48h.
   * **Platform**: [Aragon](https://client.aragon.org/#/nation3/0x92462953792d3e84af56edfc74d93e5885d38cc0/).
   * **Census**: All $veNATION holders.
   * **Voting weight**: Token-weighted by $veNATION balance.
   * **Voting system**: Binary (approve/reject).
   * **Voting threshold**: Simple majority.

Census and voting weights are determined at the time of vote creation, both for the Nation3 space on Snapshot and the Nation3 DAO on Aragon. The Nation3 DAO, Nation3 passports and $veNATION are currently only on Ethereum.

{% @mermaid/diagram content="gantt
dateFormat YYYY-MM-DD
axisFormat %d
title Lifecycle of a proposal

Community review: 1, 0000-01-01, 1d
Off-chain vote: 2, after 1, 2d
On-chain enactment: 3, after 2, 2d" %}

### Submitting a proposal

1. Once you are ready to submit a formal proposal, go to the [Proposal Generator](https://gov.nation3.org/proposals/create) to generate an encoded version. Proposals need to adhere to the [governance spec](https://github.com/nation3/gov/blob/main/specs/N3GOV-v2.d.ts).
2. [Open a pull request](https://github.com/nation3/gov-proposals/pull/new) in the `gov-proposals` repo adding the proposal as `N3GOV-ID.json` (where ID is the suggested proposal's ID). Link the pull request at the end of your forum post.
3. Modify the proposal based on feedback, both in the forum and in the pull request.
4. A bot will automatically allow you to merge it after checking:

   * All data types match the spec.
   * No changes have been done to the pull request content in the last 48h.

   You can trigger the bot to run these checks by changing the state of the pull request back to a draft, and then to ready-to-review again.
5. The [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") multisig creates the vote on Snapshot. The vote must start with `N3GOV-ID:` (where ID is the proposal's ID) followed by the title of the proposal's discussion.
6. If the Snapshot vote passed, the [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") multisig creates the vote on Aragon.

### Proposals with critical impact

The Nation3 DAO has an Agent app instance (called *Critical Agent*) governed by a Voting app with the following voting parameters:

* **Duration**: 144h (six days).
* **Platform**: [Aragon](https://client.aragon.org/#/nation3/0xfbad11cb39f62cf5248b2d85e3fb36df99df758e/).
* **Census**: All $veNATION holders.
* **Voting weight**: Token-weighted by $veNATION balance.
* **Voting system**: Binary (yes/no).
* **Voting threshold**: >66% (supermajority) approval threshold with >20% participation rate.

Any proposal which would trigger a transaction from the *Critical Agent* app on the Nation3 DAO follows the same governance process as standard proposals, but instead of 48h for each step in the process, it's 144h (six days).

### Who can create votes

The [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") multisig has permission to create votes, both in the Nation3 space on Snapshot and the Nation3 [dao](https://docs.nation3.org/legal-system/dao "mention") on Aragon.

The Nation3 [dao](https://docs.nation3.org/legal-system/dao "mention") can request changes in the signers and signing threshold of the [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") multisig by passing a *Proclamation* proposal.

As a backup mechanism in case of [guardian-guild](https://docs.nation3.org/guilds/guardian-guild "mention") multisig malfunction, the [supreme-court](https://docs.nation3.org/legal-system/supreme-court "mention") multisig can create votes on Aragon. The Voting app installed on such DAO is configured with the exact same parameters as the *Critical Agent* app, with the exception of any $veNATION holder being able to create votes on it.