@drift-labs/sdk 2.156.0-beta.1 → 2.156.0-beta.3

package/VERSION

@@ -1 +1 @@
-2.156.0-beta.1
+2.156.0-beta.3

package/lib/browser/index.d.ts

@@ -33,6 +33,7 @@ export * from './accounts/types';
 export * from './addresses/pda';
 export * from './adminClient';
 export * from './assert/assert';
+export { PythLazerSubscriber, PythLazerPriceFeedArray } from './pyth';
 export * from './testClient';
 export * from './user';
 export * from './userConfig';

package/lib/browser/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pyth = exports.PublicKey = exports.BN = exports.CustomizedCadenceBulkAccountLoader = exports.WebSocketDriftClientAccountSubscriberV2 = exports.WebSocketProgramAccountsSubscriberV2 = exports.WebSocketProgramUserAccountSubscriber = exports.WebSocketProgramAccountSubscriber = exports.WebSocketAccountSubscriberV2 = void 0;
+exports.pyth = exports.PublicKey = exports.BN = exports.PythLazerSubscriber = exports.CustomizedCadenceBulkAccountLoader = exports.WebSocketDriftClientAccountSubscriberV2 = exports.WebSocketProgramAccountsSubscriberV2 = exports.WebSocketProgramUserAccountSubscriber = exports.WebSocketProgramAccountSubscriber = exports.WebSocketAccountSubscriberV2 = void 0;
 const anchor_1 = require("@coral-xyz/anchor");
 Object.defineProperty(exports, "BN", { enumerable: true, get: function () { return anchor_1.BN; } });
 const web3_js_1 = require("@solana/web3.js");
@@ -62,6 +62,8 @@ __exportStar(require("./accounts/types"), exports);
 __exportStar(require("./addresses/pda"), exports);
 __exportStar(require("./adminClient"), exports);
 __exportStar(require("./assert/assert"), exports);
+var pyth_1 = require("./pyth");
+Object.defineProperty(exports, "PythLazerSubscriber", { enumerable: true, get: function () { return pyth_1.PythLazerSubscriber; } });
 __exportStar(require("./testClient"), exports);
 __exportStar(require("./user"), exports);
 __exportStar(require("./userConfig"), exports);

package/lib/browser/pyth/index.d.ts

@@ -1,3 +1,4 @@
 export { WormholeCoreBridgeSolana, WORMHOLE_CORE_BRIDGE_SOLANA_IDL, PythSolanaReceiver, PriceUpdateAccount, } from './types';
 export { DEFAULT_WORMHOLE_PROGRAM_ID, DEFAULT_RECEIVER_PROGRAM_ID, } from './constants';
 export { getGuardianSetPda } from './utils';
+export { PythLazerSubscriber, PythLazerPriceFeedArray, } from './pythLazerSubscriber';

package/lib/browser/pyth/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGuardianSetPda = exports.DEFAULT_RECEIVER_PROGRAM_ID = exports.DEFAULT_WORMHOLE_PROGRAM_ID = exports.WORMHOLE_CORE_BRIDGE_SOLANA_IDL = void 0;
+exports.PythLazerSubscriber = exports.getGuardianSetPda = exports.DEFAULT_RECEIVER_PROGRAM_ID = exports.DEFAULT_WORMHOLE_PROGRAM_ID = exports.WORMHOLE_CORE_BRIDGE_SOLANA_IDL = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "WORMHOLE_CORE_BRIDGE_SOLANA_IDL", { enumerable: true, get: function () { return types_1.WORMHOLE_CORE_BRIDGE_SOLANA_IDL; } });
 var constants_1 = require("./constants");
