mev-searcher-pipeline-reference/README.md

MEV searcher pipeline reference

Purpose: Documentation-only reference for MEV and arbitrage opportunity taxonomy and a typical production searcher pipeline (data, simulation, strategy, execution, capital, latency). This repository is not an execution stack; it frames concepts and diagrams for engineers and operators.

Implementation source of truth: The in-repo MEV platform specifications and code live in the proxmox parent submodule MEV_Bot (Gitea d-bis/MEV_Bot). Start there for service boundaries, schemas, and build scope:

• specs/README.md — spec index and dependency order
• specs/SERVICE_ARCHITECTURE_AND_MESSAGE_CONTRACTS.md — Rust services, NATS-style contracts
• specs/SEARCH_AND_SIMULATION_SPEC.md, EXECUTION_BUNDLE_AND_RELAY_SPEC.md, etc.

This repo contains:

Document	Description
docs/OPPORTUNITY_TAXONOMY.md	Categories of state-transition / orderflow inefficiencies
docs/PRODUCTION_PIPELINE.md	End-to-end pipeline narrative + mapping to MEV_Bot services
docs/ARCHITECTURE.md	Mermaid architecture diagrams (primary diagrams live here)
docs/SCALING_AND_REALITY.md	What scales, competition, and practical constraints

Submodule (parent proxmox repo)

From the proxmox repository root:

git submodule update --init mev-searcher-pipeline-reference

Clone with submodule:

git clone --recurse-submodules <proxmox-url>

Remote

• HTTPS: https://gitea.d-bis.org/d-bis/mev-searcher-pipeline-reference.git
• Default branch: main

License

Internal reference material; align licensing with your org policy if you redistribute.