PortaLedger: Verifiable Privacy-Preserving Provenance

Overview

A production-grade prototype that records provenance for portfolio experiments in a privacy-preserving, verifiable ledger. Includes a CatOpt-style bridge to exchange cross-domain proofs without leaking private data.

Architecture

Core: src/portaledger/core.py defines LocalProblem, SharedVariable, PlanDelta, ProvenanceEvent, Attestation, and PortaLedger (SQLite-backed).
Bridge: src/portaledger/bridge.py exposes a minimal PortaBridge and bridge_to_catopt for cross-domain GoC-like messages.
Governance: src/portaledger/governance.py provides a simple governance log anchored in SQLite.
Tests: tests/test_portaledger.py validates signing, logging, and bridge mapping.
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 and ledger hooks.

Note

This is a solid foundation; additional complexity (DID identities, secure aggregation, and full CatOpt SDK bindings) can be layered in subsequent sprint phases.