/ reference / OpenVet specification

The canonical specification for OpenVet — wire formats, log structure, signature schemes, capability and generation semantics — lives in the spec/ directory of the openvet repo.

These docs deliberately do not duplicate the spec. If you find a discrepancy, treat the spec as authoritative and please open an issue.

The spec is split into:

  • Data model — the audit object, claims, criteria.
  • Log format — skipchain over a Merkle search tree; signed-commit semantics; mirroring rules.
  • Trust and capabilities — key generations, rotation, delegated signing.
  • Wire protocol — the request/response shapes for fetching log segments and appending audits.

TODO: keep this page short. If individual spec topics need a narrative companion in these docs, add a Concepts page rather than expanding this one.