Files

T

cloudinit-bot 2ef3f2e39f docs(P03): complete freeholders docs + reference phase — REQ-027 complete

P3 complete. 8 docs/freeholders/ pages (signals, standing, stands-guilds,
councils-voice, bonds, partner-spectrum, anchor-preview, index) + 2
docs/reference/ pages (architecture, components). Docs firewall green
across all 26 docs pages. Full docs deliverable (README + mkdocs.yml +
26-page site) complete — REQ-027 complete.

---ci---
project: oy
phase: 3
milestone: v0.3
status: complete
tag_base: v0.2.x
phase_role: execution
requirements:
  covered: [REQ-027]
  partial: []
---/ci---

2026-08-17 22:17:07 +00:00

2.3 KiB

Raw Blame History

Councils & Voice

OpenYield governs itself through three Councils (REQ-011, vision §19): the Mesh Council, the Guild Council, and the Stand Council. Each Freeholder participates through the Councils, weighted by Voice — a multi-source weight that combines Stash, Standing, Vouch, Freeholder status, and Guild membership. The Mission Lock makes the covenant non-amendable: no Council can vote to change the Six Principles or the fee covenant.

The three Councils

Mesh Council — the mesh-wide Council. Handles protocol-level proposals that affect every Holder and every Stand.
Guild Council — the Council for Guilds. Handles Guild-scope proposals, referenced by guild-id.
Stand Council — the Council for a single Stand, referenced by stand-id. Handles Stand-scope proposals (e.g., Vault use, Bond issuance).

The three-tier shape mirrors the three Storage Pools: a Council exists at each layer where custody is held.

Multi-source Voice

Voice is not one number. It is a weighted tally from five sources (locked as the VoiceSource enum in x/council): Stash, Standing, Vouch, Freeholder, and Guild. A Freeholder with high Standing and a long-held Stash carries more Voice than a freshly-minted one. The TallyResult mirrors the Cosmos SDK x/gov shape so the governance layer can wire to standard tooling. The VoteOption enum is Yes / No / Abstain — there is no "no-with-veto", an anti-greed design choice.

Mission Lock

The Mission Lock is a locked const bool in x/council (MissionLockAmendable = false). The Six Principles, the fee covenant (ceiling 0.1% / floor 0.01% / 1-Grain minimum), and the bond coupon cap (8% / 0%) cannot be amended by any Council vote. This is the firewall that keeps the mesh a public good: governance can act within the covenant, never on the covenant.

How a Freeholder participates

A Freeholder submits or votes on proposals in the Councils they belong to. Each vote is weighted by multi-source Voice; the tally follows x/gov semantics. See Bonds for the coupon cap the Mission Lock protects, and Standing for the metric that weights a Freeholder's Voice.

2.3 KiB Raw Blame History