pmxtjs 2.40.6 → 2.41.1

package/dist/generated/src/models/WatchAddressRequest.d.ts

@@ -9,7 +9,6 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { WatchAddressRequestArgsInner } from './WatchAddressRequestArgsInner';
 import type { ExchangeCredentials } from './ExchangeCredentials';
 /**
  *
@@ -19,10 +18,10 @@ import type { ExchangeCredentials } from './ExchangeCredentials';
 export interface WatchAddressRequest {
     /**
      *
-     * @type {Array<WatchAddressRequestArgsInner>}
+     * @type {Array<string>}
      * @memberof WatchAddressRequest
      */
-    args: Array<WatchAddressRequestArgsInner>;
+    args?: Array<string>;
     /**
      *
      * @type {ExchangeCredentials}

package/dist/generated/src/models/WatchAddressRequest.js

@@ -18,14 +18,11 @@ exports.WatchAddressRequestFromJSON = WatchAddressRequestFromJSON;
 exports.WatchAddressRequestFromJSONTyped = WatchAddressRequestFromJSONTyped;
 exports.WatchAddressRequestToJSON = WatchAddressRequestToJSON;
 exports.WatchAddressRequestToJSONTyped = WatchAddressRequestToJSONTyped;
-const WatchAddressRequestArgsInner_1 = require("./WatchAddressRequestArgsInner");
 const ExchangeCredentials_1 = require("./ExchangeCredentials");
 /**
  * Check if a given object implements the WatchAddressRequest interface.
  */
 function instanceOfWatchAddressRequest(value) {
-    if (!('args' in value) || value['args'] === undefined)
-        return false;
     return true;
 }
 function WatchAddressRequestFromJSON(json) {
@@ -36,7 +33,7 @@ function WatchAddressRequestFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'args': (json['args'].map(WatchAddressRequestArgsInner_1.WatchAddressRequestArgsInnerFromJSON)),
+        'args': json['args'] == null ? undefined : json['args'],
         'credentials': json['credentials'] == null ? undefined : (0, ExchangeCredentials_1.ExchangeCredentialsFromJSON)(json['credentials']),
     };
 }
@@ -48,7 +45,7 @@ function WatchAddressRequestToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'args': (value['args'].map(WatchAddressRequestArgsInner_1.WatchAddressRequestArgsInnerToJSON)),
+        'args': value['args'],
         'credentials': (0, ExchangeCredentials_1.ExchangeCredentialsToJSON)(value['credentials']),
     };
 }

package/dist/generated/src/models/WatchOrderBookRequest.d.ts

@@ -10,7 +10,6 @@
  * Do not edit the class manually.
  */
 import type { ExchangeCredentials } from './ExchangeCredentials';
-import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgsInner';
 /**
  *
  * @export
@@ -19,10 +18,10 @@ import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgs
 export interface WatchOrderBookRequest {
     /**
      *
-     * @type {Array<WatchOrderBookRequestArgsInner>}
+     * @type {Array<string>}
      * @memberof WatchOrderBookRequest
      */
-    args: Array<WatchOrderBookRequestArgsInner>;
+    args?: Array<string>;
     /**
      *
      * @type {ExchangeCredentials}

package/dist/generated/src/models/WatchOrderBookRequest.js

@@ -19,13 +19,10 @@ exports.WatchOrderBookRequestFromJSONTyped = WatchOrderBookRequestFromJSONTyped;
 exports.WatchOrderBookRequestToJSON = WatchOrderBookRequestToJSON;
 exports.WatchOrderBookRequestToJSONTyped = WatchOrderBookRequestToJSONTyped;
 const ExchangeCredentials_1 = require("./ExchangeCredentials");
-const WatchOrderBookRequestArgsInner_1 = require("./WatchOrderBookRequestArgsInner");
 /**
  * Check if a given object implements the WatchOrderBookRequest interface.
  */
 function instanceOfWatchOrderBookRequest(value) {
-    if (!('args' in value) || value['args'] === undefined)
-        return false;
     return true;
 }
 function WatchOrderBookRequestFromJSON(json) {
@@ -36,7 +33,7 @@ function WatchOrderBookRequestFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'args': (json['args'].map(WatchOrderBookRequestArgsInner_1.WatchOrderBookRequestArgsInnerFromJSON)),
+        'args': json['args'] == null ? undefined : json['args'],
         'credentials': json['credentials'] == null ? undefined : (0, ExchangeCredentials_1.ExchangeCredentialsFromJSON)(json['credentials']),
     };
 }
