# MEV Control Completion Punch List

Current live state:
- Public GUI and same-origin `/api` are live on `https://mev.defi-oracle.io`
- Backend control plane is contained in CT `2421` on `r630-04`
- Health, infra, supervisor controls, and signer telemetry are live

Status labels:
- `live`: deployed and working in production
- `partial`: implemented but still simplified or incomplete
- `missing`: not implemented yet
- `stale-doc`: documentation no longer matches production
- `needs-validation`: implemented but requires a dedicated operator test

## Control Plane

| Area | Status | Notes |
|------|--------|-------|
| Public GUI routing | `live` | CT `2410` serves GUI and proxies `/api` to backend CT `2421` |
| Backend containment | `live` | No MEV services run directly on a Proxmox host |
| Supervisor single-service control | `live` | Start/stop per service works |
| Supervisor bulk control | `live` | Start-all / stop-all exposed through admin API and GUI |
| Worker auto-start after boot | `live` | `mev-start-all.service` starts workers after admin API is ready |
| Infra health (Postgres / Redis / NATS) | `live` | Admin API reports all three with real checks |
| Signer telemetry API | `live` | Reports configured/shadow mode, derived signer address, and execution config |
| Safety page signer UX | `live` | UI now shows signer wiring instead of placeholder text |

## Pipeline Runtime

| Area | Status | Notes |
|------|--------|-------|
| Pool indexer | `partial` | Running, but MVP-level scope and indexing behavior |
| State ingestion | `partial` | Running; currently simplified reserve fetch strategy |
| Liquidity graph | `partial` | Running; graph API exists but UX is still raw |
| Opportunity search | `partial` | Route search is DB-adjacency based, not fully liquidity-aware |
| Simulation | `partial` | Uses simplified assumptions for gas/amount/slippage |
| Bundle builder | `partial` | Emits placeholder tx payloads; real signing not complete |
| Execution gateway | `partial` | Relay submission exists; inclusion tracking is placeholder |
| Settlement analytics | `partial` | Service runs, but final economics remain limited by gateway data |

## Critical Remaining Execution Work

| Item | Status | Notes |
|------|--------|-------|
| Real bundle signing | `partial` | Code path exists and can sign `executeArbitrage(...)` transactions, but live deployment remains blocked by missing signer key, executor contract, flash-loan provider, and V2 router config |
| Inclusion detection | `partial` | Receipt polling path exists, but real inclusion truth still depends on real signed submission and relay acceptance |
| Profit realization accuracy | `partial` | Analytics work, but realized PnL still depends on live submission and real inclusion outcomes |
| Executor deployment capture | `live` | `deploy-mev-execution-contracts.sh` can deploy and capture non-secret execution addresses into a JSON artifact |

## Market / Search Coverage

| Item | Status | Notes |
|------|--------|-------|
| Uniswap V2-style PMM flow | `partial` | Present today |
| Uniswap V3 ingestion and math | `missing` | Not yet implemented |
| Curve ingestion and math | `missing` | Not yet implemented |
| Multicall batching | `missing` | Needed for scale |
| Block subscription / `newHeads` | `missing` | Current flow is not fully event-driven |
| Incremental live indexer | `missing` | Still needs proper new-block log scanning |

## Operator / UX Gaps

| Item | Status | Notes |
|------|--------|-------|
| Config editor + restart semantics | `partial` | Raw TOML edit exists; safer validation / restart flow still needed |
| Graph visualization | `partial` | Raw JSON inspector, not a full operator graph surface |
| Real-time event UX | `partial` | SSE exists for health; broader event streaming remains limited |
| Per-service throughput / lag metrics | `missing` | Needed for serious operations |
| Correlation IDs | `missing` | Tracked in repo docs, not yet deployed |

## Documentation

| Item | Status | Notes |
|------|--------|-------|
| Deployment split-topology docs | `partial` | Updated for backend CT IP `192.168.11.223`; continue reviewing cross-links |
| Runtime completion inventory | `live` | This punch list is the current source of truth |
| MEV implementation gap doc | `live` | `MEV_Bot/mev-platform/docs/REMAINING_GAPS_IMPLEMENTATION.md` remains authoritative for execution-path debt |

## Recommended Next Execution Order

1. Commit and push the current admin API, supervisor, UI, and doc changes.
2. Implement real bundle signing in `bundle-builder`.
3. Implement inclusion detection and real profit capture in `execution-gateway` / `settlement-analytics`.
4. Upgrade ingestion/search for Uniswap V3, Curve, multicall, and block subscriptions.
5. Add operator-grade observability: queue depth, per-service lag, event counters, and correlation IDs.
6. Run a full end-to-end validation from discovery through relay submission and confirmed inclusion.