@pythnetwork/pyth-lazer-sdk 2.0.0 → 4.0.0

package/dist/cjs/client.d.ts

@@ -1,4 +1,5 @@
-import type { ParsedPayload, Request, Response } from "./protocol.js";
+import type { Logger } from "ts-log";
+import type { ParsedPayload, Request, Response, SymbolResponse, SymbolsQueryParams, LatestPriceRequest, PriceRequest, JsonUpdate } from "./protocol.js";
 import type { WebSocketPoolConfig } from "./socket/websocket-pool.js";
 export type BinaryResponse = {
     subscriptionId: number;
@@ -15,17 +16,31 @@ export type JsonOrBinaryResponse = {
     type: "binary";
     value: BinaryResponse;
 };
+export type LazerClientConfig = {
+    token: string;
+    metadataServiceUrl?: string;
+    priceServiceUrl?: string;
+    logger?: Logger;
+    webSocketPoolConfig?: WebSocketPoolConfig;
+};
 export declare class PythLazerClient {
-    private readonly wsp;
+    private readonly token;
+    private readonly metadataServiceUrl;
+    private readonly priceServiceUrl;
+    private readonly logger;
+    private readonly wsp?;
     private constructor();
+    /**
+     * Gets the WebSocket pool. If the WebSocket pool is not configured, an error is thrown.
+     * @throws Error if WebSocket pool is not configured
+     * @returns The WebSocket pool
+     */
+    private getWebSocketPool;
     /**
      * Creates a new PythLazerClient instance.
-     * @param urls - List of WebSocket URLs of the Pyth Lazer service
-     * @param token - The access token for authentication
-     * @param numConnections - The number of parallel WebSocket connections to establish (default: 3). A higher number gives a more reliable stream. The connections will round-robin across the provided URLs.
-     * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
+     * @param config - Configuration including token, metadata service URL, and price service URL, and WebSocket pool configuration
      */
-    static create(config: WebSocketPoolConfig): Promise<PythLazerClient>;
+    static create(config: LazerClientConfig): Promise<PythLazerClient>;
     /**
      * Adds a message listener that receives either JSON or binary responses from the WebSocket connections.
      * The listener will be called for each message received, with deduplication across redundant connections.
@@ -43,4 +58,29 @@ export declare class PythLazerClient {
      */
     addAllConnectionsDownListener(handler: () => void): void;
     shutdown(): void;
+    /**
+     * Private helper method to make authenticated HTTP requests with Bearer token
+     * @param url - The URL to fetch
+     * @param options - Additional fetch options
+     * @returns Promise resolving to the fetch Response
+     */
+    private authenticatedFetch;
+    /**
+     * Queries the symbols endpoint to get available price feed symbols.
+     * @param params - Optional query parameters to filter symbols
+     * @returns Promise resolving to array of symbol information
+     */
+    getSymbols(params?: SymbolsQueryParams): Promise<SymbolResponse[]>;
+    /**
+     * Queries the latest price endpoint to get current price data.
+     * @param params - Parameters for the latest price request
+     * @returns Promise resolving to JsonUpdate with current price data
+     */
+    getLatestPrice(params: LatestPriceRequest): Promise<JsonUpdate>;
+    /**
+     * Queries the price endpoint to get historical price data at a specific timestamp.
+     * @param params - Parameters for the price request including timestamp
+     * @returns Promise resolving to JsonUpdate with price data at the specified time
+     */
+    getPrice(params: PriceRequest): Promise<JsonUpdate>;
 }

package/dist/cjs/client.js

@@ -1,26 +1,57 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PythLazerClient = void 0;
+const cross_fetch_1 = __importDefault(require("cross-fetch"));
+const ts_log_1 = require("ts-log");
+const constants_js_1 = require("./constants.js");
 const protocol_js_1 = require("./protocol.js");
 const websocket_pool_js_1 = require("./socket/websocket-pool.js");
 const UINT16_NUM_BYTES = 2;
 const UINT32_NUM_BYTES = 4;
 const UINT64_NUM_BYTES = 8;
 class PythLazerClient {
+    token;
+    metadataServiceUrl;
+    priceServiceUrl;
+    logger;
     wsp;
-    constructor(wsp) {
+    constructor(token, metadataServiceUrl, priceServiceUrl, logger, wsp) {
+        this.token = token;
+        this.metadataServiceUrl = metadataServiceUrl;
+        this.priceServiceUrl = priceServiceUrl;
+        this.logger = logger;
         this.wsp = wsp;
     }
+    /**
+     * Gets the WebSocket pool. If the WebSocket pool is not configured, an error is thrown.
+     * @throws Error if WebSocket pool is not configured
+     * @returns The WebSocket pool
+     */
+    getWebSocketPool() {
+        if (!this.wsp) {
+            throw new Error("WebSocket pool is not available. Make sure to provide webSocketPoolConfig when creating the client.");
+        }
+        return this.wsp;
+    }
     /**
      * Creates a new PythLazerClient instance.
-     * @param urls - List of WebSocket URLs of the Pyth Lazer service
-     * @param token - The access token for authentication
-     * @param numConnections - The number of parallel WebSocket connections to establish (default: 3). A higher number gives a more reliable stream. The connections will round-robin across the provided URLs.
-     * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
+     * @param config - Configuration including token, metadata service URL, and price service URL, and WebSocket pool configuration
      */
     static async create(config) {
-        const wsp = await websocket_pool_js_1.WebSocketPool.create(config);
-        return new PythLazerClient(wsp);
+        const token = config.token;
+        // Collect and remove trailing slash from URLs
+        const metadataServiceUrl = (config.metadataServiceUrl ?? constants_js_1.DEFAULT_METADATA_SERVICE_URL).replace(/\/+$/, "");
+        const priceServiceUrl = (config.priceServiceUrl ?? constants_js_1.DEFAULT_PRICE_SERVICE_URL).replace(/\/+$/, "");
+        const logger = config.logger ?? ts_log_1.dummyLogger;
+        // If webSocketPoolConfig is provided, create a WebSocket pool and block until at least one connection is established.
+        let wsp;
+        if (config.webSocketPoolConfig) {
+            wsp = await websocket_pool_js_1.WebSocketPool.create(config.webSocketPoolConfig, token, logger);
+        }
+        return new PythLazerClient(token, metadataServiceUrl, priceServiceUrl, logger, wsp);
     }
     /**
      * Adds a message listener that receives either JSON or binary responses from the WebSocket connections.
@@ -29,7 +60,8 @@ class PythLazerClient {
      * or a binary response containing EVM, Solana, or parsed payload data.
      */
     addMessageListener(handler) {
-        this.wsp.addMessageListener((data) => {
+        const wsp = this.getWebSocketPool();
+        wsp.addMessageListener((data) => {
             if (typeof data == "string") {
                 handler({
                     type: "json",
@@ -81,16 +113,19 @@ class PythLazerClient {
         });
     }
     subscribe(request) {
+        const wsp = this.getWebSocketPool();
         if (request.type !== "subscribe") {
             throw new Error("Request must be a subscribe request");
         }
-        this.wsp.addSubscription(request);
+        wsp.addSubscription(request);
     }
     unsubscribe(subscriptionId) {
-        this.wsp.removeSubscription(subscriptionId);
+        const wsp = this.getWebSocketPool();
+        wsp.removeSubscription(subscriptionId);
     }
     send(request) {
-        this.wsp.sendRequest(request);
+        const wsp = this.getWebSocketPool();
+        wsp.sendRequest(request);
     }
     /**
      * Registers a handler function that will be called whenever all WebSocket connections are down or attempting to reconnect.
@@ -98,10 +133,104 @@ class PythLazerClient {
      * @param handler - Function to be called when all connections are down
      */
     addAllConnectionsDownListener(handler) {
-        this.wsp.addAllConnectionsDownListener(handler);
+        const wsp = this.getWebSocketPool();
+        wsp.addAllConnectionsDownListener(handler);
     }
     shutdown() {
-        this.wsp.shutdown();
+        const wsp = this.getWebSocketPool();
+        wsp.shutdown();
+    }
+    /**
+     * Private helper method to make authenticated HTTP requests with Bearer token
+     * @param url - The URL to fetch
+     * @param options - Additional fetch options
+     * @returns Promise resolving to the fetch Response
+     */
+    async authenticatedFetch(url, options = {}) {
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            ...options.headers,
+        };
+        return (0, cross_fetch_1.default)(url, {
+            ...options,
+            headers,
+        });
+    }
+    /**
+     * Queries the symbols endpoint to get available price feed symbols.
+     * @param params - Optional query parameters to filter symbols
+     * @returns Promise resolving to array of symbol information
+     */
+    async getSymbols(params) {
+        const url = new URL(`${this.metadataServiceUrl}/v1/symbols`);
+        if (params?.query) {
+            url.searchParams.set("query", params.query);
+        }
+        if (params?.asset_type) {
+            url.searchParams.set("asset_type", params.asset_type);
+        }
+        try {
+            const response = await this.authenticatedFetch(url.toString());
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch symbols: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Queries the latest price endpoint to get current price data.
+     * @param params - Parameters for the latest price request
+     * @returns Promise resolving to JsonUpdate with current price data
+     */
+    async getLatestPrice(params) {
+        const url = `${this.priceServiceUrl}/v1/latest_price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("getLatestPrice", { url, body });
+            const response = await this.authenticatedFetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: body,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch latest price: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Queries the price endpoint to get historical price data at a specific timestamp.
+     * @param params - Parameters for the price request including timestamp
+     * @returns Promise resolving to JsonUpdate with price data at the specified time
+     */
+    async getPrice(params) {
+        const url = `${this.priceServiceUrl}/v1/price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("getPrice", { url, body });
+            const response = await this.authenticatedFetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: body,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch price: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
 }
 exports.PythLazerClient = PythLazerClient;

package/dist/cjs/constants.d.ts

@@ -1,2 +1,6 @@
 export declare const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export declare const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
+export declare const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export declare const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
+export declare const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
+export declare const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/cjs/constants.js

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOLANA_LAZER_STORAGE_ID = exports.SOLANA_LAZER_PROGRAM_ID = void 0;
+exports.DEFAULT_STREAM_SERVICE_1_URL = exports.DEFAULT_STREAM_SERVICE_0_URL = exports.DEFAULT_PRICE_SERVICE_URL = exports.DEFAULT_METADATA_SERVICE_URL = exports.SOLANA_LAZER_STORAGE_ID = exports.SOLANA_LAZER_PROGRAM_ID = void 0;
 exports.SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 exports.SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
+exports.DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+exports.DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
+exports.DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
+exports.DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/cjs/protocol.d.ts

@@ -37,6 +37,7 @@ export type JsonBinaryData = {
 };
 export type InvalidFeedSubscriptionDetails = {
     unknownIds: number[];
+    unknownSymbols: string[];
     unsupportedChannels: number[];
     unstable: number[];
 };
@@ -75,3 +76,49 @@ export declare const FORMAT_MAGICS_LE: {
     LE_ECDSA: number;
     LE_UNSIGNED: number;
 };
+export type AssetType = "crypto" | "fx" | "equity" | "metal" | "rates" | "nav" | "commodity" | "funding-rate";
+export type SymbolsQueryParams = {
+    query?: string;
+    asset_type?: AssetType;
+};
+export type SymbolResponse = {
+    pyth_lazer_id: number;
+    name: string;
+    symbol: string;
+    description: string;
+    asset_type: string;
+    exponent: number;
+    min_publishers: number;
+    min_channel: string;
+    state: string;
+    schedule: string;
+    cmc_id?: number | null;
+    hermes_id?: string | null;
+    interval?: string | null;
+};
+export type LatestPriceRequest = {
+    priceFeedIds?: number[];
+    symbols?: string[];
+    properties: PriceFeedProperty[];
+    formats: Format[];
+    jsonBinaryEncoding?: JsonBinaryEncoding;
+    parsed?: boolean;
+    channel: Channel;
+};
+export type PriceRequest = {
+    timestamp: number;
+    priceFeedIds?: number[];
+    symbols?: string[];
+    properties: PriceFeedProperty[];
+    formats: Format[];
+    jsonBinaryEncoding?: JsonBinaryEncoding;
+    parsed?: boolean;
+    channel: Channel;
+};
+export type JsonUpdate = {
+    parsed?: ParsedPayload;
+    evm?: JsonBinaryData;
+    solana?: JsonBinaryData;
+    leEcdsa?: JsonBinaryData;
+    leUnsigned?: JsonBinaryData;
+};

package/dist/cjs/socket/websocket-pool.d.ts

@@ -5,10 +5,8 @@ import type { Request } from "../protocol.js";
 import type { ResilientWebSocketConfig } from "./resilient-websocket.js";
 import { ResilientWebSocket } from "./resilient-websocket.js";
 export type WebSocketPoolConfig = {
-    urls: string[];
-    token: string;
+    urls?: string[];
     numConnections?: number;
-    logger?: Logger;
     rwsConfig?: Omit<ResilientWebSocketConfig, "logger" | "endpoint">;
     onError?: (error: ErrorEvent) => void;
 };
@@ -30,7 +28,7 @@ export declare class WebSocketPool {
      * @param numConnections - Number of parallel WebSocket connections to maintain (default: 3)
      * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
      */
-    static create(config: WebSocketPoolConfig): Promise<WebSocketPool>;
+    static create(config: WebSocketPoolConfig, token: string, logger?: Logger): Promise<WebSocketPool>;
     /**
      * Checks for error responses in JSON messages and throws appropriate errors
      */

package/dist/cjs/socket/websocket-pool.js

@@ -7,6 +7,7 @@ exports.WebSocketPool = void 0;
 const ttlcache_1 = __importDefault(require("@isaacs/ttlcache"));
 const ts_log_1 = require("ts-log");
 const resilient_websocket_js_1 = require("./resilient-websocket.js");
+const constants_js_1 = require("../constants.js");
 const DEFAULT_NUM_CONNECTIONS = 4;
 class WebSocketPool {
     logger;
@@ -37,29 +38,30 @@ class WebSocketPool {
      * @param numConnections - Number of parallel WebSocket connections to maintain (default: 3)
      * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
      */
-    static async create(config) {
-        if (config.urls.length === 0) {
-            throw new Error("No URLs provided");
-        }
-        const logger = config.logger ?? ts_log_1.dummyLogger;
-        const pool = new WebSocketPool(logger);
+    static async create(config, token, logger) {
+        const urls = config.urls ?? [
+            constants_js_1.DEFAULT_STREAM_SERVICE_0_URL,
+            constants_js_1.DEFAULT_STREAM_SERVICE_1_URL,
+        ];
+        const log = logger ?? ts_log_1.dummyLogger;
+        const pool = new WebSocketPool(log);
         const numConnections = config.numConnections ?? DEFAULT_NUM_CONNECTIONS;
         for (let i = 0; i < numConnections; i++) {
-            const url = config.urls[i % config.urls.length];
+            const url = urls[i % urls.length];
             if (!url) {
                 throw new Error(`URLs must not be null or empty`);
             }
             const wsOptions = {
                 ...config.rwsConfig?.wsOptions,
                 headers: {
-                    Authorization: `Bearer ${config.token}`,
+                    Authorization: `Bearer ${token}`,
                 },
             };
             const rws = new resilient_websocket_js_1.ResilientWebSocket({
                 ...config.rwsConfig,
                 endpoint: url,
                 wsOptions,
-                logger,
+                logger: log,
             });
             // If a websocket client unexpectedly disconnects, ResilientWebSocket will reestablish
             // the connection and call the onReconnect callback.

package/dist/esm/client.d.ts

@@ -1,4 +1,5 @@
-import type { ParsedPayload, Request, Response } from "./protocol.js";
+import type { Logger } from "ts-log";
+import type { ParsedPayload, Request, Response, SymbolResponse, SymbolsQueryParams, LatestPriceRequest, PriceRequest, JsonUpdate } from "./protocol.js";
 import type { WebSocketPoolConfig } from "./socket/websocket-pool.js";
 export type BinaryResponse = {
     subscriptionId: number;
@@ -15,17 +16,31 @@ export type JsonOrBinaryResponse = {
     type: "binary";
     value: BinaryResponse;
 };
+export type LazerClientConfig = {
+    token: string;
+    metadataServiceUrl?: string;
+    priceServiceUrl?: string;
+    logger?: Logger;
+    webSocketPoolConfig?: WebSocketPoolConfig;
+};
 export declare class PythLazerClient {
-    private readonly wsp;
+    private readonly token;
+    private readonly metadataServiceUrl;
+    private readonly priceServiceUrl;
+    private readonly logger;
+    private readonly wsp?;
     private constructor();
+    /**
+     * Gets the WebSocket pool. If the WebSocket pool is not configured, an error is thrown.
+     * @throws Error if WebSocket pool is not configured
+     * @returns The WebSocket pool
+     */
+    private getWebSocketPool;
     /**
      * Creates a new PythLazerClient instance.
-     * @param urls - List of WebSocket URLs of the Pyth Lazer service
-     * @param token - The access token for authentication
-     * @param numConnections - The number of parallel WebSocket connections to establish (default: 3). A higher number gives a more reliable stream. The connections will round-robin across the provided URLs.
-     * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
+     * @param config - Configuration including token, metadata service URL, and price service URL, and WebSocket pool configuration
      */
-    static create(config: WebSocketPoolConfig): Promise<PythLazerClient>;
+    static create(config: LazerClientConfig): Promise<PythLazerClient>;
     /**
      * Adds a message listener that receives either JSON or binary responses from the WebSocket connections.
      * The listener will be called for each message received, with deduplication across redundant connections.
@@ -43,4 +58,29 @@ export declare class PythLazerClient {
      */
     addAllConnectionsDownListener(handler: () => void): void;
     shutdown(): void;
+    /**
+     * Private helper method to make authenticated HTTP requests with Bearer token
+     * @param url - The URL to fetch
+     * @param options - Additional fetch options
+     * @returns Promise resolving to the fetch Response
+     */
+    private authenticatedFetch;
+    /**
+     * Queries the symbols endpoint to get available price feed symbols.
+     * @param params - Optional query parameters to filter symbols
+     * @returns Promise resolving to array of symbol information
+     */
+    getSymbols(params?: SymbolsQueryParams): Promise<SymbolResponse[]>;
+    /**
+     * Queries the latest price endpoint to get current price data.
+     * @param params - Parameters for the latest price request
+     * @returns Promise resolving to JsonUpdate with current price data
+     */
+    getLatestPrice(params: LatestPriceRequest): Promise<JsonUpdate>;
+    /**
+     * Queries the price endpoint to get historical price data at a specific timestamp.
+     * @param params - Parameters for the price request including timestamp
+     * @returns Promise resolving to JsonUpdate with price data at the specified time
+     */
+    getPrice(params: PriceRequest): Promise<JsonUpdate>;
 }

package/dist/esm/client.js

@@ -1,24 +1,52 @@
+import fetch from "cross-fetch";
 import WebSocket from "isomorphic-ws";
+import { dummyLogger } from "ts-log";
+import { DEFAULT_METADATA_SERVICE_URL, DEFAULT_PRICE_SERVICE_URL, } from "./constants.js";
 import { BINARY_UPDATE_FORMAT_MAGIC_LE, FORMAT_MAGICS_LE } from "./protocol.js";
 import { WebSocketPool } from "./socket/websocket-pool.js";
 const UINT16_NUM_BYTES = 2;
 const UINT32_NUM_BYTES = 4;
 const UINT64_NUM_BYTES = 8;
 export class PythLazerClient {
+    token;
+    metadataServiceUrl;
+    priceServiceUrl;
+    logger;
     wsp;
-    constructor(wsp) {
+    constructor(token, metadataServiceUrl, priceServiceUrl, logger, wsp) {
+        this.token = token;
+        this.metadataServiceUrl = metadataServiceUrl;
+        this.priceServiceUrl = priceServiceUrl;
+        this.logger = logger;
         this.wsp = wsp;
     }
+    /**
+     * Gets the WebSocket pool. If the WebSocket pool is not configured, an error is thrown.
+     * @throws Error if WebSocket pool is not configured
+     * @returns The WebSocket pool
+     */
+    getWebSocketPool() {
+        if (!this.wsp) {
+            throw new Error("WebSocket pool is not available. Make sure to provide webSocketPoolConfig when creating the client.");
+        }
+        return this.wsp;
+    }
     /**
      * Creates a new PythLazerClient instance.
-     * @param urls - List of WebSocket URLs of the Pyth Lazer service
-     * @param token - The access token for authentication
-     * @param numConnections - The number of parallel WebSocket connections to establish (default: 3). A higher number gives a more reliable stream. The connections will round-robin across the provided URLs.
-     * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
+     * @param config - Configuration including token, metadata service URL, and price service URL, and WebSocket pool configuration
      */
     static async create(config) {
-        const wsp = await WebSocketPool.create(config);
-        return new PythLazerClient(wsp);
+        const token = config.token;
+        // Collect and remove trailing slash from URLs
+        const metadataServiceUrl = (config.metadataServiceUrl ?? DEFAULT_METADATA_SERVICE_URL).replace(/\/+$/, "");
+        const priceServiceUrl = (config.priceServiceUrl ?? DEFAULT_PRICE_SERVICE_URL).replace(/\/+$/, "");
+        const logger = config.logger ?? dummyLogger;
+        // If webSocketPoolConfig is provided, create a WebSocket pool and block until at least one connection is established.
+        let wsp;
+        if (config.webSocketPoolConfig) {
+            wsp = await WebSocketPool.create(config.webSocketPoolConfig, token, logger);
+        }
+        return new PythLazerClient(token, metadataServiceUrl, priceServiceUrl, logger, wsp);
     }
     /**
      * Adds a message listener that receives either JSON or binary responses from the WebSocket connections.
@@ -27,7 +55,8 @@ export class PythLazerClient {
      * or a binary response containing EVM, Solana, or parsed payload data.
      */
     addMessageListener(handler) {
-        this.wsp.addMessageListener((data) => {
+        const wsp = this.getWebSocketPool();
+        wsp.addMessageListener((data) => {
             if (typeof data == "string") {
                 handler({
                     type: "json",
@@ -79,16 +108,19 @@ export class PythLazerClient {
         });
     }
     subscribe(request) {
+        const wsp = this.getWebSocketPool();
         if (request.type !== "subscribe") {
             throw new Error("Request must be a subscribe request");
         }
-        this.wsp.addSubscription(request);
+        wsp.addSubscription(request);
     }
     unsubscribe(subscriptionId) {
-        this.wsp.removeSubscription(subscriptionId);
+        const wsp = this.getWebSocketPool();
+        wsp.removeSubscription(subscriptionId);
     }
     send(request) {
-        this.wsp.sendRequest(request);
+        const wsp = this.getWebSocketPool();
+        wsp.sendRequest(request);
     }
     /**
      * Registers a handler function that will be called whenever all WebSocket connections are down or attempting to reconnect.
@@ -96,9 +128,103 @@ export class PythLazerClient {
      * @param handler - Function to be called when all connections are down
      */
     addAllConnectionsDownListener(handler) {
-        this.wsp.addAllConnectionsDownListener(handler);
+        const wsp = this.getWebSocketPool();
+        wsp.addAllConnectionsDownListener(handler);
     }
     shutdown() {
-        this.wsp.shutdown();
+        const wsp = this.getWebSocketPool();
+        wsp.shutdown();
+    }
+    /**
+     * Private helper method to make authenticated HTTP requests with Bearer token
+     * @param url - The URL to fetch
+     * @param options - Additional fetch options
+     * @returns Promise resolving to the fetch Response
+     */
+    async authenticatedFetch(url, options = {}) {
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            ...options.headers,
+        };
+        return fetch(url, {
+            ...options,
+            headers,
+        });
+    }
+    /**
+     * Queries the symbols endpoint to get available price feed symbols.
+     * @param params - Optional query parameters to filter symbols
+     * @returns Promise resolving to array of symbol information
+     */
+    async getSymbols(params) {
+        const url = new URL(`${this.metadataServiceUrl}/v1/symbols`);
+        if (params?.query) {
+            url.searchParams.set("query", params.query);
+        }
+        if (params?.asset_type) {
+            url.searchParams.set("asset_type", params.asset_type);
+        }
+        try {
+            const response = await this.authenticatedFetch(url.toString());
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch symbols: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Queries the latest price endpoint to get current price data.
+     * @param params - Parameters for the latest price request
+     * @returns Promise resolving to JsonUpdate with current price data
+     */
+    async getLatestPrice(params) {
+        const url = `${this.priceServiceUrl}/v1/latest_price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("getLatestPrice", { url, body });
+            const response = await this.authenticatedFetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: body,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch latest price: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Queries the price endpoint to get historical price data at a specific timestamp.
+     * @param params - Parameters for the price request including timestamp
+     * @returns Promise resolving to JsonUpdate with price data at the specified time
+     */
+    async getPrice(params) {
+        const url = `${this.priceServiceUrl}/v1/price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("getPrice", { url, body });
+            const response = await this.authenticatedFetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: body,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${String(response.status)} - ${await response.text()}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch price: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
 }

package/dist/esm/constants.d.ts

@@ -1,2 +1,6 @@
 export declare const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export declare const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
+export declare const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export declare const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
+export declare const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
+export declare const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/esm/constants.js

@@ -1,2 +1,6 @@
 export const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
+export const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
+export const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
+export const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/esm/protocol.d.ts

@@ -37,6 +37,7 @@ export type JsonBinaryData = {
 };
 export type InvalidFeedSubscriptionDetails = {
     unknownIds: number[];
+    unknownSymbols: string[];
     unsupportedChannels: number[];
     unstable: number[];
 };
@@ -75,3 +76,49 @@ export declare const FORMAT_MAGICS_LE: {
     LE_ECDSA: number;
     LE_UNSIGNED: number;
 };
+export type AssetType = "crypto" | "fx" | "equity" | "metal" | "rates" | "nav" | "commodity" | "funding-rate";
+export type SymbolsQueryParams = {
+    query?: string;
+    asset_type?: AssetType;
+};
+export type SymbolResponse = {
+    pyth_lazer_id: number;
+    name: string;
+    symbol: string;
+    description: string;
+    asset_type: string;
+    exponent: number;
+    min_publishers: number;
+    min_channel: string;
+    state: string;
+    schedule: string;
+    cmc_id?: number | null;
+    hermes_id?: string | null;
+    interval?: string | null;
+};
+export type LatestPriceRequest = {
+    priceFeedIds?: number[];
+    symbols?: string[];
+    properties: PriceFeedProperty[];
+    formats: Format[];
+    jsonBinaryEncoding?: JsonBinaryEncoding;
+    parsed?: boolean;
+    channel: Channel;
+};
+export type PriceRequest = {
+    timestamp: number;
+    priceFeedIds?: number[];
+    symbols?: string[];
+    properties: PriceFeedProperty[];
+    formats: Format[];
+    jsonBinaryEncoding?: JsonBinaryEncoding;
+    parsed?: boolean;
+    channel: Channel;
+};
+export type JsonUpdate = {
+    parsed?: ParsedPayload;
+    evm?: JsonBinaryData;
+    solana?: JsonBinaryData;
+    leEcdsa?: JsonBinaryData;
+    leUnsigned?: JsonBinaryData;
+};

package/dist/esm/socket/websocket-pool.d.ts

@@ -5,10 +5,8 @@ import type { Request } from "../protocol.js";
 import type { ResilientWebSocketConfig } from "./resilient-websocket.js";
 import { ResilientWebSocket } from "./resilient-websocket.js";
 export type WebSocketPoolConfig = {
-    urls: string[];
-    token: string;
+    urls?: string[];
     numConnections?: number;
-    logger?: Logger;
     rwsConfig?: Omit<ResilientWebSocketConfig, "logger" | "endpoint">;
     onError?: (error: ErrorEvent) => void;
 };
@@ -30,7 +28,7 @@ export declare class WebSocketPool {
      * @param numConnections - Number of parallel WebSocket connections to maintain (default: 3)
      * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
      */
-    static create(config: WebSocketPoolConfig): Promise<WebSocketPool>;
+    static create(config: WebSocketPoolConfig, token: string, logger?: Logger): Promise<WebSocketPool>;
     /**
      * Checks for error responses in JSON messages and throws appropriate errors
      */

package/dist/esm/socket/websocket-pool.js

@@ -2,6 +2,7 @@ import TTLCache from "@isaacs/ttlcache";
 import WebSocket from "isomorphic-ws";
 import { dummyLogger } from "ts-log";
 import { ResilientWebSocket } from "./resilient-websocket.js";
+import { DEFAULT_STREAM_SERVICE_0_URL, DEFAULT_STREAM_SERVICE_1_URL, } from "../constants.js";
 const DEFAULT_NUM_CONNECTIONS = 4;
 export class WebSocketPool {
     logger;
@@ -32,29 +33,30 @@ export class WebSocketPool {
      * @param numConnections - Number of parallel WebSocket connections to maintain (default: 3)
      * @param logger - Optional logger to get socket level logs. Compatible with most loggers such as the built-in console and `bunyan`.
      */
-    static async create(config) {
-        if (config.urls.length === 0) {
-            throw new Error("No URLs provided");
-        }
-        const logger = config.logger ?? dummyLogger;
-        const pool = new WebSocketPool(logger);
+    static async create(config, token, logger) {
+        const urls = config.urls ?? [
+            DEFAULT_STREAM_SERVICE_0_URL,
+            DEFAULT_STREAM_SERVICE_1_URL,
+        ];
+        const log = logger ?? dummyLogger;
+        const pool = new WebSocketPool(log);
         const numConnections = config.numConnections ?? DEFAULT_NUM_CONNECTIONS;
         for (let i = 0; i < numConnections; i++) {
-            const url = config.urls[i % config.urls.length];
+            const url = urls[i % urls.length];
             if (!url) {
                 throw new Error(`URLs must not be null or empty`);
             }
             const wsOptions = {
                 ...config.rwsConfig?.wsOptions,
                 headers: {
-                    Authorization: `Bearer ${config.token}`,
+                    Authorization: `Bearer ${token}`,
                 },
             };
             const rws = new ResilientWebSocket({
                 ...config.rwsConfig,
                 endpoint: url,
                 wsOptions,
-                logger,
+                logger: log,
             });
             // If a websocket client unexpectedly disconnects, ResilientWebSocket will reestablish
             // the connection and call the onReconnect callback.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pythnetwork/pyth-lazer-sdk",
-  "version": "2.0.0",
+  "version": "4.0.0",
   "description": "Pyth Lazer SDK",
   "publishConfig": {
     "access": "public"
@@ -48,6 +48,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@isaacs/ttlcache": "^1.4.1",
+    "cross-fetch": "^4.0.0",
     "isomorphic-ws": "^5.0.0",
     "ts-log": "^2.2.7",
     "ws": "^8.18.0"
@@ -60,7 +61,9 @@
     "test:types": "tsc",
     "test:format": "prettier --check .",
     "fix:format": "prettier --write .",
-    "example": "node --loader ts-node/esm examples/index.js",
+    "example:streaming": "node --loader ts-node/esm examples/streaming.js",
+    "example:history": "node --loader ts-node/esm examples/history.js",
+    "example:symbols": "node --loader ts-node/esm examples/symbols.js",
     "doc": "typedoc --out docs/typedoc src"
   }
 }