# GridGuard: Secure, Attested Cross-Domain Energy Mesh Orchestrator (MVP)

GridGuard provides a security-first framework overlaying cross-domain optimization stacks (e.g., CatOpt/Open-EnergyMesh).
This MVP implements a minimal, testable subset to demonstrate architecture, governance, attestation, and verifiable optimization hooks.

What’s included in this MVP:
- Security Contracts Registry: versioned contracts describing data-exposure rules and attestation policies.
- Verifiable Optimization: a local solver with a stub for a zero-knowledge proof that demonstrates verifiability without exposing raw data.
- Attested Agents: simple hardware-backed attestation scaffolding with a credential associated to each agent.
- Secure Transport: basic channel abstraction with key rotation stubs.
- Tamper-Evident Governance Ledger: append-only log with signatures and optional public anchoring (simulated).
- Delta-Sync: state reconciliation with proof checks.
- EnergiBridge: canonical, vendor-agnostic bridge mapping GridGuard primitives to a CatOpt-inspired representation (Objects, Morphisms, PlanDelta). Enables cross-vendor interoperability.
- Graph-of-Contracts registry: versioned schemas for adapters and data models; replay protection and auditability.
- Attestation enhancements: DID-based identities and hardware-backed attestation binding to contract permissions.
- Privacy-by-design primitives: secure aggregation and pluggable zero-knowledge proof stubs for verifiable compliance.
- Post-quantum readiness: crypto-hygiene considerations and key rotation strategies.
- Tamper-evident governance ledger: anchoring options to public ledgers for cross-organization auditability.
- Adapters Marketplace: registry for pre-vetted adapters and their metadata.
- Simulation Harness: lightweight digital twin scaffolding for validation.

Project Structure (Python):
- src/gridguard_secure_attested_cross_domain_e/
  - contracts.py
  - optimization.py
  - attestation.py
  - transport.py
  - governance.py
  - marketplace.py
  - simulation.py
  - __init__.py

Tests: tests/test_basic.py

How to run tests:
  bash test.sh

This README also serves as a marketing and onboarding document to explain the architecture and how to contribute.