@lifi/perps-sdk-provider-ondo 0.0.0-preview-7ff840c

package/dist/esm/types/ws.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Ondo WebSocket wire types. Client ops are `{op, ...args}` envelopes (only
+ * `login` nests its arguments); server data frames are
+ * `{type: 'update', channel, data}`.
+ */
+import type { OndoFill, OndoOrder, OndoPosition } from './wire.js';
+/** Level tuple as streamed: `[price, size]`, both decimal strings. @public */
+export type OndoBookLevel = [string, string];
+/** Streamed order-book snapshot (`depthBooksPerps`/`topOfBooksPerps`). @public */
+export interface OndoBookSnapshot {
+    market: string;
+    time: string;
+    asks: OndoBookLevel[];
+    bids: OndoBookLevel[];
+    depthLevels?: string;
+}
+/** Streamed public trade (`tradesPerps`). @public */
+export interface OndoWsTrade {
+    market: string;
+    price: string;
+    size: string;
+    cost: string;
+    aggressor_side: 'buy' | 'sell';
+    time: string;
+    id: string;
+}
+/**
+ * Streamed candlestick (`kLinePerps`). Prices and volume arrive as numbers,
+ * unlike the string-typed REST shapes; `s`/`e`/`t` are Unix seconds.
+ * @public
+ */
+export interface OndoKline {
+    m: string;
+    t: number;
+    s: number;
+    e: number;
+    o: number;
+    h: number;
+    l: number;
+    c: number;
+    v: number;
+    x: boolean;
+}
+/** Streamed mark price (`markPricesPerps`). @public */
+export interface OndoMarkPrice {
+    market: string;
+    markPrice: string;
+}
+/** Streamed funding rate (`fundingRatesPerps`). @public */
+export interface OndoFundingRate {
+    market: string;
+    rate: string;
+    intervalEnds: string;
+    premiums?: unknown[];
+}
+/** Server frame envelope. Non-`update` types are acks or errors. @public */
+export type OndoWsMessage = {
+    type: 'update';
+    channel: 'depthBooksPerps';
+    data: OndoBookSnapshot[];
+} | {
+    type: 'update';
+    channel: 'tradesPerps';
+    data: OndoWsTrade[];
+} | {
+    type: 'update';
+    channel: 'kLinePerps';
+    data: OndoKline;
+} | {
+    type: 'update';
+    channel: 'markPricesPerps';
+    data: OndoMarkPrice[];
+} | {
+    type: 'update';
+    channel: 'fundingRatesPerps';
+    data: OndoFundingRate[];
+} | {
+    type: 'update';
+    channel: 'ordersPerps';
+    data: OndoOrder[];
+} | {
+    type: 'update';
+    channel: 'fillsPerps';
+    data: OndoFill[];
+} | {
+    type: 'update';
+    channel: 'positionsPerps';
+    data: OndoPosition[];
+} | {
+    type: 'update';
+    channel: string;
+    data: unknown;
+} | {
+    type: 'pong';
+} | {
+    type: 'loggedIn';
+    msg?: string;
+} | {
+    type: 'subscribed';
+    channel?: string;
+} | {
+    type: 'unsubscribed';
+    channel?: string;
+} | {
+    type: 'error';
+    msg?: string;
+};
+//# sourceMappingURL=ws.d.ts.map

package/dist/esm/types/ws.d.ts.map

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

package/dist/esm/types/ws.js

@@ -0,0 +1,7 @@
+/**
+ * Ondo WebSocket wire types. Client ops are `{op, ...args}` envelopes (only
+ * `login` nests its arguments); server data frames are
+ * `{type: 'update', channel, data}`.
+ */
+export {};
+//# sourceMappingURL=ws.js.map

package/dist/esm/types/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../../src/types/ws.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/utils/activityCursor.d.ts

