Files

T

cloudinit-bot d09c6132b1 docs(P02): complete nomads docs phase

P2 complete. 8 docs/nomads/ pages: index, reach, stash, bearers, maps-pay,
pacts, standing, window. Docs firewall green (scans new nomads pages),
no regression. All pages cross-reference docs/shared/.

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

2026-08-17 22:14:53 +00:00

2.1 KiB

Raw Blame History

Stash

A Stash is a Holder's personal Storage Pool (REQ-014). It is the place a Nomad holds Bread, and it is the second thing a Nomad needs after a Reach to begin. The Stash is the unit of self-service: the Holder owns it, controls it, and can delegate a scoped, time-limited, revocable Window to a partner or a service without giving up custody.

What a Stash is

The Stash is the Holder-level layer of the three Storage Pools (Stash, Vault, Root-Pool). It is a storage layer, not a custodial position: the protocol holds the canonical state that records who owns what; the Holder holds the value. There is no custodian between a Nomad and their Stash.

How a Nomad uses a Stash

A Nomad moves Bread into a Stash through the bearers — a Holder on a surveillance-resistant bearer can receive value without an internet connection to OY Chain. From the Stash a Nomad can:

Hold Bread (the unit of value — see Bread scale).
Pass value to another Reach (the Hand-Pass, free at the protocol level inside a Guild).
Pay for a service via Maps & Pay.
Authorize a Window so a partner or service can read the Stash within bounds the Holder set.

The 90-day Freeholder signal

Holding a Stash continuously for 90 days is the first of the four Freeholder signals (REQ-005). The Stash does not need to hold a large amount — the signal is about continuity, not size. A Nomad who keeps a Stash for 90 days and earns the other three signals (Standing, Capital, Vouch) becomes a Freeholder.

Delegation, not custody

The Stash stays the Holder's. When a Nomad opens a Window to a service, the service gets a scoped capability (e.g., "read Stash balance for the next hour", "spend up to N Grain on this service this week") — it does not get custody. The Window is revocable, rate-limited, and audited. See Window for the primitive.

See Storage Pools for the full three-pool model, and Bearers for how value reaches a Stash over a surveillance-resistant bearer.

2.1 KiB Raw Blame History