open-standards/smart-byte/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

44 lines
2 KiB
Text

{
"@context": {
"@version": 1.1,
"sb": "https://byte.transaction.science/vocab/v1#",
"xsd": "http://www.w3.org/2001/XMLSchema#",
"prov": "http://www.w3.org/ns/prov#",
"Byte": "sb:Byte",
"Envelope": "sb:Envelope",
"Issuer": "sb:Issuer",
"Holder": "sb:Holder",
"Cargo": "sb:Cargo",
"LockstepEvent": "sb:LockstepEvent",
"Receipt": "sb:Receipt",
"Cluster": "sb:Cluster",
"AID": "sb:AID",
"issuer": { "@id": "sb:issuer", "@type": "@id" },
"holder": { "@id": "sb:holder", "@type": "@id" },
"content_hash": { "@id": "sb:contentHash", "@type": "xsd:string" },
"previous_hash": { "@id": "sb:previousHash", "@type": "xsd:string" },
"cargo": { "@id": "sb:cargo", "@type": "xsd:string" },
"cargo_class": { "@id": "sb:cargoClass", "@type": "@vocab" },
"joules_uj": { "@id": "sb:joulesMicrojoules","@type": "xsd:nonNegativeInteger" },
"energy_provenance": { "@id": "sb:energyProvenance","@type": "@vocab" },
"issued_at": { "@id": "sb:issuedAt", "@type": "xsd:dateTime" },
"sequence": { "@id": "sb:sequence", "@type": "xsd:nonNegativeInteger" },
"lockstep_height": { "@id": "sb:lockstepHeight", "@type": "xsd:nonNegativeInteger" },
"aid": { "@id": "sb:aid", "@type": "xsd:string" },
"signature": { "@id": "sb:signature", "@type": "xsd:string" },
"rotated_at": { "@id": "sb:rotatedAt", "@type": "xsd:dateTime" },
"schema_id": { "@id": "sb:schemaId", "@type": "xsd:string" },
"Value": "sb:Value",
"Coding": "sb:Coding",
"Identity": "sb:Identity",
"Telemetry": "sb:Telemetry",
"Custom": "sb:Custom",
"HwShunt": "sb:HwShunt",
"ModelBased": "sb:ModelBased",
"Estimator": "sb:Estimator"
}
}