edge-latency-aware-cross-ve.../README.md

1.6 KiB

ELAC-Plan (Edge-Latency Aware Cross-Venue Execution Planner)

This repository implements a production-oriented MVP of ELAC-Plan: an edge-native federation for cross-venue execution planning with privacy-preserving signals and deterministic delta-sync.

  • Primitives map to canonical primitives used across adapters:
    • Objects: LocalProblem
    • Morphisms: SharedVariables
    • DualVariables: DualVariables
    • PlanDelta: PlanDelta
    • Governance/AuditLog: GovernanceAuditLog (stubbed for now)
  • MVP adapters:
    • NBBOFeedAdapter: translates NBBO-like feeds into SharedVariables
    • BrokerGatewayAdapter: simulates broker API publishing of PlanDelta
  • Solver: LocalSolver (toy solver)
  • API: FastAPI app exposing /problems and /status to drive LocalProblem -> PlanDelta flow
  • Packaging: Python packaging metadata in pyproject.toml; tests with pytest; build via python -m build

How to run (dev):

  • Run tests: ./test.sh
  • Run API locally (example): uvicorn elac_plan.api:app --reload

This is a minimal but production-conscious MVP intended to be extended by adding governance ledger, secure aggregation, and real adapters in subsequent iterations.

Interop and roadmap

  • See docs/elac_plan_interop.md for a minimal DSL sketch and EnergiBridge-style interoperability planning (LocalProblem/SharedVariables/PlanDelta/DualVariables/AuditLog).
  • The MVP already includes two adapters (NBBOFeedAdapter and BrokerGatewayAdapter) and a toy LocalSolver for end-to-end delta-sync.
  • The plan includes phases for governance, secure aggregation, cross-venue demos, and HIL testing; reference SDK and sample DSL are provided for integration with other domains.