Skip to content

feat(vindex): add top-level Engine API and read-path stress tests - #193

Merged
mhutchinson merged 1 commit into
transparency-dev:mainfrom
mhutchinson:vindex/engine
Nov 17, 2026
Merged

mhutchinson merged 1 commit into
transparency-dev:mainfrom
mhutchinson:vindex/engine

Conversation

@mhutchinson

@mhutchinson mhutchinson commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds the top-level embeddable vindex package (Engine, StorageConfig, and functional Options) and concurrent read-path stress tests:

  • vindex (vindex.go, vindex_test.go):
    • Idiomatic functional-options API: New(storage StorageConfig, outSigner note.Signer, opts ...Option) makes required persistence paths and the Output Log signer explicit in the type signature while separating optional subsystems (WithInputLog, WithUnverifiedInputLog, WithInputOrigin, WithStaticCT, WithFrom, WithOutputWitnessPolicy, WithOutputWitnesses, WithServing, WithTuning).
    • Keeps HTTP socket binding out of the library (Engine exposes Handler() and AdminHandler() directly, while callers retain ownership of *WASMHost).
    • Validates storage paths, URLs, signer/origin consistency, and witness/checkpoint policies upfront before creating directories on disk, and serializes Start, Run, SyncOnce, and Close transitions cleanly.
  • vindex/client (read_path_stress_test.go):
    • Exercises concurrent key/prefix/non-inclusion reads and multi-page /values continuation folding while background ingestion and Output Log checkpoints advance.

@mhutchinson
mhutchinson merged commit eb4ea4f into transparency-dev:main Nov 17, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants