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

package/dist/types/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/types/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/types/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/types/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/types/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/types/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/types/utils/mapActivity.d.ts

@@ -0,0 +1,21 @@
+import type { FundingActivity, LiquidationActivity, MarketDisplay } from '@lifi/perps-types';
+import type { OndoFundingFeeTransfer, OndoLiquidationEvent } from '../types/wire.js';
+/**
+ * Map an Ondo funding-fee transfer to a {@link FundingActivity}. Ondo carries
+ * no transfer id on the wire, so a deterministic `funding:<market>:<ISO time>`
+ * id is synthesized — funding settles at most once per market per interval,
+ * so the pair is unique.
+ *
+ * @param market - Backend-resolved market identity for `transfer.market`.
+ * @public
+ */
+export declare const mapFundingActivity: (transfer: OndoFundingFeeTransfer, market: MarketDisplay) => FundingActivity;
+/**
+ * Map an Ondo liquidation event to a {@link LiquidationActivity}. Ondo does
+ * not report the account value at liquidation time, and its margin accounts
+ * are cross-only, so `accountValue` is `'0'` and `leverageType` is `'cross'`.
+ *
+ * @public
+ */
+export declare const mapLiquidationActivity: (event: OndoLiquidationEvent, resolveMarket: (market: string) => MarketDisplay) => LiquidationActivity;
+//# sourceMappingURL=mapActivity.d.ts.map

package/dist/types/utils/mapActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapActivity.d.ts","sourceRoot":"","sources":["../../../src/utils/mapActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,kBAAkB,CAAA;AAEzB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,sBAAsB,EAChC,QAAQ,aAAa,KACpB,eAYF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,oBAAoB,EAC3B,eAAe,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,KAC/C,mBAYD,CAAA"}

package/dist/types/utils/mapFill.d.ts

@@ -0,0 +1,12 @@
+import type { Fill, MarketDisplay } from '@lifi/perps-types';
+import type { OndoFill } from '../types/wire.js';
+/**
+ * Map a raw Ondo fill to the generic {@link Fill}. The fee is netted against
+ * Ondo's `feeRebate`; when the wire `direction` is absent the classification
+ * falls back to the fill side.
+ *
+ * @param market - Backend-resolved market identity for `fill.market`.
+ * @public
+ */
+export declare const mapFill: (fill: OndoFill, market: MarketDisplay) => Fill;
+//# sourceMappingURL=mapFill.d.ts.map

package/dist/types/utils/mapFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFill.d.ts","sourceRoot":"","sources":["../../../src/utils/mapFill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAQ5D,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,kBAAkB,CAAA;AAYnE;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,QAAQ,EAAE,QAAQ,aAAa,KAAG,IAkB9D,CAAA"}

package/dist/types/utils/mapOrder.d.ts

@@ -0,0 +1,50 @@
+import type { MarketDisplay, OpenOrder, Order, TriggerOrder } from '@lifi/perps-types';
+import { OrderStatus, OrderType } from '@lifi/perps-types';
+import type { OndoOrder, OndoOrderStatus, OndoOrderType } from '../types/wire.js';
+/** @public */
+export declare const mapOrderType: (type: OndoOrderType) => OrderType;
+/**
+ * Map Ondo's order status onto the generic enum. `untriggered` stop orders
+ * are active resting orders from the trader's point of view, so they map to
+ * OPEN.
+ * @public
+ */
+export declare const mapOrderStatus: (status: OndoOrderStatus) => OrderStatus;
+/**
+ * Plain-English `statusReason` for a cancelled order; `undefined` for every
+ * other status. Unknown wire reasons fall back to the generic sentence rather
+ * than leaking raw enum values into the UI.
+ * @public
+ */
+export declare const mapStatusReason: (order: OndoOrder) => string | undefined;
+/**
+ * Whether an order rests on a trigger. Checks `stopOrderType` and
+ * `triggerPrice` besides the type so a lagging `type` field cannot
+ * misclassify a trigger as a plain order.
+ * @public
+ */
+export declare const isTriggerOrder: (order: OndoOrder) => boolean;
+/** Map an active non-trigger Ondo order to an {@link OpenOrder}. @public */
+export declare const mapOrder: (order: OndoOrder, market: MarketDisplay) => OpenOrder;
+/** Map an active trigger Ondo order to a {@link TriggerOrder}. @public */
+export declare const mapTriggerOrder: (order: OndoOrder, market: MarketDisplay) => TriggerOrder;
+/**
+ * Bucket a venue order list into active open/trigger orders (mapped) and
+ * terminal order ids. Orders whose market the resolver does not know are
+ * skipped.
+ * @public
+ */
+export declare const classifyAndMapOrders: (orders: OndoOrder[], resolveMarket: (market: string) => MarketDisplay | undefined) => {
+    openOrders: OpenOrder[];
+    triggerOrders: TriggerOrder[];
+    terminated: string[];
+};
+/**
+ * Map a single venue order onto the rich {@link Order} detail shape.
+ * `remainingSize` and `averagePrice` are derived (`size − filledSize`,
+ * `filledCost ÷ filledSize`); `updatedAt` is the latest transition timestamp
+ * Ondo exposes, falling back to `createdAt`.
+ * @public
+ */
+export declare const mapOrderDetail: (order: OndoOrder, market: MarketDisplay) => Order;
+//# sourceMappingURL=mapOrder.d.ts.map

