Skip to content

aigovops_lantern.bundle

Receipt-bundle loading, validation, and iteration helpers.

Bundle loader.

A Lantern "bundle" is one of:

  1. A path to an NDJSON file of AIGovOps Beacon receipts (the aigovops-beacon.v1 profile of the OVERT 1.0 receipt envelope).
  2. A path to a JSON file containing a list of such receipts.
  3. A directory containing either of the above files (auto-detected).

Lantern is read-only by construction. It validates structure for parsing purposes only — it never re-signs and never asserts attestation. Signature verification is Beacon's job; if a caller needs cryptographic assurance, run beacon verify first and feed the verified output here.

BundleError

Bases: ValueError

A bundle could not be loaded or parsed.

Receipt dataclass

A single Beacon receipt, as Lantern reads it.

This is intentionally a thin wrapper around the parsed dict. Beacon owns the canonical schema; Lantern only requires enough structure to render a human-readable view.

is_signed property

Whether the receipt carries a signature envelope.

Lantern reports the presence of a signature; it does not attempt to verify it. Use Beacon for cryptographic verification.

Bundle dataclass

A collection of Beacon receipts loaded from disk.

load(source)

Load a bundle from a file or directory path.

Recognized inputs
  • *.ndjson / *.jsonl — newline-delimited Beacon receipts
  • *.json — single JSON array of Beacon receipts
  • a directory containing exactly one of the above