# Vision

OpenYield is a jurisdiction-light, public-good mesh for **real production**.
The vision is a covenant, not a product: the mesh holds real value, the Six
Principles are immutable, and the protocol cannot become a custodial
platform. This page is the brief overview; the full vision source lives in
`.ciagent/oy/PROJECT.md`.

## The covenant

OpenYield exists to hold **real production** — the real return of real work,
held in the Bread unit, in the three Storage Pools, attested by the Watchers,
mirrored by the Mirror. The covenant is anti-greed by construction:

- **Mission Lock** fixes the Six Principles and the fee covenant. No Council
  — Mesh, Guild, or Stand — can amend them. The coupon cap on bonds is a
  mission-locked ceiling, not a parameter.
- **Jurisdiction-light** — the bearers (OY-LR, OY-BLE, OY-WiFi-Direct, OY-SAT,
  OY-QR) let a Holder reach the mesh without a phone plan or a custodial
  on-ramp. A Holder needs only a Reach and a Stash to begin.
- **Public good** — the mesh is open to all. The Watchers attest daily; the
  Mirror mirrors the state; anyone can verify the mesh's real return without
  trusting a single custodian.

## The layers

1. **OY Chain** (Layer 1) — the canonical state: the Bread unit, the
   Storage Pools, Standing, Watcher attestations, the Pact / Council /
   Partner surface.
2. **Satellites** (Layer 2) — wrapped Bread propagates to satellite chains
   (Polygon active; Base, Arbitrum, Optimism, Solana as enum placeholders)
   via IBC.
3. **Bearers** — the surveillance-resistant transport layer: OY-LR (LoRa,
   long-range), OY-BLE (Bluetooth), OY-WiFi-Direct, OY-SAT (satellite),
   OY-QR (paper / QR code). The Mirror mirrors canonical state to them.
4. **Exits** — the Layer 3 exit layer: Holder-initiated DEX swaps and
   off-mesh service exits, with bridge routes for cross-chain exits.

## The actors

- **Holders** (Nomads) — the everyday participants, each with a Reach and a
  Stash.
- **Freeholders** — the active participants who run Stands, Guilds, and
  Councils.
- **Partners** — the four-tier spectrum (Op, MasterOp, Pier, Anchor) that
  processes Pass-Acts and provides credentials and institutional backing.
- **Watchers** — the 9 attesters with 6-of-9 quorum and 100,000 Bread bonds.

## The units

- **Bread** — the unit of real value (see [Bread scale](bread-scale.md)).
- **Standing** — the reputation layer (the four signals, Bayesian Standing).
- **Voice** — the governance input (multi-source: Stash, Standing, Vouch,
  Freeholder, Guild).
- **Coupon** — the bond-market term (capped at 8% / floored at 0%, mission-locked).

## Where to go next

- [Six Principles](six-principles.md) — the immutable covenant.
- [Storage Pools](storage-pools.md) — the three pools.
- [Watchers & Mirror](watchers-mirror.md) — the attestation layer.
- [Lexicon](lexicon.md) — why the docs say "real production" and "Holder".
- [README](../../README.md) — build & test instructions.
- `.ciagent/oy/PROJECT.md` — the full vision source.