@zofai/zo-sdk 0.2.14 → 0.2.16

package/dist/pythProClient.cjs

@@ -0,0 +1,277 @@
+"use strict";
+/** Kronos Pyth Pro (Pyth Lazer) REST + WebSocket client. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythProStreamClient = void 0;
+exports.hexToBytes = hexToBytes;
+exports.apiBaseUrlToPythProWsUrl = apiBaseUrlToPythProWsUrl;
+exports.getLatestPythProPrices = getLatestPythProPrices;
+exports.fetchPythProUpdateBytesFromKronos = fetchPythProUpdateBytesFromKronos;
+function hexToBytes(hex) {
+    const normalized = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(normalized.length / 2);
+    for (let i = 0; i < normalized.length; i += 2) {
+        bytes[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+/** Derive ws(s):// stream URL from kronos http(s) base URL. */
+function apiBaseUrlToPythProWsUrl(baseUrl) {
+    const url = new URL(baseUrl);
+    url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+    url.pathname = '/pyth-pro/stream';
+    url.search = '';
+    url.hash = '';
+    return url.toString();
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, '');
+}
+function parseLatestPriceResponse(json) {
+    if (!json.success || !json.data) {
+        throw new Error(json.message ?? 'Pyth Pro latest-price request failed');
+    }
+    return json.data;
+}
+/**
+ * Fetch latest Pyth Pro prices from kronos REST (`GET` or `POST /pyth-pro/latest-price`).
+ */
+async function getLatestPythProPrices(baseUrl, options) {
+    const { priceFeedIds, channel, includeEmaPrice, includeUpdateBytes } = options;
+    if (priceFeedIds.length === 0) {
+        throw new Error('priceFeedIds is required');
+    }
+    const root = normalizeBaseUrl(baseUrl);
+    if (priceFeedIds.length <= 20) {
+        const params = new URLSearchParams();
+        params.set('priceFeedIds', priceFeedIds.join(','));
+        if (channel) {
+            params.set('channel', channel);
+        }
+        if (includeEmaPrice) {
+            params.set('includeEmaPrice', 'true');
+        }
+        if (includeUpdateBytes) {
+            params.set('includeUpdateBytes', 'true');
+        }
+        const res = await fetch(`${root}/pyth-pro/latest-price?${params}`);
+        const json = await res.json();
+        if (!res.ok && json.message) {
+            throw new Error(json.message);
+        }
+        return parseLatestPriceResponse(json);
+    }
+    const res = await fetch(`${root}/pyth-pro/latest-price`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            priceFeedIds,
+            channel,
+            includeEmaPrice: includeEmaPrice ?? false,
+            includeUpdateBytes: includeUpdateBytes ?? false,
+        }),
+    });
+    const json = await res.json();
+    if (!res.ok && json.message) {
+        throw new Error(json.message);
+    }
+    return parseLatestPriceResponse(json);
+}
+/**
+ * Fetch leEcdsa update bytes via kronos (for on-chain `parse_and_verify_le_ecdsa_update_v2`).
+ */
+async function fetchPythProUpdateBytesFromKronos(baseUrl, feedIds, options) {
+    const data = await getLatestPythProPrices(baseUrl, {
+        priceFeedIds: feedIds,
+        channel: options?.channel,
+        includeEmaPrice: options?.includeEmaPrice,
+        includeUpdateBytes: true,
+    });
+    if (!data.leEcdsaHex) {
+        throw new Error('No leEcdsaHex in kronos Pyth Pro response (set includeUpdateBytes: true)');
+    }
+    return hexToBytes(data.leEcdsaHex);
+}
+/**
+ * WebSocket client for kronos `/pyth-pro/stream`.
+ * Multiplexes subscriptions and re-subscribes after reconnect.
+ */
+class PythProStreamClient {
+    constructor(baseUrl, options) {
+        this.ws = null;
+        this.connectPromise = null;
+        this.reconnectTimer = null;
+        this.pingTimer = null;
+        this.closedByUser = false;
+        this.subscriptions = new Map();
+        this.updateHandlers = new Map();
+        this.messageHandlers = new Set();
+        this.wsUrl = options?.wsUrl ?? apiBaseUrlToPythProWsUrl(baseUrl);
+        this.autoReconnect = options?.autoReconnect ?? true;
+        this.reconnectDelayMs = options?.reconnectDelayMs ?? 1000;
+        this.pingIntervalMs = options?.pingIntervalMs ?? 30000;
+        this.WebSocketImpl = options?.WebSocketImpl ?? WebSocket;
+    }
+    /** Open the WebSocket and wait for the server `connected` message (or socket open). */
+    connect() {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            return Promise.resolve();
+        }
+        if (this.connectPromise) {
+            return this.connectPromise;
+        }
+        this.closedByUser = false;
+        this.connectPromise = new Promise((resolve, reject) => {
+            const ws = new this.WebSocketImpl(this.wsUrl);
+            this.ws = ws;
+            const onOpen = () => {
+                this.startPing();
+                this.resubscribeAll();
+                resolve();
+            };
+            const onError = (event) => {
+                if (ws.readyState !== WebSocket.OPEN) {
+                    reject(new Error(`Pyth Pro WebSocket connection failed: ${this.wsUrl}`));
+                }
+                this.emitMessage({ type: 'error', message: String(event) });
+            };
+            ws.addEventListener('open', onOpen, { once: true });
+            ws.addEventListener('error', onError, { once: true });
+            ws.addEventListener('message', (event) => {
+                this.handleMessage(String(event.data));
+            });
+            ws.addEventListener('close', () => {
+                this.stopPing();
+                this.ws = null;
+                this.connectPromise = null;
+                if (!this.closedByUser && this.autoReconnect) {
+                    this.scheduleReconnect();
+                }
+            });
+        });
+        return this.connectPromise;
+    }
+    disconnect() {
+        this.closedByUser = true;
+        this.clearReconnect();
+        this.stopPing();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connectPromise = null;
+    }
+    /**
+     * Subscribe to live price updates. Returns an unsubscribe function.
+     * `onUpdate` is called for each `streamUpdated` matching `subscriptionId`.
+     */
+    subscribe(options, onUpdate) {
+        this.subscriptions.set(options.subscriptionId, options);
+        let handlers = this.updateHandlers.get(options.subscriptionId);
+        if (!handlers) {
+            handlers = new Set();
+            this.updateHandlers.set(options.subscriptionId, handlers);
+        }
+        handlers.add(onUpdate);
+        void this.connect().then(() => {
+            this.send({ type: 'subscribe', ...options });
+        });
+        return () => {
+            this.unsubscribe(options.subscriptionId, onUpdate);
+        };
+    }
+    /** Remove one handler or the whole subscription when `onUpdate` is omitted. */
+    unsubscribe(subscriptionId, onUpdate) {
+        const handlers = this.updateHandlers.get(subscriptionId);
+        if (onUpdate && handlers) {
+            handlers.delete(onUpdate);
+            if (handlers.size > 0) {
+                return;
+            }
+        }
+        this.updateHandlers.delete(subscriptionId);
+        this.subscriptions.delete(subscriptionId);
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.send({ type: 'unsubscribe', subscriptionId });
+        }
+    }
+    onMessage(handler) {
+        this.messageHandlers.add(handler);
+        return () => {
+            this.messageHandlers.delete(handler);
+        };
+    }
+    send(message) {
+        if (this.ws?.readyState !== WebSocket.OPEN) {
+            return;
+        }
+        this.ws.send(JSON.stringify(message));
+    }
+    resubscribeAll() {
+        for (const sub of this.subscriptions.values()) {
+            this.send({ type: 'subscribe', ...sub });
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer) {
+            return;
+        }
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.connect().catch(() => {
+                this.scheduleReconnect();
+            });
+        }, this.reconnectDelayMs);
+    }
+    clearReconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    startPing() {
+        if (this.pingIntervalMs <= 0) {
+            return;
+        }
+        this.stopPing();
+        this.pingTimer = setInterval(() => {
+            this.send({ type: 'ping' });
+        }, this.pingIntervalMs);
+    }
+    stopPing() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+    }
+    emitMessage(message) {
+        for (const handler of this.messageHandlers) {
+            handler(message);
+        }
+    }
+    handleMessage(raw) {
+        let message;
+        try {
+            message = JSON.parse(raw);
+        }
+        catch {
+            this.emitMessage({ type: 'error', message: `Invalid JSON: ${raw}` });
+            return;
+        }
+        this.emitMessage(message);
+        if (message.type === 'streamUpdated') {
+            const handlers = this.updateHandlers.get(message.subscriptionId);
+            if (handlers) {
+                for (const handler of handlers) {
+                    handler({
+                        subscriptionId: message.subscriptionId,
+                        timestampUs: message.timestampUs,
+                        priceFeeds: message.priceFeeds,
+                        leEcdsaHex: message.leEcdsaHex,
+                    });
+                }
+            }
+        }
+    }
+}
+exports.PythProStreamClient = PythProStreamClient;
+//# sourceMappingURL=pythProClient.cjs.map

