Files
openyield/docs/shared/vision.md
T
cloudinit-bot 82ae6cf5a2 docs(milestone): complete OpenYield v0.3 (Bearers & Documentation)
Milestone v0.3 complete. Feature type, tags v0.2.x. Two work-streams
shipped under one feature milestone:

(A) Bearers skeleton + tests (D-020 pattern, 7 x/* packages, zero ext deps):
- x/bridge (NEW): BridgeStatus enum (4), BridgeRoute by-ID-string refs
- x/exit (NEW): ExitStatus enum (5), ExitRoute, DEXSwap (opaque venue)
- x/bearers (EXT): OYSATLink surveillance-resistant LOCKED, OYQRCode idempotent
- x/partner (EXT): AnchorCredential (custody-provider-id empty in skeleton)
- x/hub (NEW): HubService enum (3), LendingCouponCapBps=800 LOCAL const (A-304)
- x/services (NEW): ServiceKind enum (4), window-id by-ID-string ref (A-307)
- x/bond (EXT): GrowthBond, ClampGrowth G-012 underflow guard, secondary market
All packages >=93.3% coverage. Both lexicon firewalls green. G-003 intact.

(B) Documentation deliverable (REQ-027 complete, 26-page MkDocs Material site):
- README.md + mkdocs.yml + docs/index.md
- docs/shared/ (7 pages): Six Principles, Bread Scale, Storage Pools, Watchers/Mirror, Lexicon, Vision
- docs/nomads/ (8 pages): Reach, Stash, Bearers, Maps-Pay, Pacts, Standing, Window
- docs/freeholders/ (8 pages): Signals, Standing, Stands-Guilds, Councils-Voice, Bonds, Partner Spectrum, Anchor Preview
- docs/reference/ (2 pages): Architecture, Components
- REQ-028: lexicon firewall extended to docs/ + README.md (lexicon_meta_docs_test.go, 5 tests incl G-013 walk-coverage + G-014 shared self-test)

Phases: P0 -> v0.2.0, P1 -> v0.2.1, P2 -> v0.2.2, P3 -> v0.2.3, P4 -> v0.2.4, P5 -> v0.2.5, P6 -> v0.2.6 (milestone release).

Requirements covered: REQ-010, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026 (skeleton), REQ-027, REQ-028 (complete).
IDEATE-01..08 ratified and delivered.

---ci---
project: oy
phase: 6
milestone: v0.3
status: complete
tag_base: v0.2.x
phase_role: final
milestone_complete: true
requirements:
  covered: [REQ-010, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026, REQ-027, REQ-028]
  partial: []
---/ci---
2026-08-17 22:35:36 +00:00

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

  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).
  • 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