@0xmonaco/core 1.0.50 → 1.0.51

package/dist/api/websocket/websocket.js

@@ -7,8 +7,6 @@ const CONNECTION_TIMEOUT = 10000;
 const HEARTBEAT_INTERVAL = 15000;
 const MAX_RECONNECT_DELAY = 30000;
 const RECONNECT_BASE_DELAY = 1000;
-const TWAP_ORDER_STATES = ["PENDING", "ACTIVE", "COMPLETED", "CANCELLED"];
-const INSTRUMENT_CHANGE_KINDS = ["listing", "delisting", "halt", "unhalt", "config_change"];
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -134,6 +132,10 @@ function parseConditionalOrderEvent(rawData) {
             // passed through untouched rather than matched against a value list.
             reason: readString(data, "reason"),
             updatedAt: readString(data, "updatedAt"),
+            // Populated on the subscribe-time snapshot frame and absent on live
+            // updates (0XM-2440). Reading it optionally is what keeps the
+            // snapshot's value from being silently dropped before the subscriber.
+            version: readOptionalNumber(data, "version"),
         },
     };
 }
@@ -310,7 +312,14 @@ function parseInstrumentEventData(raw) {
     }
     const data = keysToCamelCase(raw);
     return {
-        change: readEnum(data, "change", INSTRUMENT_CHANGE_KINDS),
+        // Read as a plain non-empty string, not matched against a value list: an
+        // unrecognized change kind must not throw, because the throw is swallowed
+        // by the message-handler catch and takes the whole frame with it — and
+        // every instrument frame carries the market's FULL current config, so a
+        // dropped frame can hide a market going inactive behind an unfamiliar
+        // label. The declared `InstrumentChangeKind` union documents the values
+        // the server sends today, not a runtime guarantee.
+        change: readString(data, "change"),
         tradingPairId: readString(data, "tradingPairId"),
         symbol: readString(data, "symbol"),
         isActive: readBoolean(data, "isActive"),
@@ -373,9 +382,16 @@ function parseTwapOrderEvent(rawData) {
     if (typeof twapOrderId !== "string" || twapOrderId.length === 0) {
         throw new Error("Invalid TWAP order event: twapOrderId must be a non-empty string");
     }
+    // `state` is required, so an absent/non-string/empty one is a malformed
+    // frame — but an unrecognized VALUE is passed through untouched. Matching it
+    // against a value list would throw, the message-handler catch would swallow
+    // the throw, and the whole update would be lost: a TWAP order whose state
+    // this SDK version predates would stop reporting its fills entirely
+    // (0XM-2627's failure mode). The declared `TwapOrderState` union documents
+    // the values the server sends today, not a runtime guarantee.
     const state = data.state;
-    if (typeof state !== "string" || !TWAP_ORDER_STATES.includes(state)) {
-        throw new Error(`Invalid TWAP order event: state must be one of ${TWAP_ORDER_STATES.join(", ")}`);
+    if (typeof state !== "string" || state.length === 0) {
+        throw new Error("Invalid TWAP order event: state must be a non-empty string");
     }
     return {
         eventType: "twap_order_update",
@@ -553,6 +569,21 @@ export function createMonacoWebSocket(baseUrl, options = {}) {
         return frameChannel === subscriptionChannel || frameChannel.startsWith(`${subscriptionChannel}:`);
     };
     const routeMessage = (msg) => {
+        if (msg.type === "Error") {
+            // Connection-scoped, not channel-scoped: an Error frame matches no
+            // subscription, so without this it reached no consumer at all and a
+            // failed subscribe / invalidated session / unreadable subscribe-time
+            // snapshot was silent. `code` is passed through whatever its value —
+            // a code added server-side after this SDK shipped must still reach the
+            // app rather than be dropped for being unrecognized (0XM-2627's
+            // leniency contract) — but a frame missing either field is malformed,
+            // and synthesizing the missing half would send the app down a branch on
+            // data the server never sent.
+            if (typeof msg.code === "string" && typeof msg.message === "string") {
+                options.onError?.({ code: msg.code, message: msg.message });
+            }
+            return;
+        }
         if (!msg.channel)
             return;
         if (msg.type === "Snapshot") {
@@ -816,7 +847,15 @@ export function createMonacoWebSocket(baseUrl, options = {}) {
                 // Concrete price series of this candle (`trade`/`mark`). Present on
                 // every current frame; a wildcard (`*`) subscriber reads it to tell the
                 // two streams apart. Omitted when a legacy frame carries no `price_type`.
-                const priceType = data.price_type === "trade" || data.price_type === "mark" ? data.price_type : undefined;
+                //
+                // Passed through rather than matched against the two known values: a
+                // wildcard subscription accepts any suffix, so a series added
+                // server-side after this version reaches this parser, and reporting it
+                // as `undefined` would leave a wildcard subscriber unable to do the one
+                // thing the field exists for. Only a missing or non-string value is
+                // treated as absent.
+                const rawPriceType = data.price_type;
+                const priceType = typeof rawPriceType === "string" && rawPriceType !== "" ? rawPriceType : undefined;
                 const event = {
                     // `trading_pair_id` is the pair UUID; `symbol` is the display string.
                     // `tradingPairId` must carry the UUID (the symbol lives in `candlestick.s`).
@@ -887,12 +926,17 @@ export function createMonacoWebSocket(baseUrl, options = {}) {
                         token: (movementData.token ?? movementData.token_address),
                         tokenAddress: (movementData.token ?? movementData.token_address),
                         assetId: movementData.asset_id,
+                        symbol: movementData.symbol,
                         amount: String(movementData.amount),
                         amountRaw: movementData.amount_raw,
                         balanceBefore: movementData.balance_before != null ? String(movementData.balance_before) : undefined,
+                        balanceBeforeRaw: movementData.balance_before_raw,
                         balanceAfter: movementData.balance_after != null ? String(movementData.balance_after) : undefined,
+                        balanceAfterRaw: movementData.balance_after_raw,
                         lockedBefore: movementData.locked_before != null ? String(movementData.locked_before) : undefined,
+                        lockedBeforeRaw: movementData.locked_before_raw,
                         lockedAfter: movementData.locked_after != null ? String(movementData.locked_after) : undefined,
+                        lockedAfterRaw: movementData.locked_after_raw,
                         referenceId: movementData.reference_id,
                         referenceType: movementData.reference_type,
                         description: movementData.description,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.50",
+	"version": "1.0.51",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -19,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.50",
-		"@0xmonaco/types": "1.0.50",
+		"@0xmonaco/contracts": "1.0.51",
+		"@0xmonaco/types": "1.0.51",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"