# Governor

> ⚠️ **Experimental — generated with no human supervision** by the daily MCP pipeline (Solidity→Gno port). Not audited. See [r/moul/x/daily](https://github.com/moul/gno-contracts/blob/main/r/moul/x/daily/README.md).

---


A simplified on-chain governance realm inspired by OpenZeppelin's `Governor`.
It ports the core proposal → vote → execute lifecycle to Gno: `Propose` records
a proposal's snapshot height and a deadline of `ChainHeight() + votingPeriod`,
`CastVote` gives every address a single equally-weighted vote (1 address = 1
vote, tracked in an avl voter set), and `State` computes `Active` / `Succeeded`
/ `Defeated` from the deadline versus the current chain height plus whether the
`for` tally beats `against`. `Execute` finalizes a `Succeeded` proposal.

Unlike the ERC20Votes-weighted original, voting power here is flat (one address,
one vote) and there is no timelock — the emphasis is on a clean, deterministic
state machine driven by block height.

## Example calls

```
# open a proposal (returns its id)
Propose("Fund the docs working group for Q3")

# vote: 0=against, 1=for, 2=abstain (one vote per address)
CastVote(1, 1)

# read the current state: Active | Succeeded | Defeated | Executed
State(1)

# once past the deadline with for > against, finalize it
Execute(1)
```

`Render("")` lists every proposal with its tally bars (`▓░`) and state.

## What changed in v1

State moved from a hand-rolled `avl.Tree` + `nextID` + zero-padding helper to
[`p/moul/kit/store`](/p/moul/kit/store/v0), which keys entries by
[`seqid`](/p/nt/seqid/v0) instead of a fixed-width decimal string.

v0 padded ids to width 12. Past that width the padding stops and the tree
orders `"1000000000000"` before `"999999999999"`, so every list this realm
renders would be wrong from that entry on. `store` keys are 8 big-endian bytes
whose order is numeric for every `uint64`, so there is no width left to outgrow.

`Proposal` loses its `ID` field, which the store now owns, and the local
`mustGet` becomes one line: the store's labelled `MustGet` panics
`governor: proposal #7 not found`, the same information `v0` assembled by hand.
The `totalCount` counter is gone too: with no deletion, the highest id ever
assigned is the count, so `LastID()` answers it. Each proposal keeps its own
address-keyed `votes` tree, which the store does not cover. Proposal ids
already started at 1, so nothing shifts.

This is a storage change, which under this repo's versioning rule is a
compatibility change, hence a new version rather than an edit in place.
[`v0`](https://github.com/moul/gno-contracts/tree/4f2df83869b80470eb81c48a82fdbe82256b8113/r/moul/x/daily/governor) stays live and untouched.

<!-- BEGIN GNOCONTRACTS FOOTER (generated by `make readmes`; do not edit below) -->

---

Part of **[moul/gno-contracts](https://github.com/moul/gno-contracts)** — moul's versioned gno.land contracts. See the repository for the full catalog, build/test tooling, and usage.

**Dependency graph:**

![gno.land/r/moul/x/daily/governor/v1 dependency graph](https://raw.githubusercontent.com/moul/gno-contracts/main/_assets/gno.land/r/moul/x/daily/governor/v1/deps.png)

> 🧪 **Highly experimental — potentially vibe-coded.** Not audited; may break, change, or be removed at any time. Do not use with anything of value. Full disclaimer: [DISCLAIMER](https://github.com/moul/gno-contracts/blob/main/DISCLAIMER.md).

<!-- END GNOCONTRACTS FOOTER -->