@@ -48,7 +45,7 @@ function WatchOrderBookRequestToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'args': (value['args'].map(WatchOrderBookRequestArgsInner_1.WatchOrderBookRequestArgsInnerToJSON)),
+        'args': value['args'],
         'credentials': (0, ExchangeCredentials_1.ExchangeCredentialsToJSON)(value['credentials']),
     };
 }

package/dist/generated/src/models/WatchOrderBooksRequest.d.ts

@@ -10,7 +10,6 @@
  * Do not edit the class manually.
  */
 import type { ExchangeCredentials } from './ExchangeCredentials';
-import type { WatchOrderBooksRequestArgsInner } from './WatchOrderBooksRequestArgsInner';
 /**
  *
  * @export
@@ -19,10 +18,10 @@ import type { WatchOrderBooksRequestArgsInner } from './WatchOrderBooksRequestAr
 export interface WatchOrderBooksRequest {
     /**
      *
-     * @type {Array<WatchOrderBooksRequestArgsInner>}
+     * @type {Array<string>}
      * @memberof WatchOrderBooksRequest
      */
-    args: Array<WatchOrderBooksRequestArgsInner>;
+    args?: Array<string>;
     /**
      *
      * @type {ExchangeCredentials}

package/dist/generated/src/models/WatchOrderBooksRequest.js

@@ -19,13 +19,10 @@ exports.WatchOrderBooksRequestFromJSONTyped = WatchOrderBooksRequestFromJSONType
 exports.WatchOrderBooksRequestToJSON = WatchOrderBooksRequestToJSON;
 exports.WatchOrderBooksRequestToJSONTyped = WatchOrderBooksRequestToJSONTyped;
 const ExchangeCredentials_1 = require("./ExchangeCredentials");
-const WatchOrderBooksRequestArgsInner_1 = require("./WatchOrderBooksRequestArgsInner");
 /**
  * Check if a given object implements the WatchOrderBooksRequest interface.
  */
 function instanceOfWatchOrderBooksRequest(value) {
-    if (!('args' in value) || value['args'] === undefined)
-        return false;
     return true;
 }
 function WatchOrderBooksRequestFromJSON(json) {
@@ -36,7 +33,7 @@ function WatchOrderBooksRequestFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'args': (json['args'].map(WatchOrderBooksRequestArgsInner_1.WatchOrderBooksRequestArgsInnerFromJSON)),
+        'args': json['args'] == null ? undefined : json['args'],
         'credentials': json['credentials'] == null ? undefined : (0, ExchangeCredentials_1.ExchangeCredentialsFromJSON)(json['credentials']),
     };
 }
@@ -48,7 +45,7 @@ function WatchOrderBooksRequestToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'args': (value['args'].map(WatchOrderBooksRequestArgsInner_1.WatchOrderBooksRequestArgsInnerToJSON)),
+        'args': value['args'],
         'credentials': (0, ExchangeCredentials_1.ExchangeCredentialsToJSON)(value['credentials']),
     };
 }

package/dist/generated/src/models/WatchTradesRequest.d.ts

@@ -10,7 +10,6 @@
  * Do not edit the class manually.
  */
 import type { ExchangeCredentials } from './ExchangeCredentials';
-import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgsInner';
 /**
  *
  * @export
@@ -19,10 +18,10 @@ import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgs
 export interface WatchTradesRequest {
     /**
      *
-     * @type {Array<WatchOrderBookRequestArgsInner>}
+     * @type {Array<string>}
      * @memberof WatchTradesRequest
      */