package/dist/types/utils/mapOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,kBAAkB,CAAA;AAOzB,cAAc;AACd,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,KAAG,SAWlD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,eAAe,KAAG,WAYxD,CAAA;AASD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,KAAG,MAAM,GAAG,SAK3D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,KAAG,OAIhB,CAAA;AAElC,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,GACnB,OAAO,SAAS,EAChB,QAAQ,aAAa,KACpB,SAUD,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAC1B,OAAO,SAAS,EAChB,QAAQ,aAAa,KACpB,YAOD,CAAA;AAOF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,SAAS,EAAE,EACnB,eAAe,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KAC3D;IACD,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAA;CAqBrB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,EAChB,QAAQ,aAAa,KACpB,KA+BF,CAAA"}

package/dist/types/utils/mapPosition.d.ts

@@ -0,0 +1,19 @@
+import type { MarketDisplay, Position } from '@lifi/perps-types';
+import type { OndoPosition } from '../types/wire.js';
+/**
+ * Map a raw Ondo position to the generic Position type. Ondo margin accounts
+ * are cross-margined only.
+ *
+ * @param market - Backend-resolved market identity for `pos.market`.
+ * @public
+ */
+export declare const mapPosition: (pos: OndoPosition, market: MarketDisplay) => Position;
+/**
+ * Map raw Ondo positions to open {@link Position}s, dropping neutral and
+ * zero-quantity rows. Only valid for payloads carrying the full position
+ * set — dropping zeros from a partial frame would make closes unobservable.
+ *
+ * @public
+ */
+export declare const mapOpenPositions: (positions: OndoPosition[], resolveMarket: (market: string) => MarketDisplay) => Position[];
+//# sourceMappingURL=mapPosition.d.ts.map

package/dist/types/utils/mapPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,YAAY,EACjB,QAAQ,aAAa,KACpB,QAWD,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,WAAW,YAAY,EAAE,EACzB,eAAe,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,KAC/C,QAAQ,EAK6C,CAAA"}

package/dist/types/utils/ohlcvInterval.d.ts

@@ -0,0 +1,11 @@
+import type { OhlcvInterval } from '@lifi/perps-types';
+/** @public */
+export declare const mapInterval: (interval: string) => string;
+/**
+ * Recover the SDK interval from a kline frame's bar span in seconds. Ondo's
+ * kline updates carry no resolution field — only the interval start/end —
+ * so the span is the only way to route a frame to its subscription.
+ * @public
+ */
+export declare const intervalFromBarSpan: (spanSecs: number) => OhlcvInterval | undefined;
+//# sourceMappingURL=ohlcvInterval.d.ts.map

package/dist/types/utils/ohlcvInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcvInterval.d.ts","sourceRoot":"","sources":["../../../src/utils/ohlcvInterval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAoCtD,cAAc;AACd,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,MAU9C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,KACf,aAAa,GAAG,SAUlB,CAAA"}

package/dist/types/utils/ondoAsset.d.ts

@@ -0,0 +1,4 @@
+import type { Asset } from '@lifi/perps-types';
+/** @public */
+export declare const ondoAsset: (id: string, displaySymbol: string) => Asset;
+//# sourceMappingURL=ondoAsset.d.ts.map

package/dist/types/utils/ondoAsset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ondoAsset.d.ts","sourceRoot":"","sources":["../../../src/utils/ondoAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG9C,cAAc;AACd,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,EAAE,eAAe,MAAM,KAAG,KAK5D,CAAA"}

