NPM Package. Canonical Contracts

OMEGA Contracts

The canonical interoperability substrate for OMEGA protocol libraries. @omega-protocol/contracts is a small TypeScript package that defines the shared types, JSON Schemas, canonical encoding, fixtures, and conformance runner used across the OMEGA stack. It is not a runtime, router, engine, service, or implementation of any protocol's native logic. It is the substrate every implementation conforms to.

npm
Published package
8
Protocol shapes
C0-C3
Conformance levels
MIT
License

Install.

npm
npm install @omega-protocol/contracts

What's in it.

Conformance levels.

The package defines four levels of conformance, each requiring more than the previous.

LevelRequirement
C0Schema conformant. Output validates against the JSON Schemas.
C1Adapter conformant. Native fixture round-trips through the adapter, schemas validate, determinism holds, fingerprint stability holds.
C2Composition conformant. Output integrates into an OmegaRecord without massaging.
C3Integrity conformant. No adapter timestamps, derived-field provenance present, content hash reproducibility holds against the locked test vector.

Run conformance checks.

CLI
npx omega-contracts-conformance <library-path> --level C3

Locked test vector.

Composition content hash
152eab926412e397dfdd56217dad03a924bc9c138bee2ceafa2f3200c3d2c705

Every implementation claiming C3 conformance must reproduce this hash from the canonical composition fixture. If it does not, the implementation is not conformant.

Why this exists.

Before contracts, the 8 OMEGA protocol libraries were specified separately. Each one defined its own native shape. Composition required custom glue code. Different teams would solve the same composition problem differently, and the resulting records would not interoperate.

Contracts is the substrate that makes them compose. It is the thing that turns eight protocols into one stack.

Source.