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

package/dist/cjs/websocket/LighterWsProvider.d.ts

@@ -0,0 +1,45 @@
+import { type PerpsSDKClient, type ProviderGetQuoteParams, type QuoteListener, WsProviderBase, type WsProviderFactory } from '@lifi/perps-sdk';
+import type { Subscription } from '@lifi/perps-types';
+import type { Address } from 'viem';
+export type LighterAuthProvider = (address: Address) => Promise<string | undefined>;
+interface SubState {
+    channel: string;
+    address?: Address;
+    needsAuth: boolean;
+}
+export interface LighterWsProviderOptions {
+    restUrl?: string;
+    authProvider?: LighterAuthProvider;
+}
+export declare class LighterWsProvider extends WsProviderBase<SubState> {
+    private readonly api;
+    private readonly authProvider;
+    private readonly client;
+    private readonly orderbooks;
+    private lastPricesByAssetId;
+    private readonly positionsByAddress;
+    private readonly registry;
+    private readonly accountIndexCache;
+    private readonly accountIndexPromises;
+    constructor(wsUrl?: string, providerKey?: string, options?: LighterWsProviderOptions, client?: PerpsSDKClient);
+    subscribeQuote(params: ProviderGetQuoteParams, onQuote: QuoteListener): Promise<() => void>;
+    protected openChannel(sub: Subscription): Promise<() => void>;
+    protected onClose(): void;
+    protected sendSubscribe({ channel, needsAuth, address, }: SubState): Promise<void>;
+    protected toKey(sub: Subscription): string;
+    private resolveChannel;
+    private resolveAccountIndex;
+    private fetchAccountIndex;
+    protected handleMessage(raw: string): void;
+    private dispatch;
+    private handleAccountOrders;
+    private handleAccountTrades;
+    private handleAccountPositions;
+    private addressFromChannel;
+    private handleMarketStats;
+    private handleOrderBook;
+    private marketIdFromChannel;
+}
+export declare const lighterWsProvider: (options?: LighterWsProviderOptions) => WsProviderFactory;
+export {};
+//# sourceMappingURL=LighterWsProvider.d.ts.map

package/dist/cjs/websocket/LighterWsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LighterWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/LighterWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAIlB,cAAc,EACd,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AA0EnC,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;AAEhC,UAAU,QAAQ;IAEhB,OAAO,EAAE,MAAM,CAAA;IAEf,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,SAAS,EAAE,OAAO,CAAA;CACnB;AAaD,MAAM,WAAW,wBAAwB;IAEvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAMhB,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AASD,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,mBAAmB,CAA6B;IAOxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAE9E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqC;gBAGxE,KAAK,GAAE,MAAuB,EAC9B,WAAW,SAAY,EACvB,OAAO,GAAE,wBAA6B,EACtC,MAAM,CAAC,EAAE,cAAc;IAmBnB,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;cA4ChD,OAAO,IAAI,IAAI;cAMlB,aAAa,CAAC,EAC5B,OAAO,EACP,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB3B,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;YAqB5B,cAAc;YAmDd,mBAAmB;YAqBnB,iBAAiB;IAK/B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqB1C,OAAO,CAAC,QAAQ;IA+DhB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,sBAAsB;IAwC9B,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,mBAAmB;CAW5B;AAuGD,eAAO,MAAM,iBAAiB,GAC3B,UAAU,wBAAwB,KAAG,iBAEmB,CAAA"}