@@ -0,0 +1,47 @@
+import { type ActivityItem } from '@lifi/perps-types';
+/**
+ * Per-endpoint cursor envelope for Ondo activity pagination.
+ *
+ * Each key holds the `pageInfo.nextCursor` returned by that endpoint on the
+ * previous call. When a key is **present** with a non-empty string the
+ * corresponding endpoint will be re-fetched at that cursor on the next call;
+ * when a key is **absent** the endpoint is treated as exhausted (or never
+ * paged because the type filter excluded it) and skipped.
+ *
+ * The envelope is round-tripped through `cursor` as base64url JSON so callers
+ * don't need to know the per-endpoint shape.
+ * @public
+ */
+export interface OndoActivityCursor {
+    fundings?: string;
+    liquidations?: string;
+    /**
+     * Already-fetched, merged-and-sorted rows that did not fit under the page
+     * `limit`. The upstream cursors above have advanced past these rows, so they
+     * are replayed (prepended) on the next page before any fresh fetch — without
+     * them the tail would be lost forever.
+     */
+    overflow?: ActivityItem[];
+}
+/**
+ * Encode an `OndoActivityCursor` as the base64url-of-JSON cursor string
+ * persisted between activity pages. Returns `undefined` when every
+ * per-endpoint key is empty and no `overflow` rows remain — the caller
+ * should report `hasMore: false` and omit `cursor` from `Pagination` then.
+ *
+ * Browser-direct: `Buffer` is Node-only. We use `btoa` over a Latin-1
+ * encoding of the UTF-8 bytes and then rewrite `+/=` to base64url. This is
+ * the same byte sequence Node's `Buffer.from(json, 'utf8').toString('base64url')`
+ * produces, so cursors round-trip across environments.
+ * @public
+ */
+export declare const encodeActivityCursor: (env: OndoActivityCursor) => string | undefined;
+/**
+ * Decode a previously-encoded activity cursor. Returns `undefined` for an
+ * absent cursor (first page) and throws {@link PerpsError} with
+ * `ValidationError` if the string is malformed — we'd rather fail loudly than
+ * silently re-page from page 1 and re-deliver already-paginated rows.
+ * @public
+ */
+export declare const decodeActivityCursor: (cursor: string | undefined) => OndoActivityCursor | undefined;
+//# sourceMappingURL=activityCursor.d.ts.map

package/dist/esm/utils/activityCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityCursor.d.ts","sourceRoot":"","sources":["../../../src/utils/activityCursor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAA;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AAOD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,kBAAkB,KACtB,MAAM,GAAG,SAcX,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,GAAG,SAAS,KACzB,kBAAkB,GAAG,SA6CvB,CAAA"}

package/dist/esm/utils/activityCursor.js

