exh

Execution algorithm workspace built on mkt.

Workspace

• crates/exh: reliable execution kernel
• crates/exh-kit: typed execution signals, helpers, testkit, and reference algorithms

Core idea

• User algorithms declare the desired execution shape, not imperative place/cancel/query steps.
• exh owns journal/replay, multi-child state, pending side-effect recovery, and target-state reconciliation.
• exh-kit owns ergonomic layers: signal canonicalization, typed algorithm metadata schemas, reusable execution primitives, and high-quality examples.
• mkt remains the trading primitive layer.

Execution model

• Engine advances from explicit observed_at, typed signals, and external order observations.
• External order updates are first-class; driver queries are only recovery fallback for pending actions.
• Algorithm implementations can remain stateless; execution-local scratchpad and audit metadata are journaled through decisions.
• Each advance executes at most one external side effect and then performs bounded internal convergence toward the current desired state.
• Strategy code can use exh_kit::schema wrappers to encode/decode algorithm state and audit structs without constructing raw JSON payloads.

Storage

• MemoryJournal exists for tests and simple runs.
• SqliteJournal provides a durable local backend on SQLite WAL with FULL synchronous mode.

Examples

• cargo run -p exh-kit --example robust_vwap
• cargo run -p exh-kit --example maker_ladder
• cargo run -p exh-kit --example deadline_catchup
• cargo run -p exh-kit --example adaptive_ioc_port
• cargo run -p exh-kit --example hierarchical_iceberg_oehrl
• cargo run -p exh-kit --example target_aware_pov
• cargo run -p exh-kit --example market_limit_rl_switch
• cargo run -p exh-kit --example basket_parent_allocator

See docs/adaptive_ioc_port.md for the gaps exposed while porting the top50 rotation executor's adaptive IOC loop. See docs/recent_execution_strategy_ports.md for the research-to-example mapping and framework gaps exposed by recent advanced execution strategies.