@zofai/zo-sdk 0.2.14 → 0.2.15

package/dist/storkClient.d.cts

@@ -0,0 +1,90 @@
+/** Kronos Stork price REST client + update payload parsing. */
+export interface IStorkEvmSignature {
+    r: string;
+    s: string;
+    v: string | number;
+}
+export interface IStorkSignedPrice {
+    public_key?: string;
+    encoded_asset_id?: string;
+    /** Stork quantized price used for on-chain signature verification. */
+    quantized_price?: string;
+    price?: string;
+    timestamped_signature?: {
+        timestamp?: number | string;
+        /** Nanosecond timestamp used for on-chain updates (preferred). */
+        timestamp_nano?: number | string;
+        signature?: IStorkEvmSignature;
+        msg_hash?: string;
+    };
+    publisher_merkle_root?: string;
+    calculation_alg?: {
+        type?: string;
+        version?: string;
+        checksum?: string;
+    };
+}
+export interface IStorkKronosPriceEntry {
+    asset_id: string;
+    price: string;
+    priceUsd?: number;
+    timestamp?: number;
+    signature_type?: string;
+    stork_signed_price?: IStorkSignedPrice;
+    signed_prices?: unknown[];
+    /** Pre-parsed on-chain update payload from kronos (preferred). */
+    update_data?: IStorkUpdateDataRaw;
+}
+export interface IStorkUpdateDataRaw {
+    id?: string | number[];
+    temporal_numeric_value_timestamp_ns?: number | string;
+    temporal_numeric_value_magnitude?: string | number;
+    temporal_numeric_value_negative?: boolean;
+    publisher_merkle_root?: string | number[];
+    value_compute_alg_hash?: string | number[];
+    r?: string | number[];
+    s?: string | number[];
+    v?: number | string;
+}
+/** Normalized update payload for Stork Move calls. */
+export interface IStorkUpdateData {
+    id: Uint8Array;
+    temporalNumericValueTimestampNs: bigint;
+    temporalNumericValueMagnitude: bigint;
+    temporalNumericValueNegative: boolean;
+    publisherMerkleRoot: Uint8Array;
+    valueComputeAlgHash: Uint8Array;
+    r: Uint8Array;
+    s: Uint8Array;
+    v: number;
+}
+export interface IStorkLatestPriceData {
+    prices: Record<string, IStorkKronosPriceEntry>;
+}
+export interface IStorkLatestPriceResponse {
+    success: boolean;
+    timestamp?: string;
+    data?: IStorkLatestPriceData;
+    message?: string;
+}
+export interface IGetLatestStorkPricesOptions {
+    assets: string[];
+    /** Override kronos REST base URL. */
+    kronosUrl?: string;
+}
+export declare function hexToBytes(hex: string): Uint8Array;
+export declare function base64ToBytes(base64: string): Uint8Array;
+export declare function parseStorkUpdateDataRaw(raw: IStorkUpdateDataRaw): IStorkUpdateData;
+/** Build on-chain update data from kronos / Stork REST signed price payload. */
+export declare function buildStorkUpdateDataFromSignedPrice(entry: IStorkKronosPriceEntry, 
+/** Fallback 32-byte feeder id when `encoded_asset_id` is absent. */
+feederId?: Uint8Array): IStorkUpdateData | null;
+export declare function parseStorkUpdateDataList(data: IStorkLatestPriceData, 
+/** Stork asset symbol → 32-byte on-chain feeder id from zo-oracle config. */
+assetIdByAsset?: Map<string, Uint8Array>): IStorkUpdateData[];
+/**
+ * Fetch latest Stork prices from kronos REST (`GET` or `POST /stork/latest-price`).
+ */
+export declare function getLatestStorkPrices(baseUrl: string, options: IGetLatestStorkPricesOptions): Promise<IStorkLatestPriceData>;
+export declare function fetchStorkUpdateDataFromKronos(baseUrl: string, assets: string[], assetIdByAsset?: Map<string, Uint8Array>): Promise<IStorkUpdateData[]>;
+//# sourceMappingURL=storkClient.d.cts.map

