@lifi/perps-sdk 0.1.1-alpha.8 → 0.2.0-alpha.0

package/dist/types/client/types.d.ts

@@ -1,51 +1,68 @@
-import type { Address, AuthorizationAction, AuthorizationInput, AuthorizationsResponse, OrderSide, OrderType, SignedAuthorization, TimeInForce, TriggerOrderInput, WithdrawalInput } from '@lifi/perps-types';
+import type { AccountConfigSetting, AccountResponse, ActionStep, Address, AssetIdentity, ExecuteActionResponse, ModifyOrderInput, OrderSide, OrderType, SignedActionStep, TimeInForce, TriggerOrderInput, WithdrawalParams } from '@lifi/perps-types';
 import type { StorageAdapter } from '../agent/types.js';
-export type { PerpsBaseConfig, PerpsConfig, PerpsSDKClient, RequestInterceptor, SDKRequestOptions, } from './createPerpsClient.js';
+import type { LighterReadOnlyTokenManagerOptions, LighterSignerConfig } from '../signers/lighter/index.js';
+import type { ProviderConfigs } from './createPerpsClient.js';
+export type { HyperliquidConfig, PerpsBaseConfig, PerpsConfig, PerpsSDKClient, ProviderConfig, ProviderConfigs, RequestInterceptor, SDKRequestOptions, } from './createPerpsClient.js';
 /**
  * Signing mode determines who signs trading actions.
  *
  * - `USER`: User wallet signs each action (requires wallet popup per action)
  * - `USER_AGENT`: SDK-generated agent signs actions (no popups after initial setup)
  */
-export type SigningMode = 'USER' | 'USER_AGENT';
+export declare enum SigningMode {
+    USER = "USER",
+    USER_AGENT = "USER_AGENT"
+}
 /**
  * Options for PerpsClient constructor.
  */
 export interface PerpsClientOptions {
     /** Integrator identifier (required) */
     integrator: string;
-    /** Optional API key for authenticated requests */
-    apiKey?: string;
+    /** API key for authenticated requests (get one at https://portal.li.fi/) */
+    apiKey: string;
     /** Base API URL. Defaults to DEFAULT_API_URL */
     apiUrl?: string;
     /** Custom storage adapter for agent keys. Defaults to localStorage. */
     storage?: StorageAdapter;
+    /** Provider-specific configuration */
+    providers?: ProviderConfigs;
+    /**
+     * Optional Lighter WASM signer configuration. Override the REST URL, chain
+     * ID, or WASM asset locations. Omit to accept defaults (mainnet, chain 304,
+     * WASM assets bundled with the package).
+     */
+    lighter?: LighterSignerConfig;
+    /**
+     * Optional Lighter read-only token manager configuration. Override the
+     * Lighter REST URL, inject a custom HTTP fetcher, or pin a clock for
+     * tests. `storage` is shared with the rest of the client unless explicitly
+     * overridden here. Omit to accept the manager's defaults.
+     */
+    lighterReadOnlyToken?: LighterReadOnlyTokenManagerOptions;
 }
 /**
- * Parameters for building authorization payloads.
+ * Parameters for the internal `buildPrerequisites` helper that materialises
+ * typed-data envelopes for the setup descriptors.
  */
