@maxtrader/backtest-core

Deterministic simulation engine implementation.

Purpose

• Executes replay, order matching, risk rules, and journaling.
• Produces deterministic snapshots and analytics.
• Provides core primitives for parity and deterministic testing.

Key Exports

• createBacktestEngine
• BacktestEngineImpl
• DeterministicPaperBrokerAdapter
• runBacktestPaperParity
• determinism utilities: round8, stableHash, stableObjectHash
• analytics utilities and memory planning helpers

Minimal Usage

import { createBacktestEngine } from "@maxtrader/backtest-core";

const engine = createBacktestEngine({
  symbol: "EURUSD",
  timeframe: "M1",
  initialBalance: 10_000,
  seed: 0
});

engine.loadDataset(dataset);
engine.step(100);

const state = engine.getState();
const snapshot = engine.computeDeterminismSnapshot("core-run");

Integration Notes

• Use @maxtrader/backtest-browser-runtime for browser UI apps.
• Core is sync API; browser runtime wraps it as async worker API.
• Keep determinism constraints intact when extending engine internals.