@lifi/perps-sdk-provider-lighter 0.2.0-alpha.0

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

@@ -0,0 +1,51 @@
+import { type ActivityItem } from '@lifi/perps-types';
+/**
+ * Per-endpoint cursor envelope for Lighter activity pagination.
+ *
+ * Each key holds the upstream `cursor` / `next_cursor` 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. The encoding mirrors the LI.FI
+ * backend's wire format so cursors created by the backend remain usable.
+ * @public
+ */
+export interface LighterActivityCursor {
+    deposits?: string;
+    withdraws?: string;
+    fundings?: string;
+    liquidations?: string;
+    transfers?: 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 a `LighterActivityCursor` as the base64url-of-JSON cursor string
+ * Lighter widgets persist 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: LighterActivityCursor) => 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) => LighterActivityCursor | 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;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AAaD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,qBAAqB,KACzB,MAAM,GAAG,SAcX,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,GAAG,SAAS,KACzB,qBAAqB,GAAG,SA6C1B,CAAA"}

package/dist/esm/utils/activityCursor.js

@@ -0,0 +1,99 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+const CURSOR_KEYS = [
+    'deposits',
+    'withdraws',
+    'fundings',
+    'liquidations',
+    'transfers',
+];
+const isNonEmpty = (v) => typeof v === 'string' && v.length > 0;
+/**
+ * Encode a `LighterActivityCursor` as the base64url-of-JSON cursor string
+ * Lighter widgets persist 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 Lighter activity cursor: not base64url-encoded JSON');
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        throw new PerpsError(PerpsErrorCode.ValidationError, 'Invalid Lighter 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 Lighter 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 Lighter 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,65 @@
+import { PerpsError, type ResolvedRetryPolicy } from '@lifi/perps-sdk';
+/** @internal */
+export type ApiParams = Record<string, string | number | boolean>;
+/**
+ * Auth-gated read whose token Lighter rejected. Distinct from a generic
+ * {@link PerpsError} so callers can evict the stored read-only token and retry
+ * with a freshly-created one. Lighter signals this on either channel: an HTTP
+ * 401/403, or an HTTP 200 carrying an error `code` in the body.
+ * @internal
+ */
+export declare class LighterAuthRejectedError extends PerpsError {
+}
+/** @internal */
+export declare const LIGHTER_RETRY_DEFAULTS: ResolvedRetryPolicy;
+/** @internal */
+export interface LighterApiClientOptions {
+    signal?: AbortSignal;
+    policy?: ResolvedRetryPolicy;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * HTTP boundary against Lighter's REST API.
+ *
+ * Browser-direct by design: no LI.FI backend hop, no caching shim — caller
+ * supplies the REST base URL, the path, and any query params, and we return
+ * the parsed JSON body. Lighter advertises CORS headers on every public
+ * endpoint so a vanilla `fetch` from the widget works.
+ *
+ * Auth-gated endpoints (accountLimits, accountActiveOrders, deposit/history,
+ * withdraw/history, positionFunding, liquidations, transfer/history) take the
+ * Lighter read-only token as the `auth` query parameter — NOT as an
+ * `Authorization` header. This matches Lighter's OpenAPI spec and lets the
+ * same call work browser-direct and from server-side proxies.
+ *
+ * Lighter signals rate limiting via 429 OR 405 (documented behaviour) with a
+ * documented 60s firewall cooldown. The default {@link ResolvedRetryPolicy}
+ * waits long enough to avoid hammering through the cooldown.
+ * @public
+ */
+export declare class LighterApiClient {
+    private readonly baseUrl;
+    private readonly signal;
+    private readonly policy;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, options?: LighterApiClientOptions);
+    private buildUrl;
+    get<T>(path: string, params?: ApiParams): Promise<T>;
+    /**
+     * Auth-gated GET. The token is appended as the `auth` query parameter (per
+     * Lighter's OpenAPI spec); the `Authorization` header is intentionally NOT
+     * used — Lighter rejects it.
+     */
+    getAuthed<T>(path: string, authToken: string, params?: ApiParams): Promise<T>;
+    /**
+     * GET that surfaces the raw `{status, body}` pair without throwing on
+     * non-2xx — used for endpoints (account lookup by L1 address) where the
+     * caller distinguishes specific Lighter error codes from generic failures.
+     */
+    getWithStatus<T>(path: string, params?: ApiParams): Promise<{
+        status: number;
+        data: T;
+    }>;
+    private getChecked;
+}
+//# 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,EAEL,UAAU,EACV,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AAOxB,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAejE;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;CAAG;AAO3D,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,EAAE,mBAmBpC,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,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,uBAAuB;IAO9D,OAAO,CAAC,QAAQ;IAaV,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;;;OAIG;IACG,SAAS,CAAC,CAAC,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,SAAc,GACrB,OAAO,CAAC,CAAC,CAAC;IAoBb;;;;OAIG;IACG,aAAa,CAAC,CAAC,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;YAWzB,UAAU;CAiBzB"}

