Startup Recovery
Praxis recovery starts from the Event Spine, not from mutable in-memory state.
The current startup path is:
- read all events for the current epoch
- verify the Event Spine hash chain before granting order capability
- replay those events per account into
TradingState - load symbol filters for any active symbols
- connect Binance user streams
- backfill missed fills from the reconcile cursor and reconcile open local orders against the venue while submission is gated
- mark accounts ready only after replay and a complete reconciliation
That means a process restart can rebuild local order and position state deterministically from durable events.
What Reconciliation Does
The current implementation focuses on execution-state reconciliation:
- query open orders from the venue
- walk myTrades from the durable per-
(account, symbol)reconcile cursor (inclusive overlap, exclusive advance, short-page stop, per-pass page cap), or from a bootstrap time window when no cursor exists yet - backfill missing
FillReceivedevents and advance the cursor after each append - backfill terminal order states when the venue is already canceled, expired, or rejected
Reconciliation uses event append plus normal projection updates, rather than mutating local state out of band.
The Reconnect Submission Gate
Reconnect reconciliation runs at boot and on every WebSocket reconnect edge. While it runs, new-command submission for that account is gated so no order is sent against a local view that has not yet absorbed the missed fills. The account is released only after a complete backfill and reconcile.
The gate is fail-closed:
- an incomplete backfill (page cap hit) keeps the account gated until a later pass drains the remainder
- a venue failure keeps the account gated
- a projection failure poisons the account: the per-account writer stops projecting and the account trades no further until a restart replays the durable state
Re-entering reconciliation while a pass is already in flight schedules exactly one rerun, so a reconnect that arrives mid-reconcile is not lost.
What It Does Not Yet Do
The RFC describes a broader reconciliation engine than what ships today. Now implemented: periodic per-asset balance reconciliation against the venue (a shortfall floor check that appends a ReconciliationMismatch), and fund-transaction polling that books quote-asset deposits and withdrawals into the ledger. The current code does not yet implement:
- the richer mismatch reporting surface described in the RFC (only the shortfall floor is emitted)
- a system-wide health/reduce-only/halt response inside Praxis itself
So the right way to describe the current behavior is: recovery, order-level reconciliation, balance-shortfall reconciliation, and fund-transaction booking are implemented; the full RFC reconciliation engine is not.
Why Fill Dedup Matters
Praxis uses fill_dedup_v2 in the Event Spine โ keyed per (epoch, account, symbol, venue_trade_id) โ to avoid double-counting fills during:
- WebSocket reconnection
- REST backfill
- reconciliation after restart
Without that dedup path, repeated venue fills could inflate positions and distort outcomes. The legacy fill_dedup table no longer exists: the version 4 migration folded its rows into fill_dedup_v2 under the symbol the version 3 migration proved, and dropped it.