package/dist/types/utils/orderFormatting.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Ondo order size and price formatting for exchange submission.
+ *
+ * Ondo's tick and lot grids are exact contract increments (`quoteIncrement` /
+ * `baseIncrement`) that need not be powers of ten. When the generic
+ * {@link Market} carries the raw increment (`priceIncrement` / `sizeIncrement`)
+ * these helpers snap onto that grid; otherwise they fall back to the
+ * power-of-ten grid implied by `priceDecimals` / `szDecimals`. Prices round
+ * half-up to the nearest tick; sizes truncate toward zero to the lot.
+ */
+import { type Market } from '@lifi/perps-types';
+/**
+ * Format a price onto an Ondo market's tick grid: snapped half-up to the
+ * nearest `priceIncrement` (or the grid implied by `priceDecimals`), trailing
+ * zeros stripped.
+ *
+ * @throws {PerpsError} `ValidationError` when the market carries neither
+ *   `priceIncrement` nor `priceDecimals` — without the venue's tick grid no
+ *   correct price can be produced.
+ * @public
+ */
+export declare function formatOrderPrice(market: Market, price: number): string;
+/**
+ * Format a size onto an Ondo market's lot grid: truncated toward zero (never
+ * rounded up, so the size cannot exceed the user's balance) to the market's
+ * `sizeIncrement` (or the grid implied by `szDecimals`), trailing zeros
+ * stripped.
+ *
+ * @param size - Size in base-asset units as a non-negative magnitude.
+ * @public
+ */
+export declare function formatOrderSize(market: Market, size: number): string;
+//# sourceMappingURL=orderFormatting.d.ts.map

package/dist/types/utils/orderFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,mBAAmB,CAAA;AAmB/D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUpE"}

package/dist/types/websocket/OndoWsProvider.d.ts

@@ -0,0 +1,122 @@
+import { type PerpsSDKClient, type ProviderGetQuoteParams, type QuoteListener, type StorageAdapter, WsProviderBase, type WsProviderFactory } from '@lifi/perps-sdk';
+import type { Subscription } from '@lifi/perps-types';
+import type { Address } from 'viem';
+interface SubState {
+    /** Subscribe payload minus `op` — re-sent verbatim on every (re)open. */
+    frame: {
+        channel: string;
+        markets?: string[];
+        resolution?: string;
+    };
+    needsAuth: boolean;
+    address?: Address;
+}
+/**
+ * Options for {@link ondoWsProvider} / {@link OndoWsProvider}.
+ *
+ * @public
+ */
+export interface OndoWsProviderOptions {
+    /**
+     * Ondo REST base URL — namespaces the session-token lookup, so it must
+     * match the `apiUrl` the SIWE login stored the token under. Defaults to
+     * production.
+     */
+    apiUrl?: string;
+    /** Session-token persistence backend. Defaults to browser `localStorage`. */
+    storage?: StorageAdapter;
+}
+/**
+ * Ondo realtime WS provider (extends {@link WsProviderBase}): subscribes to
+ * Ondo's WS channels (orderbook, trades, candles, market context, orders,
+ * fills, positions), logging in with the stored SIWE session JWT for the
+ * account channels. Construct via {@link ondoWsProvider}.
+ *
+ * @public
+ */
+export declare class OndoWsProvider extends WsProviderBase<SubState> {
+    private readonly tokenStore;
+    private readonly client;
+    private readonly registry;
+    private readonly apiUrl;
+    /**
+     * Ref count per shared authenticated wire channel (`positionsPerps`,
+     * `fillsPerps`, `ordersPerps`): `positions`/`fills` and the derived
+     * `accountSummary` ride the same wire subs, so neither's teardown may
+     * unsubscribe one the other still holds.
+     */
+    private readonly authWireRefs;
+    /**
+     * Running account-summary inputs while `accountSummary` is subscribed
+     * (`undefined` otherwise). `walletBalance` is REST-seeded and refreshed on
+     * fills; `marginUsed`/`unrealizedPnl` track the latest positions frame.
+     */
+    private accountSummary;
+    /** Complete (mark-price-bearing) contexts, keyed by venue market symbol. */
+    private contexts;
+    /** Funding seen before the market's first mark price. */
+    private pendingFunding;
+    /** The single address this connection's login is bound to. */
+    private accountAddress;
+    private loginPromise;
+    constructor(wsUrl?: string, providerKey?: string, options?: OndoWsProviderOptions, client?: PerpsSDKClient);
+    subscribeQuote(params: ProviderGetQuoteParams, onQuote: QuoteListener): Promise<() => void>;
+    protected toKey(sub: Subscription): string;
+    protected openChannel(sub: Subscription): Promise<() => void>;
+    /** Register a wire sub, ref-counting the shared authenticated channels. */
+    private acquireWire;
+    /** Mirror of {@link acquireWire}: drop the wire sub on its last release. */
+    private releaseWire;
+    protected sendSubscribe(state: SubState): Promise<void>;
+    protected onClose(): void;
+    /** Wire subs for `sub`, keyed uniquely for the base's replay registry. */
+    private resolveChannel;
+    /**
+     * Send the login op once per connection, before the first authenticated
+     * subscribe. Concurrent callers share one in-flight login; a failure
+     * clears the guard so a later subscribe (after a fresh SIWE login) retries.
+     */
+    private ensureLogin;
+    private restClient;
+    /**
+     * Seed the account-summary inputs from the REST balance so the first emit is
+     * complete before any positions frame lands. Throws {@link
+     * OndoSessionExpiredError} when the SIWE session is missing, matching the
+     * other authenticated channels.
+     */
+    private seedAccountSummary;
+    /** Re-pull the wallet balance (moved by the fill) and re-emit the summary. */
+    private refreshAccountSummaryBalance;
+    /**
+     * Emit the current account summary. Gross semantics: `walletBalance` is the
+     * collateral, the positions carry unrealized PnL, so it counts toward buying
+     * power (`availableMargin = walletBalance + unrealizedPnl − marginUsed`).
+     */
+    private emitAccountSummary;
+    protected handleMessage(raw: string): void;
+    private handleBooks;
+    private handleTrades;
+    private handleKline;
+    private handleMarkPrices;
+    private handleFundingRates;
+    private emitContexts;
+    /** Registry-backed market identity, or `undefined` off the tradable list. */
+    private resolveMarket;
+    private handleOrders;
+    private handleFills;
+    private handlePositions;
+}
+/**
+ * Factory for registering the Ondo WS provider with `PerpsWsClient`:
+ * `new PerpsWsClient(client, { wsProviders: { ondo: ondoWsProvider() } })`.
+ *
+ * Closes over the per-instance options (storage, apiUrl override) so
+ * `PerpsWsClient` can call the returned factory with just
+ * `({ provider, wsUrl, client })` at subscribe time. `markets` is unused —
+ * Ondo advertises a single venue, no sub-DEX filtering.
+ *
+ * @public
+ */
+export declare const ondoWsProvider: (options?: OndoWsProviderOptions) => WsProviderFactory;
+export {};
+//# sourceMappingURL=OndoWsProvider.d.ts.map

