idea85-blockenergy-mesh-ver.../README.md

1.4 KiB

BlockEnergy Mesh — idea85-blockenergy-mesh-verifiable

This repository contains a focused, production-oriented chunk of the BlockEnergy Mesh project: a protocol skeleton, canonical primitives, a Graph-of-Contracts registry, two sample adapters, and a toy on-chain proof mechanism (signature-based attestation of constraint satisfaction).

What is included (MVP slice)

  • Canonical primitives: LocalProblem, SharedVariables, PlanDelta, AuditLog (pydantic models)
  • Graph-of-Contracts: simple registry to version contract schemas and adapters
  • Two starter adapters: SubstationMeterAdapter and DerAggregatorAdapter that map device data to LocalProblem and produce PlanDelta
  • Toy proof mechanism: cryptographic commitment (SHA-256) + ECDSA signature (via cryptography) as a verifiable attestation
  • Tests and packaging: pytest tests and pyproject.toml for packaging

Run tests

  1. Create a virtualenv (recommended)
  2. Install test deps (optional): pip install -r requirements.txt (not required)
  3. Run the test script: bash test.sh

This will run pytest and python3 -m build to validate packaging metadata.

Roadmap

  • This patch implements Phase 0 skeleton and a toy proof scheme. Next steps by the swarm: integrate ZK proofs (snarkjs/circom or zksnark bindings), off-chain solver (ADMM-lite), delta-sync reconciliation, governance ledger integration, and adapter conformance suite.