How jaskaransingh-01/chronos works
This is a C++ market-simulation library with an application entry point. Its main workflow replays timestamped order events into a simulator, which manages orders and matching and accumulates trades; it also includes CSV replay input and ITCH decoding/normalization. The source index establishes module references, but the README is empty and the implementation excerpts are limited, so uncertain connections are omitted or marked dashed.
Main entry points: simulator.cpp Simulator · matching_engine.cpp Matching Engine · main.cpp Application Entry · order_book.cpp Order Book
Components 19
Replay
- Replay Engine
src/replay/replay_engine.cpp - Replay Events
include/simulator/replay/replay_event.hpp - Replay CSV Reader
src/replay/replay_event_reader.cpp
ITCH Input
- Byte Reader
src/itch/byte_reader.cpp - Message Reader
src/itch/itch_message_reader.cpp - ITCH Decoder
src/itch/itch_decoder.cpp - ITCH Normalizer
src/itch/itch_normalizer.cpp
Simulation
- Simulator
src/simulator/simulator.cpp - Simulation Clock
include/simulator/clock/clock.hpp - Event Types
include/simulator/events/event.hpp - Core Types
include/simulator/types/enums.hpp
Order Management
- Order Pool
src/orders/order_pool.cpp - Order
src/orders/order.cpp - Order Book
src/orders/order_book.cpp - Price Levels
src/orders/price_level.cpp
Matching
- Matching Engine
src/matching/matching_engine.cpp - Trade
include/simulator/matching/trade.hpp
Other components
- User
- Application Entry
app/main.cpp
Connections 19
- User → Application Entry: starts
- Application Entry → Simulation Clock: uses
app/main.cpp - Application Entry → Event Types: uses
app/main.cpp - Replay Engine → Simulator: dispatches events
- Replay Engine → Replay CSV Reader: reads events
- Replay CSV Reader → Replay Events: produces
- Message Reader → Byte Reader: reads bytes
- ITCH Decoder → Byte Reader: decodes bytes
src/itch/itch_decoder.cpp - ITCH Normalizer → Replay Events: normalizes to
- Simulator → Simulation Clock: advances
- Simulator → Order Pool: allocates orders
- Simulator → Matching Engine: submits orders
- Order Pool → Order: manages
- Order Book → Order: tracks
- Order Book → Price Levels: organizes by price
- Matching Engine → Order Book: matches against
- Matching Engine → Trade: records trades
- Order → Core Types: uses fields
- Replay Events → Core Types: uses fields
include/simulator/replay/replay_event.hpp