package/dist/cjs/websocket/LighterWsProvider.js

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lighterWsProvider = exports.LighterWsProvider = void 0;
+const perps_sdk_1 = require("@lifi/perps-sdk");
+const constants_js_1 = require("../constants.js");
+const apiClient_js_1 = require("../utils/apiClient.js");
+const index_js_1 = require("../utils/index.js");
+const DEFAULT_WS_URL = 'wss://mainnet.zklighter.elliot.ai/stream';
+const DEFAULT_REST_URL = 'https://mainnet.zklighter.elliot.ai';
+const LIGHTER_AUTH_CHANNEL = {
+    orderUpdates: 'account_all_orders',
+    fills: 'account_all_trades',
+    positions: 'account_all_positions',
+};
+function channelNeedsMarkets(channel) {
+    return (channel === 'orderUpdates' || channel === 'fills' || channel === 'positions');
+}
+class LighterWsProvider extends perps_sdk_1.WsProviderBase {
+    api;
+    authProvider;
+    client;
+    orderbooks = new Map();
+    lastPricesByAssetId = {};
+    positionsByAddress = new Map();
+    registry;
+    accountIndexCache = new Map();
+    accountIndexPromises = new Map();
+    constructor(wsUrl = DEFAULT_WS_URL, providerKey = 'lighter', options = {}, client) {
+        super(new perps_sdk_1.ReconnectingWebSocket(wsUrl, { pingPayload: '{"type":"ping"}' }), providerKey);
+        this.api = new apiClient_js_1.LighterApiClient(options.restUrl ?? DEFAULT_REST_URL, {
+            policy: (0, perps_sdk_1.resolveRetryPolicy)(apiClient_js_1.LIGHTER_RETRY_DEFAULTS, client?.config.retry, constants_js_1.LIGHTER_PROVIDER_KEY),
+            fetchImpl: client?.config.fetch,
+        });
+        this.authProvider = options.authProvider;
+        this.client = client;
+        this.registry = client && (0, perps_sdk_1.getMarketRegistry)(client, providerKey);
+    }
+    async subscribeQuote(params, onQuote) {
+        const client = this.client;
+        if (client === undefined) {
+            throw new Error('LighterWsProvider: PerpsSDKClient not provided; cannot stream quotes. ' +
+                'Construct via `lighterWsProvider({...})` and register with PerpsWsClient.');
+        }
+        return (0, perps_sdk_1.resolveSubscribeQuote)(client, this.providerKey, this, params, constants_js_1.LIGHTER_BASE_FEE_TIER, onQuote);
+    }
+    async openChannel(sub) {
+        if (sub.channel === 'candle') {
+            return () => { };
+        }
+        if (channelNeedsMarkets(sub.channel)) {
+            await this.registry?.sync();
+        }
+        const wireChannels = await this.resolveChannel(sub);
+        for (const { channel, needsAuth, address } of wireChannels) {
+            await this.registerSub(channel, { channel, needsAuth, address });
+        }
+        await this.rws.ready();
+        return () => {
+            for (const { channel } of wireChannels) {
+                this.unregisterSub(channel);
+                this.rws.send(JSON.stringify({ type: 'unsubscribe', channel }));
+            }
+            if (sub.channel === 'orderbook') {
+                const id = Number(sub.marketId);
+                if (Number.isFinite(id)) {
+                    this.orderbooks.delete(id);
+                }
+            }
+            if (sub.channel === 'positions') {
+                this.positionsByAddress.delete(sub.address.toLowerCase());
+            }
+        };
+    }
+    onClose() {
+        this.orderbooks.clear();
+        this.lastPricesByAssetId = {};
+        this.positionsByAddress.clear();
+    }
+    async sendSubscribe({ channel, needsAuth, address, }) {
+        const payload = {
+            type: 'subscribe',
+            channel,
+        };
+        if (needsAuth) {
+            if (!this.authProvider || !address) {
+                throw new Error(`Lighter WS channel '${channel}' requires authentication but no authProvider was supplied.`);
+            }
+            const token = await this.authProvider(address);
+            if (!token) {
+                throw new Error(`Lighter WS channel '${channel}' requires authentication but no token was available for ${address}.`);
+            }
+            payload.auth = token;
+        }
+        this.rws.send(JSON.stringify(payload));
+    }
+    toKey(sub) {
+        switch (sub.channel) {
+            case 'prices':
+                return 'prices';
+            case 'orderbook':
+                return `orderbook:${sub.marketId}`;
+            case 'orderUpdates':
+                return `orderUpdates:${sub.address.toLowerCase()}`;
+            case 'fills':
+                return `fills:${sub.address.toLowerCase()}`;
+            case 'positions':
+                return `positions:${sub.address.toLowerCase()}`;
+            case 'candle':
+                return `candle:${sub.marketId}:${sub.interval}`;
+            case 'spotBalances':
+                throw new Error(`Lighter WS does not support channel: ${sub.channel}.`);
+        }
+    }
+    async resolveChannel(sub) {
+        if (sub.channel === 'prices') {
+            return [
+                { channel: 'market_stats/all', needsAuth: false },
+                { channel: 'spot_market_stats/all', needsAuth: false },
+            ];
+        }
+        if (sub.channel === 'orderbook') {
+            const id = Number(sub.marketId);
+            if (!Number.isFinite(id)) {
+                throw new Error(`Lighter WS: unknown market for marketId '${sub.marketId}'. ` +
+                    'MarketId must be a numeric market_id string.');
+            }
+            return [{ channel: `order_book/${id}`, needsAuth: false }];
+        }
+        if (sub.channel === 'orderUpdates' ||
+            sub.channel === 'fills' ||
+            sub.channel === 'positions') {
+            const accountIndex = await this.resolveAccountIndex(sub.address);
+            const lighterChannel = LIGHTER_AUTH_CHANNEL[sub.channel];
+            const needsAuth = sub.channel !== 'fills';
+            return [
+                {
+                    channel: `${lighterChannel}/${accountIndex}`,
+                    needsAuth,
+                    address: sub.address,
+                },
+            ];
+        }
+        throw new Error(`Lighter WS does not support channel: ${sub.channel}.`);
+    }
+    async resolveAccountIndex(address) {
+        const addressKey = address.toLowerCase();
+        const cached = this.accountIndexCache.get(addressKey);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const idx = await (0, perps_sdk_1.cachePromise)(() => this.accountIndexPromises.get(addressKey), (p) => {
+            if (p === undefined) {
+                this.accountIndexPromises.delete(addressKey);
+            }
+            else {
+                this.accountIndexPromises.set(addressKey, p);
+            }
+        }, () => this.fetchAccountIndex(address));
+        this.accountIndexCache.set(addressKey, idx);
+        return idx;
+    }
+    async fetchAccountIndex(address) {
+        const account = await (0, index_js_1.fetchDetailedAccount)(this.api, address);
+        return account.index;
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            perps_sdk_1.wsLog.parseFailure(constants_js_1.LIGHTER_PROVIDER_KEY, raw);
+            return;
+        }
+        if (!isValidLighterFrame(msg)) {
+            perps_sdk_1.wsLog.parseFailure(constants_js_1.LIGHTER_PROVIDER_KEY, raw);
+            return;
+        }
+        try {
+            this.dispatch(msg);
+        }
+        catch (error) {
+            perps_sdk_1.wsLog.handlerFailure(constants_js_1.LIGHTER_PROVIDER_KEY, error);
+        }
+    }
+    dispatch(msg) {
+        if (msg.type === 'ping') {
+            this.rws.send(JSON.stringify({ type: 'pong' }));
+            return;
+        }
+        if (msg.type === 'subscribed/market_stats' ||
+            msg.type === 'update/market_stats') {
+            this.handleMarketStats(msg.market_stats);
+            return;
+        }
+        if (msg.type === 'subscribed/spot_market_stats' ||
+            msg.type === 'update/spot_market_stats') {
+            this.handleMarketStats(msg.spot_market_stats);
+            return;
+        }
+        if (msg.type === 'subscribed/order_book' ||
+            msg.type === 'update/order_book') {
+            this.handleOrderBook(msg, msg.type === 'subscribed/order_book');
+            return;
+        }
+        if (msg.type === 'subscribed/account_all_orders' ||
+            msg.type === 'update/account_all_orders') {
+            this.handleAccountOrders(msg);
+            return;
+        }
+        if (msg.type === 'subscribed/account_all_trades' ||
+            msg.type === 'update/account_all_trades') {
+            this.handleAccountTrades(msg);
+            return;
+        }
+        if (msg.type === 'subscribed/account_all_positions' ||
+            msg.type === 'update/account_all_positions') {
+            this.handleAccountPositions(msg, msg.type === 'subscribed/account_all_positions');
+            return;
+        }
+    }
+    handleAccountOrders(msg) {
+        const address = this.addressFromChannel(msg.channel, 'account_all_orders');
+        if (!address) {
+            return;
+        }
+        const raw = collectAuthChannelItems(msg, 'orders');
+        const data = (0, index_js_1.classifyAndMapOrders)(raw, (marketIndex) => this.registry?.get(String(marketIndex)));
+        this.emit(`orderUpdates:${address}`, {
+            channel: 'orderUpdates',
+            data,
+        });
+    }
+    handleAccountTrades(msg) {
+        const address = this.addressFromChannel(msg.channel, 'account_all_trades');
+        if (!address) {
+            return;
+        }
+        const accountIndex = this.accountIndexCache.get(address);
+        if (accountIndex === undefined) {
+            return;
+        }
+        const raw = collectAuthChannelItems(msg, 'trades');
+        const fills = raw.flatMap((t) => {
+            const market = this.registry?.get(String(t.market_id));
+            return market ? [(0, index_js_1.mapFill)(t, accountIndex, market)] : [];
+        });
+        this.emit(`fills:${address}`, { channel: 'fills', data: fills });
+    }
+    handleAccountPositions(msg, isSnapshot) {
+        const address = this.addressFromChannel(msg.channel, 'account_all_positions');
+        if (!address) {
+            return;
+        }
+        const raw = collectAuthChannelItems(msg, 'positions');
+        let state = this.positionsByAddress.get(address);
+        if (!state || isSnapshot) {
+            state = new Map();
+            this.positionsByAddress.set(address, state);
+        }
+        for (const p of raw) {
+            if (Number.parseFloat(p.position) === 0) {
+                state.delete(p.market_id);
+            }
+            else {
+                const market = this.registry?.get(String(p.market_id));
+                if (market) {
+                    state.set(p.market_id, (0, index_js_1.mapPosition)(p, market));
+                }
+            }
+        }
+        this.emit(`positions:${address}`, {
+            channel: 'positions',
+            data: [...state.values()],
+        });
+    }
+    addressFromChannel(channel, prefix) {
+        if (!channel?.startsWith(prefix)) {
+            return null;
+        }
+        const sep = channel[prefix.length];
+        if (sep !== '/' && sep !== ':') {
+            return null;
+        }
+        const idx = Number(channel.slice(prefix.length + 1));
+        if (!Number.isFinite(idx)) {
+            return null;
+        }
+        for (const [addr, cachedIdx] of this.accountIndexCache) {
+            if (cachedIdx === idx) {
+                return addr;
+            }
+        }
+        return null;
+    }
+    handleMarketStats(stats) {
+        if (!stats) {
+            return;
+        }
+        const updates = {};
+        for (const entry of Object.values(stats)) {
+            updates[String(entry.market_id)] = entry.last_trade_price;
+        }
+        if (Object.keys(updates).length === 0) {
+            return;
+        }
+        this.lastPricesByAssetId = { ...this.lastPricesByAssetId, ...updates };
+        this.emit('prices', {
+            channel: 'prices',
+            data: this.lastPricesByAssetId,
+        });
+    }
+    handleOrderBook(msg, isSnapshot) {
+        const marketId = this.marketIdFromChannel(msg.channel);
+        if (marketId === null) {
+            return;
+        }
+        const assetId = String(marketId);
+        let state = this.orderbooks.get(marketId);
+        if (!state || isSnapshot) {
+            state = { bids: new Map(), asks: new Map(), assetId };
+            this.orderbooks.set(marketId, state);
+        }
+        applyLevels(state.bids, msg.order_book.bids);
+        applyLevels(state.asks, msg.order_book.asks);
+        this.emit(`orderbook:${assetId}`, {
+            channel: 'orderbook',
+            data: {
+                provider: this.providerKey,
+                marketId: assetId,
+                bids: mapToLevels(state.bids, (a, b) => Number(b.price) - Number(a.price)),
+                asks: mapToLevels(state.asks, (a, b) => Number(a.price) - Number(b.price)),
+                timestamp: Date.now(),
+            },
+        });
+    }
+    marketIdFromChannel(channel) {
+        if (!channel?.startsWith('order_book')) {
+            return null;
+        }
+        const tail = channel.slice('order_book'.length);
+        if (tail.length < 2 || (tail[0] !== '/' && tail[0] !== ':')) {
+            return null;
+        }
+        const n = Number(tail.slice(1));
+        return Number.isFinite(n) ? n : null;
+    }
+}
+exports.LighterWsProvider = LighterWsProvider;
+const isObject = (v) => typeof v === 'object' && v !== null;
+function isValidLighterFrame(msg) {
+    if (typeof msg.type !== 'string') {
+        return false;
+    }
+    if (msg.type === 'subscribed/order_book' ||
+        msg.type === 'update/order_book') {
+        const book = msg.order_book;
+        return (isObject(book) && Array.isArray(book.bids) && Array.isArray(book.asks));
+    }
+    return true;
+}
+function applyLevels(book, levels) {
+    for (const level of levels) {
+        if (level.size === '0' || Number(level.size) === 0) {
+            book.delete(level.price);
+        }
+        else {
+            book.set(level.price, level.size);
+        }
+    }
+}
+function mapToLevels(book, compare) {
+    const levels = [...book].map(([price, size]) => ({ price, size }));
+    levels.sort(compare);
+    return levels;
+}
+function extractItems(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value === 'object') {
+        return Object.values(value).flatMap((v) => Array.isArray(v) ? v : [v]);
+    }
+    return undefined;
+}
+function collectAuthChannelItems(msg, field) {
+    return (extractItems(msg[field]) ??
+        extractItems(msg.data?.[field]) ??
+        []);
+}
+const lighterWsProvider = (options) => ({ provider, wsUrl, client }) => new LighterWsProvider(wsUrl, provider, options, client);
+exports.lighterWsProvider = lighterWsProvider;
+//# sourceMappingURL=LighterWsProvider.js.map