package/dist/esm/utils/apiClient.js

@@ -0,0 +1,131 @@
+import { fetchWithRetry, PerpsError, } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { LIGHTER_INVALID_AUTH_CODE, LIGHTER_SUCCESS_CODES, } from '../constants.js';
+/**
+ * Lighter signals errors on two channels: a non-2xx HTTP status, or an HTTP 200
+ * carrying an error `code` in the JSON body. Returns the body error `code` when
+ * the body advertises one that is not a success code, else `undefined`.
+ */
+const lighterBodyErrorCode = (data) => {
+    const code = data?.code;
+    if (code === undefined || LIGHTER_SUCCESS_CODES.has(code)) {
+        return undefined;
+    }
+    return code;
+};
+/**
+ * Auth-gated read whose token Lighter rejected. Distinct from a generic
+ * {@link PerpsError} so callers can evict the stored read-only token and retry
+ * with a freshly-created one. Lighter signals this on either channel: an HTTP
+ * 401/403, or an HTTP 200 carrying an error `code` in the body.
+ * @internal
+ */
+export class LighterAuthRejectedError extends PerpsError {
+}
+const isLighterAuthRejection = (status, data) => status === 401 ||
+    status === 403 ||
+    lighterBodyErrorCode(data) === LIGHTER_INVALID_AUTH_CODE;
+/** @internal */
+export const LIGHTER_RETRY_DEFAULTS = {
+    enabled: true,
+    maxAttempts: 2,
+    baseDelayMs: 10_000,
+    maxDelayMs: 60_000,
+    respectRetryAfter: true,
+    classify: ({ response }) => {
+        if (response.status === 429 || response.status === 405) {
+            return 'retry-rate-limit';
+        }
+        if (response.status === 502 ||
+            response.status === 503 ||
+            response.status === 504) {
+            return 'retry-server';
+        }
+        return 'fail';
+    },
+};
+/**
+ * HTTP boundary against Lighter's REST API.
+ *
+ * Browser-direct by design: no LI.FI backend hop, no caching shim — caller
+ * supplies the REST base URL, the path, and any query params, and we return
+ * the parsed JSON body. Lighter advertises CORS headers on every public
+ * endpoint so a vanilla `fetch` from the widget works.
+ *
+ * Auth-gated endpoints (accountLimits, accountActiveOrders, deposit/history,
+ * withdraw/history, positionFunding, liquidations, transfer/history) take the
+ * Lighter read-only token as the `auth` query parameter — NOT as an
+ * `Authorization` header. This matches Lighter's OpenAPI spec and lets the
+ * same call work browser-direct and from server-side proxies.
+ *
+ * Lighter signals rate limiting via 429 OR 405 (documented behaviour) with a
+ * documented 60s firewall cooldown. The default {@link ResolvedRetryPolicy}
+ * waits long enough to avoid hammering through the cooldown.
+ * @public
+ */
+export class LighterApiClient {
+    baseUrl;
+    signal;
+    policy;
+    fetchImpl;
+    constructor(baseUrl, options) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.signal = options?.signal;
+        this.policy = options?.policy ?? LIGHTER_RETRY_DEFAULTS;
+        this.fetchImpl = options?.fetchImpl;
+    }
+    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 get(path, params) {
+        return this.getChecked(path, params);
+    }
+    /**
+     * Auth-gated GET. The token is appended as the `auth` query parameter (per
+     * Lighter's OpenAPI spec); the `Authorization` header is intentionally NOT
+     * used — Lighter rejects it.
+     */
+    async getAuthed(path, authToken, params = {}) {
+        const { status, data } = await this.getWithStatus(path, {
+            ...params,
+            auth: authToken,
+        });
+        if (isLighterAuthRejection(status, data)) {
+            throw new LighterAuthRejectedError(PerpsErrorCode.ThirdPartyError, `Lighter rejected the auth token for ${path}`);
+        }
+        if (status < 200 || status >= 300) {
+            throw new PerpsError(PerpsErrorCode.ThirdPartyError, `Lighter API request failed: ${status} — ${JSON.stringify(data).slice(0, 200)}`);
+        }
+        return data;
+    }
+    /**
+     * GET that surfaces the raw `{status, body}` pair without throwing on
+     * non-2xx — used for endpoints (account lookup by L1 address) where the
+     * caller distinguishes specific Lighter error codes from generic failures.
+     */
+    async getWithStatus(path, params) {
+        const url = this.buildUrl(path, params);
+        const response = await fetchWithRetry(url, {}, { policy: this.policy, fetchImpl: this.fetchImpl, signal: this.signal });
+        const data = (await response.json().catch(() => undefined));
+        return { status: response.status, data };
+    }
+    async getChecked(path, params) {
+        const { status, data } = await this.getWithStatus(path, params);
+        if (status < 200 || status >= 300) {
+            throw new PerpsError(PerpsErrorCode.ThirdPartyError, `Lighter API request failed: ${status} — ${JSON.stringify(data).slice(0, 200)}`);
+        }
+        const errorCode = lighterBodyErrorCode(data);
+        if (errorCode !== undefined) {
+            throw new PerpsError(PerpsErrorCode.ThirdPartyError, `Lighter API error for ${path}: code ${errorCode} — ${JSON.stringify(data).slice(0, 200)}`);
+        }
+        return data;
+    }
+}
+//# 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/fetchDetailedAccount.d.ts

