@drift-labs/sdk-browser 2.156.0-beta.0 → 2.156.0-beta.4

package/VERSION

@@ -1 +1 @@
-2.156.0-beta.0
+2.156.0-beta.4

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/jupiter/jupiterClient.d.ts

@@ -209,15 +209,29 @@ export interface QuoteResponse {
     errorCode?: string;
 }
 export declare const RECOMMENDED_JUPITER_API_VERSION = "/v1";
-export declare const RECOMMENDED_JUPITER_API = "https://lite-api.jup.ag/swap";
+/** @deprecated Use RECOMMENDED_JUPITER_API instead. lite-api.jup.ag requires migration to api.jup.ag with API key. */
+export declare const LEGACY_JUPITER_API = "https://lite-api.jup.ag/swap";
+export declare const RECOMMENDED_JUPITER_API = "https://api.jup.ag/swap";
 export declare class JupiterClient {
     url: string;
     connection: Connection;
     lookupTableCahce: Map<string, AddressLookupTableAccount>;
-    constructor({ connection, url }: {
+    private apiKey?;
+    /**
+     * Create a Jupiter client
+     * @param connection - Solana connection
+     * @param url - Optional custom API URL. Defaults to https://api.jup.ag/swap
+     * @param apiKey - API key for Jupiter API. Required for api.jup.ag (free tier available at https://portal.jup.ag)
+     */
+    constructor({ connection, url, apiKey, }: {
         connection: Connection;
         url?: string;
+        apiKey?: string;
     });
+    /**
+     * Get the headers for API requests, including API key if configured
+     */
+    private getHeaders;
     /**
      * Get routes for a swap
      * @param inputMint the mint of the input token

package/lib/browser/jupiter/jupiterClient.js

@@ -3,16 +3,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JupiterClient = exports.RECOMMENDED_JUPITER_API = exports.RECOMMENDED_JUPITER_API_VERSION = void 0;
+exports.JupiterClient = exports.RECOMMENDED_JUPITER_API = exports.LEGACY_JUPITER_API = exports.RECOMMENDED_JUPITER_API_VERSION = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const node_fetch_1 = __importDefault(require("node-fetch"));
 exports.RECOMMENDED_JUPITER_API_VERSION = '/v1';
-exports.RECOMMENDED_JUPITER_API = 'https://lite-api.jup.ag/swap';
+/** @deprecated Use RECOMMENDED_JUPITER_API instead. lite-api.jup.ag requires migration to api.jup.ag with API key. */
+exports.LEGACY_JUPITER_API = 'https://lite-api.jup.ag/swap';
+exports.RECOMMENDED_JUPITER_API = 'https://api.jup.ag/swap';
 class JupiterClient {
-    constructor({ connection, url }) {
+    /**
+     * Create a Jupiter client
+     * @param connection - Solana connection
+     * @param url - Optional custom API URL. Defaults to https://api.jup.ag/swap
+     * @param apiKey - API key for Jupiter API. Required for api.jup.ag (free tier available at https://portal.jup.ag)
+     */
+    constructor({ connection, url, apiKey, }) {
         this.lookupTableCahce = new Map();
         this.connection = connection;
         this.url = url !== null && url !== void 0 ? url : exports.RECOMMENDED_JUPITER_API;
+        this.apiKey = apiKey;
+    }
+    /**
+     * Get the headers for API requests, including API key if configured
+     */
+    getHeaders(contentType) {
+        const headers = {};
+        if (contentType) {
+            headers['Content-Type'] = contentType;
+        }
+        if (this.apiKey) {
+            headers['x-api-key'] = this.apiKey;
+        }
+        return headers;
     }
     /**
      * Get routes for a swap
@@ -43,10 +65,12 @@ class JupiterClient {
         if (swapMode === 'ExactOut') {
             params.delete('maxAccounts');
         }
-        const apiVersionParam = this.url === exports.RECOMMENDED_JUPITER_API
+        const apiVersionParam = this.url === exports.RECOMMENDED_JUPITER_API || this.url === exports.LEGACY_JUPITER_API
             ? exports.RECOMMENDED_JUPITER_API_VERSION
             : '';
-        const quote = await (await (0, node_fetch_1.default)(`${this.url}${apiVersionParam}/quote?${params.toString()}`)).json();
+        const headers = this.getHeaders();
+        const fetchOptions = Object.keys(headers).length > 0 ? { headers } : {};
+        const quote = await (await (0, node_fetch_1.default)(`${this.url}${apiVersionParam}/quote?${params.toString()}`, fetchOptions)).json();
         return quote;
     }
     /**
@@ -60,14 +84,12 @@ class JupiterClient {
         if (!quote) {
             throw new Error('Jupiter swap quote not provided. Please try again.');
         }
-        const apiVersionParam = this.url === exports.RECOMMENDED_JUPITER_API
+        const apiVersionParam = this.url === exports.RECOMMENDED_JUPITER_API || this.url === exports.LEGACY_JUPITER_API
             ? exports.RECOMMENDED_JUPITER_API_VERSION
             : '';
         const resp = await (await (0, node_fetch_1.default)(`${this.url}${apiVersionParam}/swap`, {
             method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
+            headers: this.getHeaders('application/json'),
             body: JSON.stringify({
                 quoteResponse: quote,
                 userPublicKey,

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/browser/swap/UnifiedSwapClient.d.ts

@@ -60,6 +60,14 @@ export interface SwapTransactionResult {
 export declare class UnifiedSwapClient {
     private client;
     private clientType;
+    /**
+     * Create a unified swap client
+     * @param clientType - 'jupiter' or 'titan'
+     * @param connection - Solana connection
+     * @param authToken - For Titan: auth token (required when not using proxy). For Jupiter: API key (required for api.jup.ag, get free key at https://portal.jup.ag)
+     * @param url - Optional custom URL
+     * @param proxyUrl - Optional proxy URL for Titan
+     */
     constructor({ clientType, connection, authToken, url, proxyUrl, }: {
         clientType: SwapClientType;
         connection: Connection;

package/lib/browser/swap/UnifiedSwapClient.js

@@ -4,12 +4,21 @@ exports.UnifiedSwapClient = void 0;
 const jupiterClient_1 = require("../jupiter/jupiterClient");
 const titanClient_1 = require("../titan/titanClient");
 class UnifiedSwapClient {
+    /**
+     * Create a unified swap client
+     * @param clientType - 'jupiter' or 'titan'
+     * @param connection - Solana connection
+     * @param authToken - For Titan: auth token (required when not using proxy). For Jupiter: API key (required for api.jup.ag, get free key at https://portal.jup.ag)
+     * @param url - Optional custom URL
+     * @param proxyUrl - Optional proxy URL for Titan
+     */
     constructor({ clientType, connection, authToken, url, proxyUrl, }) {
         this.clientType = clientType;
         if (clientType === 'jupiter') {
             this.client = new jupiterClient_1.JupiterClient({
                 connection,
                 url,
+                apiKey: authToken,
             });
         }
         else if (clientType === 'titan') {

package/lib/browser/user.js

@@ -674,9 +674,9 @@ class User {
             return 0;
         }
         const marginCalc = this.getMarginCalculation('Maintenance');
-        let totalCollateral;
-        let maintenanceMarginReq;
-        if (perpMarketIndex) {
+        let totalCollateral = numericConstants_1.ZERO;
+        let maintenanceMarginReq = numericConstants_1.ZERO;
+        if (perpMarketIndex != null) {
             const isolatedMarginCalc = marginCalc.isolatedMarginCalculations.get(perpMarketIndex);
             if (isolatedMarginCalc) {
                 totalCollateral = isolatedMarginCalc.totalCollateral;

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/jupiter/jupiterClient.d.ts

@@ -209,15 +209,29 @@ export interface QuoteResponse {
     errorCode?: string;
 }
 export declare const RECOMMENDED_JUPITER_API_VERSION = "/v1";
-export declare const RECOMMENDED_JUPITER_API = "https://lite-api.jup.ag/swap";
+/** @deprecated Use RECOMMENDED_JUPITER_API instead. lite-api.jup.ag requires migration to api.jup.ag with API key. */
+export declare const LEGACY_JUPITER_API = "https://lite-api.jup.ag/swap";
+export declare const RECOMMENDED_JUPITER_API = "https://api.jup.ag/swap";
 export declare class JupiterClient {
     url: string;
     connection: Connection;
     lookupTableCahce: Map<string, AddressLookupTableAccount>;
-    constructor({ connection, url }: {
+    private apiKey?;
+    /**
+     * Create a Jupiter client
+     * @param connection - Solana connection
+     * @param url - Optional custom API URL. Defaults to https://api.jup.ag/swap
+     * @param apiKey - API key for Jupiter API. Required for api.jup.ag (free tier available at https://portal.jup.ag)
+     */
+    constructor({ connection, url, apiKey, }: {
         connection: Connection;
         url?: string;
+        apiKey?: string;
     });
+    /**
+     * Get the headers for API requests, including API key if configured
+     */
+    private getHeaders;
     /**
      * Get routes for a swap
      * @param inputMint the mint of the input token