lakestream
Specification

Metadata

How stream metadata and offsets are laid out in Oxia.

This page will describe how Lakestream lays out stream metadata and offset state in Oxia. It matters because the key namespace and transaction model are what let multiple writers and compactors coordinate safely, keeping catalog state, offsets, and compaction bookkeeping consistent under concurrent access.

Planned coverage

  • Oxia key namespaces for stream and offset metadata
  • Multi-key transactions and the guarantees they provide
  • Versioning of metadata records

Source material

Documented in the ursa-storage repo, at project-docs/metadata-storage-spec.md.