How vigsank/kite-paper-node works
kite-paper-node is a drop-in Zerodha Kite Connect paper-trading mock. A strategy initiates requests through the in-process SDK, REST, or MCP surface; those interfaces reach the mock engine, which coordinates simulated orders and portfolio state alongside generated or replayed market data. The README also documents persistent state and WebSocket ticker modes. Some subsystem links rely on the SOURCE INDEX or README because the relevant wiring was not excerpted; uncertain links are omitted.
Main entry points: mock-engine.ts Mock engine · services Broker services · generator-pool.ts Generator pool · tick-event-bus.ts Tick event bus
Components 24
User interfaces
- Kite SDK mock
src/mock-kite-connect.ts - Kite ticker mock
src/mock-kite-ticker.ts - REST API
src/server/rest-server.ts - WebSocket server
src/server/ws-server.ts - Binary packet packing
src/server/binary-packer.ts - MCP tools and server
src/mcp/tools.ts
Mock orchestration
- Mock engine
src/mock-engine.ts - Broker services
src/services
Trading and portfolio
- GTT triggers
src/core/gtt-engine.ts - Order lifecycle
src/core/order-engine.ts - Order matching
src/core/matching-engine.ts - Ledger and fills
src/core/ledger-engine.ts - Positions
src/core/position-engine.ts - Margin calculations
src/core/margin-engine.ts
Market data
- Generator pool
src/market/generator-pool.ts - Random-walk generator
src/market/random-walk-generator.ts - CSV market data
src/market/csv-data-provider.ts - Historical replay
src/market/historical-replay.ts - Tick history
src/market/tick-history-buffer.ts - Tick event bus
src/market/tick-event-bus.ts
State and persistence
- Broker state store
src/state/state-store.ts - State persistence
src/state/state-persistence.ts
Other components
- Strategy client
- CSV data files
Connections 33
- Strategy client → Kite SDK mock: calls
README.md - Strategy client → REST API: requests
README.md - Strategy client → MCP tools and server: invokes tools
README.md - Strategy client → Kite ticker mock: subscribes
README.md - Kite SDK mock → Mock engine: delegates to
src/mock-kite-connect.ts - REST API → Broker services: routes requests
src/server/rest-server.ts - REST API → Mock engine: uses
src/server/rest-server.ts - MCP tools and server → Mock engine: calls
src/mcp/tools.ts - Kite ticker mock → Tick event bus: receives ticks
- WebSocket server → Tick event bus: streams ticks
- WebSocket server → Binary packet packing: packs packets
- Mock engine → Broker state store: coordinates state
src/mock-engine.ts - Mock engine → GTT triggers: constructs
src/mock-engine.ts - Mock engine → Broker services: wires services
src/mock-engine.ts - Mock engine → Generator pool: configures market data
src/mock-engine.ts - Generator pool → Random-walk generator: creates generators
src/market/generator-pool.ts - Generator pool → CSV market data: uses data provider
src/market/generator-pool.ts - CSV market data → CSV data files: loads
src/market/csv-data-provider.ts - Generator pool → Tick event bus: emits ticks
src/market/generator-pool.ts - Historical replay → Tick event bus: emits replay ticks
src/market/historical-replay.ts - Tick event bus → Order matching: dispatches ticks
src/core/matching-engine.ts - Order matching → Order lifecycle: updates fills
src/core/matching-engine.ts - Order matching → Ledger and fills: executes fills
src/core/matching-engine.ts - Ledger and fills → Positions: applies fills
src/core/ledger-engine.ts - Ledger and fills → Margin calculations: calculates margin
src/core/ledger-engine.ts - Order lifecycle → Margin calculations: checks affordability
src/core/order-engine.ts - Order lifecycle → Broker state store: stores orders
src/core/order-engine.ts - Positions → Broker state store: updates positions
src/core/position-engine.ts - Margin calculations → Broker state store: reads and updates
src/core/margin-engine.ts - Broker state store → State persistence: persists snapshot
- Broker services → Generator pool: serves quote data
src/services/quote-service.ts - Broker services → CSV market data: reads historical data
src/services/historical-service.ts - Broker services → Tick history: reads candles
src/services/historical-service.ts