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

22 lines
1.4 KiB
Markdown

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.