PortaLedger: Verifiable Privacy-Preserving Provenance

Overview

A compact, testable Python package for recording portfolio experiment provenance with cryptographic attestation, SQLite-backed audit storage, and a CatOpt-style bridge for canonical Graph-of-Contracts payloads.

Architecture

Core: src/portaledger/core.py defines LocalProblem, SharedVariable, PlanDelta, ProvenanceEvent, Attestation, ProvenanceRecord, and PortaLedger (SQLite-backed).
Bridge: src/portaledger/bridge.py exposes PortaBridge, bridge_to_catopt, PrivacyBudget, and PolicyBlock for GoC-like messages.
Governance: src/portaledger/governance.py provides a versioned policy registry and tamper-evident governance log anchored in SQLite.
Tests: tests/test_portaledger.py validates signing, verification, querying, bridge mapping, and governance versioning.
Packaging: pyproject.toml, README.md, and test.sh to build and test.

Usage

Run tests: ./test.sh
The Python package is published as portaledger (0.1.0) with a production-like API surface for core data types, bridge helpers, and governance hooks.

Note

This implementation already supports attested deltas, queryable provenance history, structured bridge payloads, and versioned governance records.