@zofai/zo-sdk 0.2.14 → 0.2.15

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":"AAAA,4DAA4D;AAE5D,MAAM,MAAM,cAAc,GACpB,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CAAA;AAEzB,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,MAAM,0BAA0B,GAChC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG,mBAAmB,GAC/C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,qCAAqC,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtB,MAAM,MAAM,0BAA0B,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,0BAA0B,GAClD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAOlD;AAED,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhE;AAaD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CA4CjC;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,8BAA8B,EAAE,SAAS,GAAG,iBAAiB,CAAC,GAC5E,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,SAAS,CAAA;CACjC;AAED,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;AAChE,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,CAAA;AAEzE;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAEhD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8C;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;gBAEtD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,2BAA2B;IAQlE,uFAAuF;IACvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CxB,UAAU,IAAI,IAAI;IAWlB;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE,0BAA0B,EACnC,QAAQ,EAAE,mBAAmB,GAC5B,MAAM,IAAI;IAmBb,+EAA+E;IAC/E,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAgBzE,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAOpD,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;CA0BtB"}

package/dist/pythProClient.mjs

@@ -0,0 +1,269 @@
+/** Kronos Pyth Pro (Pyth Lazer) REST + WebSocket client. */
+export 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. */
+export 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`).
+ */
+export 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`).
+ */
+export 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.
+ */
+export 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,
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=pythProClient.mjs.map

package/dist/pythProClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythProClient.mjs","sourceRoot":"","sources":["../src/pythProClient.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAuE5D,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC5D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IACzD,GAAG,CAAC,QAAQ,GAAG,kBAAkB,CAAA;IACjC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAA;IACf,GAAG,CAAC,IAAI,GAAG,EAAE,CAAA;IACb,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAgC;IAChE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,sCAAsC,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,OAAuC;IAEvC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAA;IAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEtC,IAAI,YAAY,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAChC,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,kBAAkB,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,0BAA0B,MAAM,EAAE,CAAC,CAAA;QAClE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAgC,CAAA;QAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,wBAAwB,EAAE;QACvD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,YAAY;YACZ,OAAO;YACP,eAAe,EAAE,eAAe,IAAI,KAAK;YACzC,kBAAkB,EAAE,kBAAkB,IAAI,KAAK;SAChD,CAAC;KACH,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAgC,CAAA;IAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,OAAe,EACf,OAAiB,EACjB,OAA6E;IAE7E,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE;QACjD,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,eAAe,EAAE,OAAO,EAAE,eAAe;QACzC,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAA;IACF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAA;IAC7F,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;AACpC,CAAC;AAkBD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAiB9B,YAAY,OAAe,EAAE,OAAqC;QAV1D,OAAE,GAAqB,IAAI,CAAA;QAC3B,mBAAc,GAAyB,IAAI,CAAA;QAC3C,mBAAc,GAAyC,IAAI,CAAA;QAC3D,cAAS,GAA0C,IAAI,CAAA;QACvD,iBAAY,GAAG,KAAK,CAAA;QAEX,kBAAa,GAAG,IAAI,GAAG,EAAsC,CAAA;QAC7D,mBAAc,GAAG,IAAI,GAAG,EAAoC,CAAA;QAC5D,oBAAe,GAAG,IAAI,GAAG,EAAwB,CAAA;QAGhE,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAA;QAChE,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAA;QACnD,IAAI,CAAC,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,IAAI,CAAA;QACzD,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAM,CAAA;QACvD,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,SAAS,CAAA;IAC1D,CAAC;IAED,uFAAuF;IACvF,OAAO;QACL,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAA;QAC5B,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC7C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;YAEZ,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,CAAC,SAAS,EAAE,CAAA;gBAChB,IAAI,CAAC,cAAc,EAAE,CAAA;gBACrB,OAAO,EAAE,CAAA;YACX,CAAC,CAAA;YAED,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC/B,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBAC1E,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC7D,CAAC,CAAA;YAED,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACnD,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACrD,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YACxC,CAAC,CAAC,CAAA;YACF,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAChC,IAAI,CAAC,QAAQ,EAAE,CAAA;gBACf,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;gBACd,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;gBAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBAC7C,IAAI,CAAC,iBAAiB,EAAE,CAAA;gBAC1B,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QACxB,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,IAAI,CAAC,QAAQ,EAAE,CAAA;QACf,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YACf,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;QAChB,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,SAAS,CACP,OAAmC,EACnC,QAA6B;QAE7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QAEvD,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;YACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;QAC3D,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEtB,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAA;IACH,CAAC;IAED,+EAA+E;IAC/E,WAAW,CAAC,cAAsB,EAAE,QAA8B;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACxD,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YACzB,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QACzC,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAA6B;QACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC,CAAA;IACH,CAAC;IAEO,IAAI,CAAC,OAAmC;QAC9C,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAM;QACR,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACvC,CAAC;IAEO,cAAc;QACpB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;YAC1B,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAA;YAC1B,CAAC,CAAC,CAAA;QACJ,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC3B,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YACjC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAM;QACR,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAA;QACf,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7B,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IACzB,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACvB,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAmC;QACrD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,OAAO,CAAC,OAAO,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,GAAW;QAC/B,IAAI,OAAmC,CAAA;QACvC,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAA;QACzD,CAAC;QACD,MAAM,CAAC;YACL,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,EAAE,EAAE,CAAC,CAAA;YACpE,OAAM;QACR,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAEzB,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;YAChE,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,OAAO,CAAC;wBACN,cAAc,EAAE,OAAO,CAAC,cAAc;wBACtC,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,UAAU,EAAE,OAAO,CAAC,UAAU;wBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;qBAC/B,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/storkClient.cjs

