82ae6cf5a2
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---
64 lines
3.0 KiB
Markdown
64 lines
3.0 KiB
Markdown
# 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. |