package/dist/types/websocket/OndoWsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OndoWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/OndoWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAGlB,KAAK,cAAc,EAEnB,cAAc,EACd,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAwDnC,UAAU,QAAQ;IAChB,yEAAyE;IACzE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IAEzD;;;;OAIG;IACH,OAAO,CAAC,cAAc,CAET;IAEb,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAoC;IACpD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAGnB;IAEH,8DAA8D;IAC9D,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,YAAY,CAA2B;gBAG7C,KAAK,GAAE,MAA4B,EACnC,WAAW,SAAoB,EAC/B,OAAO,GAAE,qBAA0B,EACnC,MAAM,CAAC,EAAE,cAAc;IAmBnB,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;IAkBtB,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;cAqB1B,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAgDnE,2EAA2E;YAC7D,WAAW;IAsBzB,4EAA4E;IAC5E,OAAO,CAAC,WAAW;cAaH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;cAO1C,OAAO,IAAI,IAAI;IAMlC,0EAA0E;IAC1E,OAAO,CAAC,cAAc;IAyGtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,UAAU;IAMlB;;;;;OAKG;YACW,kBAAkB;IAmBhC,8EAA8E;YAChE,4BAA4B;IAiB1C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAkB1B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA+C1C,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,YAAY;IAgBpB,6EAA6E;IAC7E,OAAO,CAAC,aAAa,CAGpB;IAED,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,eAAe;CA2BxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GACxB,UAAU,qBAAqB,KAAG,iBAEmB,CAAA"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@lifi/perps-sdk-provider-ondo",
+  "version": "0.0.0-preview-7ff840c",
+  "description": "Ondo Perps provider plugin for @lifi/perps-sdk",
+  "homepage": "https://github.com/lifinance/perps-sdk",
+  "bugs": {
+    "url": "https://github.com/lifinance/perps-sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lifinance/perps-sdk.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Aaron Boyd <aaron@li.finance>",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "typings": "./dist/types/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**",
+    "!dist/**/*.tsbuildinfo",
+    "src/**/*.ts",
+    "!src/**/*.spec.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.mock.ts",
+    "!src/**/*.handlers.ts",
+    "!src/**/*.tsbuildinfo",
+    "!**/__mocks__/**",
+    "!*.tmp",
+    "!*.env",
+    "!tsconfig.json"
+  ],
+  "dependencies": {
+    "big.js": "^7.0.1",
+    "viem": "^2.48.8",
+    "@lifi/perps-types": "^0.0.0-preview-7ff840c"
+  },
+  "peerDependencies": {
+    "@lifi/perps-sdk": "^0.0.0-preview-7ff840c"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "perps",
+    "perpetuals",
+    "trading",
+    "defi",
+    "lifi",
+    "sdk",
+    "viem",
+    "ondo"
+  ]
+}