@@ -8,3 +8,5 @@ Object.defineProperty(exports, "DEFAULT_WORMHOLE_PROGRAM_ID", { enumerable: true
 Object.defineProperty(exports, "DEFAULT_RECEIVER_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.DEFAULT_RECEIVER_PROGRAM_ID; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "getGuardianSetPda", { enumerable: true, get: function () { return utils_1.getGuardianSetPda; } });
+var pythLazerSubscriber_1 = require("./pythLazerSubscriber");
+Object.defineProperty(exports, "PythLazerSubscriber", { enumerable: true, get: function () { return pythLazerSubscriber_1.PythLazerSubscriber; } });

package/lib/browser/pyth/pythLazerSubscriber.d.ts

@@ -0,0 +1,89 @@
+/// <reference types="node" />
+import { Channel } from '@pythnetwork/pyth-lazer-sdk';
+import { DriftEnv } from '../config';
+/**
+ * Configuration for a group of Pyth Lazer price feeds.
+ */
+export type PythLazerPriceFeedArray = {
+    /** Optional channel for update frequency (e.g., 'fixed_rate@200ms') */
+    channel?: Channel;
+    /** Array of Pyth Lazer price feed IDs to subscribe to */
+    priceFeedIds: number[];
+};
+/**
+ * Manages subscriptions to Pyth Lazer price feeds and provides access to real-time price data.
+ * Automatically filters out non-stable feeds and handles reconnection logic.
+ */
+export declare class PythLazerSubscriber {
+    private endpoints;
+    private token;
+    private priceFeedArrays;
+    private resubTimeoutMs;
+    private sdkLogging;
+    private static readonly SYMBOLS_API_URL;
+    private symbolsCache;
+    private pythLazerClient?;
+    feedIdChunkToPriceMessage: Map<string, string>;
+    feedIdToPrice: Map<number, number>;
+    feedIdHashToFeedIds: Map<string, number[]>;
+    subscriptionIdsToFeedIdsHash: Map<number, string>;
+    allSubscribedIds: number[];
+    timeoutId?: NodeJS.Timeout;
+    receivingData: boolean;
+    isUnsubscribing: boolean;
+    marketIndextoPriceFeedIdChunk: Map<number, number[]>;
+    marketIndextoPriceFeedId: Map<number, number>;
+    /**
+     * Creates a new PythLazerSubscriber instance.
+     * @param endpoints - Array of WebSocket endpoint URLs for Pyth Lazer
+     * @param token - Authentication token for Pyth Lazer API
+     * @param priceFeedArrays - Array of price feed configurations to subscribe to
+     * @param env - Drift environment (mainnet-beta, devnet, etc.)
+     * @param resubTimeoutMs - Milliseconds to wait before resubscribing on data timeout
+     * @param sdkLogging - Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
+     */
+    constructor(endpoints: string[], token: string, priceFeedArrays: PythLazerPriceFeedArray[], env?: DriftEnv, resubTimeoutMs?: number, sdkLogging?: boolean);
+    private fetchSymbolsIfNeeded;
+    private filterStableFeeds;
+    /**
+     * Subscribes to Pyth Lazer price feeds. Automatically filters out non-stable feeds
+     * and establishes WebSocket connections for real-time price updates.
+     */
+    subscribe(): Promise<void>;
+    protected setTimeout(): void;
+    /**
+     * Unsubscribes from all Pyth Lazer price feeds and shuts down WebSocket connections.
+     */
+    unsubscribe(): Promise<void>;
+    hash(arr: number[]): string;
+    /**
+     * Retrieves the latest Solana-format price message for a group of feed IDs.
+     * @param feedIds - Array of price feed IDs
+     * @returns Hex-encoded price message data, or undefined if not available
+     */
+    getLatestPriceMessage(feedIds: number[]): Promise<string | undefined>;
+    /**
+     * Retrieves the latest Solana-format price message for a specific market.
+     * @param marketIndex - The market index to get price data for
+     * @returns Hex-encoded price message data, or undefined if not found
+     */
+    getLatestPriceMessageForMarketIndex(marketIndex: number): Promise<string | undefined>;
+    /**
+     * Gets the array of price feed IDs associated with a market index.
+     * @param marketIndex - The market index to look up
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromMarketIndex(marketIndex: number): number[];
+    /**
+     * Gets the array of price feed IDs from a subscription hash.
+     * @param hash - The subscription hash
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromHash(hash: string): number[];
+    /**
+     * Gets the current parsed price for a specific market index.
+     * @param marketIndex - The market index to get the price for
+     * @returns The price as a number, or undefined if not available
+     */
+    getPriceFromMarketIndex(marketIndex: number): number | undefined;
+}

package/lib/browser/pyth/pythLazerSubscriber.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythLazerSubscriber = void 0;
+const pyth_lazer_sdk_1 = require("@pythnetwork/pyth-lazer-sdk");
+const perpMarkets_1 = require("../constants/perpMarkets");
+/**
+ * Manages subscriptions to Pyth Lazer price feeds and provides access to real-time price data.
+ * Automatically filters out non-stable feeds and handles reconnection logic.
+ */
+class PythLazerSubscriber {
+    /**
+     * Creates a new PythLazerSubscriber instance.
+     * @param endpoints - Array of WebSocket endpoint URLs for Pyth Lazer
+     * @param token - Authentication token for Pyth Lazer API
+     * @param priceFeedArrays - Array of price feed configurations to subscribe to
+     * @param env - Drift environment (mainnet-beta, devnet, etc.)
+     * @param resubTimeoutMs - Milliseconds to wait before resubscribing on data timeout
+     * @param sdkLogging - Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
+     */
+    constructor(endpoints, token, priceFeedArrays, env = 'devnet', resubTimeoutMs = 2000, sdkLogging = false) {
+        this.endpoints = endpoints;
+        this.token = token;
+        this.priceFeedArrays = priceFeedArrays;
+        this.resubTimeoutMs = resubTimeoutMs;
+        this.sdkLogging = sdkLogging;
+        this.symbolsCache = null;
+        this.feedIdChunkToPriceMessage = new Map();
+        this.feedIdToPrice = new Map();
+        this.feedIdHashToFeedIds = new Map();
+        this.subscriptionIdsToFeedIdsHash = new Map();
+        this.allSubscribedIds = [];
+        this.receivingData = false;
+        this.isUnsubscribing = false;
+        this.marketIndextoPriceFeedIdChunk = new Map();
+        this.marketIndextoPriceFeedId = new Map();
+        const markets = perpMarkets_1.PerpMarkets[env].filter((market) => market.pythLazerId !== undefined);
+        this.allSubscribedIds = this.priceFeedArrays
+            .map((array) => array.priceFeedIds)
+            .flat();
+        for (const priceFeedIds of priceFeedArrays) {
+            const filteredMarkets = markets.filter((market) => priceFeedIds.priceFeedIds.includes(market.pythLazerId));
+            for (const market of filteredMarkets) {
+                this.marketIndextoPriceFeedIdChunk.set(market.marketIndex, priceFeedIds.priceFeedIds);
+                this.marketIndextoPriceFeedId.set(market.marketIndex, market.pythLazerId);
+            }
+        }
+    }
+    async fetchSymbolsIfNeeded() {
+        if (this.symbolsCache !== null)
+            return;
+        try {
+            const response = await fetch(PythLazerSubscriber.SYMBOLS_API_URL);
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const symbols = await response.json();
+            this.symbolsCache = new Map();
+            for (const symbol of symbols) {
+                this.symbolsCache.set(symbol.pyth_lazer_id, {
+                    name: symbol.name,
+                    state: symbol.state,
+                });
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to fetch Pyth Lazer symbols, proceeding with all feeds: ${error}`);
+            this.symbolsCache = new Map(); // Empty map = no filtering
+        }
+    }
+    filterStableFeeds(feedIds) {
+        if (this.symbolsCache === null || this.symbolsCache.size === 0) {
+            return feedIds; // No filtering if cache unavailable
+        }
+        return feedIds.filter((feedId) => {
+            const info = this.symbolsCache.get(feedId);
+            if (!info) {
+                console.warn(`Feed ID ${feedId} not found in symbols API, including anyway`);
+                return true;
+            }
+            if (info.state !== 'stable') {
+                console.warn(`Removing feed ID ${feedId} (${info.name}) - state is "${info.state}", not "stable"`);
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Subscribes to Pyth Lazer price feeds. Automatically filters out non-stable feeds
+     * and establishes WebSocket connections for real-time price updates.
+     */
+    async subscribe() {
+        var _a;
+        await this.fetchSymbolsIfNeeded();
+        this.pythLazerClient = await pyth_lazer_sdk_1.PythLazerClient.create({
+            token: this.token,
+            logger: this.sdkLogging ? console : undefined,
+            webSocketPoolConfig: {
+                urls: this.endpoints,
+                numConnections: 4, // Optionally specify number of parallel redundant connections to reduce the chance of dropped messages. The connections will round-robin across the provided URLs. Default is 4.
+                onError: (error) => {
+                    console.error('⛔️ PythLazerClient error:', error.message);
+                },
+                onWebSocketError: (error) => {
+                    console.error('⛔️ WebSocket error:', error.message);
+                },
+                onWebSocketPoolError: (error) => {
+                    console.error('⛔️ WebSocket pool error:', error.message);
+                },
+                // Optional configuration for resilient WebSocket connections
+                rwsConfig: {
+                    heartbeatTimeoutDurationMs: 5000, // Optional heartbeat timeout duration in milliseconds
+                    maxRetryDelayMs: 1000, // Optional maximum retry delay in milliseconds
+                    logAfterRetryCount: 10, // Optional log after how many retries
+                },
+            },
+        });
+        // Reset allSubscribedIds to rebuild with only stable feeds
+        this.allSubscribedIds = [];
+        let subscriptionId = 1;
+        for (const priceFeedArray of this.priceFeedArrays) {
+            const filteredFeedIds = this.filterStableFeeds(priceFeedArray.priceFeedIds);
+            if (filteredFeedIds.length === 0) {
+                console.warn(`All feeds filtered out for subscription ${subscriptionId}, skipping`);
+                continue;
+            }
+            // Update allSubscribedIds with only stable feeds
+            this.allSubscribedIds.push(...filteredFeedIds);
+            const feedIdsHash = this.hash(filteredFeedIds);
+            this.feedIdHashToFeedIds.set(feedIdsHash, filteredFeedIds);
+            this.subscriptionIdsToFeedIdsHash.set(subscriptionId, feedIdsHash);
+            // Update marketIndextoPriceFeedIdChunk to use filtered feeds
+            for (const [marketIndex, chunk,] of this.marketIndextoPriceFeedIdChunk.entries()) {
+                if (this.hash(chunk) === this.hash(priceFeedArray.priceFeedIds)) {
+                    this.marketIndextoPriceFeedIdChunk.set(marketIndex, filteredFeedIds);
+                }
+            }
+            // Remove entries from marketIndextoPriceFeedId for filtered-out feeds
+            for (const [marketIndex, feedId,] of this.marketIndextoPriceFeedId.entries()) {
+                if (!filteredFeedIds.includes(feedId) &&
+                    priceFeedArray.priceFeedIds.includes(feedId)) {
+                    this.marketIndextoPriceFeedId.delete(marketIndex);
+                    this.marketIndextoPriceFeedIdChunk.delete(marketIndex);
+                }
+            }
+            this.pythLazerClient.addMessageListener((message) => {
+                var _a, _b;
+                this.receivingData = true;
+                clearTimeout(this.timeoutId);
+                switch (message.type) {
+                    case 'json': {
+                        if (message.value.type == 'streamUpdated') {
+                            if ((_a = message.value.solana) === null || _a === void 0 ? void 0 : _a.data) {
+                                this.feedIdChunkToPriceMessage.set(this.subscriptionIdsToFeedIdsHash.get(message.value.subscriptionId), message.value.solana.data);
+                            }
+                            if ((_b = message.value.parsed) === null || _b === void 0 ? void 0 : _b.priceFeeds) {
+                                for (const priceFeed of message.value.parsed.priceFeeds) {
+                                    const price = Number(priceFeed.price) *
+                                        Math.pow(10, Number(priceFeed.exponent));
+                                    this.feedIdToPrice.set(priceFeed.priceFeedId, price);
+                                }
+                            }
+                        }
+                        break;
+                    }
+                    default: {
+                        break;
+                    }
+                }
+                this.setTimeout();
+            });
+            this.pythLazerClient.send({
+                type: 'subscribe',
+                subscriptionId,
+                priceFeedIds: filteredFeedIds,
+                properties: ['price', 'bestAskPrice', 'bestBidPrice', 'exponent'],
+                formats: ['solana'],
+                deliveryFormat: 'json',
+                channel: (_a = priceFeedArray.channel) !== null && _a !== void 0 ? _a : 'fixed_rate@200ms',
+                jsonBinaryEncoding: 'hex',
+            });
+            subscriptionId++;
+        }
+        this.receivingData = true;
+        this.setTimeout();
+    }
+    setTimeout() {
+        this.timeoutId = setTimeout(async () => {
+            if (this.isUnsubscribing) {
+                // If we are in the process of unsubscribing, do not attempt to resubscribe
+                return;
+            }
+            if (this.receivingData) {
+                console.log(`No ws data from pyth lazer client resubscribing`);
+                await this.unsubscribe();
+                this.receivingData = false;
+                await this.subscribe();
+            }
+        }, this.resubTimeoutMs);
+    }
+    /**
+     * Unsubscribes from all Pyth Lazer price feeds and shuts down WebSocket connections.
+     */
+    async unsubscribe() {
+        var _a;
+        this.isUnsubscribing = true;
+        (_a = this.pythLazerClient) === null || _a === void 0 ? void 0 : _a.shutdown();
+        this.pythLazerClient = undefined;
+        clearTimeout(this.timeoutId);
+        this.timeoutId = undefined;
+        this.isUnsubscribing = false;
+    }
+    hash(arr) {
+        return 'h:' + arr.join('|');
+    }
+    /**
+     * Retrieves the latest Solana-format price message for a group of feed IDs.
+     * @param feedIds - Array of price feed IDs
+     * @returns Hex-encoded price message data, or undefined if not available
+     */
+    async getLatestPriceMessage(feedIds) {
+        return this.feedIdChunkToPriceMessage.get(this.hash(feedIds));
+    }
+    /**
+     * Retrieves the latest Solana-format price message for a specific market.
+     * @param marketIndex - The market index to get price data for
+     * @returns Hex-encoded price message data, or undefined if not found
+     */
+    async getLatestPriceMessageForMarketIndex(marketIndex) {
+        const feedIds = this.marketIndextoPriceFeedIdChunk.get(marketIndex);
+        if (!feedIds) {
+            return undefined;
+        }
+        return await this.getLatestPriceMessage(feedIds);
+    }
+    /**
+     * Gets the array of price feed IDs associated with a market index.
+     * @param marketIndex - The market index to look up
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromMarketIndex(marketIndex) {
+        return this.marketIndextoPriceFeedIdChunk.get(marketIndex) || [];
+    }
+    /**
+     * Gets the array of price feed IDs from a subscription hash.
+     * @param hash - The subscription hash
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromHash(hash) {
+        return this.feedIdHashToFeedIds.get(hash) || [];
+    }
+    /**
+     * Gets the current parsed price for a specific market index.
+     * @param marketIndex - The market index to get the price for
+     * @returns The price as a number, or undefined if not available
+     */
+    getPriceFromMarketIndex(marketIndex) {
+        const feedId = this.marketIndextoPriceFeedId.get(marketIndex);
+        if (feedId === undefined) {
+            return undefined;
+        }
+        return this.feedIdToPrice.get(feedId);
+    }
+}
+exports.PythLazerSubscriber = PythLazerSubscriber;
+PythLazerSubscriber.SYMBOLS_API_URL = 'https://history.pyth-lazer.dourolabs.app/history/v1/symbols';

package/lib/node/index.d.ts

@@ -33,6 +33,7 @@ export * from './accounts/types';
 export * from './addresses/pda';
 export * from './adminClient';
 export * from './assert/assert';
+export { PythLazerSubscriber, PythLazerPriceFeedArray } from './pyth';
 export * from './testClient';
 export * from './user';
 export * from './userConfig';

package/lib/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/node/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pyth = exports.PublicKey = exports.BN = exports.CustomizedCadenceBulkAccountLoader = exports.WebSocketDriftClientAccountSubscriberV2 = exports.WebSocketProgramAccountsSubscriberV2 = exports.WebSocketProgramUserAccountSubscriber = exports.WebSocketProgramAccountSubscriber = exports.WebSocketAccountSubscriberV2 = void 0;
+exports.pyth = exports.PublicKey = exports.BN = exports.PythLazerSubscriber = exports.CustomizedCadenceBulkAccountLoader = exports.WebSocketDriftClientAccountSubscriberV2 = exports.WebSocketProgramAccountsSubscriberV2 = exports.WebSocketProgramUserAccountSubscriber = exports.WebSocketProgramAccountSubscriber = exports.WebSocketAccountSubscriberV2 = void 0;
 const anchor_1 = require("@coral-xyz/anchor");
 Object.defineProperty(exports, "BN", { enumerable: true, get: function () { return anchor_1.BN; } });
 const web3_js_1 = require("@solana/web3.js");
@@ -62,6 +62,8 @@ __exportStar(require("./accounts/types"), exports);
 __exportStar(require("./addresses/pda"), exports);
 __exportStar(require("./adminClient"), exports);
 __exportStar(require("./assert/assert"), exports);
+var pyth_1 = require("./pyth");
+Object.defineProperty(exports, "PythLazerSubscriber", { enumerable: true, get: function () { return pyth_1.PythLazerSubscriber; } });
 __exportStar(require("./testClient"), exports);
 __exportStar(require("./user"), exports);
 __exportStar(require("./userConfig"), exports);

package/lib/node/pyth/index.d.ts

@@ -1,4 +1,5 @@
 export { WormholeCoreBridgeSolana, WORMHOLE_CORE_BRIDGE_SOLANA_IDL, PythSolanaReceiver, PriceUpdateAccount, } from './types';
 export { DEFAULT_WORMHOLE_PROGRAM_ID, DEFAULT_RECEIVER_PROGRAM_ID, } from './constants';
 export { getGuardianSetPda } from './utils';
+export { PythLazerSubscriber, PythLazerPriceFeedArray, } from './pythLazerSubscriber';
 //# sourceMappingURL=index.d.ts.map

package/lib/node/pyth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pyth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pyth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACN,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,uBAAuB,CAAC"}

package/lib/node/pyth/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGuardianSetPda = exports.DEFAULT_RECEIVER_PROGRAM_ID = exports.DEFAULT_WORMHOLE_PROGRAM_ID = exports.WORMHOLE_CORE_BRIDGE_SOLANA_IDL = void 0;
+exports.PythLazerSubscriber = exports.getGuardianSetPda = exports.DEFAULT_RECEIVER_PROGRAM_ID = exports.DEFAULT_WORMHOLE_PROGRAM_ID = exports.WORMHOLE_CORE_BRIDGE_SOLANA_IDL = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "WORMHOLE_CORE_BRIDGE_SOLANA_IDL", { enumerable: true, get: function () { return types_1.WORMHOLE_CORE_BRIDGE_SOLANA_IDL; } });
 var constants_1 = require("./constants");
@@ -8,3 +8,5 @@ Object.defineProperty(exports, "DEFAULT_WORMHOLE_PROGRAM_ID", { enumerable: true
 Object.defineProperty(exports, "DEFAULT_RECEIVER_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.DEFAULT_RECEIVER_PROGRAM_ID; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "getGuardianSetPda", { enumerable: true, get: function () { return utils_1.getGuardianSetPda; } });
+var pythLazerSubscriber_1 = require("./pythLazerSubscriber");
+Object.defineProperty(exports, "PythLazerSubscriber", { enumerable: true, get: function () { return pythLazerSubscriber_1.PythLazerSubscriber; } });

package/lib/node/pyth/pythLazerSubscriber.d.ts

@@ -0,0 +1,90 @@
+/// <reference types="node" />
+import { Channel } from '@pythnetwork/pyth-lazer-sdk';
+import { DriftEnv } from '../config';
+/**
+ * Configuration for a group of Pyth Lazer price feeds.
+ */
+export type PythLazerPriceFeedArray = {
+    /** Optional channel for update frequency (e.g., 'fixed_rate@200ms') */
+    channel?: Channel;
+    /** Array of Pyth Lazer price feed IDs to subscribe to */
+    priceFeedIds: number[];
+};
+/**
+ * Manages subscriptions to Pyth Lazer price feeds and provides access to real-time price data.
+ * Automatically filters out non-stable feeds and handles reconnection logic.
+ */
+export declare class PythLazerSubscriber {
+    private endpoints;
+    private token;
+    private priceFeedArrays;
+    private resubTimeoutMs;
+    private sdkLogging;
+    private static readonly SYMBOLS_API_URL;
+    private symbolsCache;
+    private pythLazerClient?;
+    feedIdChunkToPriceMessage: Map<string, string>;
+    feedIdToPrice: Map<number, number>;
+    feedIdHashToFeedIds: Map<string, number[]>;
+    subscriptionIdsToFeedIdsHash: Map<number, string>;
+    allSubscribedIds: number[];
+    timeoutId?: NodeJS.Timeout;
+    receivingData: boolean;
+    isUnsubscribing: boolean;
+    marketIndextoPriceFeedIdChunk: Map<number, number[]>;
+    marketIndextoPriceFeedId: Map<number, number>;
+    /**
+     * Creates a new PythLazerSubscriber instance.
+     * @param endpoints - Array of WebSocket endpoint URLs for Pyth Lazer
+     * @param token - Authentication token for Pyth Lazer API
+     * @param priceFeedArrays - Array of price feed configurations to subscribe to
+     * @param env - Drift environment (mainnet-beta, devnet, etc.)
+     * @param resubTimeoutMs - Milliseconds to wait before resubscribing on data timeout
+     * @param sdkLogging - Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
+     */
+    constructor(endpoints: string[], token: string, priceFeedArrays: PythLazerPriceFeedArray[], env?: DriftEnv, resubTimeoutMs?: number, sdkLogging?: boolean);
+    private fetchSymbolsIfNeeded;
+    private filterStableFeeds;
+    /**
+     * Subscribes to Pyth Lazer price feeds. Automatically filters out non-stable feeds
+     * and establishes WebSocket connections for real-time price updates.
+     */
+    subscribe(): Promise<void>;
+    protected setTimeout(): void;
+    /**
+     * Unsubscribes from all Pyth Lazer price feeds and shuts down WebSocket connections.
+     */
+    unsubscribe(): Promise<void>;
+    hash(arr: number[]): string;
+    /**
+     * Retrieves the latest Solana-format price message for a group of feed IDs.
+     * @param feedIds - Array of price feed IDs
+     * @returns Hex-encoded price message data, or undefined if not available
+     */
+    getLatestPriceMessage(feedIds: number[]): Promise<string | undefined>;
+    /**
+     * Retrieves the latest Solana-format price message for a specific market.
+     * @param marketIndex - The market index to get price data for
+     * @returns Hex-encoded price message data, or undefined if not found
+     */
+    getLatestPriceMessageForMarketIndex(marketIndex: number): Promise<string | undefined>;
+    /**
+     * Gets the array of price feed IDs associated with a market index.
+     * @param marketIndex - The market index to look up
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromMarketIndex(marketIndex: number): number[];
+    /**
+     * Gets the array of price feed IDs from a subscription hash.
+     * @param hash - The subscription hash
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromHash(hash: string): number[];
+    /**
+     * Gets the current parsed price for a specific market index.
+     * @param marketIndex - The market index to get the price for
+     * @returns The price as a number, or undefined if not available
+     */
+    getPriceFromMarketIndex(marketIndex: number): number | undefined;
+}
+//# sourceMappingURL=pythLazerSubscriber.d.ts.map

package/lib/node/pyth/pythLazerSubscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythLazerSubscriber.d.ts","sourceRoot":"","sources":["../../../src/pyth/pythLazerSubscriber.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAOF;;;GAGG;AACH,qBAAa,mBAAmB;IA4B9B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe;IAEvB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAhCnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CACwB;IAC/D,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC3D,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC/C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAa;IACvD,4BAA4B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC9D,gBAAgB,EAAE,MAAM,EAAE,CAAM;IAEhC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAC3B,aAAa,UAAS;IACtB,eAAe,UAAS;IAExB,6BAA6B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAa;IACjE,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAE1D;;;;;;;;OAQG;gBAEM,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,uBAAuB,EAAE,EAClD,GAAG,GAAE,QAAmB,EAChB,cAAc,GAAE,MAAa,EAC7B,UAAU,GAAE,OAAe;YA2BtB,oBAAoB;IAuBlC,OAAO,CAAC,iBAAiB;IAuBzB;;;OAGG;IACG,SAAS;IA0Hf,SAAS,CAAC,UAAU,IAAI,IAAI;IAgB5B;;OAEG;IACG,WAAW;IASjB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM;IAI3B;;;;OAIG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3E;;;;OAIG;IACG,mCAAmC,CACxC,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQ9B;;;;OAIG;IACH,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAI7D;;;;OAIG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;;;OAIG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOhE"}

package/lib/node/pyth/pythLazerSubscriber.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythLazerSubscriber = void 0;
+const pyth_lazer_sdk_1 = require("@pythnetwork/pyth-lazer-sdk");
+const perpMarkets_1 = require("../constants/perpMarkets");
+/**
+ * Manages subscriptions to Pyth Lazer price feeds and provides access to real-time price data.
+ * Automatically filters out non-stable feeds and handles reconnection logic.
+ */
+class PythLazerSubscriber {
+    /**
+     * Creates a new PythLazerSubscriber instance.
+     * @param endpoints - Array of WebSocket endpoint URLs for Pyth Lazer
+     * @param token - Authentication token for Pyth Lazer API
+     * @param priceFeedArrays - Array of price feed configurations to subscribe to
+     * @param env - Drift environment (mainnet-beta, devnet, etc.)
+     * @param resubTimeoutMs - Milliseconds to wait before resubscribing on data timeout
+     * @param sdkLogging - Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
+     */
+    constructor(endpoints, token, priceFeedArrays, env = 'devnet', resubTimeoutMs = 2000, sdkLogging = false) {
+        this.endpoints = endpoints;
+        this.token = token;
+        this.priceFeedArrays = priceFeedArrays;
+        this.resubTimeoutMs = resubTimeoutMs;
+        this.sdkLogging = sdkLogging;
+        this.symbolsCache = null;
+        this.feedIdChunkToPriceMessage = new Map();
+        this.feedIdToPrice = new Map();
+        this.feedIdHashToFeedIds = new Map();
+        this.subscriptionIdsToFeedIdsHash = new Map();
+        this.allSubscribedIds = [];
+        this.receivingData = false;
+        this.isUnsubscribing = false;
+        this.marketIndextoPriceFeedIdChunk = new Map();
+        this.marketIndextoPriceFeedId = new Map();
+        const markets = perpMarkets_1.PerpMarkets[env].filter((market) => market.pythLazerId !== undefined);
+        this.allSubscribedIds = this.priceFeedArrays
+            .map((array) => array.priceFeedIds)
+            .flat();
+        for (const priceFeedIds of priceFeedArrays) {
+            const filteredMarkets = markets.filter((market) => priceFeedIds.priceFeedIds.includes(market.pythLazerId));
+            for (const market of filteredMarkets) {
+                this.marketIndextoPriceFeedIdChunk.set(market.marketIndex, priceFeedIds.priceFeedIds);
+                this.marketIndextoPriceFeedId.set(market.marketIndex, market.pythLazerId);
+            }
+        }
+    }
+    async fetchSymbolsIfNeeded() {
+        if (this.symbolsCache !== null)
+            return;
+        try {
+            const response = await fetch(PythLazerSubscriber.SYMBOLS_API_URL);
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const symbols = await response.json();
+            this.symbolsCache = new Map();
+            for (const symbol of symbols) {
+                this.symbolsCache.set(symbol.pyth_lazer_id, {
+                    name: symbol.name,
+                    state: symbol.state,
+                });
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to fetch Pyth Lazer symbols, proceeding with all feeds: ${error}`);
+            this.symbolsCache = new Map(); // Empty map = no filtering
+        }
+    }
+    filterStableFeeds(feedIds) {
+        if (this.symbolsCache === null || this.symbolsCache.size === 0) {
+            return feedIds; // No filtering if cache unavailable
+        }
+        return feedIds.filter((feedId) => {
+            const info = this.symbolsCache.get(feedId);
+            if (!info) {
+                console.warn(`Feed ID ${feedId} not found in symbols API, including anyway`);
+                return true;
+            }
+            if (info.state !== 'stable') {
+                console.warn(`Removing feed ID ${feedId} (${info.name}) - state is "${info.state}", not "stable"`);
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Subscribes to Pyth Lazer price feeds. Automatically filters out non-stable feeds
+     * and establishes WebSocket connections for real-time price updates.
+     */
+    async subscribe() {
+        var _a;
+        await this.fetchSymbolsIfNeeded();
+        this.pythLazerClient = await pyth_lazer_sdk_1.PythLazerClient.create({
+            token: this.token,
+            logger: this.sdkLogging ? console : undefined,
+            webSocketPoolConfig: {
+                urls: this.endpoints,
+                numConnections: 4, // Optionally specify number of parallel redundant connections to reduce the chance of dropped messages. The connections will round-robin across the provided URLs. Default is 4.
+                onError: (error) => {
+                    console.error('⛔️ PythLazerClient error:', error.message);
+                },
+                onWebSocketError: (error) => {
+                    console.error('⛔️ WebSocket error:', error.message);
+                },
+                onWebSocketPoolError: (error) => {
+                    console.error('⛔️ WebSocket pool error:', error.message);
+                },
+                // Optional configuration for resilient WebSocket connections
+                rwsConfig: {
+                    heartbeatTimeoutDurationMs: 5000, // Optional heartbeat timeout duration in milliseconds
+                    maxRetryDelayMs: 1000, // Optional maximum retry delay in milliseconds
+                    logAfterRetryCount: 10, // Optional log after how many retries
+                },
+            },
+        });
+        // Reset allSubscribedIds to rebuild with only stable feeds
+        this.allSubscribedIds = [];
+        let subscriptionId = 1;
+        for (const priceFeedArray of this.priceFeedArrays) {
+            const filteredFeedIds = this.filterStableFeeds(priceFeedArray.priceFeedIds);
+            if (filteredFeedIds.length === 0) {
+                console.warn(`All feeds filtered out for subscription ${subscriptionId}, skipping`);
+                continue;
+            }
+            // Update allSubscribedIds with only stable feeds
+            this.allSubscribedIds.push(...filteredFeedIds);
+            const feedIdsHash = this.hash(filteredFeedIds);
+            this.feedIdHashToFeedIds.set(feedIdsHash, filteredFeedIds);
+            this.subscriptionIdsToFeedIdsHash.set(subscriptionId, feedIdsHash);
+            // Update marketIndextoPriceFeedIdChunk to use filtered feeds
+            for (const [marketIndex, chunk,] of this.marketIndextoPriceFeedIdChunk.entries()) {
+                if (this.hash(chunk) === this.hash(priceFeedArray.priceFeedIds)) {
+                    this.marketIndextoPriceFeedIdChunk.set(marketIndex, filteredFeedIds);
+                }
+            }
+            // Remove entries from marketIndextoPriceFeedId for filtered-out feeds
+            for (const [marketIndex, feedId,] of this.marketIndextoPriceFeedId.entries()) {
+                if (!filteredFeedIds.includes(feedId) &&
+                    priceFeedArray.priceFeedIds.includes(feedId)) {
+                    this.marketIndextoPriceFeedId.delete(marketIndex);
+                    this.marketIndextoPriceFeedIdChunk.delete(marketIndex);
+                }
+            }
+            this.pythLazerClient.addMessageListener((message) => {
+                var _a, _b;
+                this.receivingData = true;
+                clearTimeout(this.timeoutId);
+                switch (message.type) {
+                    case 'json': {
+                        if (message.value.type == 'streamUpdated') {
+                            if ((_a = message.value.solana) === null || _a === void 0 ? void 0 : _a.data) {
+                                this.feedIdChunkToPriceMessage.set(this.subscriptionIdsToFeedIdsHash.get(message.value.subscriptionId), message.value.solana.data);
+                            }
+                            if ((_b = message.value.parsed) === null || _b === void 0 ? void 0 : _b.priceFeeds) {
+                                for (const priceFeed of message.value.parsed.priceFeeds) {
+                                    const price = Number(priceFeed.price) *
+                                        Math.pow(10, Number(priceFeed.exponent));
+                                    this.feedIdToPrice.set(priceFeed.priceFeedId, price);
+                                }
+                            }
+                        }
+                        break;
+                    }
+                    default: {
+                        break;
+                    }
+                }
+                this.setTimeout();
+            });
+            this.pythLazerClient.send({
+                type: 'subscribe',
+                subscriptionId,
+                priceFeedIds: filteredFeedIds,
+                properties: ['price', 'bestAskPrice', 'bestBidPrice', 'exponent'],
+                formats: ['solana'],
+                deliveryFormat: 'json',
+                channel: (_a = priceFeedArray.channel) !== null && _a !== void 0 ? _a : 'fixed_rate@200ms',
+                jsonBinaryEncoding: 'hex',
+            });
+            subscriptionId++;
+        }
+        this.receivingData = true;
+        this.setTimeout();
+    }
+    setTimeout() {
+        this.timeoutId = setTimeout(async () => {
+            if (this.isUnsubscribing) {
+                // If we are in the process of unsubscribing, do not attempt to resubscribe
+                return;
+            }
+            if (this.receivingData) {
+                console.log(`No ws data from pyth lazer client resubscribing`);
+                await this.unsubscribe();
+                this.receivingData = false;
+                await this.subscribe();
+            }
+        }, this.resubTimeoutMs);
+    }
+    /**
+     * Unsubscribes from all Pyth Lazer price feeds and shuts down WebSocket connections.
+     */
+    async unsubscribe() {
+        var _a;
+        this.isUnsubscribing = true;
+        (_a = this.pythLazerClient) === null || _a === void 0 ? void 0 : _a.shutdown();
+        this.pythLazerClient = undefined;
+        clearTimeout(this.timeoutId);
+        this.timeoutId = undefined;
+        this.isUnsubscribing = false;
+    }
+    hash(arr) {
+        return 'h:' + arr.join('|');
+    }
+    /**
+     * Retrieves the latest Solana-format price message for a group of feed IDs.
+     * @param feedIds - Array of price feed IDs
+     * @returns Hex-encoded price message data, or undefined if not available
+     */
+    async getLatestPriceMessage(feedIds) {
+        return this.feedIdChunkToPriceMessage.get(this.hash(feedIds));
+    }
+    /**
+     * Retrieves the latest Solana-format price message for a specific market.
+     * @param marketIndex - The market index to get price data for
+     * @returns Hex-encoded price message data, or undefined if not found
+     */
+    async getLatestPriceMessageForMarketIndex(marketIndex) {
+        const feedIds = this.marketIndextoPriceFeedIdChunk.get(marketIndex);
+        if (!feedIds) {
+            return undefined;
+        }
+        return await this.getLatestPriceMessage(feedIds);
+    }
+    /**
+     * Gets the array of price feed IDs associated with a market index.
+     * @param marketIndex - The market index to look up
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromMarketIndex(marketIndex) {
+        return this.marketIndextoPriceFeedIdChunk.get(marketIndex) || [];
+    }
+    /**
+     * Gets the array of price feed IDs from a subscription hash.
+     * @param hash - The subscription hash
+     * @returns Array of price feed IDs, or empty array if not found
+     */
+    getPriceFeedIdsFromHash(hash) {
+        return this.feedIdHashToFeedIds.get(hash) || [];
+    }
+    /**
+     * Gets the current parsed price for a specific market index.
+     * @param marketIndex - The market index to get the price for
+     * @returns The price as a number, or undefined if not available
+     */
+    getPriceFromMarketIndex(marketIndex) {
+        const feedId = this.marketIndextoPriceFeedId.get(marketIndex);
+        if (feedId === undefined) {
+            return undefined;
+        }
+        return this.feedIdToPrice.get(feedId);
+    }
+}
+exports.PythLazerSubscriber = PythLazerSubscriber;
+PythLazerSubscriber.SYMBOLS_API_URL = 'https://history.pyth-lazer.dourolabs.app/history/v1/symbols';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@drift-labs/sdk",
-	"version": "2.156.0-beta.1",
+	"version": "2.156.0-beta.3",
 	"main": "lib/node/index.js",
 	"types": "lib/node/index.d.ts",
 	"module": "./lib/browser/index.js",

package/src/pyth/pythLazerSubscriber.ts

@@ -2,8 +2,13 @@ import { Channel, PythLazerClient } from '@pythnetwork/pyth-lazer-sdk';
 import { DriftEnv } from '../config';
 import { PerpMarkets } from '../constants/perpMarkets';
 
+/**
+ * Configuration for a group of Pyth Lazer price feeds.
+ */
 export type PythLazerPriceFeedArray = {
+	/** Optional channel for update frequency (e.g., 'fixed_rate@200ms') */
 	channel?: Channel;
+	/** Array of Pyth Lazer price feed IDs to subscribe to */
 	priceFeedIds: number[];
 };
 
@@ -12,6 +17,10 @@ type FeedSymbolInfo = {
 	state: string;
 };
 
+/**
+ * Manages subscriptions to Pyth Lazer price feeds and provides access to real-time price data.
+ * Automatically filters out non-stable feeds and handles reconnection logic.
+ */
 export class PythLazerSubscriber {
 	private static readonly SYMBOLS_API_URL =
 		'https://history.pyth-lazer.dourolabs.app/history/v1/symbols';
@@ -30,15 +39,21 @@ export class PythLazerSubscriber {
 	marketIndextoPriceFeedIdChunk: Map<number, number[]> = new Map();
 	marketIndextoPriceFeedId: Map<number, number> = new Map();
 
+	/**
+	 * Creates a new PythLazerSubscriber instance.
+	 * @param endpoints - Array of WebSocket endpoint URLs for Pyth Lazer
+	 * @param token - Authentication token for Pyth Lazer API
+	 * @param priceFeedArrays - Array of price feed configurations to subscribe to
+	 * @param env - Drift environment (mainnet-beta, devnet, etc.)
+	 * @param resubTimeoutMs - Milliseconds to wait before resubscribing on data timeout
+	 * @param sdkLogging - Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
+	 */
 	constructor(
 		private endpoints: string[],
 		private token: string,
 		private priceFeedArrays: PythLazerPriceFeedArray[],
 		env: DriftEnv = 'devnet',
 		private resubTimeoutMs: number = 2000,
-		/**
-		 * Whether to log Pyth SDK logs to the console. This is very noisy but could be useful for debugging.
-		 */
 		private sdkLogging: boolean = false
 	) {
 		const markets = PerpMarkets[env].filter(
@@ -112,6 +127,10 @@ export class PythLazerSubscriber {
 		});
 	}
 
+	/**
+	 * Subscribes to Pyth Lazer price feeds. Automatically filters out non-stable feeds
+	 * and establishes WebSocket connections for real-time price updates.
+	 */
 	async subscribe() {
 		await this.fetchSymbolsIfNeeded();
 
@@ -250,6 +269,9 @@ export class PythLazerSubscriber {
 		}, this.resubTimeoutMs);
 	}
 
+	/**
+	 * Unsubscribes from all Pyth Lazer price feeds and shuts down WebSocket connections.
+	 */
 	async unsubscribe() {
 		this.isUnsubscribing = true;
 		this.pythLazerClient?.shutdown();
@@ -263,10 +285,20 @@ export class PythLazerSubscriber {
 		return 'h:' + arr.join('|');
 	}
 
+	/**
+	 * Retrieves the latest Solana-format price message for a group of feed IDs.
+	 * @param feedIds - Array of price feed IDs
+	 * @returns Hex-encoded price message data, or undefined if not available
+	 */
 	async getLatestPriceMessage(feedIds: number[]): Promise<string | undefined> {
 		return this.feedIdChunkToPriceMessage.get(this.hash(feedIds));
 	}
 
+	/**
+	 * Retrieves the latest Solana-format price message for a specific market.
+	 * @param marketIndex - The market index to get price data for
+	 * @returns Hex-encoded price message data, or undefined if not found
+	 */
 	async getLatestPriceMessageForMarketIndex(
 		marketIndex: number
 	): Promise<string | undefined> {
@@ -277,14 +309,29 @@ export class PythLazerSubscriber {
 		return await this.getLatestPriceMessage(feedIds);
 	}
 
+	/**
+	 * Gets the array of price feed IDs associated with a market index.
+	 * @param marketIndex - The market index to look up
+	 * @returns Array of price feed IDs, or empty array if not found
+	 */
 	getPriceFeedIdsFromMarketIndex(marketIndex: number): number[] {
 		return this.marketIndextoPriceFeedIdChunk.get(marketIndex) || [];
 	}
 
+	/**
+	 * Gets the array of price feed IDs from a subscription hash.
+	 * @param hash - The subscription hash
+	 * @returns Array of price feed IDs, or empty array if not found
+	 */
 	getPriceFeedIdsFromHash(hash: string): number[] {
 		return this.feedIdHashToFeedIds.get(hash) || [];
 	}
 
+	/**
+	 * Gets the current parsed price for a specific market index.
+	 * @param marketIndex - The market index to get the price for
+	 * @returns The price as a number, or undefined if not available
+	 */
 	getPriceFromMarketIndex(marketIndex: number): number | undefined {
 		const feedId = this.marketIndextoPriceFeedId.get(marketIndex);
 		if (feedId === undefined) {