# 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.