How zenithsoulx/mercury works
Mercury replays LOBSTER market messages into a price-time-priority order book, with an optional path for comparing reconstructed states against reference snapshots and tooling for latency measurement. The graph follows the documented replay and matching layers, then shows the validation branch. Relationships among the core layers are documented in the README; validation wiring is also visible in the sampled validator entry point. Latency tooling is documented, but its detailed runtime behavior was not sampled.
Main entry points: order_book.cpp Order Book · replay_engine.cpp Replay Engine · validate_replay.cpp Validation CLI · book_validator.cpp Book Validator
Components 17
Market Data
- LOBSTER Messages
- Message Parser
src/lobster_parser.cpp - Typed Events
include/replay/lobster_message.hpp
Replay
- Replay Engine
src/replay_engine.cpp
Matching Engine
- Order Book
src/order_book.cpp - Book Side
src/book_side.cpp - Price Index
src/price_index.cpp - Price Level
src/price_level.cpp - Order
src/order.cpp - Trade Records
include/core/trade.hpp - Strong Types
include/core/types.hpp
Validation
- LOBSTER Snapshots
- Snapshot Parser
src/lobster_orderbook_parser.cpp - Book Validator
src/book_validator.cpp - Validation CLI
tools/validate_replay.cpp
Measurement
- Latency Report
tools/latency_report.cpp - Latency Statistics
tools/latency_stats.cpp
Connections 21
- LOBSTER Messages → Message Parser: provides CSV
README.md - Message Parser → Typed Events: parses into
- Replay Engine → Message Parser: reads events
- Replay Engine → Order Book: dispatches events
README.md - Order Book → Book Side: uses sides
- Book Side → Price Index: indexes levels
- Price Index → Price Level: owns levels
- Price Level → Order: queues orders
- Order Book → Trade Records: returns trades
- Order → Strong Types: uses typed values
- Order Book → Strong Types: uses typed values
- LOBSTER Snapshots → Snapshot Parser: provides snapshots
README.md - Validation CLI → Replay Engine: constructs
tools/validate_replay.cpp - Validation CLI → Order Book: constructs
tools/validate_replay.cpp - Validation CLI → Snapshot Parser: constructs
tools/validate_replay.cpp - Validation CLI → Book Validator: runs validation
tools/validate_replay.cpp - Book Validator → Replay Engine: advances replay
- Book Validator → Snapshot Parser: compares snapshots
- Book Validator → Order Book: checks book state
- Latency Report → Replay Engine: measures replay
README.md - Latency Report → Latency Statistics: reports metrics