@@ -0,0 +1,11 @@
+import type { Address } from 'viem';
+import type { LtDetailedAccount } from '../types/index.js';
+import type { LighterApiClient } from './apiClient.js';
+/**
+ * Look up the Lighter account for an L1 address via `/api/v1/account`,
+ * discriminating Lighter's account-not-found body code from generic failures.
+ *
+ * @public
+ */
+export declare const fetchDetailedAccount: (client: LighterApiClient, address: Address) => Promise<LtDetailedAccount>;
+//# sourceMappingURL=fetchDetailedAccount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchDetailedAccount.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchDetailedAccount.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,gBAAgB,EACxB,SAAS,OAAO,KACf,OAAO,CAAC,iBAAiB,CA6B3B,CAAA"}

package/dist/esm/utils/fetchDetailedAccount.js

@@ -0,0 +1,24 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { LIGHTER_CODE_ACCOUNT_NOT_FOUND } from '../constants.js';
+/**
+ * Look up the Lighter account for an L1 address via `/api/v1/account`,
+ * discriminating Lighter's account-not-found body code from generic failures.
+ *
+ * @public
+ */
+export const fetchDetailedAccount = async (client, address) => {
+    const { status, data } = await client.getWithStatus('/api/v1/account', { by: 'l1_address', value: address });
+    if (status === 400 && data?.code === LIGHTER_CODE_ACCOUNT_NOT_FOUND) {
+        throw new PerpsError(PerpsErrorCode.AccountNotFound, `No Lighter account found for address: ${address}`);
+    }
+    if (status < 200 || status >= 300) {
+        throw new PerpsError(PerpsErrorCode.ThirdPartyError, `Lighter account request failed: ${status} — ${JSON.stringify(data).slice(0, 200)}`);
+    }
+    const accounts = data?.accounts;
+    if (accounts === undefined || accounts.length === 0) {
+        throw new PerpsError(PerpsErrorCode.AccountNotFound, `No Lighter account found for address: ${address}`);
+    }
+    return accounts[0];
+};
+//# sourceMappingURL=fetchDetailedAccount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchDetailedAccount.js","sourceRoot":"","sources":["../../../src/utils/fetchDetailedAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAIhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAwB,EACxB,OAAgB,EACY,EAAE;IAC9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAIhD,iBAAiB,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IAE3D,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,IAAI,KAAK,8BAA8B,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,yCAAyC,OAAO,EAAE,CACnD,CAAA;IACH,CAAC;IAED,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,mCAAmC,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACpF,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAA;IAC/B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,yCAAyC,OAAO,EAAE,CACnD,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAA;AACpB,CAAC,CAAA"}

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

