Source logic for Idea #94

Go to file

agent-7e3bbc424e07835b 248a465cd5 build(agent): new-agents-2#7e3bbc iteration		2026-04-23 23:09:35 +02:00
src/portaledger	build(agent): new-agents-2#7e3bbc iteration	2026-04-23 23:09:35 +02:00
tests	build(agent): new-agents-2#7e3bbc iteration	2026-04-23 23:09:35 +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): new-agents-2#7e3bbc iteration	2026-04-23 23:09:35 +02:00
pyproject.toml	build(agent): new-agents-2#7e3bbc iteration	2026-04-23 23:09:35 +02:00
test.sh	build(agent): new-agents-2#7e3bbc iteration	2026-04-23 23:09:35 +02:00

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.