package/dist/pythProClient.cjs.map

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

package/dist/pythProClient.d.cts

@@ -0,0 +1,143 @@
+/** Kronos Pyth Pro (Pyth Lazer) REST + WebSocket client. */
+export type PythProChannel = 'real_time' | 'fixed_rate@50ms' | 'fixed_rate@200ms' | 'fixed_rate@1000ms';
+export interface PythProPriceFeed {
+    priceFeedId: number;
+    price: string;
+    exponent: number;
+    confidence: string;
+    feedUpdateTimestamp: string;
+    priceUsd: number;
+    emaPrice?: string | null;
+    emaPriceUsd?: number | null;
+}
+export interface PythProLatestPriceData {
+    timestampUs: string;
+    priceFeeds: PythProPriceFeed[];
+    leEcdsaHex: string | null;
+}
+export interface PythProLatestPriceResponse {
+    success: boolean;
+    timestamp?: string;
+    data?: PythProLatestPriceData;
+    message?: string;
+}
+export interface IGetLatestPythProPricesOptions {
+    priceFeedIds: number[];
+    channel?: PythProChannel;
+    includeEmaPrice?: boolean;
+    includeUpdateBytes?: boolean;
+    /** Override kronos REST base URL (default: `DEFAULT_API_ENDPOINT` or SDK instance apiEndpoint). */
+    kronosUrl?: string;
+}
+export interface PythProStreamUpdate {
+    subscriptionId: number;
+    timestampUs: string;
+    priceFeeds: PythProPriceFeed[];
+    leEcdsaHex?: string | null;
+}
+export interface IPythProStreamSubscription {
+    subscriptionId: number;
+    priceFeedIds: number[];
+    channel?: PythProChannel;
+    includeEmaPrice?: boolean;
+    includeUpdateBytes?: boolean;
+}
+export type PythProStreamServerMessage = {
+    type: 'connected';
+    message?: string;
+} | {
+    type: 'subscribed';
+    subscriptionId: number;
+} | {
+    type: 'unsubscribed';
+    subscriptionId: number;
+} | {
+    type: 'streamUpdated';
+} & PythProStreamUpdate | {
+    type: 'subscriptionError';
+    subscriptionId: number;
+    message?: string;
+} | {
+    type: 'subscribedWithInvalidFeedIdsIgnored';
+    subscriptionId: number;
+    ignoredFeedIds?: number[];
+} | {
+    type: 'error';
+    message?: string;
+} | {
+    type: 'pong';
+};
+export type PythProStreamClientMessage = {
+    type: 'subscribe';
+} & IPythProStreamSubscription | {
+    type: 'unsubscribe';
+    subscriptionId: number;
+} | {
+    type: 'ping';
+};
+export declare function hexToBytes(hex: string): Uint8Array;
+/** Derive ws(s):// stream URL from kronos http(s) base URL. */
+export declare function apiBaseUrlToPythProWsUrl(baseUrl: string): string;
+/**
+ * Fetch latest Pyth Pro prices from kronos REST (`GET` or `POST /pyth-pro/latest-price`).
+ */
+export declare function getLatestPythProPrices(baseUrl: string, options: IGetLatestPythProPricesOptions): Promise<PythProLatestPriceData>;
+/**
+ * Fetch leEcdsa update bytes via kronos (for on-chain `parse_and_verify_le_ecdsa_update_v2`).
+ */
+export declare function fetchPythProUpdateBytesFromKronos(baseUrl: string, feedIds: number[], options?: Pick<IGetLatestPythProPricesOptions, 'channel' | 'includeEmaPrice'>): Promise<Uint8Array>;
+export interface IPythProStreamClientOptions {
+    /** Defaults to apiBaseUrlToPythProWsUrl(baseUrl). */
+    wsUrl?: string;
+    /** Reconnect after disconnect. Default true. */
+    autoReconnect?: boolean;
+    /** Initial reconnect delay in ms. Default 1000. */
+    reconnectDelayMs?: number;
+    /** Ping interval in ms. Default 30000. Set 0 to disable. */
+    pingIntervalMs?: number;
+    /** Custom WebSocket constructor (Node test mocks, etc.). */
+    WebSocketImpl?: typeof WebSocket;
+}
+type StreamUpdateHandler = (update: PythProStreamUpdate) => void;
+type StreamMessageHandler = (message: PythProStreamServerMessage) => void;
+/**
+ * WebSocket client for kronos `/pyth-pro/stream`.
+ * Multiplexes subscriptions and re-subscribes after reconnect.
+ */
+export declare class PythProStreamClient {
+    private readonly wsUrl;
+    private readonly autoReconnect;
+    private readonly reconnectDelayMs;
+    private readonly pingIntervalMs;
+    private readonly WebSocketImpl;
+    private ws;
+    private connectPromise;
+    private reconnectTimer;
+    private pingTimer;
+    private closedByUser;
+    private readonly subscriptions;
+    private readonly updateHandlers;
+    private readonly messageHandlers;
+    constructor(baseUrl: string, options?: IPythProStreamClientOptions);
+    /** Open the WebSocket and wait for the server `connected` message (or socket open). */
+    connect(): Promise<void>;
+    disconnect(): void;
+    /**
+     * Subscribe to live price updates. Returns an unsubscribe function.
+     * `onUpdate` is called for each `streamUpdated` matching `subscriptionId`.
+     */
+    subscribe(options: IPythProStreamSubscription, onUpdate: StreamUpdateHandler): () => void;
+    /** Remove one handler or the whole subscription when `onUpdate` is omitted. */
+    unsubscribe(subscriptionId: number, onUpdate?: StreamUpdateHandler): void;
+    onMessage(handler: StreamMessageHandler): () => void;
+    private send;
+    private resubscribeAll;
+    private scheduleReconnect;
+    private clearReconnect;
+    private startPing;
+    private stopPing;
+    private emitMessage;
+    private handleMessage;
+}
+export {};
+//# sourceMappingURL=pythProClient.d.cts.map