-    args: Array<WatchOrderBookRequestArgsInner>;
+    args?: Array<string>;
     /**
      *
      * @type {ExchangeCredentials}

package/dist/generated/src/models/WatchTradesRequest.js

@@ -19,13 +19,10 @@ exports.WatchTradesRequestFromJSONTyped = WatchTradesRequestFromJSONTyped;
 exports.WatchTradesRequestToJSON = WatchTradesRequestToJSON;
 exports.WatchTradesRequestToJSONTyped = WatchTradesRequestToJSONTyped;
 const ExchangeCredentials_1 = require("./ExchangeCredentials");
-const WatchOrderBookRequestArgsInner_1 = require("./WatchOrderBookRequestArgsInner");
 /**
  * Check if a given object implements the WatchTradesRequest interface.
  */
 function instanceOfWatchTradesRequest(value) {
-    if (!('args' in value) || value['args'] === undefined)
-        return false;
     return true;
 }
 function WatchTradesRequestFromJSON(json) {
@@ -36,7 +33,7 @@ function WatchTradesRequestFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'args': (json['args'].map(WatchOrderBookRequestArgsInner_1.WatchOrderBookRequestArgsInnerFromJSON)),
+        'args': json['args'] == null ? undefined : json['args'],
         'credentials': json['credentials'] == null ? undefined : (0, ExchangeCredentials_1.ExchangeCredentialsFromJSON)(json['credentials']),
     };
 }
@@ -48,7 +45,7 @@ function WatchTradesRequestToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'args': (value['args'].map(WatchOrderBookRequestArgsInner_1.WatchOrderBookRequestArgsInnerToJSON)),
+        'args': value['args'],
         'credentials': (0, ExchangeCredentials_1.ExchangeCredentialsToJSON)(value['credentials']),
     };
 }

package/dist/generated/src/models/index.d.ts

@@ -90,10 +90,7 @@ export * from './UnwatchOrderBookRequest';
 export * from './UserTrade';
 export * from './WatchAddress200Response';
 export * from './WatchAddressRequest';
-export * from './WatchAddressRequestArgsInner';
 export * from './WatchOrderBookRequest';
-export * from './WatchOrderBookRequestArgsInner';
 export * from './WatchOrderBooks200Response';
 export * from './WatchOrderBooksRequest';
-export * from './WatchOrderBooksRequestArgsInner';
 export * from './WatchTradesRequest';

package/dist/generated/src/models/index.js

@@ -108,10 +108,7 @@ __exportStar(require("./UnwatchOrderBookRequest"), exports);
 __exportStar(require("./UserTrade"), exports);
 __exportStar(require("./WatchAddress200Response"), exports);
 __exportStar(require("./WatchAddressRequest"), exports);
-__exportStar(require("./WatchAddressRequestArgsInner"), exports);
 __exportStar(require("./WatchOrderBookRequest"), exports);
-__exportStar(require("./WatchOrderBookRequestArgsInner"), exports);
 __exportStar(require("./WatchOrderBooks200Response"), exports);
 __exportStar(require("./WatchOrderBooksRequest"), exports);
-__exportStar(require("./WatchOrderBooksRequestArgsInner"), exports);
 __exportStar(require("./WatchTradesRequest"), exports);

package/dist/pmxt/client.d.ts

@@ -5,7 +5,7 @@
  * OpenAPI client, matching the Python API exactly.
  */
 import { Configuration, DefaultApi, ExchangeCredentials } from "../generated/src/index.js";
