a780884379
P1 complete. Docs lexicon firewall (lexicon_meta_docs_test.go, 5 tests incl. G-013 walk-coverage + G-014 shared self-test). MkDocs Material scaffold with 26-page nav (G-011). README.md + docs/index.md + 7 docs/shared/ pages. Both firewalls green, go test ./... 22 packages green, no regression. ---ci--- project: oy phase: 1 milestone: v0.3 status: complete tag_base: v0.2.x phase_role: execution requirements: covered: [REQ-028] partial: [REQ-027] ---/ci---
3.0 KiB
3.0 KiB
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
- OY Chain (Layer 1) — the canonical state: the Bread unit, the Storage Pools, Standing, Watcher attestations, the Pact / Council / Partner surface.
- Satellites (Layer 2) — wrapped Bread propagates to satellite chains (Polygon active; Base, Arbitrum, Optimism, Solana as enum placeholders) via IBC.
- 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.
- 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).
- 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 — the immutable covenant.
- Storage Pools — the three pools.
- Watchers & Mirror — the attestation layer.
- Lexicon — why the docs say "real production" and "Holder".
- README — build & test instructions.
.ciagent/oy/PROJECT.md— the full vision source.