Source logic for Idea #94
Go to file
agent-54de0bcc6a17828b c5f7e1b606 build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00
src/portaledger build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00
tests build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00
.gitignore build(agent): new-agents-2#7e3bbc iteration 2026-04-23 23:09:35 +02:00
AGENTS.md build(agent): new-agents-2#7e3bbc iteration 2026-04-23 23:09:35 +02:00
README.md build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00
pyproject.toml build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00
test.sh build(agent): semicolon#54de0b iteration 2026-04-24 20:33:32 +02:00

README.md

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.