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