API documentation · Opti Mesh 1.0

Hybrid quantum optimization fundamentals

Opti Mesh 1.0 is the Æ Hive laboratory console and same-origin REST proxy for Hybrid Quantum Optimization — NISQ QAOA sampling, classical refinement, and SMT/Z3 verification for NP-hard routing, scheduling, and allocation.

Overview

Opti Mesh exposes the Combinatorial Optimization research stack as a REST API. Clients inspect laboratory health, z3 safety proofs, AIS fleet context, and QAOA raw→refined optimality. The Æ Hive console visualises telemetry and proxies all calls through /api/optimesh to the Hybrid Quantum Optimization backend (ArgoSea FastAPI).

  • Health & status — service readiness and laboratory mode
  • Overview — aggregated dashboard payload for the console
  • Verify · fleet · quantum — Z3 proofs, AIS fleet, and QAOA run artefacts

Authentication

Research console requests use the Æ Hive same-origin proxy without a browser API key. Production deployments should configure upstream policy on the Opti Mesh backend via OPTIMESH_BACKEND_URL or ARGOSEA_BACKEND_URL (default http://127.0.0.1:8010).

Content-Type: application/json
Accept: application/json

Same-origin proxy

Browser clients should call the Æ Hive proxy at /api/optimesh/*. The route forwards JSON to the Hybrid Quantum Optimization backend. When the backend is unreachable, the Opti Mesh console falls back to laboratory snapshots from /investor-relations/research/combinatorial-optimization/demo-overview.json.

GET /api/optimesh/health
GET /api/optimesh/status
GET /api/optimesh/overview
GET /api/optimesh/verify
GET /api/optimesh/fleet
GET /api/optimesh/quantum/runs
GET /api/optimesh/quantum/latest
GET /api/optimesh/quantum/latest/refined

Endpoints

MethodPathPurpose
GET/healthService health probe
GET/statusLaboratory / backend status
GET/overviewAggregated console payload (primary load)
GET/verifyZ3 / SMT safety verification results
GET/fleetAIS fleet context for optimization scenarios
GET/quantum/runsList recent QAOA optimization runs
GET/quantum/latestLatest raw QAOA sample artefacts
GET/quantum/latest/refinedLatest classically refined solution

Overview payload

GET /overview is the primary console load. It aggregates health, verification, fleet, and quantum summaries so operators can inspect the three-layer hybrid stack — NISQ QAOA sampling, classical refinement, and formal verification — in one response.

GET /api/optimesh/overview
→ { health, status, verify, fleet, quantum, … }

Quantum runs

QAOA artefacts are available under /quantum/*. Use /quantum/runs for history, /quantum/latest for the newest raw samples, and /quantum/latest/refined for the post-processed candidate returned by classical refinement.

Z3 verify

GET /verify returns SMT/Z3 safety proofs that check refined solutions against combinatorial constraints — the third layer of the Hybrid Quantum Optimization architecture described in the research paper.