Glossary

The ontology owns domain entities, personas, and supporting terms. Capability projections keep current availability separate from meaning, while the vocabulary policy records language that Green Goods does not use.

The ontology currently declares 21 canonical concepts. Availability is projected separately and does not change what a term means.

Domain Entities

Term	Type	Availability	Allowed surfaces	Definition
Garden	entity	available	admin · client · agent · public · docs	A community of gardeners rooted in a place, represented on-chain as an ERC-721 garden token whose ERC-6551 token-bound account holds the garden's treasury, role Hats, and metadata.
Action	entity	available	admin · client · agent · public · docs	A documented activity a gardener can perform — the unit of work template (e.g. "Plant native species", "Remove invasive growth").
Work	entity	available	admin · client · agent · public · docs	One documented instance of an Action performed by a gardener — media, notes, and metadata submitted as an EAS Work attestation for steward review; approval records a separate Work Approval attestation.
Work Approval	entity	available	admin · client · public · docs	The separate EAS attestation in which a garden steward records approval or rejection of a submitted Work, with feedback, confidence, and verification method. The Work record already exists; this decision never creates it.
Assessment	entity	available	admin · client · public · docs	An up-front baseline and strategy for a garden — domain, diagnosis, SMART outcome targets, selected Actions, reporting period — authored by an evaluator or steward before work begins, mirrored to a Karma GAP milestone when that module is active; explicitly not a review of submitted Work (that is Work Approval).
Hypercert	entity	in-build	admin · client · public · docs	An on-chain claim of impact bundling approved Work into a fractional impact certificate. Funders hold fractions; gardeners hold contribution credit.
Vault	entity	available	admin · client · public · docs	The garden's treasury. Funders deposit; the garden's Tokenbound Account holds; yield splits flow to stewards / gardeners / community per configured ratios.
Cookie Jar	entity	available	admin · client · public · docs	A garden-scoped emergency or discretionary fund with rate-limited withdrawals. Allowlisted members can claim within the configured cap.
Attestation	entity	available	admin · client · public · docs	An EAS (Ethereum Attestation Service) record. Used for Work submissions, Assessment outcomes, and other off-chain-verifiable claims.
Hat	entity	available	admin · client · public · docs	A Hats Protocol role token. Determines on-chain authority — steward hats can approve Work; gardener hats can submit Work; evaluator hats can attest.
Season	entity	planned	admin · client · agent · public · docs	A bounded period (typically a quarter) during which a garden runs a coordinated set of Actions and Assessments. Pacing primitive — never a countdown.
Need	entity	planned	community · admin · client · public · docs	A community-authored statement of a place-based problem paired with a desired outcome. A Need can gather signals, moderation, linked commitments, and verified funding attribution without becoming a commitment or payment itself.
Commitment Pool	entity	available	admin · client · docs	A garden-anchored (or protocol root-garden) pool that registers, curates, and reconciles commitments under a charter.
Commitment Cycle	entity	deployed-not-available	admin · client · docs	A bounded run of a pool — a Season or Campaign — seeded with timing and an immutable six-role allocation snapshot at open.
Commitment Series	entity	deployed-not-available	admin · client · docs	The internal durable, pool-scoped identity for one Offer used over time. It groups ordinary Offer instances without creating obligations automatically, merging history across pools, or becoming a separate product noun.
Commitment Provider Exposure	entity	deployed-not-available	admin · client · docs	The current count of open commitments held by one accountable lead provider in one pool, derived only from self-describing register unit events.
Commitment Unit Summary	entity	deployed-not-available	admin · client · docs	Exact-label pool or cycle totals for expected, approved, fulfilled, and open commitment units; unlike label hashes are never combined.
Commitment Series Cycle Summary	entity	deployed-not-available	admin · client · docs	Current lifecycle counts for the instances of one commitment series within one cycle.
Commitment	entity	deployed-not-available	admin · client · community · docs	A module-native promise record (offer or request) with one accountable lead, an optional contributor roster, repeatable action requirements, direction-aware confirmation, unit accounting in a non-transferable register, and evidence/work linkage — deliberately not an EAS attestation.
Commitment Contributor	entity	deployed-not-available	admin · client · community · docs	A person on a commitment's roster whose approved Work or confirmed evidence can earn Hypercert recognition and a contributor payout; one roster member is the accountable lead.
Commitment Payout Plan	entity	deployed-not-available	admin · client · docs	A garden-managed split of a fulfilled commitment's declared support into an explicit garden-retained amount and contributor child payouts. Its complete recognition vector is hash-bound, payment weights derive from amounts, and explicit finalization freezes it before dispatch.