@@ -0,0 +1,217 @@
+"use strict";
+/** Kronos Stork price REST client + update payload parsing. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexToBytes = hexToBytes;
+exports.base64ToBytes = base64ToBytes;
+exports.parseStorkUpdateDataRaw = parseStorkUpdateDataRaw;
+exports.buildStorkUpdateDataFromSignedPrice = buildStorkUpdateDataFromSignedPrice;
+exports.parseStorkUpdateDataList = parseStorkUpdateDataList;
+exports.getLatestStorkPrices = getLatestStorkPrices;
+exports.fetchStorkUpdateDataFromKronos = fetchStorkUpdateDataFromKronos;
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, '');
+}
+function parseLatestStorkResponse(json) {
+    if (!json.success || !json.data) {
+        throw new Error(json.message ?? 'Stork latest-price request failed');
+    }
+    return json.data;
+}
+function hexToBytes(hex) {
+    const normalized = hex.startsWith('0x') ? hex.slice(2) : hex;
+    if (normalized.length % 2 !== 0) {
+        throw new Error(`Invalid hex length: ${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;
+}
+function base64ToBytes(base64) {
+    const normalized = base64.replaceAll('-', '+').replaceAll('_', '/');
+    const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+function toBytes(value, field) {
+    if (value === undefined || value === null) {
+        throw new Error(`Missing Stork field: ${field}`);
+    }
+    if (value instanceof Uint8Array) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return Uint8Array.from(value);
+    }
+    if (value.startsWith('0x') || /^[0-9a-f]+$/i.test(value)) {
+        return hexToBytes(value);
+    }
+    return base64ToBytes(value);
+}
+function toBigInt(value) {
+    if (value === undefined || value === null) {
+        return 0n;
+    }
+    if (typeof value === 'bigint') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return BigInt(value);
+    }
+    // `value` is already a float64 at this point — any u64 > 2^53 has already lost
+    // precision before reaching here. String(n) round-trips the truncated float64,
+    // not the original integer. Callers should pass string timestamps from the API
+    // to avoid this loss.
+    return BigInt(String(value));
+}
+function parseV(value) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    const bytes = toBytes(value, 'v');
+    if (bytes.length > 0) {
+        return bytes[0];
+    }
+    if (value.startsWith('0x')) {
+        return Number.parseInt(value, 16);
+    }
+    return Number.parseInt(value, 10);
+}
+function parseStorkUpdateDataRaw(raw) {
+    const id = toBytes(raw.id, 'id');
+    if (id.length !== 32) {
+        throw new Error(`Stork update id must be 32 bytes, got ${id.length}`);
+    }
+    return {
+        id,
+        temporalNumericValueTimestampNs: toBigInt(raw.temporal_numeric_value_timestamp_ns),
+        temporalNumericValueMagnitude: toBigInt(raw.temporal_numeric_value_magnitude),
+        temporalNumericValueNegative: raw.temporal_numeric_value_negative ?? false,
+        publisherMerkleRoot: toBytes(raw.publisher_merkle_root, 'publisher_merkle_root'),
+        valueComputeAlgHash: toBytes(raw.value_compute_alg_hash, 'value_compute_alg_hash'),
+        r: toBytes(raw.r, 'r'),
+        s: toBytes(raw.s, 's'),
+        v: parseV(raw.v ?? 0),
+    };
+}
+function parseQuantizedPrice(value) {
+    let price = BigInt(value);
+    const negative = price < 0n;
+    if (negative) {
+        price = -price;
+    }
+    return { magnitude: price, negative };
+}
+/** Build on-chain update data from kronos / Stork REST signed price payload. */
+function buildStorkUpdateDataFromSignedPrice(entry, 
+/** Fallback 32-byte feeder id when `encoded_asset_id` is absent. */
+feederId) {
+    const signed = entry.stork_signed_price;
+    if (signed?.timestamped_signature?.signature) {
+        const checksum = signed.calculation_alg?.checksum;
+        if (!checksum) {
+            return null;
+        }
+        const quantizedPrice = signed.quantized_price ?? signed.price ?? entry.price;
+        if (!quantizedPrice) {
+            return null;
+        }
+        const assetId = signed.encoded_asset_id;
+        if (!assetId && !feederId) {
+            return null;
+        }
+        const { magnitude, negative } = parseQuantizedPrice(String(quantizedPrice));
+        // Nanosecond timestamps for dates in 2026+ (~1.78e18 ns) exceed float64 safe-integer
+        // range (2^53 ≈ 9e15). JSON.parse silently truncates them by up to ±127 ns (precision
+        // step = 256 at this scale), causing get_stork_message_hash to produce the wrong value
+        // and ecrecover to fail → EInvalidSignature (error code 0).
+        // Prefer string sources; fall back to update_data.temporal_numeric_value_timestamp_ns
+        // (a string in kronos pre-parsed payloads) when stork_signed_price only has a number.
+        const rawTimestampNs = signed.timestamped_signature.timestamp_nano
+            ?? signed.timestamped_signature.timestamp
+            ?? entry.timestamp;
+        const timestampNs = (typeof rawTimestampNs === 'number'
+            && typeof entry.update_data?.temporal_numeric_value_timestamp_ns === 'string')
+            ? entry.update_data.temporal_numeric_value_timestamp_ns
+            : rawTimestampNs;
+        const id = assetId
+            ? toBytes(assetId, 'encoded_asset_id')
+            : feederId;
+        return {
+            id,
+            temporalNumericValueTimestampNs: toBigInt(timestampNs),
+            temporalNumericValueMagnitude: magnitude,
+            temporalNumericValueNegative: negative,
+            publisherMerkleRoot: toBytes(signed.publisher_merkle_root, 'publisher_merkle_root'),
+            valueComputeAlgHash: toBytes(checksum, 'value_compute_alg_hash'),
+            r: toBytes(signed.timestamped_signature.signature.r, 'r'),
+            s: toBytes(signed.timestamped_signature.signature.s, 's'),
+            v: parseV(signed.timestamped_signature.signature.v),
+        };
+    }
+    if (entry.update_data) {
+        return parseStorkUpdateDataRaw(entry.update_data);
+    }
+    return null;
+}
+function parseStorkUpdateDataList(data, 
+/** Stork asset symbol → 32-byte on-chain feeder id from zo-oracle config. */
+assetIdByAsset) {
+    const updates = [];
+    for (const entry of Object.values(data.prices)) {
+        const feederId = assetIdByAsset?.get(entry.asset_id);
+        const update = buildStorkUpdateDataFromSignedPrice(entry, feederId);
+        if (update) {
+            if (update.id.length !== 32) {
+                throw new Error(`Stork asset ${entry.asset_id}: id must be 32 bytes (got ${update.id.length}); `
+                    + 'pass assetIdByAsset from buildStorkAssetIdMap()');
+            }
+            updates.push(update);
+        }
+    }
+    return updates;
+}
+/**
+ * Fetch latest Stork prices from kronos REST (`GET` or `POST /stork/latest-price`).
+ */
+async function getLatestStorkPrices(baseUrl, options) {
+    const { assets } = options;
+    if (assets.length === 0) {
+        throw new Error('assets is required');
+    }
+    const root = normalizeBaseUrl(baseUrl);
+    if (assets.length <= 20) {
+        const params = new URLSearchParams();
+        params.set('assets', assets.join(','));
+        const res = await fetch(`${root}/stork/latest-price?${params}`);
+        const json = await res.json();
+        if (!res.ok && json.message) {
+            throw new Error(json.message);
+        }
+        return parseLatestStorkResponse(json);
+    }
+    const res = await fetch(`${root}/stork/latest-price`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ assets }),
+    });
+    const json = await res.json();
+    if (!res.ok && json.message) {
+        throw new Error(json.message);
+    }
+    return parseLatestStorkResponse(json);
+}
+async function fetchStorkUpdateDataFromKronos(baseUrl, assets, assetIdByAsset) {
+    const data = await getLatestStorkPrices(baseUrl, { assets });
+    const updates = parseStorkUpdateDataList(data, assetIdByAsset);
+    if (updates.length === 0) {
+        throw new Error(`No Stork update data returned for assets: ${assets.join(',')}`);
+    }
+    return updates;
+}
+//# sourceMappingURL=storkClient.cjs.map

package/dist/storkClient.cjs.map

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