open-standards/eoc/vocab/v1.jsonld
Transaction Science 2354fd9a96 vocab v1 across sister standards: arl + openpay + smart-byte + eoc + wai + joule-code (wave-23 #3)
Carries the third-generation-interop pattern shipped at
jouleclaw/vocab/v1 across every TX Science open standard. Every
sister standard now has a stable IRI for every wire field of
every major data type, plus a Turtle ontology covering classes,
enumerations, and properties.

What ships, per standard:

  arl/vocab/         Claim, Session, Evaluation, Attestation;
                     the four axes (Validation Depth 1–9,
                     Convergence A–E, EnergyProfile, S0–S4);
                     ARL-S isolation tiers 0–3.

  openpay/vocab/     Money, Currency, PaymentMethod, Receipt,
                     Refund, Dispute; the five rails (FedNow / PIX
                     / SEPA Instant / USDC / USDT); the four card
                     schemes; the seven lifecycle states.

  smart-byte/vocab/  Byte, Envelope, Issuer, Holder, KERI AID,
                     LockstepEvent; the cargo-class taxonomy
                     (Value / Coding / Identity / Telemetry /
                     Custom) and the shared HwShunt / ModelBased /
                     Estimator energy-provenance enum.

  eoc/vocab/         Query, Resolution, EOC Receipt, the four
                     cascade stages (Cache / KeyValue / Graph /
                     Neural), CarbonRecord, VendorAPI binding.

  wai/vocab/         Manifest, Capability, Codec; the two paths
                     (NeuralPath shared-prior + ZerothPath
                     registered codec menu); the six modalities;
                     the nine codecs in the v1 menu.

  joule-code/vocab/  README.md complements the LEXICON.md / v1.jsonld
                     / v1.ttl already shipped in b838b86.

Every JSON-LD `@context` pairs with a Turtle ontology. Every
ontology subclasses W3C PROV-O where the alignment is exact
(prov:Activity for sessions / resolutions / lockstep events,
prov:Entity for source trees, prov:Agent for issuers / agents).

Pattern is identical to jouleclaw/vocab/v1 so a downstream
consumer that already loads one vocabulary picks up the others
with no new code: same namespace shape, same JSON-LD context
binding, same Turtle conventions.

Standards documents stay unchanged on the wire: vocabularies are
optional additions, not modifications. A receipt or claim that
doesn't carry `@context` deserialises exactly as before; one that
does gains typed RDF semantics for free.

Licences match each standard's spec text — CC-BY-4.0 for ARL,
Smart Byte, EOC, joule-code; Apache-2.0 for OpenPay, WAI.

Deploy follow-up: extending the Caddyfile @-blocks of arl /
openpay / byte / eoc / wai / joulecode sites to serve `.jsonld`
files as `application/ld+json` is a separate small change. Until
then the vocab is reachable via the GitHub raw URL.
2026-06-02 14:16:58 -04:00

37 lines
1.6 KiB
Text

{
"@context": {
"@version": 1.1,
"eoc": "https://eoc.transaction.science/vocab/v1#",
"xsd": "http://www.w3.org/2001/XMLSchema#",
"prov": "http://www.w3.org/ns/prov#",
"Query": "eoc:Query",
"Resolution": "eoc:Resolution",
"Stage": "eoc:Stage",
"Receipt": "eoc:Receipt",
"CarbonRecord": "eoc:CarbonRecord",
"VendorAPI": "eoc:VendorAPI",
"stage_closed": { "@id": "eoc:stageClosed", "@type": "@vocab" },
"joules_uj": { "@id": "eoc:joulesMicrojoules","@type": "xsd:nonNegativeInteger" },
"energy_provenance": { "@id": "eoc:energyProvenance", "@type": "@vocab" },
"carbon_grams": { "@id": "eoc:carbonGrams", "@type": "xsd:double" },
"embedding_id": { "@id": "eoc:embeddingId", "@type": "xsd:string" },
"vendor_id": { "@id": "eoc:vendorId", "@type": "xsd:string" },
"model_id": { "@id": "eoc:modelId", "@type": "xsd:string" },
"query_text": { "@id": "eoc:queryText", "@type": "xsd:string" },
"input_hash": { "@id": "eoc:inputHash", "@type": "xsd:string" },
"output_hash": { "@id": "eoc:outputHash", "@type": "xsd:string" },
"closed_at": { "@id": "eoc:closedAt", "@type": "xsd:dateTime" },
"schema_id": { "@id": "eoc:schemaId", "@type": "xsd:string" },
"Cache": "eoc:Cache",
"KeyValue": "eoc:KeyValue",
"Graph": "eoc:Graph",
"Neural": "eoc:Neural",
"HwShunt": "eoc:HwShunt",
"ModelBased": "eoc:ModelBased",
"Estimator": "eoc:Estimator"
}
}