jhcontext 0.2.0__tar.gz

jhcontext-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,113 @@
+name: Build and Publish Python package
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'                # tags like v0.1.0 will trigger publish -> PyPI
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: 'target repository (testpypi or pypi)'
+        required: true
+        default: 'testpypi'
+
+jobs:
+  build:
+    name: Run tests & build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install build/test deps
+        run: |
+          python -m pip install --upgrade pip build wheel pytest
+
+      - name: Run tests
+        run: |
+          pytest -q || true   # keep build job non-fatal if you use tests later
+
+      - name: Build distributions
+        run: |
+          python -m build --sdist --wheel
+
+      - name: Upload artifact (for later jobs)
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-artifacts
+          path: dist/*
+
+  publish:
+    name: Publish to PyPI / TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download built artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-artifacts
+          path: dist
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install upload tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Determine target repository and token
+        id: repoinfo
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            REPO="${{ github.event.inputs.repository }}"
+          else
+            # if triggered by tag push, default to pypi
+            REPO="pypi"
+          fi
+          echo "repository=${REPO}" >> $GITHUB_OUTPUT
+          if [ "${REPO}" = "testpypi" ]; then
+            echo "url=https://test.pypi.org/legacy/" >> $GITHUB_OUTPUT
+            echo "token_secret=TEST_PYPI_API_TOKEN" >> $GITHUB_OUTPUT
+          else
+            echo "url=https://upload.pypi.org/legacy/" >> $GITHUB_OUTPUT
+            echo "token_secret=PYPI_API_TOKEN" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to chosen PyPI
+        env:
+          REPO_URL: ${{ steps.repoinfo.outputs.url }}
+        run: |
+          # choose token from secrets
+          if [ "${{ steps.repoinfo.outputs.token_secret }}" = "TEST_PYPI_API_TOKEN" ]; then
+            TOKEN="${{ secrets.TEST_PYPI_API_TOKEN }}"
+          else
+            TOKEN="${{ secrets.PYPI_API_TOKEN }}"
+          fi
+
+          if [ -z "$TOKEN" ]; then
+            echo "ERROR: API token secret not found. Create repository secret named TEST_PYPI_API_TOKEN or PYPI_API_TOKEN."
+            exit 1
+          fi
+
+          # upload using twine to the selected repository URL
+          python -m twine upload --repository-url "$REPO_URL" -u __token__ -p "$TOKEN" dist/*
+
+      - name: Show success
+        run: echo "Published to ${{ steps.repoinfo.outputs.repository }} (if no errors above)."

jhcontext-0.2.0/LICENSE

@@ -0,0 +1,3 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/

jhcontext-0.2.0/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.4
+Name: jhcontext
+Version: 0.2.0
+Summary: PAC-AI: Protocol for Auditable Context in AI — Python SDK
+Project-URL: Repository, https://github.com/jhdarosa/jhcontext
+Project-URL: Documentation, https://github.com/jhdarosa/jhcontext#readme
+Project-URL: Protocol Spec, https://github.com/jhdarosa/jhcontext-protocol
+Author-email: jh <jh@jhcontext.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: ai-act,auditability,context-management,multi-agent,provenance,w3c-prov
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: rdflib>=7.0
+Provides-Extra: all
+Requires-Dist: aiosqlite>=0.20; extra == 'all'
+Requires-Dist: crewai-tools>=1.9; extra == 'all'
+Requires-Dist: crewai>=1.9; extra == 'all'
+Requires-Dist: cryptography>=44.0; extra == 'all'
+Requires-Dist: fastapi>=0.115; extra == 'all'
+Requires-Dist: mcp>=1.0; extra == 'all'
+Requires-Dist: uvicorn>=0.34; extra == 'all'
+Provides-Extra: crewai
+Requires-Dist: crewai-tools>=1.9; extra == 'crewai'
+Requires-Dist: crewai>=1.9; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: aiosqlite>=0.20; extra == 'server'
+Requires-Dist: cryptography>=44.0; extra == 'server'
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: mcp>=1.0; extra == 'server'
+Requires-Dist: uvicorn>=0.34; extra == 'server'
+Description-Content-Type: text/markdown
+
+# jhcontext SDK
+
+**PAC-AI: Protocol for Auditable Context in AI** — Python SDK v0.2.0
+
+A Python toolkit for building, signing, auditing, and serving AI context envelopes compliant with the PAC-AI protocol. Designed for EU AI Act compliance scenarios including temporal oversight (Art. 14) and negative proof (Art. 13).
+
+## Install
+
+```bash
+# Core: models, builder, PROV, audit, crypto
+pip install jhcontext
+
+# With server (FastAPI + MCP + SQLite)
+pip install "jhcontext[server]"
+
+# With CrewAI integration
+pip install "jhcontext[crewai]"
+
+# Everything
+pip install "jhcontext[all]"
+
+# Development (adds pytest)
+pip install "jhcontext[all,dev]"
+```
+
+## Architecture
+
+```
+jhcontext/
+├── models.py          # Pydantic v2 data models (Envelope, Artifact, Decision, ...)
+├── builder.py         # EnvelopeBuilder — fluent API for constructing envelopes
+├── prov.py            # PROVGraph — W3C PROV graph builder (rdflib)
+├── audit.py           # Compliance verification (temporal oversight, negative proof, isolation)
+├── crypto.py          # SHA-256 hashing, Ed25519 signing (HMAC fallback)
+├── canonicalize.py    # Deterministic JSON serialization
+├── semantics.py       # UserML semantic payload helpers
+├── cli.py             # CLI: jhcontext serve | mcp | version
+├── client/
+│   └── api_client.py  # REST client (httpx)
+└── server/
+    ├── app.py          # FastAPI app factory
+    ├── mcp_server.py   # MCP server (stdio transport)
+    ├── routes/         # REST API routes (envelopes, artifacts, decisions, provenance, compliance)
+    └── storage/
+        └── sqlite.py   # SQLite backend (zero-config, ~/.jhcontext/)
+```
+
+## Quick Start
+
+### Build and sign an envelope
+
+```python
+from jhcontext import EnvelopeBuilder, RiskLevel, ArtifactType, observation, userml_payload
+
+# Build semantic payload
+payload = userml_payload(
+    observations=[observation("user:alice", "temperature", 22.3)],
+)
+
+# Build envelope
+env = (
+    EnvelopeBuilder()
+    .set_producer("did:example:agent-1")
+    .set_scope("healthcare")
+    .set_risk_level(RiskLevel.HIGH)
+    .set_human_oversight(True)
+    .set_semantic_payload([payload])
+    .add_artifact(
+        artifact_id="art-vitals",
+        artifact_type=ArtifactType.TOKEN_SEQUENCE,
+        content_hash="sha256:abc123...",
+    )
+    .sign("did:example:agent-1")
+    .build()
+)
+
+print(env.context_id)
+print(env.proof.content_hash)
+```
+
+### Build a W3C PROV graph
+
+```python
+from jhcontext import PROVGraph
+
+prov = (
+    PROVGraph("ctx-health-001")
+    .add_entity("vitals", "Patient Vitals", artifact_type="token_sequence")
+    .add_entity("recommendation", "AI Recommendation")
+    .add_activity("ai-analysis", "AI Analysis",
+                  started_at="2026-01-01T10:00:00Z",
+                  ended_at="2026-01-01T10:01:00Z")
+    .add_agent("agent-sensor", "Sensor Agent", role="data_collector")
+    .used("ai-analysis", "vitals")
+    .was_generated_by("recommendation", "ai-analysis")
+    .was_associated_with("ai-analysis", "agent-sensor")
+    .was_derived_from("recommendation", "vitals")
+)
+
+# Serialize
+print(prov.serialize("turtle"))
+
+# Query
+chain = prov.get_causal_chain("recommendation")
+used = prov.get_used_entities("ai-analysis")
+sequence = prov.get_temporal_sequence()
+```
+
+### Run compliance audits
+
+```python
+from jhcontext import (
+    verify_temporal_oversight,
+    verify_negative_proof,
+    verify_workflow_isolation,
+    verify_integrity,
+    generate_audit_report,
+)
+
+# Art. 14 — Temporal oversight (human reviewed AFTER AI, >= 5 min)
+result = verify_temporal_oversight(
+    prov,
+    ai_activity_id="ai-analysis",
+    human_activities=["doctor-review"],
+    min_review_seconds=300.0,
+)
+
+# Art. 13 — Negative proof (excluded data types not in decision chain)
+result = verify_negative_proof(
+    prov,
+    decision_entity_id="final-grade",
+    excluded_artifact_types=["biometric", "social_media"],
+)
+
+# Workflow isolation (two PROV graphs share zero artifacts)
+result = verify_workflow_isolation(prov_a, prov_b)
+
+# Envelope integrity (hash + signature)
+result = verify_integrity(env)
+
+# Generate full audit report
+report = generate_audit_report(env, prov, [result1, result2, result3])
+print(report.to_dict())
+```
+
+### Start the server
+
+```bash
+# REST API on localhost:8400
+jhcontext serve
+
+# MCP server (stdio transport)
+jhcontext mcp
+```
+
+### Use the REST client
+
+```python
+from jhcontext.client.api_client import JHContextClient
+
+client = JHContextClient(base_url="http://localhost:8400")
+
+# Submit envelope
+ctx_id = client.submit_envelope(env)
+
+# Retrieve
+data = client.get_envelope(ctx_id)
+
+# List with filters
+envelopes = client.list_envelopes(scope="healthcare")
+
+# Health check
+print(client.health())
+
+client.close()
+```
+
+## Testing
+
+```bash
+pip install -e ".[all,dev]"
+pytest tests/ --ignore=tests/test_example.py -v
+```
+
+## Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **Envelope** | Immutable context unit: semantic payload + artifacts + provenance + proof |
+| **Artifact** | Registered data object (embedding, token sequence, tool result) with content hash |
+| **PROVGraph** | W3C PROV provenance graph (entities, activities, agents, relations) |
+| **Proof** | Cryptographic integrity: canonical hash + Ed25519/HMAC signature |
+| **Audit** | Compliance checks: temporal oversight, negative proof, workflow isolation |
+| **UserML** | Semantic payload format: observation → interpretation → situation layers |
+
+## Protocol
+
+Based on the **PAC-AI** (Protocol for Auditable Context in AI) specification. JSON-LD schema at `jhcontext-protocol/jhcontext-core.jsonld` (v0.3).
+
+## License
+
+Apache-2.0

jhcontext-0.2.0/README.md

@@ -0,0 +1,202 @@
+# jhcontext SDK
+
+**PAC-AI: Protocol for Auditable Context in AI** — Python SDK v0.2.0
+
+A Python toolkit for building, signing, auditing, and serving AI context envelopes compliant with the PAC-AI protocol. Designed for EU AI Act compliance scenarios including temporal oversight (Art. 14) and negative proof (Art. 13).
+
+## Install
+
+```bash
+# Core: models, builder, PROV, audit, crypto
+pip install jhcontext
+
+# With server (FastAPI + MCP + SQLite)
+pip install "jhcontext[server]"
+
+# With CrewAI integration
+pip install "jhcontext[crewai]"
+
+# Everything
+pip install "jhcontext[all]"
+
+# Development (adds pytest)
+pip install "jhcontext[all,dev]"
+```
+
+## Architecture
+
+```
+jhcontext/
+├── models.py          # Pydantic v2 data models (Envelope, Artifact, Decision, ...)
+├── builder.py         # EnvelopeBuilder — fluent API for constructing envelopes
+├── prov.py            # PROVGraph — W3C PROV graph builder (rdflib)
+├── audit.py           # Compliance verification (temporal oversight, negative proof, isolation)
+├── crypto.py          # SHA-256 hashing, Ed25519 signing (HMAC fallback)
+├── canonicalize.py    # Deterministic JSON serialization
+├── semantics.py       # UserML semantic payload helpers
+├── cli.py             # CLI: jhcontext serve | mcp | version
+├── client/
+│   └── api_client.py  # REST client (httpx)
+└── server/
+    ├── app.py          # FastAPI app factory
+    ├── mcp_server.py   # MCP server (stdio transport)
+    ├── routes/         # REST API routes (envelopes, artifacts, decisions, provenance, compliance)
+    └── storage/
+        └── sqlite.py   # SQLite backend (zero-config, ~/.jhcontext/)
+```
+
+## Quick Start
+
+### Build and sign an envelope
+
+```python
+from jhcontext import EnvelopeBuilder, RiskLevel, ArtifactType, observation, userml_payload
+
+# Build semantic payload
+payload = userml_payload(
+    observations=[observation("user:alice", "temperature", 22.3)],
+)
+
+# Build envelope
+env = (
+    EnvelopeBuilder()
+    .set_producer("did:example:agent-1")
+    .set_scope("healthcare")
+    .set_risk_level(RiskLevel.HIGH)
+    .set_human_oversight(True)
+    .set_semantic_payload([payload])
+    .add_artifact(
+        artifact_id="art-vitals",
+        artifact_type=ArtifactType.TOKEN_SEQUENCE,
+        content_hash="sha256:abc123...",
+    )
+    .sign("did:example:agent-1")
+    .build()
+)
+
+print(env.context_id)
+print(env.proof.content_hash)
+```
+
+### Build a W3C PROV graph
+
+```python
+from jhcontext import PROVGraph
+
+prov = (
+    PROVGraph("ctx-health-001")
+    .add_entity("vitals", "Patient Vitals", artifact_type="token_sequence")
+    .add_entity("recommendation", "AI Recommendation")
+    .add_activity("ai-analysis", "AI Analysis",
+                  started_at="2026-01-01T10:00:00Z",
+                  ended_at="2026-01-01T10:01:00Z")
+    .add_agent("agent-sensor", "Sensor Agent", role="data_collector")
+    .used("ai-analysis", "vitals")
+    .was_generated_by("recommendation", "ai-analysis")
+    .was_associated_with("ai-analysis", "agent-sensor")
+    .was_derived_from("recommendation", "vitals")
+)
+
+# Serialize
+print(prov.serialize("turtle"))
+
+# Query
+chain = prov.get_causal_chain("recommendation")
+used = prov.get_used_entities("ai-analysis")
+sequence = prov.get_temporal_sequence()
+```
+
+### Run compliance audits
+
+```python
+from jhcontext import (
+    verify_temporal_oversight,
+    verify_negative_proof,
+    verify_workflow_isolation,
+    verify_integrity,
+    generate_audit_report,
+)
+
+# Art. 14 — Temporal oversight (human reviewed AFTER AI, >= 5 min)
+result = verify_temporal_oversight(
+    prov,
+    ai_activity_id="ai-analysis",
+    human_activities=["doctor-review"],
+    min_review_seconds=300.0,
+)
+
+# Art. 13 — Negative proof (excluded data types not in decision chain)
+result = verify_negative_proof(
+    prov,
+    decision_entity_id="final-grade",
+    excluded_artifact_types=["biometric", "social_media"],
+)
+
+# Workflow isolation (two PROV graphs share zero artifacts)
+result = verify_workflow_isolation(prov_a, prov_b)
+
+# Envelope integrity (hash + signature)
+result = verify_integrity(env)
+
+# Generate full audit report
+report = generate_audit_report(env, prov, [result1, result2, result3])
+print(report.to_dict())
+```
+
+### Start the server
+
+```bash
+# REST API on localhost:8400
+jhcontext serve
+
+# MCP server (stdio transport)
+jhcontext mcp
+```
+
+### Use the REST client
+
+```python
+from jhcontext.client.api_client import JHContextClient
+
+client = JHContextClient(base_url="http://localhost:8400")
+
+# Submit envelope
+ctx_id = client.submit_envelope(env)
+
+# Retrieve
+data = client.get_envelope(ctx_id)
+
+# List with filters
+envelopes = client.list_envelopes(scope="healthcare")
+
+# Health check
+print(client.health())
+
+client.close()
+```
+
+## Testing
+
+```bash
+pip install -e ".[all,dev]"
+pytest tests/ --ignore=tests/test_example.py -v
+```
+
+## Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **Envelope** | Immutable context unit: semantic payload + artifacts + provenance + proof |
+| **Artifact** | Registered data object (embedding, token sequence, tool result) with content hash |
+| **PROVGraph** | W3C PROV provenance graph (entities, activities, agents, relations) |
+| **Proof** | Cryptographic integrity: canonical hash + Ed25519/HMAC signature |
+| **Audit** | Compliance checks: temporal oversight, negative proof, workflow isolation |
+| **UserML** | Semantic payload format: observation → interpretation → situation layers |
+
+## Protocol
+
+Based on the **PAC-AI** (Protocol for Auditable Context in AI) specification. JSON-LD schema at `jhcontext-protocol/jhcontext-core.jsonld` (v0.3).
+
+## License
+
+Apache-2.0

jhcontext-0.2.0/SESSION_CONTINUE.md

@@ -0,0 +1,86 @@
+# jhcontext-sdk — Session Continuation Instructions
+
+## What was done
+
+### Paper (jhcontext-paper8pgs/)
+- 8-page version of PAC-AI paper for IADIS AIS 2026 (Valencia, deadline Apr 10)
+- Renamed PAC-P → **PAC-AI** (Protocol for Auditable Context in AI)
+- Scenarios: Healthcare (Art. 14, temporal oversight) + Education (Art. 13, negative proof)
+- IADIS formatting, APA bibliography, blind review ready
+- Currently 9 pages (needs ~2 lines trimmed to fit 8)
+- Figure 1 (pacp-layers.jpeg) still says "PAC-P" — needs regenerated image
+
+### SDK (jhcontext-sdk/) — v0.2.0, IMPLEMENTED
+Core modules all working and tested:
+- `jhcontext/models.py` — Pydantic models (Envelope, Artifact, DecisionInfluence, Privacy, Compliance, Proof, Decision)
+- `jhcontext/builder.py` — EnvelopeBuilder fluent API
+- `jhcontext/prov.py` — PROVGraph (rdflib W3C PROV builder with query helpers)
+- `jhcontext/audit.py` — verify_temporal_oversight, verify_negative_proof, verify_workflow_isolation, verify_integrity
+- `jhcontext/crypto.py` — SHA-256, Ed25519 sign/verify (HMAC fallback without cryptography pkg)
+- `jhcontext/canonicalize.py` — JSON deterministic serialization
+- `jhcontext/semantics.py` — UserML helpers (observation, interpretation, situation)
+- `jhcontext/server/app.py` — FastAPI app factory
+- `jhcontext/server/routes/` — envelopes, artifacts, decisions, provenance, compliance routes
+- `jhcontext/server/storage/sqlite.py` — SQLite backend (zero-config, ~/.jhcontext/)
+- `jhcontext/server/mcp_server.py` — MCP server with tools (submit_envelope, get_envelope, query_prov, run_audit)
+- `jhcontext/client/api_client.py` — REST client (httpx)
+- `jhcontext/cli.py` — CLI: `jhcontext serve`, `jhcontext mcp`, `jhcontext version`
+- `pyproject.toml` — hatchling, extras: [server], [crewai], [all], [dev]
+
+### Protocol spec (jhcontext-protocol/)
+- `jhcontext-core.jsonld` — Updated to v0.3 with artifacts_registry, decision_influence, privacy, compliance, scope, passed_artifact_pointer
+
+### Agent definitions (jhcontext-agent/)
+- `paper-agent.yaml` — Paper revision agent + task
+- `author_actions.md` — Detailed plan with CrewAI agents for both scenarios
+
+## What remains to be done
+
+### Priority 1: Tests + README
+- Write formal pytest tests for all modules (test_models, test_builder, test_prov, test_audit, test_crypto, test_storage, test_api)
+- Write README.md with architecture overview, install modes, usage examples
+- Run full test suite: `pip install -e ".[all,dev]" && pytest`
+
+### Priority 2: jhcontext-usecases repo
+- Create `/home/jhdarosa/Repos/jhcontext-usecases/`
+- Healthcare scenario: 5 CrewAI agents (sensor→situation→decision→oversight→audit) using jhcontext SDK
+- Education scenario: 4 CrewAI agents (ingestion→grading→equity→audit) with workflow isolation
+- Agent YAML definitions are in `jhcontext-agent/author_actions.md` — use as reference
+- Each scenario should produce: envelope JSON, PROV Turtle, audit report JSON
+- Entry points: `python -m usecases.healthcare.run`, `python -m usecases.education.run`
+
+### Priority 3: Server testing
+- Test FastAPI server: `jhcontext serve` → hit endpoints with httpx
+- Test MCP server: `jhcontext mcp` → verify tools work via stdio
+- Test client↔server flow end-to-end
+
+### Priority 4: Paper updates
+- Trim paper to 8 pages (currently 9 — needs ~2 lines cut)
+- Update Figure 1 image (still says PAC-P instead of PAC-AI)
+- After usecases run: add implementation evidence to paper (envelope snippets, PROV graphs, metrics)
+
+### Priority 5: Publish
+- Publish jhcontext to PyPI: `python -m build && twine upload dist/*`
+- Push to GitHub (public repo)
+- For blind review: use anonymous.4open.science for paper reference
+
+## Key files to read for context
+1. `/home/jhdarosa/.claude/plans/cached-toasting-turing.md` — Full implementation plan
+2. `/home/jhdarosa/Repos/jhcontext-agent/author_actions.md` — CrewAI agent definitions + scenario specs
+3. `/home/jhdarosa/Repos/jhcontext-paper8pgs/sections/05scenarios.tex` — Paper scenario descriptions
+4. `/home/jhdarosa/Repos/jhcontext-sdk/pyproject.toml` — Package structure and dependencies
+
+## Quick verification commands
+```bash
+# Test SDK works
+cd /home/jhdarosa/Repos/jhcontext-sdk
+pip install -e ".[dev]"
+python -c "from jhcontext import EnvelopeBuilder, PROVGraph; print('OK')"
+
+# Start server
+pip install -e ".[server]"
+jhcontext serve  # FastAPI on localhost:8400
+
+# Start MCP
+jhcontext mcp  # stdio transport
+```

jhcontext-0.2.0/cli.py

@@ -0,0 +1,24 @@
+# Simple CLI to load a JSON file and print canonical form and hash
+import sys, json
+from jhcontext import from_dict
+
+def main():
+    if len(sys.argv) < 2:
+        print('Usage: python cli.py envelope.json')
+        sys.exit(1)
+    path = sys.argv[1]
+    with open(path,'r',encoding='utf-8') as f:
+        d = json.load(f)
+    env = from_dict(d)
+    try:
+        env.validate()
+    except Exception as e:
+        print('Validation error:', e)
+        sys.exit(2)
+    print('Canonical:', env.canonical())
+    print('Hash:', env.hash())
+    proof = env.sign(env.raw.get('producer','did:example:unknown'))
+    print('Mock proof:', proof)
+
+if __name__ == '__main__':
+    main()