Files
proxmox/docs/04-configuration/MEV_CONTROL_COMPLETION_PUNCHLIST.md
2026-04-13 12:36:51 -07:00

4.9 KiB

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