openbroker 1.9.3 → 1.9.5

package/dist/core/client.js

@@ -15,6 +15,8 @@ export class HyperliquidClient {
     szDecimalsMap = new Map();
     /** Maps coin name → dex info for HIP-3 assets. Main dex assets have dexName=null */
     coinDexMap = new Map();
+    /** Static positional universe per dex, used to join allDexsAssetCtxs WS pushes. */
+    dexUniverseMap = new Map();
     /** Cache of perpDexs list */
     perpDexsCache = null;
     /** Whether HIP-3 assets have been loaded into maps */
@@ -45,6 +47,13 @@ export class HyperliquidClient {
     spotMetaLoaded = false;
     /** HIP-4 outcome metadata cache */
     outcomeMeta = null;
+    /** Static main-dex universe retained while live asset contexts arrive over WebSocket. */
+    staticMeta = null;
+    /** Runtime-owned live data cache. CLI calls leave this detached and remain REST-only. */
+    realtime = null;
+    predictedFundingsCache = null;
+    predictedFundingsInFlight = null;
+    spotMetaCache = null;
     verbose = false;
     constructor(config) {
         this.config = config ?? loadConfig();
@@ -184,6 +193,10 @@ export class HyperliquidClient {
     get isTestnet() {
         return !isMainnet();
     }
+    /** Attach/detach the automation runtime's WebSocket-first data cache. */
+    setRealtimeDataProvider(provider) {
+        this.realtime = provider;
+    }
     /**
      * Returns vaultAddress param for SDK exchange calls.
      * Only used for vault trading (HYPERLIQUID_VAULT_ADDRESS set explicitly).
@@ -208,6 +221,10 @@ export class HyperliquidClient {
     }
     // ============ Market Data ============
     async getMetaAndAssetCtxs() {
+        const liveCtxs = this.realtime?.connected ? this.realtime.getMainAssetCtxs() : null;
+        if (this.staticMeta && liveCtxs) {
+            return { meta: this.staticMeta, assetCtxs: liveCtxs };
+        }
         if (this.meta)
             return this.meta;
         this.log('Fetching metaAndAssetCtxs...');
@@ -230,6 +247,8 @@ export class HyperliquidClient {
             assetCtxs: response[1],
         };
         this.meta = meta;
+        this.staticMeta = meta.meta;
+        this.dexUniverseMap.set('', meta.meta.universe.map((asset) => asset.name));
         // Build lookup maps for main dex
         meta.meta.universe.forEach((asset, index) => {
             this.assetMap.set(asset.name, index);
@@ -243,6 +262,29 @@ export class HyperliquidClient {
         }
         return meta;
     }
+    /**
+     * Warm only the native/main static universe for an automation runtime.
+     * Dynamic contexts arrive via allDexsAssetCtxs, and HIP-3 metadata is loaded
+     * on demand when a strategy references a prefixed market. This avoids the
+     * old startup burst that fetched every HIP-3 dex before the socket opened.
+     */
+    async initializeRealtimeMetadata() {
+        if (this.staticMeta)
+            return;
+        const response = await this.withRetry(() => this.info.metaAndAssetCtxs(), 'metaAndAssetCtxs(realtime-init)');
+        const meta = {
+            meta: { universe: response[0].universe },
+            assetCtxs: response[1],
+        };
+        this.meta = meta;
+        this.staticMeta = meta.meta;
+        this.dexUniverseMap.set('', meta.meta.universe.map((asset) => asset.name));
+        meta.meta.universe.forEach((asset, index) => {
+            this.assetMap.set(asset.name, index);
+            this.szDecimalsMap.set(asset.name, asset.szDecimals);
+            this.coinDexMap.set(asset.name, { dexName: null, dexIdx: 0, localName: asset.name });
+        });
+    }
     /**
      * Load HIP-3 perp dex assets into the asset/szDecimals maps.
      * Asset index formula: 100000 + dexIdx * 10000 + assetIdx
@@ -356,10 +398,14 @@ export class HyperliquidClient {
                 if (asset.maxLeverage)
                     this.hip3MaxLeverageMap.set(coinName, asset.maxLeverage);
             });
+            this.dexUniverseMap.set(dexName, universe.map((asset) => (asset.name.startsWith(`${dexName}:`) ? asset.name : `${dexName}:${asset.name}`)));
         }
         this.loadedHip3Dexes.add(dexName);
     }
     async getAllMids() {
+        const live = this.realtime?.connected ? this.realtime.getAllMids() : null;
+        if (live)
+            return { ...live };
         this.log('Fetching allMids...');
         let response;
         try {
@@ -449,8 +495,11 @@ export class HyperliquidClient {
      * Get spot market metadata
      */
     async getSpotMeta() {
+        if (this.spotMetaCache)
+            return this.spotMetaCache;
         this.log('Fetching spotMeta...');
         const data = await this.postInfo({ type: 'spotMeta' }, 'spotMeta');
+        this.spotMetaCache = data;
         this.log('spotMeta response:', JSON.stringify(data).slice(0, 500));
         return data;
     }
@@ -458,6 +507,23 @@ export class HyperliquidClient {
      * Get spot metadata with asset contexts (prices, volumes)
      */
     async getSpotMetaAndAssetCtxs() {
+        const liveMids = this.realtime?.connected ? this.realtime.getAllMids() : null;
+        if (liveMids) {
+            const meta = await this.getSpotMeta();
+            return {
+                meta,
+                assetCtxs: meta.universe.map((pair) => {
+                    const price = liveMids[pair.name] ?? '0';
+                    return {
+                        coin: pair.name,
+                        dayNtlVlm: '0',
+                        markPx: price,
+                        midPx: price,
+                        prevDayPx: price,
+                    };
+                }),
+            };
+        }
         this.log('Fetching spotMetaAndAssetCtxs...');
         const data = await this.postInfo({ type: 'spotMetaAndAssetCtxs' }, 'spotMetaAndAssetCtxs');
         this.log('spotMetaAndAssetCtxs response:', JSON.stringify(data).slice(0, 500));
@@ -767,6 +833,10 @@ export class HyperliquidClient {
      * Get user's spot token balances
      */
     async getSpotBalances(user) {
+        const target = user ?? this.address;
+        const live = this.realtime?.connected ? this.realtime.getSpotBalances(target) : null;
+        if (live)
+            return live;
         this.log('Fetching spotClearinghouseState for:', user ?? this.address);
         const data = await this.postInfo({
             type: 'spotClearinghouseState',
@@ -804,6 +874,30 @@ export class HyperliquidClient {
      * Get predicted funding rates across venues
      */
     async getPredictedFundings() {
+        const ttlMs = 60_000;
+        if (this.predictedFundingsCache && Date.now() - this.predictedFundingsCache.timestamp < ttlMs) {
+            return this.predictedFundingsCache.value;
+        }
+        if (this.predictedFundingsInFlight)
+            return this.predictedFundingsInFlight;
+        this.predictedFundingsInFlight = this.fetchPredictedFundings();
+        try {
+            const value = await this.predictedFundingsInFlight;
+            this.predictedFundingsCache = { value, timestamp: Date.now() };
+            return value;
+        }
+        catch (error) {
+            if (this.predictedFundingsCache) {
+                this.log('predictedFundings refresh failed; using stale cache:', this.describeError(error));
+                return this.predictedFundingsCache.value;
+            }
+            throw error;
+        }
+        finally {
+            this.predictedFundingsInFlight = null;
+        }
+    }
+    async fetchPredictedFundings() {
         this.log('Fetching predictedFundings...');
         const baseUrl = isMainnet()
             ? 'https://api.hyperliquid.xyz'
@@ -817,8 +911,13 @@ export class HyperliquidClient {
             },
             body: JSON.stringify({ type: 'predictedFundings' }),
         });
+        if (!response.ok) {
+            throw new Error(`predictedFundings failed: HTTP ${response.status} ${response.statusText}`);
+        }
         const data = await response.json();
-        this.log('predictedFundings response length:', data?.length);
+        if (!Array.isArray(data))
+            throw new Error('predictedFundings returned malformed payload');
+        this.log('predictedFundings response length:', data.length);
         return data;
     }
     /**
@@ -826,6 +925,9 @@ export class HyperliquidClient {
      * Returns best bid/ask and depth
      */
     async getL2Book(coin) {
+        const live = this.realtime?.connected ? await this.realtime.getL2Book(coin) : null;
+        if (live)
+            return this.normalizeL2Book(live.levels);
         this.log('Fetching l2Book for:', coin);
         // API accepts prefixed names directly (e.g., "xyz:CL")
         let response;
@@ -842,8 +944,11 @@ export class HyperliquidClient {
         if (!response || !Array.isArray(response.levels)) {
             throw new Error(`l2Book(${coin}) returned empty/malformed payload.`);
         }
-        const bids = (response.levels[0] ?? []);
-        const asks = (response.levels[1] ?? []);
+        return this.normalizeL2Book(response.levels);
+    }
+    normalizeL2Book(levels) {
+        const bids = levels[0] ?? [];
+        const asks = levels[1] ?? [];
         const bestBid = bids.length > 0 ? parseFloat(bids[0].px) : 0;
         const bestAsk = asks.length > 0 ? parseFloat(asks[0].px) : 0;
         const midPrice = (bestBid + bestAsk) / 2;
@@ -959,6 +1064,26 @@ export class HyperliquidClient {
         this.meta = null;
         // Keep the asset/szDecimals/coinDex maps - they don't change
     }
+    /** Join an allDexsAssetCtxs WebSocket payload with the cached static universes. */
+    fundingRatesFromWs(ctxs) {
+        const rates = new Map();
+        for (const [dexName, values] of ctxs) {
+            const universe = this.dexUniverseMap.get(dexName || '');
+            if (!universe)
+                continue;
+            for (let index = 0; index < Math.min(universe.length, values.length); index++) {
+                const coin = universe[index];
+                const value = values[index];
+                if (!coin || !value)
+                    continue;
+                rates.set(coin, {
+                    rate: Number(value.funding ?? 0),
+                    premium: Number(value.premium ?? 0),
+                });
+            }
+        }
+        return rates;
+    }
     /**
      * Get all loaded asset names (main + HIP-3)
      */
@@ -1362,6 +1487,10 @@ export class HyperliquidClient {
         return data;
     }
     async getUserState(user, dex) {
+        const target = user ?? this.address;
+        const live = this.realtime?.connected ? this.realtime.getUserState(target, dex) : null;
+        if (live)
+            return live;
         this.log('Fetching clearinghouseState for:', user ?? this.address, dex ? `dex: ${dex}` : '');
         const params = { user: user ?? this.address };
         if (dex !== undefined)
@@ -1504,6 +1633,10 @@ export class HyperliquidClient {
      * For standard accounts: aggregates margin summaries from each dex.
      */
     async getUserStateAll(user) {
+        const target = user ?? this.address;
+        const live = this.realtime?.connected ? this.realtime.getUserStateAll(target) : null;
+        if (live)
+            return live;
         await this.getMetaAndAssetCtxs(); // Ensure HIP-3 dex list is loaded
         const unified = await this.isUnifiedAccount(user);
         const mainState = await this.getUserState(user);
@@ -1539,7 +1672,11 @@ export class HyperliquidClient {
         return this.mergeUserStateAll(perDex, unified, spotBalances);
     }
     async getOpenOrders(user) {
-        this.log('Fetching openOrders for:', user ?? this.address);
+        const target = user ?? this.address;
+        const live = this.realtime?.connected ? this.realtime.getOpenOrders(target) : null;
+        if (live)
+            return live;
+        this.log('Fetching openOrders for:', target);
         await this.getMetaAndAssetCtxs(); // Ensure HIP-3 dex list is loaded
         // Fetch main dex orders
         const orders = await this.withRetry(() => this.info.openOrders({ user: user ?? this.address }), 'openOrders');

package/dist/core/ws.d.ts

@@ -1,6 +1,6 @@
 import type { ISubscription } from '@nktkas/hyperliquid';
 import type { UserEventsWsEvent } from '@nktkas/hyperliquid';
-import type { ClearinghouseState } from './types.js';
+import type { ClearinghouseState, OpenOrder } from './types.js';
 export interface WsEventMap {
     /** L2 order book snapshot for a specific coin */
     l2Book: {
@@ -69,6 +69,12 @@ export interface WsEventMap {
             entryNtl?: string;
         }>;
     };
+    /** Complete open-order snapshot for one user + dex (empty dex = native/main). */
+    openOrders: {
+        user: string;
+        dex: string;
+        orders: OpenOrder[];
+    };
     /** Order status changed (filled, canceled, rejected, etc.) */
     orderUpdate: {
         order: {
@@ -134,6 +140,7 @@ export declare class WebSocketManager {
     private subscriptions;
     private handlers;
     private _connected;
+    private closing;
     private verbose;
     constructor(verbose?: boolean);
     private log;
@@ -172,6 +179,8 @@ export declare class WebSocketManager {
      * `getSpotBalances` REST polling in the collateral gate.
      */
     subscribeSpotState(user: `0x${string}`): Promise<ISubscription>;
+    /** Subscribe to complete open-order snapshots for one dex. */
+    subscribeOpenOrders(user: `0x${string}`, dex?: string): Promise<ISubscription>;
     /**
      * Subscribe to order lifecycle events (fill, cancel, reject, etc.).
      * This is the most important subscription for trading automations.
@@ -189,11 +198,14 @@ export declare class WebSocketManager {
     /**
      * Start all subscriptions needed for the automation runtime:
      * - allMids (price feed)
+     * - allDexsAssetCtxs (funding / mark / oracle contexts)
+     * - allDexsClearinghouseState + spotState (positions, margin, balances)
+     * - openOrders for main + requested HIP-3 dexes
      * - orderUpdates (order lifecycle)
      * - userFills (trade fills)
      * - userEvents (liquidations, funding payments, system cancels)
      */
-    subscribeAll(user: `0x${string}`): Promise<void>;
+    subscribeAll(user: `0x${string}`, dexNames?: string[]): Promise<void>;
 }
 export declare function getWebSocket(verbose?: boolean): WebSocketManager;
 export declare function resetWebSocket(): void;

package/dist/core/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../scripts/core/ws.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAKV,iBAAiB,EAIlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE;YACN,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC5C,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SAC7C,CAAC;KACH,CAAC;IACF,wCAAwC;IACxC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC1C;;;;;;;OAOG;IACH,gBAAgB,EAAE;QAChB,IAAI,EAAE,KAAK,CAAC;YACV,MAAM;YACN,KAAK,CAAC;gBACJ,OAAO,EAAE,MAAM,CAAC;gBAChB,YAAY,EAAE,MAAM,CAAC;gBACrB,SAAS,EAAE,MAAM,CAAC;gBAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;gBACvB,QAAQ,EAAE,MAAM,CAAC;gBACjB,MAAM,EAAE,MAAM,CAAC;gBACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBACtB,SAAS,CAAC,EAAE,MAAM,CAAC;gBACnB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;aACtC,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;IACF;;;;;OAKG;IACH,yBAAyB,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QAIb,mBAAmB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;KACtF,CAAC;IACF,4EAA4E;IAC5E,SAAS,EAAE;QACT,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClG,CAAC;IACF,8DAA8D;IAC9D,WAAW,EAAE;QACX,KAAK,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;YAChB,EAAE,EAAE,MAAM,CAAC;YACX,GAAG,EAAE,MAAM,CAAC;YACZ,SAAS,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,OAAO,CAAC;SACtB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,0BAA0B;IAC1B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,6KAA6K;QAC7K,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,6GAA6G;QAC7G,GAAG,EAAE,MAAM,CAAC;QACZ,gGAAgG;QAChG,aAAa,EAAE,MAAM,CAAC;QACtB;;;;WAIG;QACH,WAAW,CAAC,EAAE;YACZ,cAAc,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;SAC/B,CAAC;KACH,CAAC;IACF,iEAAiE;IACjE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,6BAA6B;IAC7B,YAAY,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,sBAAsB;IACtB,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAIlF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAI3B,OAAO,CAAC,GAAG;IAIX,IAAI,SAAS,IAAI,OAAO,CAEvB;IAIK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAOrE,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAItE,OAAO,CAAC,IAAI;IAaZ,kBAAkB,IAAI,IAAI;IAM1B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAQhD;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAY3D;;;;;OAKG;IACG,yBAAyB,IAAI,OAAO,CAAC,aAAa,CAAC;IAUzD;;;;OAIG;IACG,kCAAkC,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAQrF;;;OAGG;IACG,kBAAkB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAWrE;;;OAGG;IACG,qBAAqB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBxE;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBrE;;;OAGG;IACG,mBAAmB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAUtE;;;;;;OAMG;IACG,YAAY,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAavD;AAMD,wBAAgB,YAAY,CAAC,OAAO,UAAQ,GAAG,gBAAgB,CAK9D;AAED,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../scripts/core/ws.ts"],"names":[],"mappings":"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"}

package/dist/core/ws.js

@@ -9,6 +9,7 @@ export class WebSocketManager {
     subscriptions = [];
     handlers = new Map();
     _connected = false;
+    closing = false;
     verbose;
     constructor(verbose = false) {
         this.verbose = verbose;
@@ -27,14 +28,36 @@ export class WebSocketManager {
         this.transport = new WebSocketTransport({
             isTestnet: !isMainnet(),
             resubscribe: true, // auto-resubscribe on reconnect
+            reconnect: { maxRetries: Infinity },
+        });
+        const socket = this.transport.socket;
+        socket.addEventListener('open', () => {
+            if (this._connected)
+                return;
+            this._connected = true;
+            this.emit('connected', undefined);
+            this.log('Connected to', isMainnet() ? 'mainnet' : 'testnet');
+        });
+        socket.addEventListener('close', () => {
+            if (!this._connected)
+                return;
+            this._connected = false;
+            this.emit('disconnected', { reason: this.closing ? 'manual close' : 'socket closed' });
+            this.log(this.closing ? 'Closed' : 'Disconnected; transport will reconnect');
+        });
+        socket.addEventListener('error', () => {
+            this.emit('error', { error: new Error('Hyperliquid WebSocket transport error') });
         });
         this.client = new SubscriptionClient({ transport: this.transport });
         await this.transport.ready();
-        this._connected = true;
-        this.emit('connected', undefined);
-        this.log('Connected to', isMainnet() ? 'mainnet' : 'testnet');
+        if (!this._connected) {
+            this._connected = true;
+            this.emit('connected', undefined);
+            this.log('Connected to', isMainnet() ? 'mainnet' : 'testnet');
+        }
     }
     async close() {
+        this.closing = true;
         for (const sub of this.subscriptions) {
             try {
                 await sub.unsubscribe();
@@ -50,9 +73,12 @@ export class WebSocketManager {
             this.transport = null;
             this.client = null;
         }
-        this._connected = false;
-        this.emit('disconnected', { reason: 'manual close' });
-        this.log('Closed');
+        if (this._connected) {
+            this._connected = false;
+            this.emit('disconnected', { reason: 'manual close' });
+            this.log('Closed');
+        }
+        this.closing = false;
     }
     // ── Event system ───────────────────────────────────────────────
     on(event, handler) {
@@ -162,6 +188,18 @@ export class WebSocketManager {
         });
         return this.trackSub(sub);
     }
+    /** Subscribe to complete open-order snapshots for one dex. */
+    async subscribeOpenOrders(user, dex = '') {
+        const client = this.ensureClient();
+        const sub = await client.openOrders({ user, dex }, (data) => {
+            this.emit('openOrders', {
+                user: data.user,
+                dex: data.dex,
+                orders: data.orders,
+            });
+        });
+        return this.trackSub(sub);
+    }
     /**
      * Subscribe to order lifecycle events (fill, cancel, reject, etc.).
      * This is the most important subscription for trading automations.
@@ -232,15 +270,23 @@ export class WebSocketManager {
     /**
      * Start all subscriptions needed for the automation runtime:
      * - allMids (price feed)
+     * - allDexsAssetCtxs (funding / mark / oracle contexts)
+     * - allDexsClearinghouseState + spotState (positions, margin, balances)
+     * - openOrders for main + requested HIP-3 dexes
      * - orderUpdates (order lifecycle)
      * - userFills (trade fills)
      * - userEvents (liquidations, funding payments, system cancels)
      */
-    async subscribeAll(user) {
+    async subscribeAll(user, dexNames = []) {
         await this.connect();
         this.log('Subscribing to all feeds for', user);
         await Promise.all([
             this.subscribeAllMids(),
+            this.subscribeAllDexsAssetCtxs(),
+            this.subscribeAllDexsClearinghouseState(user),
+            this.subscribeSpotState(user),
+            this.subscribeOpenOrders(user),
+            ...dexNames.map((dex) => this.subscribeOpenOrders(user, dex)),
             this.subscribeOrderUpdates(user),
             this.subscribeUserFills(user),
             this.subscribeUserEvents(user),

package/dist/setup/install.js

@@ -5,19 +5,54 @@ import * as path from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { spawnSync } from 'child_process';
+import { INSTALLABLE_PACKAGES, packageSpec, resolveInstallablePackage, } from './package-catalog.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const packageRoot = path.resolve(__dirname, '../..');
-const args = new Set(process.argv.slice(2));
+const rawArgs = process.argv.slice(2);
+const args = new Set(rawArgs);
+function positionalArgs() {
+    const positionals = [];
+    for (let index = 0; index < rawArgs.length; index++) {
+        const arg = rawArgs[index];
+        if (arg === '--tag') {
+            index++;
+            continue;
+        }
+        if (!arg.startsWith('-'))
+            positionals.push(arg);
+    }
+    return positionals;
+}
+function optionValue(flag) {
+    const index = rawArgs.indexOf(flag);
+    if (index < 0)
+        return null;
+    const value = rawArgs[index + 1];
+    if (!value || value.startsWith('-'))
+        fail(`${flag} requires a value`);
+    return value;
+}
 function printUsage() {
     console.log(`
-OpenBroker Harness Installer
-============================
+OpenBroker Installer
+====================
 
 Usage:
+  openbroker install <package> [--tag <version>] [--dry]
+  openbroker install --list
   openbroker install --codex [options]
   npx openbroker@latest install --codex [options]
 
+Companion packages:
+  monitoring    Install the local automation dashboard
+  extended      Install the Extended Exchange CLI
+
+Package options:
+  --tag <tag>   Install a release tag or exact version (default: latest)
+  --dry         Print the npm command without installing
+  --list        List supported companion packages
+
 Harnesses:
   --codex       Install the OpenBroker skill for Codex
 
@@ -74,6 +109,55 @@ function installGlobalCli() {
         fail('global CLI installation failed. Fix the npm permission error, then rerun with --skip-cli.');
     }
 }
+function printInstallablePackages() {
+    console.log('Installable OpenBroker packages:\n');
+    for (const entry of INSTALLABLE_PACKAGES) {
+        console.log(`  ${entry.key.padEnd(12)} ${entry.packageName.padEnd(26)} ${entry.description}`);
+    }
+    console.log('\nInstall or upgrade with: openbroker install <package>');
+}
+function installCompanionPackage(target) {
+    const entry = resolveInstallablePackage(target);
+    if (!entry) {
+        printInstallablePackages();
+        fail(`unknown installable package: ${target}`);
+    }
+    const allowedFlags = new Set(['--tag', '--dry']);
+    const unsupported = rawArgs.filter((arg, index) => (arg.startsWith('-')
+        && !allowedFlags.has(arg)
+        && rawArgs[index - 1] !== '--tag'));
+    if (unsupported.length > 0)
+        fail(`unsupported package option: ${unsupported[0]}`);
+    const tag = optionValue('--tag') ?? 'latest';
+    let spec;
+    try {
+        spec = packageSpec(entry, tag);
+    }
+    catch (error) {
+        fail(error instanceof Error ? error.message : String(error));
+    }
+    const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const npmArgs = ['install', '--global', spec];
+    console.log(`OpenBroker — Install ${entry.key}`);
+    console.log('================================\n');
+    console.log(`Package: ${spec}`);
+    console.log(`Command: ${npmCommand} ${npmArgs.join(' ')}`);
+    if (args.has('--dry')) {
+        console.log('\nDry run only; nothing was installed.');
+        return;
+    }
+    const result = spawnSync(npmCommand, npmArgs, { stdio: 'inherit' });
+    if (result.error)
+        fail(`could not start npm: ${result.error.message}`);
+    if (result.status !== 0) {
+        fail(`installation failed for ${entry.packageName}; resolve the npm error and retry`);
+    }
+    console.log(`\n✅ ${entry.packageName} installed successfully.`);
+    console.log(`Available command: ${entry.command}`);
+    console.log('\nNext steps:');
+    for (const step of entry.nextSteps)
+        console.log(`  ${step}`);
+}
 function runApiWalletSetup() {
     const onboardPath = path.join(packageRoot, 'scripts', 'setup', 'onboard.ts');
     console.log('\nStarting restricted API-wallet onboarding...\n');
@@ -94,6 +178,19 @@ function main() {
         printUsage();
         return;
     }
+    if (args.has('--list')) {
+        printInstallablePackages();
+        return;
+    }
+    const positionals = positionalArgs();
+    if (positionals.length > 0) {
+        if (positionals.length > 1)
+            fail(`expected one package name, received: ${positionals.join(' ')}`);
+        if (args.has('--codex'))
+            fail('choose either a companion package or the --codex harness installer');
+        installCompanionPackage(positionals[0]);
+        return;
+    }
     if (!args.has('--codex')) {
         printUsage();
         fail('choose a supported harness flag such as --codex');

package/dist/setup/package-catalog.d.ts

@@ -0,0 +1,12 @@
+export interface InstallablePackage {
+    key: string;
+    aliases: string[];
+    packageName: string;
+    command: string;
+    description: string;
+    nextSteps: string[];
+}
+export declare const INSTALLABLE_PACKAGES: InstallablePackage[];
+export declare function resolveInstallablePackage(input: string): InstallablePackage | null;
+export declare function packageSpec(entry: InstallablePackage, tag?: string): string;
+//# sourceMappingURL=package-catalog.d.ts.map

package/dist/setup/package-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-catalog.d.ts","sourceRoot":"","sources":["../../scripts/setup/package-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAuBpD,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAOlF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,SAAW,GAAG,MAAM,CAK7E"}

package/dist/setup/package-catalog.js

@@ -0,0 +1,36 @@
+export const INSTALLABLE_PACKAGES = [
+    {
+        key: 'monitoring',
+        aliases: ['openbroker-monitoring'],
+        packageName: 'openbroker-monitoring',
+        command: 'openbroker-monitoring',
+        description: 'Local automation dashboard and optional audit observer',
+        nextSteps: [
+            'openbroker-monitoring serve --host 127.0.0.1 --port 3001',
+            'Open http://127.0.0.1:3001',
+        ],
+    },
+    {
+        key: 'extended',
+        aliases: ['openbroker-extended'],
+        packageName: 'openbroker-extended',
+        command: 'openbroker-ex',
+        description: 'Extended Exchange trading CLI and library',
+        nextSteps: [
+            'openbroker-ex --help',
+            'openbroker-ex setup',
+        ],
+    },
+];
+export function resolveInstallablePackage(input) {
+    const normalized = input.trim().toLowerCase();
+    return INSTALLABLE_PACKAGES.find((entry) => (entry.key === normalized
+        || entry.packageName === normalized
+        || entry.aliases.includes(normalized))) ?? null;
+}
+export function packageSpec(entry, tag = 'latest') {
+    if (!/^[a-z0-9][a-z0-9._-]*$/i.test(tag)) {
+        throw new Error(`invalid package tag or version: ${tag}`);
+    }
+    return `${entry.packageName}@${tag}`;
+}

package/dist/setup/package-catalog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=package-catalog.test.d.ts.map

package/dist/setup/package-catalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-catalog.test.d.ts","sourceRoot":"","sources":["../../scripts/setup/package-catalog.test.ts"],"names":[],"mappings":""}