How aryan0dhankhar/lob_engine works
This is a C++ limit-order-book engine: a Python market-feed simulator sends UDP packets to the engine, which parses add/cancel messages, transfers requests through an SPSC queue, and updates the order book. The README documents asynchronous logging; source excerpts show its queue-backed worker writing to a log file. The order book uses a preallocated pool and shared order/price-level types. The excerpts do not show the engine invoking match(), so the graph does not claim that crossing orders are matched during the main workflow.
Main entry points: main.cpp Engine runtime · FeedHandler.hpp Packet gateway · OrderBook.cpp Limit order book · Logger.cpp Async logger
Components 15
Market-data ingress
- Feed simulator
market_feed.py - UDP socket
include/UdpSocket.hpp - Packet gateway
include/FeedHandler.hpp - Wire messages
include/MarketData.hpp
Order processing
- Engine runtime
main.cpp - Order requests
include/MarketData.hpp - SPSC queue
include/LockFreeQueue.hpp - Limit order book
src/OrderBook.cpp
Engine internals
- Order object pool
include/ObjectPool.hpp - Order types
include/Types.hpp - Order book API
include/OrderBook.hpp
Logging
- Async logger
src/Logger.cpp - Log queue
include/LockFreeQueue.hpp - Log file
Other components
- UDP multicast
Connections 14
- Feed simulator → UDP multicast: sends packets
README.md - UDP multicast → UDP socket: delivers datagrams
README.md - Engine runtime → UDP socket: receives datagrams
main.cpp - Engine runtime → Packet gateway: processes packets
main.cpp - Packet gateway → Wire messages: parses messages
include/FeedHandler.hpp - Packet gateway → SPSC queue: pushes requests
include/FeedHandler.hpp - Packet gateway → Order requests: builds requests
include/FeedHandler.hpp - Engine runtime → SPSC queue: pops requests
main.cpp - Engine runtime → Limit order book: adds or cancels
main.cpp - Limit order book → Order object pool: allocates orders
src/OrderBook.cpp - Limit order book → Order types: stores order types
- Engine runtime → Async logger: starts and logs
main.cpp - Async logger → Log queue: enqueues messages
src/Logger.cpp - Async logger → Log file: writes log lines
src/Logger.cpp