@0xmonaco/core 1.0.46 → 1.0.48

package/dist/api/trading/api.js

@@ -668,6 +668,10 @@ export class TradingAPIImpl extends BaseAPI {
             strategyKey: options.strategyKey,
             useMasterBalance: options.useMasterBalance,
             clientTwapId: options.clientTwapId,
+            executionStyle: options.executionStyle,
+            triggerPrice: options.triggerPrice,
+            triggerDirection: options.triggerDirection,
+            conditionalExpiry: options.conditionalExpiry,
         };
         return await this.makeAuthenticatedRequest(perpRoutes.orders.createTwap(), {
             method: "POST",

package/dist/api/websocket/types.d.ts

@@ -1,6 +1,5 @@
-import type { AccountEvent, ConditionalOrderEvent, InstrumentEvent, Interval, LiquidationEvent, MarketStatsAllEvent, MarketStatsEvent, MonacoWebSocketConfig, OHLCVEvent, OHLCVPriceType, OrderbookEvent, OrderbookQuotationMode, OrderEvent, PositionEvent, SessionCredentials, TradeEvent, TradingMode, TwapOrderEvent, UserBalanceEvent, UserMovementEvent, WebSocketStatus } from "@0xmonaco/types";
-export type { ResyncHandler, StatusHandler, WebSocketResyncInfo } from "@0xmonaco/types";
-export type MessageHandler<T> = (data: T) => void;
+import type { MonacoWebSocketConfig, SessionCredentials } from "@0xmonaco/types";
+export type { MessageHandler, MonacoWebSocket, ResyncHandler, StatusHandler, WebSocketResyncInfo } from "@0xmonaco/types";
 /**
  * Options for {@link createMonacoWebSocket}. The reconnect/resync knobs and
  * callbacks are shared with the main SDK config via {@link MonacoWebSocketConfig}
@@ -11,45 +10,3 @@ export interface MonacoWebSocketOptions extends MonacoWebSocketConfig {
     /** Session keypair for authenticated channels (orders, balances, etc.) */
     session?: SessionCredentials;
 }
-export interface MonacoWebSocket {
-    /** Connect to the WebSocket server */
-    connect: () => Promise<void>;
-    /** Disconnect from the WebSocket server */
-    disconnect: () => void;
-    /** Check if currently connected */
-    isConnected: () => boolean;
-    /** Get current websocket connection status */
-    getStatus: () => WebSocketStatus;
-    /** Set (or clear) the session keypair used to authenticate the connection */
-    setSessionKeypair: (credentials: SessionCredentials | undefined) => void;
-    /** Subscribe to order events (requires authentication) */
-    orders: (tradingPairId: string, tradingMode: TradingMode, handler: MessageHandler<OrderEvent>) => () => void;
-    /** Subscribe to orderbook events (public) */
-    orderbook: (tradingPairId: string, tradingMode: TradingMode, magnitude: number, quotationMode: OrderbookQuotationMode, handler: MessageHandler<OrderbookEvent>) => () => void;
-    /** Subscribe to OHLCV candlestick events (public) */
-    ohlcv: (tradingPairId: string, tradingMode: TradingMode, interval: Interval, handler: MessageHandler<OHLCVEvent>, priceType?: OHLCVPriceType) => () => void;
-    /** Subscribe to trade events (public) */
-    trades: (tradingPairId: string, handler: MessageHandler<TradeEvent>) => () => void;
-    /** Subscribe to user movement events (requires authentication) */
-    movements: (handler: MessageHandler<UserMovementEvent>) => () => void;
-    /** Subscribe to user order events for all trading pairs (requires authentication) */
-    userOrders: (handler: MessageHandler<OrderEvent>) => () => void;
-    /** Subscribe to user balance events (requires authentication) */
-    balances: (handler: MessageHandler<UserBalanceEvent>) => () => void;
-    /** Subscribe to conditional TP/SL lifecycle events (requires authentication) */
-    conditionalOrders: (handler: MessageHandler<ConditionalOrderEvent>, tradingPairId?: string) => () => void;
-    /** Subscribe to TWAP parent-order lifecycle events (requires authentication) */
-    twapOrders: (handler: MessageHandler<TwapOrderEvent>, tradingPairId?: string) => () => void;
-    /** Subscribe to position state updates (requires authentication); omit `tradingPairId` for all pairs */
-    positions: (handler: MessageHandler<PositionEvent>, tradingPairId?: string) => () => void;
-    /** Subscribe to liquidation alerts (requires authentication); omit `tradingPairId` for all pairs */
-    liquidations: (handler: MessageHandler<LiquidationEvent>, tradingPairId?: string) => () => void;
-    /** Subscribe to account-level margin health updates for the authenticated user (requires authentication) */
-    account: (handler: MessageHandler<AccountEvent>) => () => void;
-    /** Subscribe to market lifecycle + config changes (public); omit `tradingPairId` for all markets */
-    instruments: (handler: MessageHandler<InstrumentEvent>, tradingPairId?: string) => () => void;
-    /** Subscribe to per-market statistics for one trading pair (public) */
-    marketStats: (tradingPairId: string, handler: MessageHandler<MarketStatsEvent>) => () => void;
-    /** Subscribe to the all-markets statistics summary (public) */
-    marketStatsAll: (handler: MessageHandler<MarketStatsAllEvent>) => () => void;
-}

package/dist/api/websocket/websocket.js

@@ -7,11 +7,6 @@ const CONNECTION_TIMEOUT = 10000;
 const HEARTBEAT_INTERVAL = 15000;
 const MAX_RECONNECT_DELAY = 30000;
 const RECONNECT_BASE_DELAY = 1000;
-const CONDITIONAL_ORDER_REASONS = ["created", "activated", "cancelled", "parent_cancelled", "triggered", "failed", "oco_cancelled"];
-const CONDITIONAL_ORDER_CONDITION_TYPES = ["STOP_LOSS", "TAKE_PROFIT"];
-const CONDITIONAL_ORDER_TRIGGER_SOURCES = ["MARK_PRICE"];
-const CONDITIONAL_ORDER_STATES = ["PENDING_PARENT", "ACTIVE", "TRIGGERING", "TRIGGERED", "CANCELLED", "EXPIRED", "FAILED"];
-const CONDITIONAL_ORDER_ASSOCIATION_TYPES = ["POSITION", "PARENT_ORDER"];
 const TWAP_ORDER_STATES = ["PENDING", "ACTIVE", "COMPLETED", "CANCELLED"];
 const INSTRUMENT_CHANGE_KINDS = ["listing", "delisting", "halt", "unhalt", "config_change"];
 function isRecord(value) {
@@ -40,6 +35,19 @@ function readBoolean(source, field) {
     }
     return value;
 }
+/**
+ * Read a wire sequence counter: a non-negative safe integer. The server
+ * serializes Rust `u64` sequence fields as plain JSON numbers, so a negative,
+ * fractional, or unsafe (> 2^53 - 1) value is a malformed frame that would
+ * corrupt ordering/dedup logic — reject it rather than pass it through.
+ */
+function readSequence(source, field) {
+    const value = source[field];
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Invalid WebSocket event: ${field} must be a non-negative safe integer`);
+    }
+    return value;
+}
 function readOptionalNumber(source, field) {
     const value = source[field];
     if (value === undefined || value === null)
@@ -63,14 +71,20 @@ function readEnum(source, field, allowed) {
     }
     return value;
 }
-function readOptionalEnum(source, field, allowed) {
-    const value = source[field];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "string" || !allowed.includes(value)) {
-        throw new Error(`Invalid WebSocket event: ${field} must be one of ${allowed.join(", ")}`);
-    }
-    return value;
+/**
+ * Read an optional wire enum leniently.
+ *
+ * Absent, `null`, and a present-but-empty string all mean "not set": server
+ * side these fields are `Option<..>` over closed enums, so `""` is a malformed
+ * value rather than a variant this SDK version predates, and letting it through
+ * would put a string the union does not contain onto the typed surface. It is
+ * mapped to absent rather than thrown on, because throwing would drop the whole
+ * frame over one optional field. A non-empty value is passed through untouched,
+ * whether or not the SDK recognizes it.
+ */
+function readOptionalEnumValue(source, field) {
+    const value = readOptionalString(source, field);
+    return value === undefined || value.length === 0 ? undefined : value;
 }
 function parseConditionalOrderEvent(rawData) {
     if (!isRecord(rawData)) {
@@ -81,6 +95,13 @@ function parseConditionalOrderEvent(rawData) {
     }
     const data = keysToCamelCase(rawData.data);
     return {
+        // event_type is the event-class discriminator, validated strictly so a
+        // mis-routed frame is rejected rather than parsed as a conditional order.
+        // The value fields below stay lenient — read as strings and cast, never
+        // checked against an allow-list — so an unexpected *value* never drops the
+        // whole update (0XM-2627). The parse throw is swallowed by the
+        // message-handler catch, so a strict enum here means a silently lost frame
+        // with nothing surfaced to the consumer.
         eventType: readEnum(rawData, "event_type", ["conditional_order_update"]),
         userId: readString(rawData, "user_id"),
         data: {
@@ -89,27 +110,29 @@ function parseConditionalOrderEvent(rawData) {
             marginAccountId: readString(data, "marginAccountId"),
             positionId: readOptionalString(data, "positionId"),
             parentOrderId: readOptionalString(data, "parentOrderId"),
-            associationType: readOptionalEnum(data, "associationType", CONDITIONAL_ORDER_ASSOCIATION_TYPES),
+            associationType: readOptionalEnumValue(data, "associationType"),
             linkedGroupId: readOptionalString(data, "linkedGroupId"),
-            conditionType: readEnum(data, "conditionType", CONDITIONAL_ORDER_CONDITION_TYPES),
-            triggerSource: readEnum(data, "triggerSource", CONDITIONAL_ORDER_TRIGGER_SOURCES),
+            conditionType: readString(data, "conditionType"),
+            triggerSource: readString(data, "triggerSource"),
             triggerPrice: readString(data, "triggerPrice"),
-            side: readEnum(data, "side", ["BUY", "SELL"]),
-            positionSide: readEnum(data, "positionSide", ["LONG", "SHORT", "NONE"]),
-            orderType: readEnum(data, "orderType", ["LIMIT", "MARKET"]),
+            side: readString(data, "side"),
+            positionSide: readString(data, "positionSide"),
+            orderType: readString(data, "orderType"),
             limitPrice: readOptionalString(data, "limitPrice"),
             quantity: readOptionalString(data, "quantity"),
             slippageToleranceBps: readOptionalNumber(data, "slippageToleranceBps"),
             reduceOnly: readBoolean(data, "reduceOnly"),
-            timeInForce: readOptionalEnum(data, "timeInForce", ["GTC", "IOC"]),
-            state: readEnum(data, "state", CONDITIONAL_ORDER_STATES),
+            timeInForce: readOptionalEnumValue(data, "timeInForce"),
+            state: readString(data, "state"),
             triggeredOrderId: readOptionalString(data, "triggeredOrderId"),
             triggeredAt: readOptionalString(data, "triggeredAt"),
             activatedAt: readOptionalString(data, "activatedAt"),
             cancelledAt: readOptionalString(data, "cancelledAt"),
             expiresAt: readOptionalString(data, "expiresAt"),
             failureReason: readOptionalString(data, "failureReason"),
-            reason: readEnum(data, "reason", CONDITIONAL_ORDER_REASONS),
+            // Free-form on the wire (the server field is a plain string), so it is
+            // passed through untouched rather than matched against a value list.
+            reason: readString(data, "reason"),
             updatedAt: readString(data, "updatedAt"),
         },
     };
@@ -194,6 +217,10 @@ function parseAccountEvent(rawData) {
         userId: readString(rawData, "user_id"),
         data: {
             marginAccountId: readString(data, "marginAccountId"),
+            // Monotonic per-account publish counter (0XM-2498): a plain JSON number on
+            // the wire, used to order/dedupe frames across reconnect races. Must be a
+            // non-negative safe integer — anything else is a malformed frame.
+            sequence: readSequence(data, "sequence"),
             equity: readString(data, "equity"),
             collateral: readString(data, "collateral"),
             freeCollateral: readString(data, "freeCollateral"),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.46",
+	"version": "1.0.48",
 	"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.46",
-		"@0xmonaco/types": "1.0.46",
+		"@0xmonaco/contracts": "1.0.48",
+		"@0xmonaco/types": "1.0.48",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"