Skip to main content

Entity Matrix

Every partner protocol has its own name for the things Green Goods records. This page is the translation table, one section per protocol: what that protocol calls a garden, a piece of work, an approval, or a role. A mapping is vocabulary, not a shipped integration; each section says whether code stands behind it and where its components are recorded. It is generated from the tracked ontology sidecar (packages/shared/src/ontology/green-goods-ontology.json, integration_matrix section).

Protocols at a glance​

The integration catalog (integrations in the sidecar) names the protocols Green Goods has built against, and the checked-in deployment artifacts say on which networks their components are recorded. A protocol without a catalog entry is a vocabulary mapping only.

ProtocolCode integrationNetworks with recorded componentsMapped terms
EASEASSepolia Testnet (Partial), Arbitrum One (Deployed), Celo (Partial)9
TokenboundTokenbound AccountsSepolia Testnet (Deployed), Arbitrum One (Deployed), Celo (Deployed)1
Hats ProtocolHats ProtocolSepolia Testnet (Deployed), Arbitrum One (Deployed)7
Karma GAPKarma GAPSepolia Testnet (Deployed), Arbitrum One (Deployed)9
HypercertsHypercertsSepolia Testnet (Partial), Arbitrum One (Deployed)12
OctantOctantSepolia Testnet (Deployed), Arbitrum One (Deployed)4
Gardens V2GardensSepolia Testnet (Deployed), Arbitrum One (Deployed)5
Cookie JarCookie JarSepolia Testnet (Deployed), Arbitrum One (Deployed)4
UnlockUnlock ProtocolArbitrum One (Deployed)1
ENSENSSepolia Testnet (Deployed), Arbitrum One (Deployed)2

Mappings by protocol​

Each table lists only the Green Goods terms that have an equivalent in that protocol; a term that is absent has none there. The kind says whether the Green Goods side is an entity, an attestation schema, a persona, or an integration-facing concept.

EAS​

Code integration: EAS. Recorded on: Sepolia Testnet (Partial), Arbitrum One (Deployed), Celo (Partial).

Green GoodsEASKind
GardenAttestation recipientEntity
WorkAttestation (Work Submission schema)Entity
Work ApprovalAttestation (Work Approval schema)Schema
AssessmentAttestation (Assessment schema)Entity
AttestationAttestationEntity
GardenerAttesterPersona
StewardAttesterPersona
EvaluatorAttesterPersona
Community MemberAttesterPersona

Tokenbound​

Code integration: Tokenbound Accounts. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed), Celo (Deployed).

Green GoodsTokenboundKind
GardenToken-bound account (ERC-6551)Entity

Hats Protocol​

Code integration: Hats Protocol. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsHats ProtocolKind
GardenAdmin HatEntity
HatHatEntity
GardenerGardener HatPersona
StewardSteward HatPersona
EvaluatorEvaluator HatPersona
FunderFunder HatPersona
Community MemberCommunity HatPersona

Karma GAP​

Code integration: Karma GAP. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsKarma GAPKind
GardenProjectEntity
ActionPartial Project UpdateEntity
WorkPartial Project UpdateEntity
Work ApprovalPartial Project UpdateSchema
AssessmentProject MilestoneEntity
GardenerProject MemberPersona
StewardProject AdminPersona
EvaluatorGrant EvaluatorPersona
Community MemberProject ExplorerPersona

Hypercerts​

Code integration: Hypercerts. Recorded on: Sepolia Testnet (Partial), Arbitrum One (Deployed).

Green GoodsHypercertsKind
GardenHypercert HolderEntity
ActionHypercert DataEntity
WorkHypercert DataEntity
Work ApprovalHypercert DataSchema
AssessmentHypercert DataEntity
HypercertHypercertEntity
GardenerContributorPersona
StewardCreatorPersona
EvaluatorEvaluatorPersona
FunderFunderPersona
Community MemberEvaluatorPersona
ImpactHypercert TokenConcept

Octant​

Code integration: Octant. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsOctantKind
GardenVault OwnerEntity
VaultMulti-strategy vault (ERC-4626)Entity
StewardVault AdminPersona
FunderVault DepositorPersona

Gardens V2​

Code integration: Gardens. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsGardens V2Kind
GardenCommunityEntity
GardenerCommunity MemberPersona
StewardCouncil MemberPersona
FunderCommunity FunderPersona
Community MemberCommunity MemberPersona

Code integration: Cookie Jar. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsCookie JarKind
GardenJar ownerEntity
Cookie JarJarEntity
GardenerWithdrawerPersona
FunderDepositorPersona

Unlock​

Code integration: Unlock Protocol. Recorded on: Arbitrum One (Deployed).

Green GoodsUnlockKind
BadgesLock (a badge type) and key (a badge held)Concept

ENS​

Code integration: ENS. Recorded on: Sepolia Testnet (Deployed), Arbitrum One (Deployed).

Green GoodsENSKind
GardenSubname of greengoods.ethEntity
GardenerSubname of greengoods.ethPersona

Using the matrix​

When you build against a partner protocol, read its section first so the names at the API boundary match the mapping the team already settled on. When a task or an issue speaks the partner's language (a Karma GAP "Project Milestone", for instance), translate it back through the same section: that one is a Green Goods Assessment.

Maintenance​

The mapping data lives in the ontology sidecar's integration_matrix section, and each catalog integration names its column through matrix_column. Add a column only after its source-backed implementation or specification exists, give it a catalog entry or a column note (the ontology check refuses a column with neither), then run node scripts/docs/generate.mjs --scope ontology for this page and node scripts/quality/check-ontology.mjs --generate for the reference pages. bun run check --only docs-generated fails CI whenever this page drifts from its sources.

See the full integrations overview with surface-level status for each protocol connection.