Files
openyield/docs/freeholders/partner-spectrum.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

2.2 KiB

Partner Spectrum

OpenYield defines a four-tier Partner Spectrum (REQ-018, vision §13): Op, Master Op, Pier, and Anchor. Partners are the external actors a Freeholder interacts with through the mesh — service operators, route providers, and institutional bridges. The four tiers are locked as the PartnerTier enum in x/partner (exactly 4, regression-tested).

The four tiers

  • Op — a service operator. Runs a service a Holder uses through a Window (e.g., a Maps provider). The lightest tier.
  • Master Op — a senior operator. Coordinates multiple Ops or runs a higher-trust service. "Op" is the safe short form; the full word is not used as a standalone term.
  • Pier — a routing Partner. Connects the mesh to external venues (e.g., a DEX or an off-mesh service) and sources Forex rates. Piers route; they do not custody Holder value.
  • Anchor — the first institutional Partner tier. Carries a credential (jurisdiction, custody provider, attestations). See Anchor Preview for what is coming in v0.3 P4.

How Freeholders relate to Partners

A Freeholder authorizes a Partner to act on their behalf through a scoped, time-limited, revocable Window — never by handing over custody. The Partner holds a credential, not the Holder's Stash. A Partner's Standing is visible so a Freeholder can choose an operator with a real history over a freshly-spun-up alternative (see Maps & Pay).

Partner status

Each Partner has a status (locked PartnerStatus enum in x/partner): Pending → Active, with Suspended and Revoked as the governance paths. The Mesh Council can suspend or revoke a Partner. The four tiers and the status enum are unchanged by v0.3 — v0.3 only extends x/partner with the Anchor credential shape (REQ-023), not a new tier.

See Storage Pools for why the mesh says "Holder" and "Reach" rather than the legacy custodial words, and Bonds for the coupon market a Partner may route to.