-export interface BuildAuthorizationParams {
-    /** DEX to authorize */
-    dex: string;
+export interface CheckPrerequisitesParams {
+    /** Provider to build setup actions for */
+    provider: string;
     /** User wallet address */
     address: Address;
     /** Address of the signer (auto-set in USER_AGENT mode) */
     signerAddress?: Address;
-    /** Authorizations to create */
-    authorizations: AuthorizationInput[];
 }
 /**
  * Parameters for placing an order.
  */
 export interface PlaceOrderParams {
-    /** DEX to place order on */
-    dex: string;
+    /** Provider to place order on */
+    provider: string;
     /** User wallet address */
     address: Address;
-    /** Client-provided order ID */
-    clientOrderId?: string;
-    /** Market symbol */
-    symbol: string;
+    /** Asset identity */
+    asset: AssetIdentity;
     /** Order side */
     side: OrderSide;
     /** Order type */
@@ -68,67 +85,116 @@ export interface PlaceOrderParams {
     stopLoss?: TriggerOrderInput;
 }
 /**
- * Parameters for building a withdrawal payload.
+ * Parameters for placing trigger-only orders (TP/SL on existing positions).
+ * Sends a TRIGGER_ONLY order that skips the main order wire.
+ */
+export interface PlaceTriggerOrderParams {
+    provider: string;
+    address: Address;
+    asset: AssetIdentity;
+    side: OrderSide;
+    takeProfit?: TriggerOrderInput;
+    stopLoss?: TriggerOrderInput;
+}
+/**
+ * Parameters for withdrawing funds.
  */
-export interface BuildWithdrawalParams {
-    /** DEX to withdraw from */
-    dex: string;
+export interface WithdrawParams {
+    /** Provider to withdraw from */
+    provider: string;
     /** User wallet address (account owner) */
     address: Address;
     /** Withdrawal details */
-    withdrawal: WithdrawalInput;
+    withdrawal: WithdrawalParams;
 }
 /**
  * Parameters for canceling orders.
  */
 export interface CancelOrdersParams {
-    /** DEX to cancel orders on */
-    dex: string;
+    /** Provider to cancel orders on */
+    provider: string;
     /** User wallet address */
     address: Address;
     /** Order IDs to cancel */
     ids: string[];
 }
 /**
- * Parameters for getRequiredAuthorizations().
+ * Parameters for modifying orders.
  */
-export interface GetRequiredAuthorizationsParams {
-    /** DEX to check authorizations for */
-    dex: string;
+export interface ModifyOrdersParams {
+    /** Provider to modify orders on */
+    provider: string;
     /** User wallet address */
     address: Address;
+    /** Modifications to apply */
+    modifications: ModifyOrderInput[];
 }
 /**
- * Result from getRequiredAuthorizations().
+ * Parameters for {@link PerpsClient.checkSetup}.
  */
-export interface RequiredAuthorizationsResult {
-    /** Authorization actions requiring user wallet signature (with typed data for signing) */
-    userAuthorizations: AuthorizationAction[];
-    /** Authorization actions the SDK auto-signs with the agent (with typed data) */
-    agentAuthorizations: AuthorizationAction[];
-    /** Whether all authorizations are already satisfied (ready to trade) */
+export interface GetSetupParams {
+    /** Provider to check setup for */
+    provider: string;
+    /** User wallet address */
+    address: Address;
+}
+/**
+ * Result from {@link PerpsClient.checkSetup}.
+ *
+ * Reports the unsatisfied entries on `Provider.setup` for the queried
+ * account, split by the signer role the descriptor declares.
+ *
+ * `Provider.options` items are NEVER included here — they don't gate trading
+ * and are surfaced separately via `getAccount().settings`.
+ */
+export interface SetupResult {
+    /** Setup steps requiring user wallet signature */
+    userPrerequisites: ActionStep[];
+    /** Setup steps the SDK auto-signs with the agent */
+    agentPrerequisites: ActionStep[];
+    /** Whether all setup items are already satisfied (ready to trade) */
     isReady: boolean;
 }
 /**
- * Parameters for executeAuthorizations().
+ * Parameters for {@link PerpsClient.satisfySetup}.
  */
-export interface ExecuteAuthorizationsParams {
-    /** DEX to authorize */
-    dex: string;
+export interface SatisfySetupParams {
+    /** Provider to satisfy setup for */
+    provider: string;
     /** User wallet address */
     address: Address;
-    /** The result from getRequiredAuthorizations() */
-    required: RequiredAuthorizationsResult;
-    /** User-signed actions corresponding to required.userAuthorizations */
-    userSignedActions: SignedAuthorization[];
+    /** The result from checkSetup() */
+    required: SetupResult;
+    /** User-signed actions corresponding to required.userPrerequisites */
+    userSignedActions: SignedActionStep[];
 }
 /**
- * Result from executeAuthorizations().
+ * Result from {@link PerpsClient.satisfySetup}.
+ */
+export interface SatisfySetupResult {
+    /** Results from user-signed setup submission */
+    userResults: ExecuteActionResponse;
+    /** Results from agent-signed setup submission (if any) */
+    agentResults?: ExecuteActionResponse;
+    /**
+     * Fallback user-wallet setup steps surfaced when an agent-signed
+     * `ACCOUNT_MODE` dispatch is not authorised (e.g. Hyperliquid refuses to
+     * upgrade from a non-default abstraction variant without a user signature).
+     * Caller must re-sign these with the user's wallet.
+     */
+    fallbackUserPrerequisites?: ActionStep[];
+}
+/**
+ * Result envelope returned by {@link PerpsClient.getAccount} — wraps the
+ * backend's `AccountResponse` with a single SDK-projected `settings` array.
+ *
+ * `settings` contains exactly one `AccountConfigSetting` per descriptor on
+ * `Provider.setup` + `Provider.options` (in that order). Index the
+ * projection by `setting.type === descriptor.type` and read
+ * `setting.values[i].value` for each `Param` the descriptor declared.
  */
-export interface ExecuteAuthorizationsResult {
-    /** Results from user-signed authorization submission */
-    userResults: AuthorizationsResponse;
-    /** Results from agent-signed authorization submission (if any) */
-    agentResults?: AuthorizationsResponse;
+export interface GetAccountResult extends AccountResponse {
+    /** SDK-projected current state of every setup + options descriptor. */
+    settings: AccountConfigSetting[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/client/types.d.ts.map

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

package/dist/types/errors/PerpsError.d.ts

@@ -1,9 +1,8 @@
 import { PerpsErrorCode } from '@lifi/perps-types';
-import { PerpsErrorName } from './constants.js';
 export declare class PerpsError extends Error {
     code: PerpsErrorCode;
-    name: PerpsErrorName;
+    name: string;
+    tool?: string;
     constructor(code?: PerpsErrorCode, message?: string);
-    static fromError(error: unknown, defaultCode?: PerpsErrorCode): PerpsError;
 }
 //# sourceMappingURL=PerpsError.d.ts.map

package/dist/types/errors/PerpsError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsError.d.ts","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,cAAc,CAAA;IACX,IAAI,iBAA4B;gBAGvC,IAAI,GAAE,cAA4C,EAClD,OAAO,SAA2B;IAQpC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,cAAc,GAAG,UAAU;CAe3E"}
+{"version":3,"file":"PerpsError.d.ts","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,cAAc,CAAA;IACX,IAAI,SAAe;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;gBAGX,IAAI,GAAE,cAA4C,EAClD,OAAO,SAA2B;CAKrC"}

package/dist/types/errors/constants.d.ts

@@ -1,14 +1,4 @@
-export declare enum PerpsErrorName {
-    PerpsError = "PerpsError",
-    HTTPError = "HTTPError",
-    ValidationError = "ValidationError",
-    ServerError = "ServerError",
-    ConfigError = "ConfigError",
-    AgentError = "AgentError"
-}
 export declare enum PerpsErrorMessage {
-    UnknownError = "Unknown error occurred.",
-    ConfigNotInitialized = "SDK not configured. Call createPerpsConfig() first.",
     AgentNotFound = "Agent not found. Call setSigningMode() first.",
     InvalidSigningMode = "Invalid signing mode for this operation."
 }

package/dist/types/errors/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B,YAAY,4BAA4B;IACxC,oBAAoB,wDAAwD;IAC5E,aAAa,kDAAkD;IAC/D,kBAAkB,6CAA6C;CAChE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,aAAa,kDAAkD;IAC/D,kBAAkB,6CAA6C;CAChE"}

package/dist/types/index.d.ts

@@ -1,54 +1,60 @@
 export * from '@lifi/perps-types';
+export { HlAbstractionMode } from '@lifi/perps-types/providers/hyperliquid';
 export { AgentManager } from './agent/AgentManager.js';
 export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
 export type { Agent, StorageAdapter } from './agent/types.js';
 export type { PerpsBaseConfig, PerpsConfig, PerpsSDKClient, RequestInterceptor, SDKRequestOptions, } from './client/createPerpsClient.js';
 export { createPerpsClient, DEFAULT_API_URL, } from './client/createPerpsClient.js';
 export { PerpsClient } from './client/PerpsClient.js';
-export type { BuildAuthorizationParams, BuildWithdrawalParams, CancelOrdersParams, ExecuteAuthorizationsParams, ExecuteAuthorizationsResult, GetRequiredAuthorizationsParams, PerpsClientOptions, PlaceOrderParams, RequiredAuthorizationsResult, SigningMode, } from './client/types.js';
-export { getDexAuthProvider } from './dex/registry.js';
-export type { DexAuthInputs, DexAuthProvider } from './dex/types.js';
-export { AgentError } from './errors/AgentError.js';
-export { PerpsErrorMessage, PerpsErrorName } from './errors/constants.js';
-export { HTTPError } from './errors/HTTPError.js';
+export { projectAccountConfigSettings } from './client/projectAccountConfigSettings.js';
+export type { CancelOrdersParams, CheckPrerequisitesParams, GetAccountResult, GetSetupParams, HyperliquidConfig, ModifyOrdersParams, PerpsClientOptions, PlaceOrderParams as ClientPlaceOrderParams, PlaceTriggerOrderParams as ClientPlaceTriggerOrderParams, ProviderConfig, ProviderConfigs, SatisfySetupParams, SatisfySetupResult, SetupResult, } from './client/types.js';
+export { SigningMode } from './client/types.js';
+export { PerpsErrorMessage } from './errors/constants.js';
 export { PerpsError } from './errors/PerpsError.js';
-export { PerpsSDKError } from './errors/PerpsSDKError.js';
-export { ServerError } from './errors/ServerError.js';
-export { findErrorType, getErrorChain, getRootCause, getRootCauseMessage, hasErrorType, } from './errors/utils/rootCause.js';
-export { ValidationError } from './errors/ValidationError.js';
+export { projectHyperliquidConfigSettings } from './providers/hyperliquid/accountConfig.js';
+export { projectLighterConfigSettings } from './providers/lighter/accountConfig.js';
 export { PerpsWsClient } from './realtime/PerpsWsClient.js';
 export type { EventForSubscription } from './realtime/types.js';
-export type { CancelOrderParams } from './services/cancelOrder.js';
-export { cancelOrder } from './services/cancelOrder.js';
-export type { CreateAuthorizationParams } from './services/createAuthorization.js';
-export { createAuthorization } from './services/createAuthorization.js';
-export type { CreateOrderParams } from './services/createOrder.js';
-export { createOrder } from './services/createOrder.js';
-export type { CreateWithdrawalParams } from './services/createWithdrawal.js';
-export { createWithdrawal } from './services/createWithdrawal.js';
+export type { CreateActionParams } from './services/createAction.js';
+export { createAction } from './services/createAction.js';
+export type { ExecuteActionParams } from './services/executeAction.js';
+export { executeAction } from './services/executeAction.js';
 export type { GetAccountParams } from './services/getAccount.js';
 export { getAccount } from './services/getAccount.js';
-export { getDexes } from './services/getDexes.js';
-export type { GetHistoryParams } from './services/getHistory.js';
-export { getHistory } from './services/getHistory.js';
-export type { GetMarketParams } from './services/getMarket.js';
-export { getMarket } from './services/getMarket.js';
-export type { GetMarketsParams } from './services/getMarkets.js';
-export { getMarkets } from './services/getMarkets.js';
+export type { GetActivityParams } from './services/getActivity.js';
+export { getActivity } from './services/getActivity.js';
+export type { GetAssetParams } from './services/getAsset.js';
+export { getAsset } from './services/getAsset.js';
+export type { GetAssetsParams } from './services/getAssets.js';
+export { getAssets } from './services/getAssets.js';
+export type { GetFillsParams } from './services/getFills.js';
+export { getFills } from './services/getFills.js';
 export type { GetOhlcvParams } from './services/getOhlcv.js';
 export { getOhlcv } from './services/getOhlcv.js';
 export type { GetOrderParams } from './services/getOrder.js';
 export { getOrder } from './services/getOrder.js';
 export type { GetOrderbookParams } from './services/getOrderbook.js';
 export { getOrderbook } from './services/getOrderbook.js';
+export type { GetOrdersParams } from './services/getOrders.js';
+export { getOrders } from './services/getOrders.js';
+export type { GetPositionsParams } from './services/getPositions.js';
+export { getPositions } from './services/getPositions.js';
 export type { GetPricesParams } from './services/getPrices.js';
 export { getPrices } from './services/getPrices.js';
-export type { SubmitAuthorizationParams } from './services/submitAuthorization.js';
-export { submitAuthorization } from './services/submitAuthorization.js';
-export type { SubmitOrderParams } from './services/submitOrder.js';
-export { submitOrder } from './services/submitOrder.js';
-export type { SubmitWithdrawalParams } from './services/submitWithdrawal.js';
-export { submitWithdrawal } from './services/submitWithdrawal.js';
+export { getProviders } from './services/getProviders.js';
+export type { ApiKeyPair, ApproveReadOnlyTokenInputs, ApproveReadOnlyTokenResult, ChangePubKeyResult, LighterApiKey, LighterCreateTokenResponse, LighterReadOnlyToken, LighterReadOnlyTokenManagerOptions, LighterSignedBlob, LighterSignerConfig, LighterSignerContext, LighterTokenFetcher, LighterWalletSigner, LighterWasmExports, LoadLighterWasmOptions, } from './signers/lighter/index.js';
+export { buildReadOnlyTokenMessage, DEFAULT_API_KEY_INDEX, DEFAULT_LIGHTER_API_URL, DEFAULT_READ_ONLY_TOKEN_NAME, defaultLighterTokenFetcher, LIGHTER_PROVIDER_KEY, LighterKeyStore, LighterReadOnlyTokenManager, LighterSigner, loadLighterWasm, resetLighterWasmCache, walletClientSigner, } from './signers/lighter/index.js';
+export type { AccountSummary } from './utils/accountSummary.js';
+export { calculateAccountSummary } from './utils/accountSummary.js';
+export type { ExpectedPnl } from './utils/calculations.js';
+export { applySlippage, calculateExpectedPnl, calculateNotionalValue, calculatePositionSize, calculateRealizedPnlPercent, calculateRequiredMargin, calculateRoe, calculateUnrealizedPnl, estimateFees, percentFromPrice, priceFromPercent, } from './utils/calculations.js';
+export { calculateLiquidationPrice, calculateMaintenanceMarginRate, formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './utils/hyperliquid/index.js';
+export { classifyFill, FillClassification, isStopLossOrder, isTakeProfitOrder, isTpSlOrder, } from './utils/orderClassification.js';
+export { expectedRealizedPnlForOpenOrder, expectedRealizedPnlForTriggerOrder, findMatchingPosition, resolveCloseSize, } from './utils/orderMath.js';
+export { stringToFloat } from './utils/parse.js';
+export { directionSign, predictAverageEntryPrice, predictNewLeverage, predictUnrealizedPnl, realizedPnlOnClose, } from './utils/positionMath.js';
 export { signTypedData } from './utils/signTypedData.js';
+export { fromBaseUnits, fromBaseUnitsNumber } from './utils/units.js';
+export { validateMargin } from './utils/validation.js';
 export { name, version } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/providers/hyperliquid/accountConfig.d.ts

@@ -0,0 +1,13 @@
+import type { AccountConfigSetting, HyperliquidAccountConfig, ProviderOption, ProviderSetup } from '@lifi/perps-types';
+/**
+ * Project the union of Hyperliquid setup + options descriptors against the
+ * typed `HyperliquidAccountConfig`. Produces exactly one
+ * `AccountConfigSetting` per descriptor, in `setup`-then-`options` order
+ * (preserving the order in which the backend emits them).
+ *
+ * @param config Typed account state for the Hyperliquid account.
+ * @param setup  `Provider.setup` array as emitted by `/providers`.
+ * @param options `Provider.options` array as emitted by `/providers`.
+ */
+export declare function projectHyperliquidConfigSettings(config: HyperliquidAccountConfig, setup: ProviderSetup[], options: ProviderOption[]): AccountConfigSetting[];
+//# sourceMappingURL=accountConfig.d.ts.map

package/dist/types/providers/hyperliquid/accountConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.d.ts","sourceRoot":"","sources":["../../../../src/providers/hyperliquid/accountConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAExB,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAA;AAmE1B;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,cAAc,EAAE,GACxB,oBAAoB,EAAE,CAIxB"}

package/dist/types/providers/lighter/accountConfig.d.ts

@@ -0,0 +1,13 @@
+import type { AccountConfigSetting, LighterAccountConfig, ProviderOption, ProviderSetup } from '@lifi/perps-types';
+/**
+ * Project the union of Lighter setup + options descriptors against the typed
+ * `LighterAccountConfig`. Produces exactly one `AccountConfigSetting` per
+ * descriptor, in `setup`-then-`options` order (preserving the order in which
+ * the backend emits them).
+ *
+ * @param config Typed account state for the Lighter account.
+ * @param setup  `Provider.setup` array as emitted by `/providers`.
+ * @param options `Provider.options` array as emitted by `/providers`.
+ */
+export declare function projectLighterConfigSettings(config: LighterAccountConfig, setup: ProviderSetup[], options: ProviderOption[]): AccountConfigSetting[];
+//# sourceMappingURL=accountConfig.d.ts.map

package/dist/types/providers/lighter/accountConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.d.ts","sourceRoot":"","sources":["../../../../src/providers/lighter/accountConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EAEpB,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAA;AA8E1B;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,cAAc,EAAE,GACxB,oBAAoB,EAAE,CAIxB"}

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

@@ -1,14 +1,26 @@
 import type { Subscription } from '@lifi/perps-types';
 import type { PerpsSDKClient } from '../client/createPerpsClient.js';
+import { type LighterAuthProvider } from './lighter/LighterWsProvider.js';
 import type { EventForSubscription } from './types.js';
+export interface PerpsWsClientOptions {
+    /**
+     * Async function that mints a Lighter auth token for an L1 address. When
+     * provided, authenticated Lighter channels (orderUpdates, positions) will
+     * use the returned token. The provider is invoked on each subscribe send,
+     * including reconnects, so callers can transparently rotate tokens.
+     */
+    lighterAuthProvider?: LighterAuthProvider;
+}
 export declare class PerpsWsClient {
     private readonly client;
+    private readonly options;
     private providers;
     private initPromises;
-    constructor(client: PerpsSDKClient);
+    constructor(client: PerpsSDKClient, options?: PerpsWsClientOptions);
     subscribe<S extends Subscription>(sub: S, listener: (event: EventForSubscription<S>) => void): Promise<() => void>;
     close(): void;
     private getOrCreateProvider;
     private initProvider;
+    private createWsProvider;
 }
 //# sourceMappingURL=PerpsWsClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PerpsWsClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/PerpsWsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,YAAY,CAAA;AAE5E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,YAAY,CAAoD;gBAE5D,MAAM,EAAE,cAAc;IAI5B,SAAS,CAAC,CAAC,SAAS,YAAY,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,OAAO,CAAC,MAAM,IAAI,CAAC;IAKtB,KAAK;YAQS,mBAAmB;YAgBnB,YAAY;CAwB3B"}
+{"version":3,"file":"PerpsWsClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/PerpsWsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAC1C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAyC;gBAEjD,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKhE,SAAS,CAAC,CAAC,SAAS,YAAY,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,OAAO,CAAC,MAAM,IAAI,CAAC;IAMtB,KAAK;YAQS,mBAAmB;YAcnB,YAAY;IA6B1B,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/types/realtime/hyperliquid/HyperliquidWsProvider.d.ts

@@ -4,10 +4,16 @@ export declare class HyperliquidWsProvider implements WsProvider {
     private rws;
     private subs;
     private listeners;
-    private readonly dexKey;
-    private readonly assetIdLookup;
-    constructor(wsUrl: string, dexKey: string, assetIdLookup: Map<string, number>);
+    private readonly providerKey;
+    private readonly subDexes;
+    private positionsBySubDex;
+    private midsBySubDex;
+    constructor(wsUrl: string, providerKey: string, subDexes: string[]);
     subscribe(sub: Subscription, listener: SubscriptionListener): Promise<() => void>;
+    /** Build sub-key + payload pairs for each sub-dex allMids subscription. */
+    private getPriceSubEntries;
+    /** Build sub-key + payload pairs for each sub-dex clearinghouseState subscription. */
+    private getPositionSubEntries;
     close(): void;
     private resubscribeAll;
     private toKey;
@@ -17,10 +23,10 @@ export declare class HyperliquidWsProvider implements WsProvider {
     private handleMessage;
     private handleAllMids;
     private handleL2Book;
-    private handleTrades;
     private handleCandle;
     private handleOrderUpdates;
     private handleUserFills;
-    private handleWebData2;
+    private handleClearinghouseState;
+    private handleSpotClearinghouseState;
 }
 //# sourceMappingURL=HyperliquidWsProvider.d.ts.map

package/dist/types/realtime/hyperliquid/HyperliquidWsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../../src/realtime/hyperliquid/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAA;AAaxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAWnE,qBAAa,qBAAsB,YAAW,UAAU;IACtD,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAwD;IACpE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAGjD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAS9B,SAAS,CACb,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC;IAoCtB,KAAK;IAML,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IA4CrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;CASvB"}
+{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../../src/realtime/hyperliquid/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,mBAAmB,CAAA;AAY1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAWnE,qBAAa,qBAAsB,YAAW,UAAU;IACtD,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAwD;IACpE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,YAAY,CAA4C;gBAEpD,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;IAQ5D,SAAS,CACb,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC;IA6HtB,2EAA2E;IAC3E,OAAO,CAAC,kBAAkB;IAa1B,sFAAsF;IACtF,OAAO,CAAC,qBAAqB;IAgB7B,KAAK;IAML,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,4BAA4B;CAWrC"}

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

@@ -5,18 +5,11 @@ export type HlWsMessage = {
 };
 export type HlWsAllMidsData = {
     mids: HlAllMids;
+    dex?: string;
 };
 export type HlWsL2BookData = HlL2Book & {
     coin: string;
 };
-export type HlWsTrade = {
-    coin: string;
-    side: string;
-    px: string;
-    sz: string;
-    time: number;
-    tid: number;
-};
 export type HlWsCandleData = HlCandle & {
     T: number;
     s: string;
@@ -28,8 +21,17 @@ export type HlWsUserFillsData = {
     user: string;
     fills: HlUserFill[];
 };
-export type HlWsWebData2Data = {
+export type HlWsClearinghouseStateData = {
+    dex: string;
     user: string;
     clearinghouseState: Pick<HlClearinghouseState, 'assetPositions'>;
 };
+export type HlWsSpotClearinghouseStateData = {
+    user: string;
+    balances: Array<{
+        coin: string;
+        total: string;
+        hold: string;
+    }>;
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/realtime/hyperliquid/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACX,MAAM,yCAAyC,CAAA;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;CACjE,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/realtime/hyperliquid/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACX,MAAM,yCAAyC,CAAA;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;CACjE,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/D,CAAA"}