nautechsystems/nautilus_trader · error

L2 queue update should be processed

Error message

L2 queue update should be processed

What it means

Benchmark panic from `.expect("L2 queue update should be processed")` on `OrderMatchingEngine::process_order_book_delta` in the queue-position benchmark. The engine validates Add/Update delta price/size precision against the instrument and applies the delta to the L2 book, seeding and adjusting order queue positions; any precision mismatch or `book.apply_delta` failure returns `Err` and panics the bench.

Source

Thrown at crates/execution/benches/matching_engine.rs:246

                        assert_events(state, EventCounts::default());
                        assert_order_status(state, OrderStatus::Accepted, order_count);
                    },
                )
            });
        });

        // Level-wide updates affect every order queued at the updated price
        group.bench_function(BenchmarkId::new("delta_l2_update", order_count), |b| {
            b.iter_custom(|iters| {
                run_iterations(
                    iters,
                    || build_queue_engine(BookType::L2_MBP, &orders, Some(&bid), None),
                    |state| {
                        for delta in &updates {
                            state
                                .engine
                                .process_order_book_delta(black_box(delta))
                                .expect("L2 queue update should be processed");
                        }
                    },
                    |state| {
                        assert_eq!(
                            state.engine.get_book().update_count,
                            (MARKET_DATA_COUNT + 1) as u64,
                        );
                        assert_events(state, EventCounts::default());
                        assert_order_status(state, OrderStatus::Accepted, order_count);
                    },
                )
            });
        });

        // Per-order L3 updates expose the tracked-order lookup cost
        group.bench_function(BenchmarkId::new("delta_l3_update", order_count), |b| {
            b.iter_custom(|iters| {
                run_iterations(

View on GitHub (pinned to 18893faf8b)

Solutions

1. Build the queue-update deltas from the same instrument precision and price levels used to seed `orders` and the book.
2. Ensure each Update delta targets an existing level/order created by the seed deltas (Apply order matters).
3. Read the anyhow error message to identify the failing check (price precision, size precision, or apply_delta) and fix the generator accordingly.

Example fix

// before
state.engine.process_order_book_delta(black_box(delta)).expect("L2 queue update should be processed");
// after
state.engine.process_order_book_delta(black_box(delta))
    .unwrap_or_else(|e| panic!("queue update at {:?} rejected: {e}", delta.order.price));

// build queue updates from the same seeded book state
assert!(updates.iter().all(|d| seeded_levels.contains(&d.order.price)),
        "every update must target a seeded level");

fn targets_seeded_level(d: &OrderBookDelta, seeded: &[Price]) -> bool {
    seeded.iter().any(|p| **p == d.order.price)
}

if let Err(e) = engine.process_order_book_delta(update) {
    log::error!("queue update rejected: {e} — verify precision and seeded level consistency");
}

When it happens

Trigger: The synthetic queue-update deltas having price/size precision inconsistent with the instrument in `build_queue_engine`; an update referencing a price level/order state the L2 book doesn't contain; flags on the delta triggering snapshot/clear handling unexpectedly.

Common situations: Queue-update generator emitting sizes rounded differently from the order sizes seeded via `orders`; changing `queue_position` config or book type without regenerating deltas; price levels drifted between the seeded book and update stream.

Understand the failure class

Background: "Must be a positive integer", "Invalid value", "Unsupported": the invalid-argument-value error family, when a library rejects the value you pass — this error's family across 35 libraries.

Related errors

• L2 delta should be processed
• L3 queue update should be processed
• `handle_book_mbo` {IMPL_ERR} `{}`
• NoOrderSide
• Binance Futures supports L1_MBP and L2_MBP order book subscr

AI-assisted analysis of nautechsystems/nautilus_trader@18893faf8b (2026-09-08). Data as JSON: /api/errors/b191a5c991da078c. Report an issue: GitHub.