@stryke-xyz/premarket-sdk 1.2.8 → 1.2.10

package/dist/cjs/package.json

@@ -1 +1 @@
-{"name":"@stryke-xyz/premarket-sdk","version":"1.2.7","type":"commonjs"}
+{"name":"@stryke-xyz/premarket-sdk","version":"1.2.10","type":"commonjs"}

package/dist/cjs/sync/clients/activity-client.js

@@ -315,12 +315,41 @@ function _object_spread(target) {
         {
             key: "handleMessage",
             value: function handleMessage(ev) {
-                var msg;
+                var parsed;
                 try {
-                    msg = JSON.parse(ev.data);
+                    parsed = JSON.parse(ev.data);
                 } catch (unused) {
                     return;
                 }
+                // Support both single object and batched array (from the 5ms WS batcher).
+                var messages = Array.isArray(parsed) ? parsed : [
+                    parsed
+                ];
+                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(var _iterator = messages[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        var msg = _step.value;
+                        this.dispatchMessage(msg);
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+            }
+        },
+        {
+            key: "dispatchMessage",
+            value: function dispatchMessage(msg) {
                 var type = msg.type;
                 if (type === "pong") {
                     this.clearHeartbeatTimeout();
@@ -345,7 +374,7 @@ function _object_spread(target) {
                     /* noop */ return;
                 }
                 if (type === "fill" || type === "order_update") {
-                    var _$ev = _object_spread({
+                    var ev = _object_spread({
                         type: type,
                         orderHash: msg.orderHash,
                         marketId: msg.marketId,
@@ -359,7 +388,7 @@ function _object_spread(target) {
                             var cbs = _step.value;
                             cbs.forEach(function(cb) {
                                 try {
-                                    cb(_$ev);
+                                    cb(ev);
                                 } catch (unused) {}
                             });
                         }

package/dist/cjs/sync/clients/order-client.js

@@ -257,7 +257,7 @@ function normalizePrice(price) {
     if (isNaN(num)) return price;
     return num.toString();
 }
-/** A market + its token IDs to subscribe to. */ /** Current depth state for a token within a market subscription. */ /** One bid or ask level change in the normalized SDK format. */ /** Raw level shape inside the wire `depth_update.levels[]` array. */ /** Raw `depth_update` frame as published by the depth projector. */ /** Consolidated depth update emitted to SDK listeners after normalization. */ /** Last applied executor sequenceId for this token (== endSeq of the frame). */ /** Range covered by this frame; clients can detect gaps via startSeq != prevSeq + 1. */ /**
+/** A market + its token IDs to subscribe to. */ /** Current depth state for a token within a market subscription. */ /** ms epoch when lastPrice was set on the server, or null if unknown. */ /** One bid or ask level change in the normalized SDK format. */ /** Raw level shape inside the wire `depth_update.levels[]` array. */ /** Raw `depth_update` frame as published by the depth projector. */ /** Consolidated depth update emitted to SDK listeners after normalization. */ /** ms epoch when lastPrice was set on the server, or null if unknown. */ /** Last applied executor sequenceId for this token (== endSeq of the frame). */ /** Range covered by this frame; clients can detect gaps via startSeq != prevSeq + 1. */ /**
  * Configuration for the market depth websocket client.
  *
  * Supports multiple markets over a single WebSocket connection.
@@ -309,6 +309,7 @@ function normalizePrice(price) {
         _define_property(this, "statusListeners", new Set());
         _define_property(this, "snapshotListeners", new Set());
         _define_property(this, "deltaListeners", new Set());
+        _define_property(this, "lastPriceListeners", new Set());
         // Reconnection state
         _define_property(this, "shouldBeConnected", false);
         _define_property(this, "reconnectAttempts", 0);
@@ -696,6 +697,23 @@ function normalizePrice(price) {
                 };
             }
         },
+        {
+            /**
+   * Subscribe to actual executor fill prices emitted by the depth projector's
+   * dedicated `last_price` WS message. Fires once per fill price in each flush
+   * window — does NOT fire for bid/ask-only market_state updates.
+   *
+   * @param listener Called with (marketId, tokenId, price, at) for each fill.
+   * @returns Unsubscribe function.
+   */ key: "onLastPrice",
+            value: function onLastPrice(listener) {
+                var _this = this;
+                this.lastPriceListeners.add(listener);
+                return function() {
+                    return _this.lastPriceListeners.delete(listener);
+                };
+            }
+        },
         {
             key: "onStatus",
             value: function onStatus(listener) {
@@ -756,12 +774,16 @@ function normalizePrice(price) {
                 try {
                     for(var _iterator = snapshots[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
                         var snapshot = _step.value;
+                        var _snapshot_bestBidAt, _snapshot_bestAskAt, _snapshot_lastPriceAt;
                         var state = {
                             bids: new Map(),
                             asks: new Map(),
                             bestBid: snapshot.bestBid,
                             bestAsk: snapshot.bestAsk,
+                            bestBidAt: (_snapshot_bestBidAt = snapshot.bestBidAt) !== null && _snapshot_bestBidAt !== void 0 ? _snapshot_bestBidAt : null,
+                            bestAskAt: (_snapshot_bestAskAt = snapshot.bestAskAt) !== null && _snapshot_bestAskAt !== void 0 ? _snapshot_bestAskAt : null,
                             lastPrice: snapshot.lastPrice,
+                            lastPriceAt: (_snapshot_lastPriceAt = snapshot.lastPriceAt) !== null && _snapshot_lastPriceAt !== void 0 ? _snapshot_lastPriceAt : null,
                             seq: snapshot.seq
                         };
                         var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
@@ -857,24 +879,80 @@ function normalizePrice(price) {
         {
             key: "handleMarketStateUpdate",
             value: function handleMarketStateUpdate(msg) {
-                var _msg_bestBid, _msg_bestAsk, _msg_lastPrice;
                 var state = this.tokenStates.get(String(msg.tokenId));
                 if (!state) return;
-                state.bestBid = (_msg_bestBid = msg.bestBid) !== null && _msg_bestBid !== void 0 ? _msg_bestBid : state.bestBid;
-                state.bestAsk = (_msg_bestAsk = msg.bestAsk) !== null && _msg_bestAsk !== void 0 ? _msg_bestAsk : state.bestAsk;
-                state.lastPrice = (_msg_lastPrice = msg.lastPrice) !== null && _msg_lastPrice !== void 0 ? _msg_lastPrice : state.lastPrice;
+                if (msg.bestBid != null) {
+                    var _msg_bestBidAt;
+                    state.bestBid = msg.bestBid;
+                    state.bestBidAt = (_msg_bestBidAt = msg.bestBidAt) !== null && _msg_bestBidAt !== void 0 ? _msg_bestBidAt : state.bestBidAt;
+                }
+                if (msg.bestAsk != null) {
+                    var _msg_bestAskAt;
+                    state.bestAsk = msg.bestAsk;
+                    state.bestAskAt = (_msg_bestAskAt = msg.bestAskAt) !== null && _msg_bestAskAt !== void 0 ? _msg_bestAskAt : state.bestAskAt;
+                }
+                if (msg.lastPrice != null) {
+                    var _msg_lastPriceAt;
+                    state.lastPrice = msg.lastPrice;
+                    state.lastPriceAt = (_msg_lastPriceAt = msg.lastPriceAt) !== null && _msg_lastPriceAt !== void 0 ? _msg_lastPriceAt : state.lastPriceAt;
+                }
                 this.emitOutOfBandUpdate(msg.marketId, msg.tokenId, state);
             }
         },
         {
             key: "handleLastPriceUpdate",
-            value: function handleLastPriceUpdate(msg) {
+            value: function handleLastPriceUpdate(msg) /** New batched format: all fill prices in this flush window. */ /** Legacy single-price format. */ {
                 var _ref, _msg_marketId;
                 var state = this.tokenStates.get(String(msg.tokenId));
                 if (!state) return;
-                state.lastPrice = msg.lastPrice;
                 var marketId = (_ref = (_msg_marketId = msg.marketId) !== null && _msg_marketId !== void 0 ? _msg_marketId : this.tokenToMarket.get(msg.tokenId)) !== null && _ref !== void 0 ? _ref : "";
-                this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                if (msg.prices && msg.prices.length > 0) {
+                    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        var _this, _loop = function() {
+                            var entry = _step.value;
+                            state.lastPrice = entry.price;
+                            state.lastPriceAt = entry.at;
+                            _this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                            _this.lastPriceListeners.forEach(function(listener) {
+                                try {
+                                    listener(marketId, msg.tokenId, entry.price, entry.at);
+                                } catch (e) {
+                                    console.error(e);
+                                }
+                            });
+                        };
+                        // Emit one DepthUpdate per price so listeners see every fill price.
+                        for(var _iterator = msg.prices[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_this = this, _loop();
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                } else if (msg.lastPrice != null) {
+                    var _msg_lastPriceAt, _ref1, _msg_lastPriceAt1;
+                    // Legacy single-price fallback.
+                    state.lastPrice = msg.lastPrice;
+                    state.lastPriceAt = (_msg_lastPriceAt = msg.lastPriceAt) !== null && _msg_lastPriceAt !== void 0 ? _msg_lastPriceAt : state.lastPriceAt;
+                    this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                    var at = (_ref1 = (_msg_lastPriceAt1 = msg.lastPriceAt) !== null && _msg_lastPriceAt1 !== void 0 ? _msg_lastPriceAt1 : state.lastPriceAt) !== null && _ref1 !== void 0 ? _ref1 : Date.now();
+                    this.lastPriceListeners.forEach(function(listener) {
+                        try {
+                            listener(marketId, msg.tokenId, msg.lastPrice, at);
+                        } catch (e) {
+                            console.error(e);
+                        }
+                    });
+                }
             }
         },
         {
@@ -885,7 +963,10 @@ function normalizePrice(price) {
                     levels: [],
                     bestBid: state.bestBid,
                     bestAsk: state.bestAsk,
+                    bestBidAt: state.bestBidAt,
+                    bestAskAt: state.bestAskAt,
                     lastPrice: state.lastPrice,
+                    lastPriceAt: state.lastPriceAt,
                     seq: state.seq,
                     startSeq: state.seq,
                     endSeq: state.seq
@@ -970,7 +1051,10 @@ function normalizePrice(price) {
                                     levels: emittedLevels,
                                     bestBid: state.bestBid,
                                     bestAsk: state.bestAsk,
+                                    bestBidAt: state.bestBidAt,
+                                    bestAskAt: state.bestAskAt,
                                     lastPrice: state.lastPrice,
+                                    lastPriceAt: state.lastPriceAt,
                                     seq: state.seq,
                                     startSeq: startSeq,
                                     endSeq: endSeq

package/dist/esm/package.json

@@ -1 +1 @@
-{"name":"@stryke-xyz/premarket-sdk","version":"1.2.7","type":"module"}
+{"name":"@stryke-xyz/premarket-sdk","version":"1.2.10","type":"module"}

package/dist/esm/sync/clients/activity-client.js

@@ -305,12 +305,41 @@ function _object_spread(target) {
         {
             key: "handleMessage",
             value: function handleMessage(ev) {
-                var msg;
+                var parsed;
                 try {
-                    msg = JSON.parse(ev.data);
+                    parsed = JSON.parse(ev.data);
                 } catch (unused) {
                     return;
                 }
+                // Support both single object and batched array (from the 5ms WS batcher).
+                var messages = Array.isArray(parsed) ? parsed : [
+                    parsed
+                ];
+                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(var _iterator = messages[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        var msg = _step.value;
+                        this.dispatchMessage(msg);
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+            }
+        },
+        {
+            key: "dispatchMessage",
+            value: function dispatchMessage(msg) {
                 var type = msg.type;
                 if (type === "pong") {
                     this.clearHeartbeatTimeout();
@@ -335,7 +364,7 @@ function _object_spread(target) {
                     /* noop */ return;
                 }
                 if (type === "fill" || type === "order_update") {
-                    var _$ev = _object_spread({
+                    var ev = _object_spread({
                         type: type,
                         orderHash: msg.orderHash,
                         marketId: msg.marketId,
@@ -349,7 +378,7 @@ function _object_spread(target) {
                             var cbs = _step.value;
                             cbs.forEach(function(cb) {
                                 try {
-                                    cb(_$ev);
+                                    cb(ev);
                                 } catch (unused) {}
                             });
                         }

package/dist/esm/sync/clients/order-client.js

@@ -247,7 +247,7 @@ function normalizePrice(price) {
     if (isNaN(num)) return price;
     return num.toString();
 }
-/** A market + its token IDs to subscribe to. */ /** Current depth state for a token within a market subscription. */ /** One bid or ask level change in the normalized SDK format. */ /** Raw level shape inside the wire `depth_update.levels[]` array. */ /** Raw `depth_update` frame as published by the depth projector. */ /** Consolidated depth update emitted to SDK listeners after normalization. */ /** Last applied executor sequenceId for this token (== endSeq of the frame). */ /** Range covered by this frame; clients can detect gaps via startSeq != prevSeq + 1. */ /**
+/** A market + its token IDs to subscribe to. */ /** Current depth state for a token within a market subscription. */ /** ms epoch when lastPrice was set on the server, or null if unknown. */ /** One bid or ask level change in the normalized SDK format. */ /** Raw level shape inside the wire `depth_update.levels[]` array. */ /** Raw `depth_update` frame as published by the depth projector. */ /** Consolidated depth update emitted to SDK listeners after normalization. */ /** ms epoch when lastPrice was set on the server, or null if unknown. */ /** Last applied executor sequenceId for this token (== endSeq of the frame). */ /** Range covered by this frame; clients can detect gaps via startSeq != prevSeq + 1. */ /**
  * Configuration for the market depth websocket client.
  *
  * Supports multiple markets over a single WebSocket connection.
@@ -299,6 +299,7 @@ function normalizePrice(price) {
         _define_property(this, "statusListeners", new Set());
         _define_property(this, "snapshotListeners", new Set());
         _define_property(this, "deltaListeners", new Set());
+        _define_property(this, "lastPriceListeners", new Set());
         // Reconnection state
         _define_property(this, "shouldBeConnected", false);
         _define_property(this, "reconnectAttempts", 0);
@@ -686,6 +687,23 @@ function normalizePrice(price) {
                 };
             }
         },
+        {
+            /**
+   * Subscribe to actual executor fill prices emitted by the depth projector's
+   * dedicated `last_price` WS message. Fires once per fill price in each flush
+   * window — does NOT fire for bid/ask-only market_state updates.
+   *
+   * @param listener Called with (marketId, tokenId, price, at) for each fill.
+   * @returns Unsubscribe function.
+   */ key: "onLastPrice",
+            value: function onLastPrice(listener) {
+                var _this = this;
+                this.lastPriceListeners.add(listener);
+                return function() {
+                    return _this.lastPriceListeners.delete(listener);
+                };
+            }
+        },
         {
             key: "onStatus",
             value: function onStatus(listener) {
@@ -746,12 +764,16 @@ function normalizePrice(price) {
                 try {
                     for(var _iterator = snapshots[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
                         var snapshot = _step.value;
+                        var _snapshot_bestBidAt, _snapshot_bestAskAt, _snapshot_lastPriceAt;
                         var state = {
                             bids: new Map(),
                             asks: new Map(),
                             bestBid: snapshot.bestBid,
                             bestAsk: snapshot.bestAsk,
+                            bestBidAt: (_snapshot_bestBidAt = snapshot.bestBidAt) !== null && _snapshot_bestBidAt !== void 0 ? _snapshot_bestBidAt : null,
+                            bestAskAt: (_snapshot_bestAskAt = snapshot.bestAskAt) !== null && _snapshot_bestAskAt !== void 0 ? _snapshot_bestAskAt : null,
                             lastPrice: snapshot.lastPrice,
+                            lastPriceAt: (_snapshot_lastPriceAt = snapshot.lastPriceAt) !== null && _snapshot_lastPriceAt !== void 0 ? _snapshot_lastPriceAt : null,
                             seq: snapshot.seq
                         };
                         var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
@@ -847,24 +869,80 @@ function normalizePrice(price) {
         {
             key: "handleMarketStateUpdate",
             value: function handleMarketStateUpdate(msg) {
-                var _msg_bestBid, _msg_bestAsk, _msg_lastPrice;
                 var state = this.tokenStates.get(String(msg.tokenId));
                 if (!state) return;
-                state.bestBid = (_msg_bestBid = msg.bestBid) !== null && _msg_bestBid !== void 0 ? _msg_bestBid : state.bestBid;
-                state.bestAsk = (_msg_bestAsk = msg.bestAsk) !== null && _msg_bestAsk !== void 0 ? _msg_bestAsk : state.bestAsk;
-                state.lastPrice = (_msg_lastPrice = msg.lastPrice) !== null && _msg_lastPrice !== void 0 ? _msg_lastPrice : state.lastPrice;
+                if (msg.bestBid != null) {
+                    var _msg_bestBidAt;
+                    state.bestBid = msg.bestBid;
+                    state.bestBidAt = (_msg_bestBidAt = msg.bestBidAt) !== null && _msg_bestBidAt !== void 0 ? _msg_bestBidAt : state.bestBidAt;
+                }
+                if (msg.bestAsk != null) {
+                    var _msg_bestAskAt;
+                    state.bestAsk = msg.bestAsk;
+                    state.bestAskAt = (_msg_bestAskAt = msg.bestAskAt) !== null && _msg_bestAskAt !== void 0 ? _msg_bestAskAt : state.bestAskAt;
+                }
+                if (msg.lastPrice != null) {
+                    var _msg_lastPriceAt;
+                    state.lastPrice = msg.lastPrice;
+                    state.lastPriceAt = (_msg_lastPriceAt = msg.lastPriceAt) !== null && _msg_lastPriceAt !== void 0 ? _msg_lastPriceAt : state.lastPriceAt;
+                }
                 this.emitOutOfBandUpdate(msg.marketId, msg.tokenId, state);
             }
         },
         {
             key: "handleLastPriceUpdate",
-            value: function handleLastPriceUpdate(msg) {
+            value: function handleLastPriceUpdate(msg) /** New batched format: all fill prices in this flush window. */ /** Legacy single-price format. */ {
                 var _ref, _msg_marketId;
                 var state = this.tokenStates.get(String(msg.tokenId));
                 if (!state) return;
-                state.lastPrice = msg.lastPrice;
                 var marketId = (_ref = (_msg_marketId = msg.marketId) !== null && _msg_marketId !== void 0 ? _msg_marketId : this.tokenToMarket.get(msg.tokenId)) !== null && _ref !== void 0 ? _ref : "";
-                this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                if (msg.prices && msg.prices.length > 0) {
+                    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        var _this, _loop = function() {
+                            var entry = _step.value;
+                            state.lastPrice = entry.price;
+                            state.lastPriceAt = entry.at;
+                            _this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                            _this.lastPriceListeners.forEach(function(listener) {
+                                try {
+                                    listener(marketId, msg.tokenId, entry.price, entry.at);
+                                } catch (e) {
+                                    console.error(e);
+                                }
+                            });
+                        };
+                        // Emit one DepthUpdate per price so listeners see every fill price.
+                        for(var _iterator = msg.prices[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_this = this, _loop();
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                } else if (msg.lastPrice != null) {
+                    var _msg_lastPriceAt, _ref1, _msg_lastPriceAt1;
+                    // Legacy single-price fallback.
+                    state.lastPrice = msg.lastPrice;
+                    state.lastPriceAt = (_msg_lastPriceAt = msg.lastPriceAt) !== null && _msg_lastPriceAt !== void 0 ? _msg_lastPriceAt : state.lastPriceAt;
+                    this.emitOutOfBandUpdate(marketId, msg.tokenId, state);
+                    var at = (_ref1 = (_msg_lastPriceAt1 = msg.lastPriceAt) !== null && _msg_lastPriceAt1 !== void 0 ? _msg_lastPriceAt1 : state.lastPriceAt) !== null && _ref1 !== void 0 ? _ref1 : Date.now();
+                    this.lastPriceListeners.forEach(function(listener) {
+                        try {
+                            listener(marketId, msg.tokenId, msg.lastPrice, at);
+                        } catch (e) {
+                            console.error(e);
+                        }
+                    });
+                }
             }
         },
         {
@@ -875,7 +953,10 @@ function normalizePrice(price) {
                     levels: [],
                     bestBid: state.bestBid,
                     bestAsk: state.bestAsk,
+                    bestBidAt: state.bestBidAt,
+                    bestAskAt: state.bestAskAt,
                     lastPrice: state.lastPrice,
+                    lastPriceAt: state.lastPriceAt,
                     seq: state.seq,
                     startSeq: state.seq,
                     endSeq: state.seq
@@ -960,7 +1041,10 @@ function normalizePrice(price) {
                                     levels: emittedLevels,
                                     bestBid: state.bestBid,
                                     bestAsk: state.bestAsk,
+                                    bestBidAt: state.bestBidAt,
+                                    bestAskAt: state.bestAskAt,
                                     lastPrice: state.lastPrice,
+                                    lastPriceAt: state.lastPriceAt,
                                     seq: state.seq,
                                     startSeq: startSeq,
                                     endSeq: endSeq

package/dist/types/sync/clients/activity-client.d.ts

@@ -81,6 +81,7 @@ export declare class ActivitySyncClient {
     private send;
     private resubscribeAll;
     private handleMessage;
+    private dispatchMessage;
     private normalizeFill;
     private startHeartbeat;
     private stopHeartbeat;

package/dist/types/sync/clients/order-client.d.ts

@@ -15,7 +15,11 @@ export interface TokenDepthSnapshot {
     asks: DepthLevel[];
     bestBid: string | null;
     bestAsk: string | null;
+    bestBidAt: number | null;
+    bestAskAt: number | null;
     lastPrice: string | null;
+    /** ms epoch when lastPrice was set on the server, or null if unknown. */
+    lastPriceAt: number | null;
     seq: number;
 }
 /** One bid or ask level change in the normalized SDK format. */
@@ -30,7 +34,11 @@ export interface DepthUpdate {
     levels: DepthLevelUpdate[];
     bestBid: string | null;
     bestAsk: string | null;
+    bestBidAt: number | null;
+    bestAskAt: number | null;
     lastPrice: string | null;
+    /** ms epoch when lastPrice was set on the server, or null if unknown. */
+    lastPriceAt: number | null;
     /** Last applied executor sequenceId for this token (== endSeq of the frame). */
     seq: number;
     /** Range covered by this frame; clients can detect gaps via startSeq != prevSeq + 1. */
@@ -98,6 +106,7 @@ export declare class MarketDepthSyncClient {
     private statusListeners;
     private snapshotListeners;
     private deltaListeners;
+    private lastPriceListeners;
     private shouldBeConnected;
     private reconnectAttempts;
     private reconnectTimeoutId;
@@ -133,6 +142,15 @@ export declare class MarketDepthSyncClient {
     getLastPrice(tokenId: string): string | null;
     onSnapshot(listener: (marketId: string, snapshots: TokenDepthSnapshot[]) => void): () => void;
     onDelta(listener: (marketId: string, update: DepthUpdate) => void): () => void;
+    /**
+     * Subscribe to actual executor fill prices emitted by the depth projector's
+     * dedicated `last_price` WS message. Fires once per fill price in each flush
+     * window — does NOT fire for bid/ask-only market_state updates.
+     *
+     * @param listener Called with (marketId, tokenId, price, at) for each fill.
+     * @returns Unsubscribe function.
+     */
+    onLastPrice(listener: (marketId: string, tokenId: string, price: string, at: number) => void): () => void;
     onStatus(listener: (status: SyncStatus) => void): () => void;
     private _sendSubscribeMarket;
     private handleSubscribedMarket;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke-xyz/premarket-sdk",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "type": "module",
   "module": "dist/esm/index.js",
   "main": "dist/cjs/index.js",