@lifi/perps-sdk 0.2.0-alpha.0 → 1.0.1

package/dist/esm/realtime/lighter/types.d.ts

@@ -1,108 +0,0 @@
-export type LtWsMessage = {
-    channel?: string;
-    type: string;
-};
-export type LtWsPingMessage = LtWsMessage & {
-    type: 'ping';
-};
-export type LtWsMarketStats = {
-    market_id: number;
-    index_price: string;
-    mark_price: string;
-    open_interest: string;
-    last_trade_price: string;
-    current_funding_rate: string;
-    funding_rate: string;
-    funding_timestamp: number;
-    daily_base_token_volume: string;
-    daily_quote_token_volume: string;
-    daily_price_change: string;
-};
-/**
- * `market_stats/all` pushes one record per known market each tick. We
- * aggregate them into a Record<assetId, price> before emitting `prices`.
- */
-export type LtWsMarketStatsAllMessage = LtWsMessage & {
-    type: 'subscribed/market_stats' | 'update/market_stats';
-    market_stats?: Record<string, LtWsMarketStats>;
-};
-export type LtWsOrderBookLevel = {
-    price: string;
-    size: string;
-};
-export type LtWsOrderBook = {
-    asks: LtWsOrderBookLevel[];
-    bids: LtWsOrderBookLevel[];
-    offset?: number;
-};
-export type LtWsOrderBookMessage = LtWsMessage & {
-    type: 'subscribed/order_book' | 'update/order_book';
-    order_book: LtWsOrderBook;
-};
-export type LtOrderBookDetail = {
-    symbol: string;
-    market_id: number;
-    market_type: string;
-    supported_price_decimals: number;
-    supported_size_decimals: number;
-};
-export type LtOrderBookDetailsResponse = {
-    code: number;
-    order_book_details: LtOrderBookDetail[];
-};
-/**
- * `/api/v1/account?by=l1_address` response. The provider only consumes the
- * `index` field — everything else is intentionally typed as unknown.
- */
-export type LtWsAccountByL1Response = {
-    code: number;
-    accounts?: Array<{
-        index: number;
-        [k: string]: unknown;
-    }>;
-};
-/**
- * Auth-channel payloads.
- *
- * The response `channel` field uses `:` as separator (e.g.
- * `account_all_orders:42`) while the subscribe payload uses `/`.
- *
- * Per the Lighter WS spec:
- *   - orders/trades: object indexed by market index, each value an array
- *     (`{ "0": [Order], "1": [Order] }`)
- *   - positions: object indexed by market index, each value a single object
- *     (`{ "0": Position }`)
- *   - initial `account_all_trades` snapshot may send an empty flat array
- *
- * The provider uses `collectAuthChannelItems` to normalise all three shapes
- * into a flat T[].
- */
-export type LtWsAccountAllOrdersMessage = LtWsMessage & {
-    type: 'subscribed/account_all_orders' | 'update/account_all_orders';
-    orders?: Record<string, unknown[]> | unknown[];
-    data?: {
-        orders?: Record<string, unknown[]> | unknown[];
-    };
-};
-export type LtWsAccountAllTradesMessage = LtWsMessage & {
-    type: 'subscribed/account_all_trades' | 'update/account_all_trades';
-    trades?: Record<string, unknown[]> | unknown[];
-    total_volume?: number;
-    monthly_volume?: number;
-    weekly_volume?: number;
-    daily_volume?: number;
-    data?: {
-        trades?: Record<string, unknown[]> | unknown[];
-    };
-};
-export type LtWsAccountAllPositionsMessage = LtWsMessage & {
-    type: 'subscribed/account_all_positions' | 'update/account_all_positions';
-    positions?: Record<string, unknown>;
-    shares?: unknown[];
-    last_funding_round?: Record<string, string>;
-    last_funding_discount?: Record<string, string>;
-    data?: {
-        positions?: Record<string, unknown>;
-    };
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/esm/realtime/lighter/types.d.ts.map

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

package/dist/esm/realtime/lighter/types.js

@@ -1,14 +0,0 @@
-// ---------------------------------------------------------------------------
-// Lighter WebSocket message types
-//
-// The Lighter stream server sends JSON messages of shape:
-//   { type: 'subscribed/<channel>' | 'update/<channel>' | 'ping',
-//     channel: '<channel>/<id>',
-//     ...payload }
-//
-// Channels we subscribe to:
-//   - market_stats/all        → public prices across all markets
-//   - order_book/{market_id}  → bids/asks per market (stateful with deltas)
-// ---------------------------------------------------------------------------
-export {};
-//# sourceMappingURL=types.js.map

package/dist/esm/realtime/lighter/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/realtime/lighter/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kCAAkC;AAClC,EAAE;AACF,0DAA0D;AAC1D,kEAAkE;AAClE,iCAAiC;AACjC,mBAAmB;AACnB,EAAE;AACF,4BAA4B;AAC5B,iEAAiE;AACjE,4EAA4E;AAC5E,8EAA8E"}

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

@@ -1,10 +0,0 @@
-import type { Subscription, SubscriptionEvent } from '@lifi/perps-types';
-export type EventForSubscription<S extends Subscription> = Extract<SubscriptionEvent, {
-    channel: S['channel'];
-}>;
-export type SubscriptionListener = (event: SubscriptionEvent) => void;
-export interface WsProvider {
-    subscribe(sub: Subscription, listener: SubscriptionListener): Promise<() => void>;
-    close(): void;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/realtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAExE,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAChE,iBAAiB,EACjB;IAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,CAC1B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;AAErE,MAAM,WAAW,UAAU;IACzB,SAAS,CACP,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,IAAI,CAAA;CACd"}

package/dist/esm/services/getAsset.d.ts

@@ -1,20 +0,0 @@
-import type { Asset } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
-export interface GetAssetParams {
-    /** Provider to get asset from (e.g., 'hyperliquid') */
-    provider: string;
-    /** Asset symbol (e.g., 'BTC') */
-    symbol: string;
-}
-/**
- * Get a specific asset by symbol.
- *
- * @example
- * ```ts
- * const client = createPerpsClient({ integrator: 'my-app' })
- * const asset = await getAsset(client, { provider: 'hyperliquid', symbol: 'BTC' })
- * console.log(asset) // { symbol: 'BTC', markPrice: '95000.00', ... }
- * ```
- */
-export declare function getAsset(client: PerpsSDKClient, params: GetAssetParams, options?: SDKRequestOptions): Promise<Asset>;
-//# sourceMappingURL=getAsset.d.ts.map

package/dist/esm/services/getAsset.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getAsset.d.ts","sourceRoot":"","sources":["../../../src/services/getAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAQhB"}

package/dist/esm/services/getAsset.js

@@ -1,18 +0,0 @@
-import { buildUrl, request } from '../utils/request.js';
-/**
- * Get a specific asset by symbol.
- *
- * @example
- * ```ts
- * const client = createPerpsClient({ integrator: 'my-app' })
- * const asset = await getAsset(client, { provider: 'hyperliquid', symbol: 'BTC' })
- * console.log(asset) // { symbol: 'BTC', markPrice: '95000.00', ... }
- * ```
- */
-export async function getAsset(client, params, options) {
-    const url = buildUrl(`${client.config.apiUrl}/assets/${encodeURIComponent(params.symbol)}`, {
-        provider: params.provider,
-    });
-    return request(client.config, url, {}, options);
-}
-//# sourceMappingURL=getAsset.js.map

package/dist/esm/services/getAsset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getAsset.js","sourceRoot":"","sources":["../../../src/services/getAsset.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASvD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,MAAsB,EACtB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAClB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,WAAW,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EACrE;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CACF,CAAA;IACD,OAAO,OAAO,CAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACxD,CAAC"}

package/dist/esm/signers/lighter/LighterKeyStore.d.ts

@@ -1,29 +0,0 @@
-import type { Address } from '@lifi/perps-types';
-import type { StorageAdapter } from '../../agent/types.js';
-export declare const LIGHTER_PROVIDER_KEY = "lighter";
-/**
- * Default API key slot. Reusing one slot is deliberate: Lighter allows 256
- * slots per account but re-registering a slot overwrites the prior key, so
- * a fixed slot keeps storage small and recovery simple.
- */
-export declare const DEFAULT_API_KEY_INDEX = 1;
-export interface LighterApiKey {
-    /** Lighter account index, looked up once via accountsByL1Address. */
-    accountIndex: number;
-    /** API key slot (0-255). Defaults to {@link DEFAULT_API_KEY_INDEX}. */
-    apiKeyIndex: number;
-    /** Lighter-native private key (0x-prefixed hex). */
-    apiKeyPrivateKey: string;
-    /** Corresponding public key, registered via ChangePubKey. */
-    apiKeyPublicKey: string;
-}
-export declare class LighterKeyStore {
-    private readonly storage;
-    private readonly cache;
-    constructor(storage: StorageAdapter);
-    private storageKey;
-    get(address: Address): Promise<LighterApiKey | null>;
-    set(address: Address, value: LighterApiKey): Promise<void>;
-    remove(address: Address): Promise<void>;
-}
-//# sourceMappingURL=LighterKeyStore.d.ts.map

package/dist/esm/signers/lighter/LighterKeyStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LighterKeyStore.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterKeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAc1D,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;gBAE7C,OAAO,EAAE,cAAc;IAInC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAepD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

package/dist/esm/signers/lighter/LighterKeyStore.js

@@ -1,53 +0,0 @@
-// ---------------------------------------------------------------------------
-// LighterKeyStore
-//
-// Persists the Lighter-native API keypair plus account/key indices per L1
-// user address. Unlike AgentManager, the private key here is a Lighter custom
-// keypair — generated via WASM GenerateAPIKey — not an Ethereum private key.
-//
-// We namespace the storage key by provider (`lighter`) so the same user can
-// later hold credentials for other WASM-blob providers without collision.
-// ---------------------------------------------------------------------------
-const STORAGE_PREFIX = 'lifi-perps-lighter-key';
-export const LIGHTER_PROVIDER_KEY = 'lighter';
-/**
- * Default API key slot. Reusing one slot is deliberate: Lighter allows 256
- * slots per account but re-registering a slot overwrites the prior key, so
- * a fixed slot keeps storage small and recovery simple.
- */
-export const DEFAULT_API_KEY_INDEX = 1;
-export class LighterKeyStore {
-    storage;
-    cache = new Map();
-    constructor(storage) {
-        this.storage = storage;
-    }
-    storageKey(address) {
-        return `${STORAGE_PREFIX}:${address.toLowerCase()}`;
-    }
-    async get(address) {
-        const key = this.storageKey(address);
-        const cached = this.cache.get(key);
-        if (cached) {
-            return cached;
-        }
-        const stored = await this.storage.get(key);
-        if (!stored) {
-            return null;
-        }
-        const parsed = JSON.parse(stored);
-        this.cache.set(key, parsed);
-        return parsed;
-    }
-    async set(address, value) {
-        const key = this.storageKey(address);
-        this.cache.set(key, value);
-        await this.storage.set(key, JSON.stringify(value));
-    }
-    async remove(address) {
-        const key = this.storageKey(address);
-        this.cache.delete(key);
-        await this.storage.remove(key);
-    }
-}
-//# sourceMappingURL=LighterKeyStore.js.map

package/dist/esm/signers/lighter/LighterKeyStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LighterKeyStore.js","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterKeyStore.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,kBAAkB;AAClB,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAE9E,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAatC,MAAM,OAAO,eAAe;IACT,OAAO,CAAgB;IACvB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;IAEzD,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEO,UAAU,CAAC,OAAgB;QACjC,OAAO,GAAG,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAkB,CAAA;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,KAAoB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;CACF"}

package/dist/esm/signers/lighter/LighterReadOnlyTokenManager.d.ts

@@ -1,174 +0,0 @@
-import type { Address, ApproveReadOnlyTokenParams, LighterAccountConfig } from '@lifi/perps-types';
-import type { Account, WalletClient } from 'viem';
-import type { StorageAdapter } from '../../agent/types.js';
-/**
- * Default Lighter HTTP host the SDK posts the mint request to. Callers
- * pointing at testnet pass an override via {@link LighterReadOnlyTokenManagerOptions.lighterApiUrl}.
- */
-export declare const DEFAULT_LIGHTER_API_URL = "https://mainnet.zklighter.elliot.ai";
-/**
- * Default token name persisted alongside Lighter's `tokens/create` row.
- * Lighter requires a non-empty `name` form field; the literal here is what
- * surfaces in Lighter's UI listing under `app.lighter.xyz/read-only-tokens`.
- */
-export declare const DEFAULT_READ_ONLY_TOKEN_NAME = "LI.FI Perps";
-/**
- * Persisted shape of a Lighter read-only token. The `token` string is
- * Lighter's opaque `ro:{accountIndex}:{scope}:{expiry}:{rand}` bearer; the
- * SDK never parses it — `expiry`/`scope`/`accountIndex` are mint-time inputs
- * we keep alongside so consumers can render expiry UX without re-fetching.
- */
-export interface LighterReadOnlyToken {
-    /** Opaque bearer string — never parse client-side. */
-    token: string;
-    /** Unix seconds. The SDK's source of truth for expiry. */
-    expiry: number;
-    /** Lighter's `single | all` scope literal recorded at mint time. */
-    scope: 'single' | 'all';
-    /** Lighter L2 account index the token authorises. */
-    accountIndex: number;
-}
-/**
- * Lighter `POST /api/v1/tokens/create` response shape (subset). Lighter's
- * OpenAPI documents additional fields (`token_id`, `name`, `revoked`, etc.)
- * we don't need client-side.
- */
-export interface LighterCreateTokenResponse {
-    api_token: string;
-    account_index: number;
-    expiry: number;
-    scopes: string;
-}
-/**
- * Function injected for the HTTP boundary against Lighter's `tokens/create`
- * endpoint. Returning a parsed {@link LighterCreateTokenResponse} keeps the
- * mint code free of fetch/multipart plumbing and lets tests drop a fixture
- * in without spinning a mock server.
- */
-export type LighterTokenFetcher = (params: {
-    url: string;
-    authorization: string;
-    name: string;
-    accountIndex: number;
-    expiry: number;
-    subAccountAccess: boolean;
-    scopes: string;
-}) => Promise<LighterCreateTokenResponse>;
-/**
- * Function injected for the L1 wallet signature. Signature MUST be EIP-191
- * `personal_sign`. Returning a 0x-prefixed hex string keeps the mint path
- * agnostic to whichever wallet abstraction the consumer wires up.
- */
-export type LighterWalletSigner = (params: {
-    address: Address;
-    message: string;
-}) => Promise<string>;
-export interface LighterReadOnlyTokenManagerOptions {
-    storage?: StorageAdapter;
-    /** Lighter API host. Defaults to {@link DEFAULT_LIGHTER_API_URL}. */
-    lighterApiUrl?: string;
-    /** Override the multipart POST. Defaults to a `fetch`-based implementation. */
-    fetcher?: LighterTokenFetcher;
-    /** Clock injection for testing expiry logic. Defaults to `Date.now`. */
-    now?: () => number;
-}
-export interface ApproveReadOnlyTokenInputs extends ApproveReadOnlyTokenParams {
-    /** L1 wallet address that signs the mint message. */
-    address: Address;
-}
-export interface ApproveReadOnlyTokenResult {
-    token: LighterReadOnlyToken;
-    /** Projection of the post-mint Lighter account state. */
-    config: Pick<LighterAccountConfig, 'provider' | 'accountIndex' | 'readOnlyTokenApproved' | 'readOnlyTokenExpiry' | 'readOnlyTokenScope'>;
-}
-/**
- * Manage the per-account Lighter read-only token alongside the existing
- * `(L1 address, account index)`-scoped storage adapter pattern. Mirrors
- * `AgentManager`'s injection surface so the same `StorageAdapter` powers
- * both. The token is opaque — never parsed client-side; `expiry`/`scope`
- * recorded at mint time are the source of truth.
- *
- * The L1 wallet signer and the HTTP fetcher are both injectable so unit
- * tests don't need a real wallet or network.
- */
-export declare class LighterReadOnlyTokenManager {
-    private readonly storage;
-    private readonly lighterApiUrl;
-    private readonly fetcher;
-    private readonly now;
-    private readonly cache;
-    constructor(options?: LighterReadOnlyTokenManagerOptions);
-    private storageKey;
-    private isExpired;
-    /**
-     * Return the stored token for the `(address, accountIndex)` pair, or
-     * `undefined` if absent or past its `expiry`. Never surfaces an expired
-     * token — consumers can rely on the return value being usable as-is.
-     */
-    get(address: Address, accountIndex: number): Promise<LighterReadOnlyToken | undefined>;
-    /**
-     * `true` when a stored token exists AND its `expiry` falls within
-     * `thresholdDays` of now. `false` when no token exists, when the token is
-     * already expired (caller should treat that as "no token"), or when it
-     * has more than `thresholdDays` of life left.
-     */
-    isReadOnlyTokenExpiringSoon(address: Address, accountIndex: number, thresholdDays?: number): Promise<boolean>;
-    /**
-     * Persist `token` for the `(address, accountIndex)` pair. Overwrites any
-     * prior stored token under the same key — used both by the approve flow
-     * and by the renewal flow.
-     */
-    set(address: Address, accountIndex: number, token: LighterReadOnlyToken): Promise<void>;
-    remove(address: Address, accountIndex: number): Promise<void>;
-    /**
-     * Mint and persist a new Lighter read-only token.
-     *
-     * Asks `signer` to produce an EIP-191 `personal_sign` over the
-     * `createToken`-specific L1 message, POSTs the signed payload to Lighter's
-     * `/api/v1/tokens/create` via the injected `fetcher`, and persists the
-     * returned bearer alongside its `expiry`/`scope`/`accountIndex`.
-     *
-     * `expirySeconds` is the absolute unix-seconds expiry Lighter records on
-     * the row. Lighter enforces 1 day ≤ lifetime ≤ 10 years server-side; the
-     * SDK does NOT pre-validate and surfaces Lighter's 400 verbatim.
-     *
-     * `scope` defaults to `'all'` (token authorises read access to every
-     * account owned by the L1 signer). `'single'` is wired through so callers
-     * who need per-account scoping can opt in.
-     *
-     * @param signer EIP-191 wallet signer for the L1 message.
-     * @param inputs Token-mint parameters plus the L1 `address` that signs.
-     */
-    approve(signer: LighterWalletSigner, inputs: ApproveReadOnlyTokenInputs): Promise<ApproveReadOnlyTokenResult>;
-}
-/**
- * Build the EIP-191 message the user's L1 wallet signs to authorise a
- * Lighter `tokens/create` request.
- *
- * NOTE — Lighter's public docs do not fully specify the message template
- * for the read-only token mint flow. The shape here is the SDK's best-fit
- * given (a) Lighter's UI hosts the equivalent flow at
- * `app.lighter.xyz/read-only-tokens` and (b) Lighter's `tokens/create`
- * endpoint reads `account_index`, `expiry`, and `scopes` as form fields.
- * If Lighter publishes a documented template that diverges, update this
- * builder — the test fixtures will fail loudly.
- */
-export declare function buildReadOnlyTokenMessage(params: {
-    accountIndex: number;
-    expirySeconds: number;
-    scope: 'single' | 'all';
-}): string;
-/**
- * Default fetcher: posts a multipart/form-data request to Lighter's
- * `tokens/create` endpoint and returns the parsed response. Throws a
- * {@link PerpsError} with the Lighter-side body when the response is
- * non-2xx.
- */
-export declare const defaultLighterTokenFetcher: LighterTokenFetcher;
-/**
- * Adapter producing a {@link LighterWalletSigner} from a viem
- * `WalletClient`. Pulled out so `PerpsClient.approveReadOnlyToken` can call
- * into the manager without leaking viem types past the manager's boundary.
- */
-export declare function walletClientSigner(client: WalletClient<any, any, Account>): LighterWalletSigner;
-//# sourceMappingURL=LighterReadOnlyTokenManager.d.ts.map

package/dist/esm/signers/lighter/LighterReadOnlyTokenManager.d.ts.map

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