package/dist/cjs/websocket/LighterWsProvider.js.map

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

package/dist/esm/LighterProvider.d.ts

@@ -0,0 +1,105 @@
+import { type PerpsProviderPlugin } from '@lifi/perps-sdk';
+import type { Address } from 'viem';
+import type { LighterKeyStore } from './signers/LighterKeyStore.js';
+import type { LighterReadOnlyTokenManagerOptions } from './signers/LighterReadOnlyTokenManager.js';
+import type { LighterSigner } from './signers/LighterSigner.js';
+/**
+ * Construction options for the Lighter {@link PerpsProviderPlugin}.
+ *
+ * `restUrl` defaults to Lighter mainnet; pass a testnet URL or a self-hosted
+ * mirror to override.
+ *
+ * Auth-token resolution order for the auth-gated reads:
+ *   1. Per-call `options.lighterAuthToken`
+ *   2. Constructor `authToken` (string or async factory)
+ *   3. Persisted long-lived read-only token (via `readOnlyTokenOptions`'s
+ *      storage), keyed on the resolved Lighter `accountIndex`
+ *   4. Fresh 1h create via the WASM signer + the user's registered API key
+ *      from `keyStore`
+ *
+ * When none of these yields a token the auth-gated reads degrade gracefully:
+ *   - `getOrders`, `getActivity` return empty results (mirrors backend behaviour)
+ *   - `getOrder` throws `Unauthorized`
+ *   - `getAccount` returns zero fee tier rather than failing
+ *
+ * Write actions (`signActions` for the WASM_BLOB / EVM_TX arms) require
+ * `signer` and `keyStore` to be supplied.
+ *
+ * @public
+ */
+export interface LighterProviderOptions {
+    /** Lighter REST base URL. Defaults to mainnet. */
+    restUrl?: string;
+    /** Pre-created Lighter read-only bearer. */
+    authToken?: string | (() => string | Promise<string>);
+    /**
+     * WASM signer instance. Required for `signActions` (write actions) and
+     * for on-demand auth-token creating from the user's API key. The default
+     * configuration loads the WASM blob shipped with this package.
+     */
+    signer?: LighterSigner;
+    /**
+     * Store for the user's per-address Lighter API keypair. Required for
+     * `signActions` (write actions) and for on-demand auth-token creating.
+     */
+    keyStore?: LighterKeyStore;
+    /**
+     * Injection overrides (storage, fetcher, clock, host) for the read-only
+     * token manager, which is always active — Lighter reads create a long-lived
+     * read-only token on first use and reuse it thereafter. The host defaults to
+     * `restUrl`. This does not enable or disable the manager; it only overrides
+     * its dependencies (primarily for tests / non-browser storage).
+     */
+    readOnlyTokenOptions?: LighterReadOnlyTokenManagerOptions;
+    /** Token lifetime for on-demand standard-token creates (Lighter caps at 8h). Default 1h. */
+    tokenLifetimeSeconds?: number;
+    /** Re-create when the cached standard token's remaining life is below this. Default 60s. */
+    tokenRenewBufferSeconds?: number;
+}
+/**
+ * Lighter provider plugin extended with a public `resolveAuthToken` so the
+ * WS layer can share the same token-resolution closure that the read methods
+ * use internally. The base {@link PerpsProviderPlugin} contract stays
+ * provider-agnostic — this extension is opt-in for callers that explicitly
+ * type against it.
+ *
+ * @public
+ */
+export interface LighterPerpsProvider extends PerpsProviderPlugin {
+    /**
+     * Resolve a Lighter auth token for `address`, following the resolution order
+     * documented on {@link LighterProviderOptions} (the per-call override does not
+     * apply here). Returns `undefined` when no source can produce a token —
+     * callers degrade gracefully.
+     */
+    resolveAuthToken(address: Address): Promise<string | undefined>;
+}
+/**
+ * Lighter provider plugin factory. Returns an object implementing
+ * {@link PerpsProviderPlugin}, mirroring the `EthereumProvider()` / `hyperliquidProvider()`
+ * shape used by the rest of the LI.FI SDK family.
+ *
+ * Read functions call Lighter's REST API directly with no LI.FI backend hop.
+ * Auth-gated reads resolve their token via the order documented on
+ * {@link LighterProviderOptions}.
+ *
+ * Write actions (`WASM_BLOB` and `EVM_TX` signing) are dispatched via
+ * `signActions` — `PerpsClient.execute` delegates those arms here.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   providers: [lighterProvider()],
+ * })
+ * ```
+ * @public
+ */
+export declare const lighterProvider: (options?: LighterProviderOptions) => LighterPerpsProvider;
+/**
+ * Alias matching `@lifi/sdk`'s capitalised factory naming (`EVM()`, `EthereumProvider()`).
+ *
+ * @public
+ */
+export declare const Lighter: (options?: LighterProviderOptions) => LighterPerpsProvider;
+//# sourceMappingURL=LighterProvider.d.ts.map

package/dist/esm/LighterProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/LighterProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,mBAAmB,EAazB,MAAM,iBAAiB,CAAA;AAsBxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAcnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAA;AAElG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AA4E/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,kCAAkC,CAAA;IACzD,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,4FAA4F;IAC5F,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAQD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAS,sBAA2B,KACnC,oBA25BF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,aAn6BT,sBAAsB,KAC9B,oBAk6BmC,CAAA"}