Personas

Term	Type	Allowed surfaces	Definition
Gardener	persona	admin · client · agent · public · docs	A person doing regenerative Work in a garden. Submits Work, holds gardener Hats, receives credit toward Hypercerts and yield splits.
Steward	persona	admin · client · agent · public · docs	A person who stewards a garden — creates Actions, approves Work, configures Vault and Hat hierarchy. Holds the garden's steward Hats (the deployed Operator role).
Evaluator	persona	admin · client · public · docs	A person who authors or strengthens Assessments and attests impact methodology or outcomes. Evaluators do not approve or reject submitted Work; that authority belongs to Stewards.
Funder	persona	admin · client · public · docs	A person or org who deposits into a garden's Vault, holds Hypercert fractions, receives yield distributions per configured splits.
Community Member	persona	client · public · docs	A local resident affected by a Garden's Work. Signals or attests that Work exists and is healthy, and helps prioritize future Actions through public signal and conviction flows.

The canonical machine ordering is the Capital enum: Social (0), Material (1), Financial (2), Living (3), Intellectual (4), Experiential (5), Spiritual (6), Cultural (7).

Term Reference

Garden

A community of gardeners rooted in a place, represented on-chain as an ERC-721 garden token whose ERC-6551 token-bound account holds the garden's treasury, role Hats, and metadata.

Availability: available.

Action

A documented activity a gardener can perform — the unit of work template (e.g. "Plant native species", "Remove invasive growth").

Availability: available.

Work

One documented instance of an Action performed by a gardener — media, notes, and metadata submitted as an EAS Work attestation for steward review; approval records a separate Work Approval attestation.

Availability: available.

Work Approval

The separate EAS attestation in which a garden steward records approval or rejection of a submitted Work, with feedback, confidence, and verification method. The Work record already exists; this decision never creates it.

Availability: available.

Assessment

An up-front baseline and strategy for a garden — domain, diagnosis, SMART outcome targets, selected Actions, reporting period — authored by an evaluator or steward before work begins, mirrored to a Karma GAP milestone when that module is active; explicitly not a review of submitted Work (that is Work Approval).

Availability: available.

Hypercert

An on-chain claim of impact bundling approved Work into a fractional impact certificate. Funders hold fractions; gardeners hold contribution credit.

Availability: in-build.

Vault

The garden's treasury. Funders deposit; the garden's Tokenbound Account holds; yield splits flow to stewards / gardeners / community per configured ratios.

Availability: available.

A garden-scoped emergency or discretionary fund with rate-limited withdrawals. Allowlisted members can claim within the configured cap.

Availability: available.

Attestation

An EAS (Ethereum Attestation Service) record. Used for Work submissions, Assessment outcomes, and other off-chain-verifiable claims.

Availability: available.

Hat

A Hats Protocol role token. Determines on-chain authority — steward hats can approve Work; gardener hats can submit Work; evaluator hats can attest.

Availability: available.

Season

A bounded period (typically a quarter) during which a garden runs a coordinated set of Actions and Assessments. Pacing primitive — never a countdown.

Availability: planned.

Need

A community-authored statement of a place-based problem paired with a desired outcome. A Need can gather signals, moderation, linked commitments, and verified funding attribution without becoming a commitment or payment itself.

Availability: planned.

Commitment Pool

A garden-anchored (or protocol root-garden) pool that registers, curates, and reconciles commitments under a charter.

Availability: available.

Commitment Cycle

A bounded run of a pool — a Season or Campaign — seeded with timing and an immutable six-role allocation snapshot at open.