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

1.1 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.