package/dist/storkClient.d.cts.map

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

package/dist/storkClient.d.mts

@@ -0,0 +1,90 @@
+/** Kronos Stork price REST client + update payload parsing. */
+export interface IStorkEvmSignature {
+    r: string;
+    s: string;
+    v: string | number;
+}
+export interface IStorkSignedPrice {
+    public_key?: string;
+    encoded_asset_id?: string;
+    /** Stork quantized price used for on-chain signature verification. */
+    quantized_price?: string;
+    price?: string;
+    timestamped_signature?: {
+        timestamp?: number | string;
+        /** Nanosecond timestamp used for on-chain updates (preferred). */
+        timestamp_nano?: number | string;
+        signature?: IStorkEvmSignature;
+        msg_hash?: string;
+    };
+    publisher_merkle_root?: string;
+    calculation_alg?: {
+        type?: string;
+        version?: string;
+        checksum?: string;
+    };
+}
+export interface IStorkKronosPriceEntry {
+    asset_id: string;
+    price: string;
+    priceUsd?: number;
+    timestamp?: number;
+    signature_type?: string;
+    stork_signed_price?: IStorkSignedPrice;
+    signed_prices?: unknown[];
+    /** Pre-parsed on-chain update payload from kronos (preferred). */
+    update_data?: IStorkUpdateDataRaw;
+}
+export interface IStorkUpdateDataRaw {
+    id?: string | number[];
+    temporal_numeric_value_timestamp_ns?: number | string;
+    temporal_numeric_value_magnitude?: string | number;
+    temporal_numeric_value_negative?: boolean;
+    publisher_merkle_root?: string | number[];
+    value_compute_alg_hash?: string | number[];
+    r?: string | number[];
+    s?: string | number[];
+    v?: number | string;
+}
+/** Normalized update payload for Stork Move calls. */
+export interface IStorkUpdateData {
+    id: Uint8Array;
+    temporalNumericValueTimestampNs: bigint;
+    temporalNumericValueMagnitude: bigint;
+    temporalNumericValueNegative: boolean;
+    publisherMerkleRoot: Uint8Array;
+    valueComputeAlgHash: Uint8Array;
+    r: Uint8Array;
+    s: Uint8Array;
+    v: number;
+}
+export interface IStorkLatestPriceData {
+    prices: Record<string, IStorkKronosPriceEntry>;
+}
+export interface IStorkLatestPriceResponse {
+    success: boolean;
+    timestamp?: string;
+    data?: IStorkLatestPriceData;
+    message?: string;
+}
+export interface IGetLatestStorkPricesOptions {
+    assets: string[];
+    /** Override kronos REST base URL. */
+    kronosUrl?: string;
+}
+export declare function hexToBytes(hex: string): Uint8Array;
+export declare function base64ToBytes(base64: string): Uint8Array;
+export declare function parseStorkUpdateDataRaw(raw: IStorkUpdateDataRaw): IStorkUpdateData;
+/** Build on-chain update data from kronos / Stork REST signed price payload. */
+export declare function buildStorkUpdateDataFromSignedPrice(entry: IStorkKronosPriceEntry, 
+/** Fallback 32-byte feeder id when `encoded_asset_id` is absent. */
+feederId?: Uint8Array): IStorkUpdateData | null;
+export declare function parseStorkUpdateDataList(data: IStorkLatestPriceData, 
+/** Stork asset symbol → 32-byte on-chain feeder id from zo-oracle config. */
+assetIdByAsset?: Map<string, Uint8Array>): IStorkUpdateData[];
+/**
+ * Fetch latest Stork prices from kronos REST (`GET` or `POST /stork/latest-price`).
+ */
+export declare function getLatestStorkPrices(baseUrl: string, options: IGetLatestStorkPricesOptions): Promise<IStorkLatestPriceData>;
+export declare function fetchStorkUpdateDataFromKronos(baseUrl: string, assets: string[], assetIdByAsset?: Map<string, Uint8Array>): Promise<IStorkUpdateData[]>;
+//# sourceMappingURL=storkClient.d.mts.map

package/dist/storkClient.d.mts.map

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