-import { Balance, BuiltOrder, CreateOrderParams, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, Position, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from "./models.js";
+import { Balance, BuiltOrder, CreateOrderParams, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, Position, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UserTrade, FirehoseEvent } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 /**
  * Base exchange client options.
@@ -68,6 +68,8 @@ export declare abstract class Exchange {
     protected serverManager: ServerManager;
     protected initPromise: Promise<void>;
     protected isHosted: boolean;
+    private _hostedAccount?;
+    private _accountDiscoveryPromise?;
     /**
      * Sticky flag: set to `true` the first time a GET read is rejected by
      * the sidecar with 404/405 (i.e. an older pmxt-core that only supports
@@ -252,6 +254,28 @@ export declare abstract class Exchange {
      * ```
      */
     watchOrderBooks(outcomeIds: (string | MarketOutcome)[], limit?: number): Promise<Record<string, OrderBook>>;
+    /**
+     * Stream all orderbook updates across venues via the hosted WebSocket API.
+     *
+     * Returns a promise that resolves with the next book event.
+     * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
+     * Requires hosted mode (`pmxtApiKey` set).
+     *
+     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @returns Next event with source, symbol, and orderbook
+     *
+     * @example
+     * ```typescript
+     * const poly = new Polymarket({ pmxtApiKey: "pmxt_xxx" });
+     * while (true) {
+     *   const event = await poly.watchAllOrderBooks();
+     *   console.log(event.source, event.symbol, event.orderbook.bids[0]);
+     * }
+     * ```
+     */
+    watchAllOrderBooks(venues?: string[]): Promise<FirehoseEvent>;
+    /** @deprecated Use {@link watchAllOrderBooks} instead. */
+    firehose(venues?: string[]): Promise<FirehoseEvent>;
     /**
      * Watch real-time trade updates via WebSocket.
      *
@@ -337,12 +361,9 @@ export declare abstract class Exchange {
     buildOrder(params: CreateOrderParams & {
         outcome?: MarketOutcome;
     }): Promise<BuiltOrder>;
+    private _discoverHostedAccount;
+    private _executeSorOrder;
     /**
-     * Create a new order.
-     *
-     * @param params - Order parameters
-     * @returns Created order
-     *
      * @example
      * ```typescript
      * const order = await exchange.createOrder({

package/dist/pmxt/client.js

@@ -134,6 +134,8 @@ class Exchange {
     serverManager;
     initPromise;
     isHosted;
+    _hostedAccount;
+    _accountDiscoveryPromise;
     /**
      * Sticky flag: set to `true` the first time a GET read is rejected by
      * the sidecar with 404/405 (i.e. an older pmxt-core that only supports
@@ -191,9 +193,14 @@ class Exchange {
                 this.api = new index_js_1.DefaultApi(this.config);
             }
             catch (error) {
-                throw new errors_js_1.PmxtError(`Failed to start PMXT server: ${error}\n\n` +
+                const msg = `Failed to start PMXT server: ${error instanceof Error ? error.message : error}\n\n` +
                     `Please ensure 'pmxt-core' is installed: npm install -g pmxt-core\n` +
-                    `Or start the server manually: pmxt-server`);
+                    `Or start the server manually: pmxt-server`;
+                const pmxtError = new errors_js_1.PmxtError(msg);
+                if (error instanceof Error) {
+                    pmxtError.cause = error;
+                }
+                throw pmxtError;
             }
         }
     }
@@ -292,8 +299,11 @@ class Exchange {
         if (this._wsClient?.connected)
             return this._wsClient;
         const host = this.resolveBaseUrl();
-        const accessToken = this.serverManager.getAccessToken();
-        const client = new ws_client_js_1.SidecarWsClient(host, accessToken || undefined);
+        const accessToken = this.isHosted
+            ? this.pmxtApiKey
+            : this.serverManager.getAccessToken();
+        const authParamName = this.isHosted ? "apiKey" : "token";
+        const client = new ws_client_js_1.SidecarWsClient(host, accessToken || undefined, authParamName);
         try {
             // Trigger connection to validate the endpoint exists.
             // subscribe() calls ensureConnected internally, but we want
@@ -328,8 +338,12 @@ class Exchange {
         try {
             return await ws.subscribe(this.exchangeName, method, args, this.getCredentials());
         }
-        catch {
-            return null;
+        catch (error) {
+            // Only fall back to HTTP for transport-level failures
+            if (error instanceof errors_js_1.PmxtError && /connection failed|no websocket/i.test(error.message)) {
+                return null;
+            }
+            throw error;
         }
     }
     // Low-Level API Access
@@ -1426,8 +1440,11 @@ class Exchange {
                     return result;
                 }
             }
-            catch {
-                // fall through to HTTP
+            catch (error) {
+                // Only fall through to HTTP for transport-level WS failures
+                if (!(error instanceof errors_js_1.PmxtError) || !/connection failed|no websocket/i.test(error.message)) {
+                    throw error;
+                }
             }
         }
         // HTTP fallback
@@ -1453,7 +1470,7 @@ class Exchange {
                 }
                 return result;
             }
-            return {};
+            throw new errors_js_1.PmxtError("watchOrderBooks: unexpected response shape from server");
         }
         catch (error) {
             if (error instanceof errors_js_1.PmxtError)
@@ -1461,6 +1478,45 @@ class Exchange {
             throw new errors_js_1.PmxtError(`Failed to watch order books: ${error}`);
         }
     }
+    /**
+     * Stream all orderbook updates across venues via the hosted WebSocket API.
+     *
+     * Returns a promise that resolves with the next book event.
+     * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
+     * Requires hosted mode (`pmxtApiKey` set).
+     *
+     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @returns Next event with source, symbol, and orderbook
+     *
+     * @example
+     * ```typescript
+     * const poly = new Polymarket({ pmxtApiKey: "pmxt_xxx" });
+     * while (true) {
+     *   const event = await poly.watchAllOrderBooks();
+     *   console.log(event.source, event.symbol, event.orderbook.bids[0]);
+     * }
+     * ```
+     */
+    async watchAllOrderBooks(venues) {
+        await this.initPromise;
+        if (!this.isHosted) {
+            throw new errors_js_1.PmxtError("watchAllOrderBooks() requires hosted mode (set pmxtApiKey)");
+        }
+        const args = venues ? [venues] : [];
+        const wsData = await this.watchViaWs("watchAllOrderBooks", args);
+        if (wsData !== null) {
+            return {
+                source: wsData._source || "",
+                symbol: wsData._symbol || "",
+                orderbook: convertOrderBook(wsData),
+            };
+        }
+        throw new errors_js_1.PmxtError("watchAllOrderBooks() requires WebSocket transport — connection failed");
+    }
+    /** @deprecated Use {@link watchAllOrderBooks} instead. */
+    async firehose(venues) {
+        return this.watchAllOrderBooks(venues);
+    }
     /**
      * Watch real-time trade updates via WebSocket.
      *
@@ -1663,12 +1719,71 @@ class Exchange {
             throw new errors_js_1.PmxtError(`Failed to build order: ${error}`);
         }
     }
+    async _discoverHostedAccount() {
+        if (this._hostedAccount)
+            return;
+        if (!this._accountDiscoveryPromise) {
+            this._accountDiscoveryPromise = (async () => {
+                try {
+                    const res = await this.fetchWithRetry(`${this.resolveBaseUrl()}/v0/account`, { method: 'GET', headers: { ...this.getAuthHeaders() } });
+                    if (res.ok) {
+                        const body = await res.json();
+                        this._hostedAccount = { depositWallet: body.deposit_wallet, signatureType: body.signature_type };
+                    }
+                    else {
+                        this._hostedAccount = {};
+                    }
+                }
+                catch {
+                    this._hostedAccount = {};
+                }
+            })();
+        }
+        await this._accountDiscoveryPromise;
+    }
+    async _executeSorOrder(params) {
+        await this._discoverHostedAccount();
+        const buildRes = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/sor/buildOrder`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
+            body: JSON.stringify({ args: [params] }),
+        });
+        if (!buildRes.ok)
+            throw new errors_js_1.PmxtError(`buildOrder failed: ${await buildRes.text()}`);
+        const buildJson = await buildRes.json();
+        const { orderId, legs } = buildJson.data || buildJson;
+        const fills = [];
+        for (const leg of legs) {
+            try {
+                const { Polymarket, Limitless } = require('pmxt-core');
+                const VenueClass = leg.venue === 'polymarket' ? Polymarket : leg.venue === 'limitless' ? Limitless : null;
+                if (!VenueClass)
+                    throw new Error(`unsupported venue: ${leg.venue}`);
+                const venueOpts = { privateKey: this.privateKey };
+                if (leg.venue === 'polymarket' && this._hostedAccount?.depositWallet) {
+                    venueOpts.funderAddress = this._hostedAccount.depositWallet;
+                    venueOpts.signatureType = this._hostedAccount.signatureType || 3;
+                }
+                const venue = new VenueClass(venueOpts);
+                const order = await venue.createOrder({ outcomeId: leg.tokenId, side: leg.side, amount: leg.shares, price: leg.price });
+                const filledShares = order.filled || 0;
+                fills.push({ venue: leg.venue, venueOrderId: order.id, venueMarketId: leg.venueMarketId, venueOutcomeId: leg.venueOutcomeId, shares: filledShares > 0 ? filledShares : leg.shares, price: order.price || leg.price, status: filledShares > 0 ? 'filled' : 'open' });
+            }
+            catch (err) {
+                fills.push({ venue: leg.venue, venueMarketId: leg.venueMarketId, venueOutcomeId: leg.venueOutcomeId, shares: leg.shares, price: leg.price, status: 'failed', error: err.message });
+            }
+        }
+        const submitRes = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/sor/submitOrder`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
+            body: JSON.stringify({ args: [{ orderId, fills }] }),
+        });
+        if (!submitRes.ok)
+            throw new errors_js_1.PmxtError(`submitOrder failed: ${await submitRes.text()}`);
+        const submitJson = await submitRes.json();
+        return convertOrder(submitJson.data || submitJson);
+    }
     /**
-     * Create a new order.
-     *
-     * @param params - Order parameters
-     * @returns Created order
-     *
      * @example
      * ```typescript
      * const order = await exchange.createOrder({
@@ -1683,6 +1798,9 @@ class Exchange {
      */
     async createOrder(params) {
         if (this.isHosted) {
+            if (this.exchangeName === 'sor' && this.privateKey) {
+                return this._executeSorOrder(params);
+            }
             throw new errors_js_1.PmxtError("Trade execution is not available through the hosted API. " +
                 "Use the local PMXT SDK with your venue credentials instead. " +
                 "See https://pmxt.dev/docs/quickstart for setup instructions.");

package/dist/pmxt/models.d.ts

@@ -112,6 +112,17 @@ export interface OrderBook {
     /** Unix timestamp (milliseconds) */
     timestamp?: number;
 }
+/**
+ * A single event from the firehose stream.
+ */
+export interface FirehoseEvent {
+    /** The venue this event originated from (e.g. "polymarket", "limitless") */
+    source: string;
+    /** The outcome token id / asset id */
+    symbol: string;
+    /** The order book snapshot */
+    orderbook: OrderBook;
+}
 /**
  * Result of an execution price calculation.
  */

package/dist/pmxt/ws-client.d.ts

@@ -16,6 +16,7 @@ export declare class SidecarWsClient {
     private ws;
     private host;
     private accessToken;
+    private authParamName;
     private closed;
     /** requestId -> latest data payload */
     private dataStore;
@@ -24,7 +25,7 @@ export declare class SidecarWsClient {
     /** (method:symbolKey) -> requestId -- avoids duplicate subscribes */
     private activeSubs;
     private connectPromise;
-    constructor(host: string, accessToken?: string);
+    constructor(host: string, accessToken?: string, authParamName?: string);
     private ensureConnected;
     private connect;
     private getWebSocketConstructor;

package/dist/pmxt/ws-client.js

@@ -20,6 +20,7 @@ class SidecarWsClient {
     ws = null;
     host;
     accessToken;
+    authParamName;
     closed = false;
     /** requestId -> latest data payload */
     dataStore = new Map();
@@ -28,9 +29,10 @@ class SidecarWsClient {
     /** (method:symbolKey) -> requestId -- avoids duplicate subscribes */
     activeSubs = new Map();
     connectPromise = null;
-    constructor(host, accessToken) {
+    constructor(host, accessToken, authParamName = "token") {
         this.host = host;
         this.accessToken = accessToken;
+        this.authParamName = authParamName;
     }
     // ------------------------------------------------------------------
     // Connection lifecycle
@@ -61,7 +63,7 @@ class SidecarWsClient {
             }
             let url = `${scheme}://${hostPart}/ws`;
             if (this.accessToken) {
-                url = `${url}?token=${this.accessToken}`;
+                url = `${url}?${this.authParamName}=${this.accessToken}`;
             }
             // Use the ws package in Node.js, native WebSocket in browsers
             const WsConstructor = this.getWebSocketConstructor();
@@ -80,22 +82,30 @@ class SidecarWsClient {
                     // Connection failed during handshake
                     reject(new errors_js_1.PmxtError(`WebSocket connection failed: ${err.message || err}`));
                 }
+                else {
+                    // Post-handshake error — propagate to all pending subscribers
+                    const error = new errors_js_1.PmxtError(`WebSocket error: ${err.message || err}`);
+                    for (const sub of this.subscriptions.values()) {
+                        if (sub.reject) {
+                            sub.reject(error);
+                            sub.reject = null;
+                            sub.resolve = null;
+                        }
+                    }
+                    this.closed = true;
+                    this.ws = null;
+                }
             };
             ws.onclose = () => {
                 this.closed = true;
                 this.ws = null;
             };
             ws.onmessage = (event) => {
-                try {
-                    const data = typeof event.data === "string"
-                        ? event.data
-                        : event.data.toString();
-                    const msg = JSON.parse(data);
-                    this.dispatch(msg);
-                }
-                catch {
-                    // Ignore unparseable frames
-                }
+                const raw = typeof event.data === "string"
+                    ? event.data
+                    : event.data.toString();
+                const msg = JSON.parse(raw);
+                this.dispatch(msg);
             };
         });
     }
@@ -104,14 +114,15 @@ class SidecarWsClient {
         if (typeof globalThis !== "undefined" && globalThis.WebSocket) {
             return globalThis.WebSocket;
         }
-        // Node.js -- try to require ws
+        // Node.js -- require ws
         try {
             // Dynamic require to avoid bundler issues
             const wsModule = require("ws");
             return wsModule.default || wsModule;
         }
         catch {
-            return null;
+            throw new errors_js_1.PmxtError("WebSocket support in Node.js requires the 'ws' package. " +
+                "Install it with: npm install ws");
         }
     }
     dispatch(msg) {

package/generated/.openapi-generator/FILES

@@ -95,12 +95,9 @@ docs/UnwatchOrderBookRequest.md
 docs/UserTrade.md
 docs/WatchAddress200Response.md
 docs/WatchAddressRequest.md
-docs/WatchAddressRequestArgsInner.md
 docs/WatchOrderBookRequest.md
-docs/WatchOrderBookRequestArgsInner.md
 docs/WatchOrderBooks200Response.md
 docs/WatchOrderBooksRequest.md
-docs/WatchOrderBooksRequestArgsInner.md
 docs/WatchTradesRequest.md
 package.json
 src/apis/DefaultApi.ts
@@ -198,12 +195,9 @@ src/models/UnwatchOrderBookRequest.ts
 src/models/UserTrade.ts
 src/models/WatchAddress200Response.ts
 src/models/WatchAddressRequest.ts
-src/models/WatchAddressRequestArgsInner.ts
 src/models/WatchOrderBookRequest.ts
-src/models/WatchOrderBookRequestArgsInner.ts
 src/models/WatchOrderBooks200Response.ts
 src/models/WatchOrderBooksRequest.ts
-src/models/WatchOrderBooksRequestArgsInner.ts
 src/models/WatchTradesRequest.ts
 src/models/index.ts
 src/runtime.ts