package/dist/pythProClient.d.cts.map

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

package/dist/pythProClient.d.mts

@@ -0,0 +1,143 @@
+/** Kronos Pyth Pro (Pyth Lazer) REST + WebSocket client. */
+export type PythProChannel = 'real_time' | 'fixed_rate@50ms' | 'fixed_rate@200ms' | 'fixed_rate@1000ms';
+export interface PythProPriceFeed {
+    priceFeedId: number;
+    price: string;
+    exponent: number;
+    confidence: string;
+    feedUpdateTimestamp: string;
+    priceUsd: number;
+    emaPrice?: string | null;
+    emaPriceUsd?: number | null;
+}
+export interface PythProLatestPriceData {
+    timestampUs: string;
+    priceFeeds: PythProPriceFeed[];
+    leEcdsaHex: string | null;
+}
+export interface PythProLatestPriceResponse {
+    success: boolean;
+    timestamp?: string;
+    data?: PythProLatestPriceData;
+    message?: string;
+}
+export interface IGetLatestPythProPricesOptions {
+    priceFeedIds: number[];
+    channel?: PythProChannel;
+    includeEmaPrice?: boolean;
+    includeUpdateBytes?: boolean;
+    /** Override kronos REST base URL (default: `DEFAULT_API_ENDPOINT` or SDK instance apiEndpoint). */
+    kronosUrl?: string;
+}
+export interface PythProStreamUpdate {
+    subscriptionId: number;
+    timestampUs: string;
+    priceFeeds: PythProPriceFeed[];
+    leEcdsaHex?: string | null;
+}
+export interface IPythProStreamSubscription {
+    subscriptionId: number;
+    priceFeedIds: number[];
+    channel?: PythProChannel;
+    includeEmaPrice?: boolean;
+    includeUpdateBytes?: boolean;
+}
+export type PythProStreamServerMessage = {
+    type: 'connected';
+    message?: string;
+} | {
+    type: 'subscribed';
+    subscriptionId: number;
+} | {
+    type: 'unsubscribed';
+    subscriptionId: number;
+} | {
+    type: 'streamUpdated';
+} & PythProStreamUpdate | {
+    type: 'subscriptionError';
+    subscriptionId: number;
+    message?: string;
+} | {
+    type: 'subscribedWithInvalidFeedIdsIgnored';
+    subscriptionId: number;
+    ignoredFeedIds?: number[];
+} | {
+    type: 'error';
+    message?: string;
+} | {
+    type: 'pong';
+};
+export type PythProStreamClientMessage = {
+    type: 'subscribe';
+} & IPythProStreamSubscription | {
+    type: 'unsubscribe';
+    subscriptionId: number;
+} | {
+    type: 'ping';
+};
+export declare function hexToBytes(hex: string): Uint8Array;
+/** Derive ws(s):// stream URL from kronos http(s) base URL. */
+export declare function apiBaseUrlToPythProWsUrl(baseUrl: string): string;
+/**
+ * Fetch latest Pyth Pro prices from kronos REST (`GET` or `POST /pyth-pro/latest-price`).
+ */
+export declare function getLatestPythProPrices(baseUrl: string, options: IGetLatestPythProPricesOptions): Promise<PythProLatestPriceData>;
+/**
+ * Fetch leEcdsa update bytes via kronos (for on-chain `parse_and_verify_le_ecdsa_update_v2`).
+ */
+export declare function fetchPythProUpdateBytesFromKronos(baseUrl: string, feedIds: number[], options?: Pick<IGetLatestPythProPricesOptions, 'channel' | 'includeEmaPrice'>): Promise<Uint8Array>;
+export interface IPythProStreamClientOptions {
+    /** Defaults to apiBaseUrlToPythProWsUrl(baseUrl). */
+    wsUrl?: string;
+    /** Reconnect after disconnect. Default true. */
+    autoReconnect?: boolean;
+    /** Initial reconnect delay in ms. Default 1000. */
+    reconnectDelayMs?: number;
+    /** Ping interval in ms. Default 30000. Set 0 to disable. */
+    pingIntervalMs?: number;
+    /** Custom WebSocket constructor (Node test mocks, etc.). */
+    WebSocketImpl?: typeof WebSocket;
+}
+type StreamUpdateHandler = (update: PythProStreamUpdate) => void;
+type StreamMessageHandler = (message: PythProStreamServerMessage) => void;
+/**
+ * WebSocket client for kronos `/pyth-pro/stream`.
+ * Multiplexes subscriptions and re-subscribes after reconnect.
+ */
+export declare class PythProStreamClient {
+    private readonly wsUrl;
+    private readonly autoReconnect;
+    private readonly reconnectDelayMs;
+    private readonly pingIntervalMs;
+    private readonly WebSocketImpl;
+    private ws;
+    private connectPromise;
+    private reconnectTimer;
+    private pingTimer;
+    private closedByUser;
+    private readonly subscriptions;
+    private readonly updateHandlers;
+    private readonly messageHandlers;
+    constructor(baseUrl: string, options?: IPythProStreamClientOptions);
+    /** Open the WebSocket and wait for the server `connected` message (or socket open). */
+    connect(): Promise<void>;
+    disconnect(): void;
+    /**
+     * Subscribe to live price updates. Returns an unsubscribe function.
+     * `onUpdate` is called for each `streamUpdated` matching `subscriptionId`.
+     */
+    subscribe(options: IPythProStreamSubscription, onUpdate: StreamUpdateHandler): () => void;
+    /** Remove one handler or the whole subscription when `onUpdate` is omitted. */
+    unsubscribe(subscriptionId: number, onUpdate?: StreamUpdateHandler): void;
+    onMessage(handler: StreamMessageHandler): () => void;
+    private send;
+    private resubscribeAll;
+    private scheduleReconnect;
+    private clearReconnect;
+    private startPing;
+    private stopPing;
+    private emitMessage;
+    private handleMessage;
+}
+export {};
+//# sourceMappingURL=pythProClient.d.mts.map

package/dist/pythProClient.d.mts.map

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