@@ -0,0 +1,16 @@
+export type { LighterActivityCursor } from './activityCursor.js';
+export { decodeActivityCursor, encodeActivityCursor, } from './activityCursor.js';
+export { LighterApiClient } from './apiClient.js';
+export { fetchDetailedAccount } from './fetchDetailedAccount.js';
+export { lighterAsset } from './lighterAsset.js';
+export { estimateLiquidationPrice } from './liquidation.js';
+export { mapFill } from './mapFill.js';
+export { mapOpenPositions } from './mapOpenPositions.js';
+export { classifyAndMapOrders, isTriggerOrder, isTriggerType, mapOrder, mapOrderDetail, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapPosition } from './mapPosition.js';
+export { mapInterval } from './ohlcvInterval.js';
+export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+export { toIsoFromMs, toIsoFromSeconds } from './time.js';
+export type { ScaleToIntegerPolicy } from './wireEncoding.js';
+export { leverageToFraction, mapOrderTypeToInt, mapTimeInForceToInt, marginFractionToMaxLeverage, orderExpiryForTif, resolveTimeInForce, scaleToInteger, } from './wireEncoding.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":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAA"}

package/dist/esm/utils/index.js

@@ -0,0 +1,17 @@
+// biome-ignore-all lint/performance/noBarrelFile: single re-export entry point
+// for the package's utility surface. Internal modules import per-file paths
+// (e.g. `./apiClient.js`, `./mapFill.js`) directly.
+export { decodeActivityCursor, encodeActivityCursor, } from './activityCursor.js';
+export { LighterApiClient } from './apiClient.js';
+export { fetchDetailedAccount } from './fetchDetailedAccount.js';
+export { lighterAsset } from './lighterAsset.js';
+export { estimateLiquidationPrice } from './liquidation.js';
+export { mapFill } from './mapFill.js';
+export { mapOpenPositions } from './mapOpenPositions.js';
+export { classifyAndMapOrders, isTriggerOrder, isTriggerType, mapOrder, mapOrderDetail, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapPosition } from './mapPosition.js';
+export { mapInterval } from './ohlcvInterval.js';
+export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+export { toIsoFromMs, toIsoFromSeconds } from './time.js';
+export { leverageToFraction, mapOrderTypeToInt, mapTimeInForceToInt, marginFractionToMaxLeverage, orderExpiryForTif, resolveTimeInForce, scaleToInteger, } from './wireEncoding.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,+EAA+E;AAC/E,4EAA4E;AAC5E,oDAAoD;AAGpD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEzD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAA"}

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

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

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

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

package/dist/esm/utils/lighterAsset.js

@@ -0,0 +1,9 @@
+import { LIGHTER_PROVIDER_KEY } from '../constants.js';
+/** @public */
+export const lighterAsset = (id, displaySymbol) => ({
+    providerId: LIGHTER_PROVIDER_KEY,
+    id,
+    displaySymbol,
+    logoURI: '',
+});
+//# sourceMappingURL=lighterAsset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lighterAsset.js","sourceRoot":"","sources":["../../../src/utils/lighterAsset.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtD,cAAc;AACd,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,aAAqB,EAAS,EAAE,CAAC,CAAC;IACzE,UAAU,EAAE,oBAAoB;IAChC,EAAE;IACF,aAAa;IACb,OAAO,EAAE,EAAE;CACZ,CAAC,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Lighter liquidation price estimation.
+ *
+ * Lighter publishes a flat per-market `maintenance_margin_fraction` on its
+ * order books, surfaced 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 isolated position on a Lighter
+ * 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;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;GASG;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,31 @@
+/**
+ * Lighter liquidation price estimation.
+ *
+ * Lighter publishes a flat per-market `maintenance_margin_fraction` on its
+ * order books, surfaced 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 isolated position on a Lighter
+ * 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;;;;;;;GAOG;AAEH,OAAO,EACL,gCAAgC,GAEjC,MAAM,iBAAiB,CAAA;AAGxB;;;;;;;;;GASG;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"}

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

@@ -0,0 +1,10 @@
+import type { Fill, MarketDisplay } from '@lifi/perps-types';
+import type { LtTrade } from '../types/index.js';
+/**
+ * Map a raw Lighter trade to the generic Fill type.
+ * @param accountIndex - The viewer's Lighter account index (selects buy/sell side and maker/taker role).
+ * @param market - Backend-resolved market identity for `trade.market_id`.
+ * @public
+ */
+export declare const mapFill: (trade: LtTrade, accountIndex: number, market: MarketDisplay) => Fill;
+//# sourceMappingURL=mapFill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapFill.d.ts","sourceRoot":"","sources":["../../../src/utils/mapFill.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAQ5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAyChD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,QAAQ,aAAa,KACpB,IA2CF,CAAA"}