@@ -0,0 +1,93 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+const CURSOR_KEYS = ['fundings', 'liquidations'];
+const isNonEmpty = (v) => typeof v === 'string' && v.length > 0;
+/**
+ * Encode an `OndoActivityCursor` as the base64url-of-JSON cursor string
+ * persisted between activity pages. Returns `undefined` when every
+ * per-endpoint key is empty and no `overflow` rows remain — the caller
+ * should report `hasMore: false` and omit `cursor` from `Pagination` then.
+ *
+ * Browser-direct: `Buffer` is Node-only. We use `btoa` over a Latin-1
+ * encoding of the UTF-8 bytes and then rewrite `+/=` to base64url. This is
+ * the same byte sequence Node's `Buffer.from(json, 'utf8').toString('base64url')`
+ * produces, so cursors round-trip across environments.
+ * @public
+ */
+export const encodeActivityCursor = (env) => {
+    const compact = {};
+    for (const key of CURSOR_KEYS) {
+        if (isNonEmpty(env[key])) {
+            compact[key] = env[key];
+        }
+    }
+    if (env.overflow !== undefined && env.overflow.length > 0) {
+        compact.overflow = env.overflow;
+    }
+    if (Object.keys(compact).length === 0) {
+        return undefined;
+    }
+    return toBase64Url(JSON.stringify(compact));
+};
+/**
+ * Decode a previously-encoded activity cursor. Returns `undefined` for an
+ * absent cursor (first page) and throws {@link PerpsError} with
+ * `ValidationError` if the string is malformed — we'd rather fail loudly than
+ * silently re-page from page 1 and re-deliver already-paginated rows.
+ * @public
+ */
+export const decodeActivityCursor = (cursor) => {
+    if (cursor === undefined) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fromBase64Url(cursor));
+    }
+    catch {
+        throw new PerpsError(PerpsErrorCode.ValidationError, 'Invalid Ondo activity cursor: not base64url-encoded JSON');
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        throw new PerpsError(PerpsErrorCode.ValidationError, 'Invalid Ondo activity cursor: expected JSON object');
+    }
+    const cursorRecord = parsed;
+    const env = {};
+    for (const key of CURSOR_KEYS) {
+        const v = cursorRecord[key];
+        if (v === undefined) {
+            continue;
+        }
+        if (typeof v !== 'string') {
+            throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid Ondo activity cursor: ${key} must be a string`);
+        }
+        env[key] = v;
+    }
+    const overflow = cursorRecord.overflow;
+    if (overflow !== undefined) {
+        if (!Array.isArray(overflow)) {
+            throw new PerpsError(PerpsErrorCode.ValidationError, 'Invalid Ondo activity cursor: overflow must be an array');
+        }
+        env.overflow = overflow;
+    }
+    return env;
+};
+const toBase64Url = (s) => {
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(s, 'utf8').toString('base64url');
+    }
+    const utf8 = unescape(encodeURIComponent(s));
+    return btoa(utf8).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+};
+const fromBase64Url = (s) => {
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(s, 'base64url').toString('utf8');
+    }
+    const padded = s.replace(/-/g, '+').replace(/_/g, '/') + padFor(s);
+    const decoded = atob(padded);
+    return decodeURIComponent(escape(decoded));
+};
+const padFor = (s) => {
+    const rem = s.length % 4;
+    return rem === 0 ? '' : '='.repeat(4 - rem);
+};
+//# sourceMappingURL=activityCursor.js.map

package/dist/esm/utils/activityCursor.js.map

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

package/dist/esm/utils/apiClient.d.ts

@@ -0,0 +1,90 @@
+import { PerpsError, type ResolvedRetryPolicy } from '@lifi/perps-sdk';
+import type { OndoPageInfo } from '../types/wire.js';
+/** @internal */
+export type ApiParams = Record<string, string | number | boolean>;
+/** One page of a paginated Ondo response: `pageInfo` is a SIBLING of `result`. @public */
+export interface OndoPage<T> {
+    result: T[];
+    pageInfo: OndoPageInfo | undefined;
+}
+/** @internal */
+export type OndoHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Ondo request failure — a non-2xx HTTP status, a `success: false` envelope,
+ * or a body that is not a `GenericResponse` envelope at all. `errorCode`
+ * carries the wire `error_code` when the envelope advertised one.
+ *
+ * @public
+ */
+export declare class OndoApiError extends PerpsError {
+    readonly errorCode: string | undefined;
+    constructor(message: string, errorCode?: string);
+}
+/**
+ * The Ondo session JWT was rejected (HTTP 401). Distinct from
+ * {@link OndoApiError} so callers can evict the stored token and re-run the
+ * SIWE login instead of surfacing a generic venue failure.
+ *
+ * @public
+ */
+export declare class OndoSessionExpiredError extends PerpsError {
+    constructor(message: string);
+}
+/** @internal */
+export declare const ONDO_RETRY_DEFAULTS: ResolvedRetryPolicy;
+/** @internal */
+export interface OndoApiClientOptions {
+    signal?: AbortSignal;
+    policy?: ResolvedRetryPolicy;
+    fetchImpl?: typeof fetch;
+}
+/** @internal */
+export interface OndoRequestOptions {
+    params?: ApiParams;
+    /** Ondo session JWT, sent as `Authorization: Bearer <token>`. */
+    authToken?: string;
+}
+/**
+ * HTTP boundary against Ondo's REST API.
+ *
+ * Browser-direct by design: the session JWT lives client-side only, so
+ * credentialed calls (`authToken` option) go straight to Ondo — never through
+ * the LI.FI backend. Every response is an `OndoGenericResponse` envelope; the
+ * client unwraps `result` on success and throws {@link OndoApiError} (carrying
+ * the wire `error_code`) otherwise. An HTTP 401 throws
+ * {@link OndoSessionExpiredError} so callers can re-run the SIWE login.
+ * @public
+ */
+export declare class OndoApiClient {
+    private readonly baseUrl;
+    private readonly signal;
+    private readonly policy;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, options?: OndoApiClientOptions);
+    get<T>(path: string, options?: OndoRequestOptions): Promise<T>;
+    /**
+     * GET a paginated endpoint, preserving the `pageInfo` sibling that
+     * {@link get}'s envelope unwrap would otherwise drop.
+     */
+    getPage<T>(path: string, options?: OndoRequestOptions): Promise<OndoPage<T>>;
+    /**
+     * Arbitrary-method request with caller-prebuilt headers — the execution
+     * surface for credential-bearing `RestCallSignedActionStep`s, whose
+     * `Authorization` header is attached by `signActions` from the token store.
+     * Only GET is ever retried; writes are not idempotent.
+     */
+    send<T>(method: OndoHttpMethod, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    /**
+     * POSTs are never auto-retried regardless of policy: Ondo writes (order
+     * placement, login completion) are not idempotent, and a retried request
+     * whose first attempt landed would double-submit.
+     */
+    post<T>(path: string, body?: unknown, options?: Pick<OndoRequestOptions, 'authToken'>): Promise<T>;
+    private buildUrl;
+    private perform;
+    private unwrap;
+}
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/esm/utils/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../../src/utils/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EACV,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAEjE,0FAA0F;AAC1F,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,EAAE,CAAA;IACX,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAA;CACnC;AAED,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE9D;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;gBAE1B,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM;CAG5B;AAED,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,EAAE,mBAmBjC,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AASD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAOrD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAUpE;;;OAGG;IACG,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAYvB;;;;;OAKG;IACG,IAAI,CAAC,CAAC,EACV,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC7D,OAAO,CAAC,CAAC,CAAC;IAUb;;;;OAIG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAC9C,OAAO,CAAC,CAAC,CAAC;IAUb,OAAO,CAAC,QAAQ;YAaF,OAAO;IAgCrB,OAAO,CAAC,MAAM;CAyBf"}

package/dist/esm/utils/apiClient.js

@@ -0,0 +1,169 @@
+import { DISABLED_RETRY, fetchWithRetry, PerpsError, } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+/**
+ * Ondo request failure — a non-2xx HTTP status, a `success: false` envelope,
+ * or a body that is not a `GenericResponse` envelope at all. `errorCode`
+ * carries the wire `error_code` when the envelope advertised one.
+ *
+ * @public
+ */
+export class OndoApiError extends PerpsError {
+    errorCode;
+    constructor(message, errorCode) {
+        super(PerpsErrorCode.ThirdPartyError, message);
+        this.errorCode = errorCode;
+    }
+}
+/**
+ * The Ondo session JWT was rejected (HTTP 401). Distinct from
+ * {@link OndoApiError} so callers can evict the stored token and re-run the
+ * SIWE login instead of surfacing a generic venue failure.
+ *
+ * @public
+ */
+export class OndoSessionExpiredError extends PerpsError {
+    constructor(message) {
+        super(PerpsErrorCode.Unauthorized, message);
+    }
+}
+/** @internal */
+export const ONDO_RETRY_DEFAULTS = {
+    enabled: true,
+    maxAttempts: 2,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    respectRetryAfter: true,
+    classify: ({ response }) => {
+        if (response.status === 429) {
+            return 'retry-rate-limit';
+        }
+        if (response.status === 502 ||
+            response.status === 503 ||
+            response.status === 504) {
+            return 'retry-server';
+        }
+        return 'fail';
+    },
+};
+const isGenericResponse = (data) => typeof data === 'object' &&
+    data !== null &&
+    typeof data.success === 'boolean';
+/**
+ * HTTP boundary against Ondo's REST API.
+ *
+ * Browser-direct by design: the session JWT lives client-side only, so
+ * credentialed calls (`authToken` option) go straight to Ondo — never through
+ * the LI.FI backend. Every response is an `OndoGenericResponse` envelope; the
+ * client unwraps `result` on success and throws {@link OndoApiError} (carrying
+ * the wire `error_code`) otherwise. An HTTP 401 throws
+ * {@link OndoSessionExpiredError} so callers can re-run the SIWE login.
+ * @public
+ */
+export class OndoApiClient {
+    baseUrl;
+    signal;
+    policy;
+    fetchImpl;
+    constructor(baseUrl, options) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.signal = options?.signal;
+        this.policy = options?.policy ?? ONDO_RETRY_DEFAULTS;
+        this.fetchImpl = options?.fetchImpl;
+    }
+    async get(path, options) {
+        const { status, data } = await this.perform(path, {
+            method: 'GET',
+            params: options?.params,
+            authToken: options?.authToken,
+            policy: this.policy,
+        });
+        return this.unwrap(path, status, data);
+    }
+    /**
+     * GET a paginated endpoint, preserving the `pageInfo` sibling that
+     * {@link get}'s envelope unwrap would otherwise drop.
+     */
+    async getPage(path, options) {
+        const { status, data } = await this.perform(path, {
+            method: 'GET',
+            params: options?.params,
+            authToken: options?.authToken,
+            policy: this.policy,
+        });
+        const result = this.unwrap(path, status, data);
+        const pageInfo = data.pageInfo;
+        return { result: result ?? [], pageInfo };
+    }
+    /**
+     * Arbitrary-method request with caller-prebuilt headers — the execution
+     * surface for credential-bearing `RestCallSignedActionStep`s, whose
+     * `Authorization` header is attached by `signActions` from the token store.
+     * Only GET is ever retried; writes are not idempotent.
+     */
+    async send(method, path, options) {
+        const { status, data } = await this.perform(path, {
+            method,
+            body: options?.body,
+            headers: options?.headers,
+            policy: method === 'GET' ? this.policy : DISABLED_RETRY,
+        });
+        return this.unwrap(path, status, data);
+    }
+    /**
+     * POSTs are never auto-retried regardless of policy: Ondo writes (order
+     * placement, login completion) are not idempotent, and a retried request
+     * whose first attempt landed would double-submit.
+     */
+    async post(path, body, options) {
+        const { status, data } = await this.perform(path, {
+            method: 'POST',
+            body,
+            authToken: options?.authToken,
+            policy: DISABLED_RETRY,
+        });
+        return this.unwrap(path, status, data);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params || Object.keys(params).length === 0) {
+            return url;
+        }
+        const qs = Object.entries(params)
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+            .join('&');
+        return `${url}?${qs}`;
+    }
+    async perform(path, options) {
+        const headers = {
+            Accept: 'application/json',
+            ...options.headers,
+        };
+        if (options.authToken) {
+            headers.Authorization = `Bearer ${options.authToken}`;
+        }
+        const init = { method: options.method, headers };
+        if (options.method !== 'GET' && options.method !== 'DELETE') {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(options.body ?? {});
+        }
+        const response = await fetchWithRetry(this.buildUrl(path, options.params), init, { policy: options.policy, fetchImpl: this.fetchImpl, signal: this.signal });
+        const data = await response.json().catch(() => undefined);
+        return { status: response.status, data };
+    }
+    unwrap(path, status, data) {
+        if (status === 401) {
+            throw new OndoSessionExpiredError(`Ondo rejected the session token for ${path}`);
+        }
+        if (status < 200 || status >= 300) {
+            throw new OndoApiError(`Ondo API request failed: ${status} — ${JSON.stringify(data).slice(0, 200)}`, isGenericResponse(data) ? data.error_code : undefined);
+        }
+        if (!isGenericResponse(data)) {
+            throw new OndoApiError(`Ondo API returned an unexpected body for ${path}: ${JSON.stringify(data).slice(0, 200)}`);
+        }
+        if (!data.success) {
+            throw new OndoApiError(`Ondo API error for ${path}: ${data.error_code ?? 'unknown'} — ${data.error ?? 'no error message'}`, data.error_code);
+        }
+        return data.result;
+    }
+}
+//# sourceMappingURL=apiClient.js.map

package/dist/esm/utils/apiClient.js.map

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

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,11 @@
+export { decodeActivityCursor, encodeActivityCursor, type OndoActivityCursor, } from './activityCursor.js';
+export { type ApiParams, ONDO_RETRY_DEFAULTS, OndoApiClient, type OndoApiClientOptions, OndoApiError, type OndoHttpMethod, type OndoPage, type OndoRequestOptions, OndoSessionExpiredError, } from './apiClient.js';
+export { estimateLiquidationPrice } from './liquidation.js';
+export { mapFundingActivity, mapLiquidationActivity } from './mapActivity.js';
+export { mapFill } from './mapFill.js';
+export { classifyAndMapOrders, isTriggerOrder, mapOrder, mapOrderDetail, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapOpenPositions, mapPosition } from './mapPosition.js';
+export { intervalFromBarSpan, mapInterval } from './ohlcvInterval.js';
+export { ondoAsset } from './ondoAsset.js';
+export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,SAAS,EACd,mBAAmB,EACnB,aAAa,EACb,KAAK,oBAAoB,EACzB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/esm/utils/index.js

@@ -0,0 +1,12 @@
+// biome-ignore-all lint/performance/noBarrelFile: module public entry point.
+export { decodeActivityCursor, encodeActivityCursor, } from './activityCursor.js';
+export { ONDO_RETRY_DEFAULTS, OndoApiClient, OndoApiError, OndoSessionExpiredError, } from './apiClient.js';
+export { estimateLiquidationPrice } from './liquidation.js';
+export { mapFundingActivity, mapLiquidationActivity } from './mapActivity.js';
+export { mapFill } from './mapFill.js';
+export { classifyAndMapOrders, isTriggerOrder, mapOrder, mapOrderDetail, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapOpenPositions, mapPosition } from './mapPosition.js';
+export { intervalFromBarSpan, mapInterval } from './ohlcvInterval.js';
+export { ondoAsset } from './ondoAsset.js';
+export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAEL,mBAAmB,EACnB,aAAa,EAEb,YAAY,EAIZ,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/esm/utils/liquidation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ondo liquidation price estimation.
+ *
+ * The LI.FI backend surfaces Ondo's per-market maintenance margin rate on the
+ * generic {@link PerpsMarket} as `maintenanceMarginRate`. The estimate is the
+ * standard isolated-margin model parameterised by that rate.
+ */
+import { type LiquidationEstimateParams } from '@lifi/perps-sdk';
+import type { PerpsMarket } from '@lifi/perps-types';
+/**
+ * Estimate the liquidation price of a new position on an Ondo market.
+ *
+ * @returns The estimated liquidation price, or `undefined` when
+ *   `market.maintenanceMarginRate` is absent (the model cannot be evaluated
+ *   without the venue's maintenance margin rate) or the inputs are
+ *   degenerate.
+ * @public
+ */
+export declare function estimateLiquidationPrice(market: PerpsMarket, params: LiquidationEstimateParams): number | undefined;
+//# sourceMappingURL=liquidation.d.ts.map

package/dist/esm/utils/liquidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../src/utils/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,yBAAyB,GAChC,MAAM,GAAG,SAAS,CAUpB"}

package/dist/esm/utils/liquidation.js

@@ -0,0 +1,29 @@
+/**
+ * Ondo liquidation price estimation.
+ *
+ * The LI.FI backend surfaces Ondo's per-market maintenance margin rate on the
+ * generic {@link PerpsMarket} as `maintenanceMarginRate`. The estimate is the
+ * standard isolated-margin model parameterised by that rate.
+ */
+import { estimateIsolatedLiquidationPrice, } from '@lifi/perps-sdk';
+/**
+ * Estimate the liquidation price of a new position on an Ondo market.
+ *
+ * @returns The estimated liquidation price, or `undefined` when
+ *   `market.maintenanceMarginRate` is absent (the model cannot be evaluated
+ *   without the venue's maintenance margin rate) or the inputs are
+ *   degenerate.
+ * @public
+ */
+export function estimateLiquidationPrice(market, params) {
+    if (market.maintenanceMarginRate === undefined) {
+        return undefined;
+    }
+    return estimateIsolatedLiquidationPrice({
+        entryPrice: params.entryPrice,
+        leverage: params.leverage,
+        isLong: params.isLong,
+        maintenanceMarginRate: market.maintenanceMarginRate,
+    });
+}
+//# sourceMappingURL=liquidation.js.map

package/dist/esm/utils/liquidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.js","sourceRoot":"","sources":["../../../src/utils/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,gCAAgC,GAEjC,MAAM,iBAAiB,CAAA;AAGxB;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAmB,EACnB,MAAiC;IAEjC,IAAI,MAAM,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,gCAAgC,CAAC;QACtC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;KACpD,CAAC,CAAA;AACJ,CAAC"}