package/dist/storkClient.mjs

@@ -0,0 +1,208 @@
+/** Kronos Stork price REST client + update payload parsing. */
+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;
+}
+export 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;
+}
+export 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);
+}
+export 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. */
+export 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;
+}
+export 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`).
+ */
+export 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);
+}
+export 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.mjs.map

package/dist/storkClient.mjs.map

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

package/dist/storkOracle.cjs

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORK_UPDATE_FEE_MIST = void 0;
+exports.appendStorkUpdatesToTransaction = appendStorkUpdatesToTransaction;
+exports.estimateStorkUpdateFeeMist = estimateStorkUpdateFeeMist;
+const transactions_1 = require("@mysten/sui/transactions");
+/** 1 MIST per Stork feed update (matches zo-go-executor). */
+exports.STORK_UPDATE_FEE_MIST = 1n;
+function bytesToPureVector(bytesList) {
+    return bytesList.map(bytes => Array.from(bytes));
+}
+/**
+ * Append Stork on-chain price updates to an open PTB (before Pyth Pro verify + market op).
+ *
+ * 1. `update_temporal_numeric_value_evm_input_vec::new`
+ * 2. `stork::update_multiple_temporal_numeric_values_evm`
+ */
+function appendStorkUpdatesToTransaction(tx, config, updates, options) {
+    if (updates.length === 0) {
+        return;
+    }
+    const feePerUpdate = options?.feePerUpdate ?? exports.STORK_UPDATE_FEE_MIST;
+    const totalFee = feePerUpdate * BigInt(updates.length);
+    const feeSource = options?.feeSource ?? tx.gas;
+    const [feeCoin] = tx.splitCoins(feeSource, [tx.pure.u64(totalFee)]);
+    const ids = bytesToPureVector(updates.map(u => u.id));
+    const timestampNss = updates.map(u => u.temporalNumericValueTimestampNs);
+    const magnitudes = updates.map(u => u.temporalNumericValueMagnitude);
+    const negatives = updates.map(u => u.temporalNumericValueNegative);
+    const publisherMerkleRoots = bytesToPureVector(updates.map(u => u.publisherMerkleRoot));
+    const valueComputeAlgHashes = bytesToPureVector(updates.map(u => u.valueComputeAlgHash));
+    const rs = bytesToPureVector(updates.map(u => u.r));
+    const ss = bytesToPureVector(updates.map(u => u.s));
+    const vs = updates.map(u => u.v);
+    const [updateInputVec] = tx.moveCall({
+        target: `${config.storkPackage}::update_temporal_numeric_value_evm_input_vec::new`,
+        arguments: [
+            tx.pure.vector('vector<u8>', ids),
+            tx.pure.vector('u64', timestampNss),
+            tx.pure.vector('u128', magnitudes),
+            tx.pure.vector('bool', negatives),
+            tx.pure.vector('vector<u8>', publisherMerkleRoots),
+            tx.pure.vector('vector<u8>', valueComputeAlgHashes),
+            tx.pure.vector('vector<u8>', rs),
+            tx.pure.vector('vector<u8>', ss),
+            tx.pure.vector('u8', vs),
+        ],
+    });
+    tx.moveCall({
+        target: `${config.storkPackage}::stork::update_multiple_temporal_numeric_values_evm`,
+        arguments: [
+            tx.object(config.storkState),
+            updateInputVec,
+            feeCoin,
+        ],
+    });
+}
+function estimateStorkUpdateFeeMist(updateCount, feePerUpdate = exports.STORK_UPDATE_FEE_MIST) {
+    return feePerUpdate * BigInt(updateCount);
+}
+//# sourceMappingURL=storkOracle.cjs.map

package/dist/storkOracle.cjs.map

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

package/dist/storkOracle.d.cts

@@ -0,0 +1,21 @@
+import type { TransactionObjectArgument } from "@mysten/sui/transactions";
+import { Transaction } from "@mysten/sui/transactions";
+import type { IOracleProConfig } from "./consts/index.cjs";
+import type { IStorkUpdateData } from "./storkClient.cjs";
+/** 1 MIST per Stork feed update (matches zo-go-executor). */
+export declare const STORK_UPDATE_FEE_MIST = 1n;
+export interface IAppendStorkUpdatesOptions {
+    /** Coin to split update fees from. Defaults to `tx.gas`. */
+    feeSource?: TransactionObjectArgument;
+    /** MIST per update. Defaults to 1. */
+    feePerUpdate?: bigint;
+}
+/**
+ * Append Stork on-chain price updates to an open PTB (before Pyth Pro verify + market op).
+ *
+ * 1. `update_temporal_numeric_value_evm_input_vec::new`
+ * 2. `stork::update_multiple_temporal_numeric_values_evm`
+ */
+export declare function appendStorkUpdatesToTransaction(tx: Transaction, config: Pick<IOracleProConfig, 'storkPackage' | 'storkState'>, updates: IStorkUpdateData[], options?: IAppendStorkUpdatesOptions): void;
+export declare function estimateStorkUpdateFeeMist(updateCount: number, feePerUpdate?: bigint): bigint;
+//# sourceMappingURL=storkOracle.d.cts.map

package/dist/storkOracle.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storkOracle.d.cts","sourceRoot":"","sources":["../src/storkOracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iCAAgC;AACzE,OAAO,EAAE,WAAW,EAAE,iCAAgC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAAgB;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAAqB;AAErD,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,yBAAyB,CAAA;IACrC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,YAAY,CAAC,EAC7D,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,CAAC,EAAE,0BAA0B,GACnC,IAAI,CA2CN;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,MAA8B,GAC3C,MAAM,CAER"}

package/dist/storkOracle.d.mts

@@ -0,0 +1,21 @@
+import type { TransactionObjectArgument } from "@mysten/sui/transactions";
+import { Transaction } from "@mysten/sui/transactions";
+import type { IOracleProConfig } from "./consts/index.mjs";
+import type { IStorkUpdateData } from "./storkClient.mjs";
+/** 1 MIST per Stork feed update (matches zo-go-executor). */
+export declare const STORK_UPDATE_FEE_MIST = 1n;
+export interface IAppendStorkUpdatesOptions {
+    /** Coin to split update fees from. Defaults to `tx.gas`. */
+    feeSource?: TransactionObjectArgument;
+    /** MIST per update. Defaults to 1. */
+    feePerUpdate?: bigint;
+}
+/**
+ * Append Stork on-chain price updates to an open PTB (before Pyth Pro verify + market op).
+ *
+ * 1. `update_temporal_numeric_value_evm_input_vec::new`
+ * 2. `stork::update_multiple_temporal_numeric_values_evm`
+ */
+export declare function appendStorkUpdatesToTransaction(tx: Transaction, config: Pick<IOracleProConfig, 'storkPackage' | 'storkState'>, updates: IStorkUpdateData[], options?: IAppendStorkUpdatesOptions): void;
+export declare function estimateStorkUpdateFeeMist(updateCount: number, feePerUpdate?: bigint): bigint;
+//# sourceMappingURL=storkOracle.d.mts.map

package/dist/storkOracle.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storkOracle.d.mts","sourceRoot":"","sources":["../src/storkOracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iCAAgC;AACzE,OAAO,EAAE,WAAW,EAAE,iCAAgC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAAgB;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAAqB;AAErD,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,yBAAyB,CAAA;IACrC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,YAAY,CAAC,EAC7D,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,CAAC,EAAE,0BAA0B,GACnC,IAAI,CA2CN;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,MAA8B,GAC3C,MAAM,CAER"}

package/dist/storkOracle.mjs

@@ -0,0 +1,56 @@
+import { Transaction } from "@mysten/sui/transactions";
+/** 1 MIST per Stork feed update (matches zo-go-executor). */
+export const STORK_UPDATE_FEE_MIST = 1n;
+function bytesToPureVector(bytesList) {
+    return bytesList.map(bytes => Array.from(bytes));
+}
+/**
+ * Append Stork on-chain price updates to an open PTB (before Pyth Pro verify + market op).
+ *
+ * 1. `update_temporal_numeric_value_evm_input_vec::new`
+ * 2. `stork::update_multiple_temporal_numeric_values_evm`
+ */
+export function appendStorkUpdatesToTransaction(tx, config, updates, options) {
+    if (updates.length === 0) {
+        return;
+    }
+    const feePerUpdate = options?.feePerUpdate ?? STORK_UPDATE_FEE_MIST;
+    const totalFee = feePerUpdate * BigInt(updates.length);
+    const feeSource = options?.feeSource ?? tx.gas;
+    const [feeCoin] = tx.splitCoins(feeSource, [tx.pure.u64(totalFee)]);
+    const ids = bytesToPureVector(updates.map(u => u.id));
+    const timestampNss = updates.map(u => u.temporalNumericValueTimestampNs);
+    const magnitudes = updates.map(u => u.temporalNumericValueMagnitude);
+    const negatives = updates.map(u => u.temporalNumericValueNegative);
+    const publisherMerkleRoots = bytesToPureVector(updates.map(u => u.publisherMerkleRoot));
+    const valueComputeAlgHashes = bytesToPureVector(updates.map(u => u.valueComputeAlgHash));
+    const rs = bytesToPureVector(updates.map(u => u.r));
+    const ss = bytesToPureVector(updates.map(u => u.s));
+    const vs = updates.map(u => u.v);
+    const [updateInputVec] = tx.moveCall({
+        target: `${config.storkPackage}::update_temporal_numeric_value_evm_input_vec::new`,
+        arguments: [
+            tx.pure.vector('vector<u8>', ids),
+            tx.pure.vector('u64', timestampNss),
+            tx.pure.vector('u128', magnitudes),
+            tx.pure.vector('bool', negatives),
+            tx.pure.vector('vector<u8>', publisherMerkleRoots),
+            tx.pure.vector('vector<u8>', valueComputeAlgHashes),
+            tx.pure.vector('vector<u8>', rs),
+            tx.pure.vector('vector<u8>', ss),
+            tx.pure.vector('u8', vs),
+        ],
+    });
+    tx.moveCall({
+        target: `${config.storkPackage}::stork::update_multiple_temporal_numeric_values_evm`,
+        arguments: [
+            tx.object(config.storkState),
+            updateInputVec,
+            feeCoin,
+        ],
+    });
+}
+export function estimateStorkUpdateFeeMist(updateCount, feePerUpdate = STORK_UPDATE_FEE_MIST) {
+    return feePerUpdate * BigInt(updateCount);
+}
+//# sourceMappingURL=storkOracle.mjs.map

package/dist/storkOracle.mjs.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zofai/zo-sdk",
   "type": "module",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "author": "zo",
   "exports": {
     ".": {

package/src/abstract/BaseDataAPI.ts

@@ -48,7 +48,7 @@ export abstract class BaseDataAPI extends OracleAPI implements IBaseDataAPI {
     connectionURL: string,
     lpToken: LPToken,
   ) {
-    super(network, provider, connectionURL, lpToken)
+    super(network, provider, connectionURL, lpToken, apiEndpoint)
     this.provider = provider
     this.apiEndpoint = apiEndpoint
     this.connectionURL = connectionURL

package/src/consts/deployments-usdz-mainnet.json

@@ -1,7 +1,7 @@
 {
   "zo_core": {
     "package": "0x7fd8aba1652c58b6397c799fd375e748e5053145cb7e126d303e0a1545fd1fec",
-    "upgraded_package": "0x49735fc18298a38c319442531415047b3a0a833652bbb8b4aa587ac527c5dd65",
+    "upgraded_package": "0xca86fc435d91d1a6d56bcf20be99dcf21e61923cd30ee46b5930463fbce7d98f",
     "upgrade_cap": "0x2f67d379d3b9e256a9c4079de50f4bd336dcbda1bd90d1fcd61a9cc1dc369d69",
     "admin_cap": "0x63af8e78701327be98e0c44967389148c374f4ea7c7cf8acf64957b705ffd02d",
     "market": "0x3310c794d0bbc4b0421d2fedc74fbd5a028b09fe4d396cd5458786f4c52fa636",