package/dist/esm/utils/mapFill.js

@@ -0,0 +1,72 @@
+import { classifyFillFromPosition, ExplorerChainId, explorerTxUrl, } from '@lifi/perps-sdk';
+import { FillStatus, LiquidityRole, OrderSide, OrderType, } from '@lifi/perps-types';
+import Big from 'big.js';
+/**
+ * Realized PnL on a position-reducing fill, derived from the pre-trade entry
+ * basis. Returns `undefined` for opens/increases (nothing closes) or when the
+ * entry-quote snapshot is absent, and `null` when the closed portion realizes
+ * exactly zero — mirroring the Hyperliquid mapper's `null`-for-zero convention.
+ */
+const deriveRealizedPnl = (startPosition, entryQuoteBefore, fillSize, fillPrice, isBuyer) => {
+    if (entryQuoteBefore === undefined) {
+        return undefined;
+    }
+    const start = new Big(startPosition);
+    if (start.eq(0)) {
+        return undefined;
+    }
+    const isLong = start.gt(0);
+    const reducing = isLong ? !isBuyer : isBuyer;
+    if (!reducing) {
+        return undefined;
+    }
+    const absStart = start.abs();
+    const fill = new Big(fillSize);
+    // A fill larger than the open size flips the position; only the portion that
+    // unwinds the existing position realizes PnL.
+    const closedSize = fill.gt(absStart) ? absStart : fill;
+    const avgEntry = new Big(entryQuoteBefore).abs().div(absStart);
+    const price = new Big(fillPrice);
+    const pnl = isLong
+        ? price.minus(avgEntry).times(closedSize)
+        : avgEntry.minus(price).times(closedSize);
+    return pnl.eq(0) ? null : pnl.toString();
+};
+/**
+ * Map a raw Lighter trade to the generic Fill type.
+ * @param accountIndex - The viewer's Lighter account index (selects buy/sell side and maker/taker role).
+ * @param market - Backend-resolved market identity for `trade.market_id`.
+ * @public
+ */
+export const mapFill = (trade, accountIndex, market) => {
+    const isBuyer = trade.bid_account_id === accountIndex;
+    const isMaker = (trade.is_maker_ask && !isBuyer) || (!trade.is_maker_ask && isBuyer);
+    // Lighter publishes both counterparties' position-before snapshots on every
+    // trade row; reading the wrong one mis-classifies when they differ.
+    const startPosition = isMaker
+        ? trade.maker_position_size_before
+        : trade.taker_position_size_before;
+    const entryQuoteBefore = isMaker
+        ? trade.maker_entry_quote_before
+        : trade.taker_entry_quote_before;
+    return {
+        id: trade.trade_id.toString(),
+        orderId: String(isBuyer ? trade.bid_id : trade.ask_id),
+        market,
+        side: isBuyer ? OrderSide.BUY : OrderSide.SELL,
+        type: OrderType.LIMIT,
+        size: trade.size,
+        price: trade.price,
+        status: FillStatus.FILLED,
+        liquidity: isMaker ? LiquidityRole.MAKER : LiquidityRole.TAKER,
+        fee: isMaker ? trade.maker_fee?.toString() : trade.taker_fee?.toString(),
+        realizedPnl: deriveRealizedPnl(startPosition, entryQuoteBefore, trade.size, trade.price, isBuyer),
+        startPosition,
+        // `classifyFillFromPosition` takes an HL-encoded side: `'B'` for buy,
+        // anything else for sell.
+        classification: classifyFillFromPosition(startPosition, isBuyer ? 'B' : 'A', trade.size),
+        createdAt: new Date(trade.timestamp).toISOString(),
+        explorerLink: explorerTxUrl(ExplorerChainId.LIGHTER, trade.tx_hash),
+    };
+};
+//# sourceMappingURL=mapFill.js.map