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

package/dist/esm/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/esm/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"}