@pythnetwork/pyth-lazer-sdk 1.0.0 → 3.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
+     */
+    get_symbols(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
+     */
+    get_latest_price(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
+     */
+    get_price(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 get_symbols(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 get_latest_price(params) {
+        const url = `${this.priceServiceUrl}/v1/latest_price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("get_latest_price", { 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 get_price(params) {
+        const url = `${this.priceServiceUrl}/v1/price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("get_price", { 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,3 +1,6 @@
-import { PublicKey } from "@solana/web3.js";
-export declare const SOLANA_LAZER_PROGRAM_ID: PublicKey;
-export declare const SOLANA_STORAGE_ID: PublicKey;
+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,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOLANA_STORAGE_ID = exports.SOLANA_LAZER_PROGRAM_ID = void 0;
-const web3_js_1 = require("@solana/web3.js");
-exports.SOLANA_LAZER_PROGRAM_ID = new web3_js_1.PublicKey("pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt");
-exports.SOLANA_STORAGE_ID = new web3_js_1.PublicKey("3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL");
+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/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./client.js";
 export * from "./protocol.js";
-export * from "./ed25519.js";
 export * from "./constants.js";

package/dist/cjs/index.js

@@ -16,5 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client.js"), exports);
 __exportStar(require("./protocol.js"), exports);
-__exportStar(require("./ed25519.js"), exports);
 __exportStar(require("./constants.js"), exports);

package/dist/cjs/protocol.d.ts

@@ -75,3 +75,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
+     */
+    get_symbols(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
+     */
+    get_latest_price(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
+     */
+    get_price(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 get_symbols(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 get_latest_price(params) {
+        const url = `${this.priceServiceUrl}/v1/latest_price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("get_latest_price", { 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 get_price(params) {
+        const url = `${this.priceServiceUrl}/v1/price`;
+        try {
+            const body = JSON.stringify(params);
+            this.logger.debug("get_price", { 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,3 +1,6 @@
-import { PublicKey } from "@solana/web3.js";
-export declare const SOLANA_LAZER_PROGRAM_ID: PublicKey;
-export declare const SOLANA_STORAGE_ID: PublicKey;
+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,3 +1,6 @@
-import { PublicKey } from "@solana/web3.js";
-export const SOLANA_LAZER_PROGRAM_ID = new PublicKey("pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt");
-export const SOLANA_STORAGE_ID = new PublicKey("3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL");
+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/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./client.js";
 export * from "./protocol.js";
-export * from "./ed25519.js";
 export * from "./constants.js";

package/dist/esm/index.js

@@ -1,4 +1,3 @@
 export * from "./client.js";
 export * from "./protocol.js";
-export * from "./ed25519.js";
 export * from "./constants.js";

package/dist/esm/protocol.d.ts

@@ -75,3 +75,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": "1.0.0",
+  "version": "3.0.0",
   "description": "Pyth Lazer SDK",
   "publishConfig": {
     "access": "public"
@@ -48,8 +48,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@isaacs/ttlcache": "^1.4.1",
-    "@solana/buffer-layout": "^4.0.1",
-    "@solana/web3.js": "^1.98.0",
+    "cross-fetch": "^4.0.0",
     "isomorphic-ws": "^5.0.0",
     "ts-log": "^2.2.7",
     "ws": "^8.18.0"
@@ -62,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"
   }
 }

package/dist/cjs/ed25519.d.ts

@@ -1,2 +0,0 @@
-import { TransactionInstruction } from "@solana/web3.js";
-export declare const createEd25519Instruction: (message: Buffer, instructionIndex: number, startingOffset: number) => TransactionInstruction;

package/dist/cjs/ed25519.js

@@ -1,79 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEd25519Instruction = void 0;
-const BufferLayout = __importStar(require("@solana/buffer-layout"));
-const web3_js_1 = require("@solana/web3.js");
-const ED25519_INSTRUCTION_LEN = 16;
-const SIGNATURE_LEN = 64;
-const PUBKEY_LEN = 32;
-const MAGIC_LEN = 4;
-const MESSAGE_SIZE_LEN = 2;
-const ED25519_INSTRUCTION_LAYOUT = BufferLayout.struct([
-    BufferLayout.u8("numSignatures"),
-    BufferLayout.u8("padding"),
-    BufferLayout.u16("signatureOffset"),
-    BufferLayout.u16("signatureInstructionIndex"),
-    BufferLayout.u16("publicKeyOffset"),
-    BufferLayout.u16("publicKeyInstructionIndex"),
-    BufferLayout.u16("messageDataOffset"),
-    BufferLayout.u16("messageDataSize"),
-    BufferLayout.u16("messageInstructionIndex"),
-]);
-const createEd25519Instruction = (message, instructionIndex, startingOffset) => {
-    const signatureOffset = startingOffset + MAGIC_LEN;
-    const publicKeyOffset = signatureOffset + SIGNATURE_LEN;
-    const messageDataSizeOffset = publicKeyOffset + PUBKEY_LEN;
-    const messageDataOffset = messageDataSizeOffset + MESSAGE_SIZE_LEN;
-    const messageDataSize = message.readUInt16LE(messageDataSizeOffset - startingOffset);
-    const instructionData = Buffer.alloc(ED25519_INSTRUCTION_LEN);
-    ED25519_INSTRUCTION_LAYOUT.encode({
-        numSignatures: 1,
-        padding: 0,
-        signatureOffset,
-        signatureInstructionIndex: instructionIndex,
-        publicKeyOffset,
-        publicKeyInstructionIndex: instructionIndex,
-        messageDataOffset,
-        messageDataSize: messageDataSize,
-        messageInstructionIndex: instructionIndex,
-    }, instructionData);
-    return new web3_js_1.TransactionInstruction({
-        keys: [],
-        programId: web3_js_1.Ed25519Program.programId,
-        data: instructionData,
-    });
-};
-exports.createEd25519Instruction = createEd25519Instruction;

package/dist/esm/ed25519.d.ts

@@ -1,2 +0,0 @@
-import { TransactionInstruction } from "@solana/web3.js";
-export declare const createEd25519Instruction: (message: Buffer, instructionIndex: number, startingOffset: number) => TransactionInstruction;

package/dist/esm/ed25519.js

@@ -1,42 +0,0 @@
-import * as BufferLayout from "@solana/buffer-layout";
-import { Ed25519Program, TransactionInstruction } from "@solana/web3.js";
-const ED25519_INSTRUCTION_LEN = 16;
-const SIGNATURE_LEN = 64;
-const PUBKEY_LEN = 32;
-const MAGIC_LEN = 4;
-const MESSAGE_SIZE_LEN = 2;
-const ED25519_INSTRUCTION_LAYOUT = BufferLayout.struct([
-    BufferLayout.u8("numSignatures"),
-    BufferLayout.u8("padding"),
-    BufferLayout.u16("signatureOffset"),
-    BufferLayout.u16("signatureInstructionIndex"),
-    BufferLayout.u16("publicKeyOffset"),
-    BufferLayout.u16("publicKeyInstructionIndex"),
-    BufferLayout.u16("messageDataOffset"),
-    BufferLayout.u16("messageDataSize"),
-    BufferLayout.u16("messageInstructionIndex"),
-]);
-export const createEd25519Instruction = (message, instructionIndex, startingOffset) => {
-    const signatureOffset = startingOffset + MAGIC_LEN;
-    const publicKeyOffset = signatureOffset + SIGNATURE_LEN;
-    const messageDataSizeOffset = publicKeyOffset + PUBKEY_LEN;
-    const messageDataOffset = messageDataSizeOffset + MESSAGE_SIZE_LEN;
-    const messageDataSize = message.readUInt16LE(messageDataSizeOffset - startingOffset);
-    const instructionData = Buffer.alloc(ED25519_INSTRUCTION_LEN);
-    ED25519_INSTRUCTION_LAYOUT.encode({
-        numSignatures: 1,
-        padding: 0,
-        signatureOffset,
-        signatureInstructionIndex: instructionIndex,
-        publicKeyOffset,
-        publicKeyInstructionIndex: instructionIndex,
-        messageDataOffset,
-        messageDataSize: messageDataSize,
-        messageInstructionIndex: instructionIndex,
-    }, instructionData);
-    return new TransactionInstruction({
-        keys: [],
-        programId: Ed25519Program.programId,
-        data: instructionData,
-    });
-};