42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
# 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](docs/OPPORTUNITY_TAXONOMY.md) | Categories of state-transition / orderflow inefficiencies |
|
|
| [docs/PRODUCTION_PIPELINE.md](docs/PRODUCTION_PIPELINE.md) | End-to-end pipeline narrative + mapping to `MEV_Bot` services |
|
|
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Mermaid architecture diagrams (primary diagrams live here) |
|
|
| [docs/SCALING_AND_REALITY.md](docs/SCALING_AND_REALITY.md) | What scales, competition, and practical constraints |
|
|
|
|
## Submodule (parent proxmox repo)
|
|
|
|
From the proxmox repository root:
|
|
|
|
```bash
|
|
git submodule update --init mev-searcher-pipeline-reference
|
|
```
|
|
|
|
Clone with submodule:
|
|
|
|
```bash
|
|
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.
|