Files

T

cloudinit-bot c7f7391774 docs(P03): complete Councils+Forex phase

---ci---
project: oy
phase: 3
milestone: v0.2
status: complete
phase_role: execution
requirements:
  covered: [REQ-011]
  partial: [REQ-009]
---/ci---

Phase 3 (Councils+Forex) complete. 2 new modules: x/council (3-kind Council, Mission Lock
const false, Voice/SignalKind/TallyResult), x/forex (ForexPair Bread/Asset labels, RateOracle
interface, 4 OracleKind). 264 tests total (207 prev + 57 new). Coverage: x/council 96.4%,
x/forex 100%. Lexicon + G-003 invariants green. Tagged v0.1.3.

2026-08-17 21:30:05 +00:00

bearers/types

feat(P07): Bearers \u0026 Processing Mesh — FCFS, 6 bearers, proximity selection

2026-08-17 20:00:56 +00:00

bloom/types

review(P09): final review + audit + lexicon fix

2026-08-17 20:02:01 +00:00

bread/types

feat(P02): Bread unit + Root Basket + Forge/Fold types

2026-08-17 19:57:56 +00:00

council/types

docs(P03): complete Councils+Forex phase

2026-08-17 21:30:05 +00:00

feecovenant/types

feat(P05): Fee Covenant — locked bounds, auto-decline, waivers

2026-08-17 19:59:40 +00:00

forex/types

docs(P03): complete Councils+Forex phase

2026-08-17 21:30:05 +00:00

forge/types

feat(P02): Bread unit + Root Basket + Forge/Fold types

2026-08-17 19:57:56 +00:00

guild/types

docs(P01): complete Orgs+Window foundation phase

2026-08-17 21:18:35 +00:00

identity/types

feat(P06): Identity/Standing — Reach, Freeholder, Bayesian formula

2026-08-17 20:00:21 +00:00

mesh/types

feat(P08): Mesh Experience — Maps, Pay, Four Faces

2026-08-17 20:01:14 +00:00

mirror/types

feat(P01): OY Chain skeleton + Watcher/Mirror/Still modules

2026-08-17 19:56:21 +00:00

pact/types

docs(P02): complete Pacts+Partners phase

2026-08-17 21:23:29 +00:00

partner/types

docs(P02): complete Pacts+Partners phase

2026-08-17 21:23:29 +00:00

processing/types

feat(P07): Bearers \u0026 Processing Mesh — FCFS, 6 bearers, proximity selection

2026-08-17 20:00:56 +00:00

rootpool/types

feat(P03): Storage substrate — Stash, Vault, Root-Pool types

2026-08-17 19:58:31 +00:00

stand/types

docs(P01): complete Orgs+Window foundation phase

2026-08-17 21:18:35 +00:00

standing/types

feat(P06): Identity/Standing — Reach, Freeholder, Bayesian formula

2026-08-17 20:00:21 +00:00

stash/types

feat(P03): Storage substrate — Stash, Vault, Root-Pool types

2026-08-17 19:58:31 +00:00

still/types

feat(P01): OY Chain skeleton + Watcher/Mirror/Still modules

2026-08-17 19:56:21 +00:00

vault/types

feat(P03): Storage substrate — Stash, Vault, Root-Pool types

2026-08-17 19:58:31 +00:00

watcher/types

feat(P01): OY Chain skeleton + Watcher/Mirror/Still modules

2026-08-17 19:56:21 +00:00

window/types

docs(P01): complete Orgs+Window foundation phase

2026-08-17 21:18:35 +00:00

README.md

feat(P01): OY Chain skeleton + Watcher/Mirror/Still modules

2026-08-17 19:56:21 +00:00

README.md

Component 1: OY Chain & Mirror — Phase 1 Skeleton

Status

v0.0.1 — skeleton with type definitions and locked-constant tests

Vision References

§7: Architecture — Three Layers and the Mirror
§3: Still/Stir (pause/resume)

Modules

x/watcher — Watcher Bond & Attestation Quorum

types.Watcher — bonded Watcher (§7: 100,000 Bread minimum bond)
types.Attestation — daily reserve snapshot signed by a Watcher
types.ReserveSnapshot — off-chain reserve state (off-chain total, on-chain Bread, basket breakdown)
types.QuorumStatus — QuorumMet / QuorumLost / StaleEpoch
types.SlashReason — InsufficientBond / StaleAttestation / GeographicCollusion / Forgery

Locked constants (§7):

MinBond = 100000 (100,000 Bread)
Quorum = 6 (6-of-9)
MaxWatchers = 9
AttestationEpochHours = 24 (daily)

x/mirror — Reserve Ratio Publication

types.NavPerBread — Net Asset Value per Bread (§4.2)
types.ReserveRatio — real-time published ratio with quorum flag

x/still — Pause/Resume (Still/Stir)

types.StillState — StirActive / StillPaused (§3)
types.StillReason — CouncilVote / QuorumLost / SecurityAlert
types.StillRecord — tracks pause events
Auto-still on quorum lost (§4.2: Forge/Fold blocked until quorum restored)

Tests

12 tests, all passing:

Watcher: MinBond, Quorum, MaxWatchers, AttestationEpoch, DefaultParams (5)
Still: DefaultStillState, AutoStillOnQuorumLost, StillStates (3)
Mirror: DefaultPublishInterval, ModuleName, NavPerBreadStruct, ReserveRatioQuorum (4)

What's NOT in this skeleton (deferred to P1 completion)

Cosmos SDK app.go full integration (requires SDK v0.50+ dependency resolution)
Keeper implementations (BondWatcher, SubmitAttestation, VerifyQuorum, SlashWatcher)
CLI commands (oyd tx watcher bond, oyd query watcher quorum)
Proto definitions (Buf-generated types)
CometBFT consensus setup
Genesis import/export

Next Steps (P1 continuation)

Resolve Cosmos SDK v0.50 dependency tree
Implement keeper logic with store operations
Add proto definitions and code generation
Wire modules into app.go
Build oyd daemon
Integration test: 9 Watchers bond, submit attestations, verify quorum