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

package/dist/esm/errors/PerpsError.js

@@ -1,23 +1,11 @@
 import { PerpsErrorCode } from '@lifi/perps-types';
-import { version } from '../version.js';
-import { PerpsErrorName } from './constants.js';
 export class PerpsError extends Error {
     code;
-    name = PerpsErrorName.PerpsError;
+    name = 'PerpsError';
+    tool;
     constructor(code = PerpsErrorCode.DefaultError, message = 'Unknown error occurred') {
-        const errorMessage = `[${PerpsErrorName.PerpsError}] ${message}\nLI.FI Perps SDK version: ${version}`;
-        super(errorMessage);
+        super(message);
         this.code = code;
-        this.name = PerpsErrorName.PerpsError;
-    }
-    static fromError(error, defaultCode) {
-        if (error instanceof PerpsError) {
-            return error;
-        }
-        if (error instanceof Error) {
-            return new PerpsError(defaultCode ?? PerpsErrorCode.DefaultError, error.message);
-        }
-        return new PerpsError(defaultCode ?? PerpsErrorCode.DefaultError, String(error));
     }
 }
 //# sourceMappingURL=PerpsError.js.map

package/dist/esm/errors/PerpsError.js.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsError.js","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,IAAI,CAAgB;IACX,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;IAEzC,YACE,OAAuB,cAAc,CAAC,YAAY,EAClD,OAAO,GAAG,wBAAwB;QAElC,MAAM,YAAY,GAAG,IAAI,cAAc,CAAC,UAAU,KAAK,OAAO,8BAA8B,OAAO,EAAE,CAAA;QACrG,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;IACvC,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAc,EAAE,WAA4B;QAC3D,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,UAAU,CACnB,WAAW,IAAI,cAAc,CAAC,YAAY,EAC1C,KAAK,CAAC,OAAO,CACd,CAAA;QACH,CAAC;QACD,OAAO,IAAI,UAAU,CACnB,WAAW,IAAI,cAAc,CAAC,YAAY,EAC1C,MAAM,CAAC,KAAK,CAAC,CACd,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"PerpsError.js","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,IAAI,CAAgB;IACX,IAAI,GAAG,YAAY,CAAA;IAC5B,IAAI,CAAS;IAEb,YACE,OAAuB,cAAc,CAAC,YAAY,EAClD,OAAO,GAAG,wBAAwB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/errors/constants.js

@@ -1,16 +1,5 @@
-export var PerpsErrorName;
-(function (PerpsErrorName) {
-    PerpsErrorName["PerpsError"] = "PerpsError";
-    PerpsErrorName["HTTPError"] = "HTTPError";
-    PerpsErrorName["ValidationError"] = "ValidationError";
-    PerpsErrorName["ServerError"] = "ServerError";
-    PerpsErrorName["ConfigError"] = "ConfigError";
-    PerpsErrorName["AgentError"] = "AgentError";
-})(PerpsErrorName || (PerpsErrorName = {}));
 export var PerpsErrorMessage;
 (function (PerpsErrorMessage) {
-    PerpsErrorMessage["UnknownError"] = "Unknown error occurred.";
-    PerpsErrorMessage["ConfigNotInitialized"] = "SDK not configured. Call createPerpsConfig() first.";
     PerpsErrorMessage["AgentNotFound"] = "Agent not found. Call setSigningMode() first.";
     PerpsErrorMessage["InvalidSigningMode"] = "Invalid signing mode for this operation.";
 })(PerpsErrorMessage || (PerpsErrorMessage = {}));

package/dist/esm/errors/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,qDAAmC,CAAA;IACnC,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAC3B,2CAAyB,CAAA;AAC3B,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAED,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,6DAAwC,CAAA;IACxC,iGAA4E,CAAA;IAC5E,oFAA+D,CAAA;IAC/D,oFAA+D,CAAA;AACjE,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,oFAA+D,CAAA;IAC/D,oFAA+D,CAAA;AACjE,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B"}

package/dist/esm/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/esm/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/esm/index.js

@@ -1,43 +1,48 @@
 // Client
 // Types
 export * from '@lifi/perps-types';
+// Utils
+// biome-ignore lint/correctness/useImportExtensions: package subpath export
+export { HlAbstractionMode } from '@lifi/perps-types/providers/hyperliquid';
 // Agent
 export { AgentManager } from './agent/AgentManager.js';
 export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
 export { createPerpsClient, DEFAULT_API_URL, } from './client/createPerpsClient.js';
 export { PerpsClient } from './client/PerpsClient.js';
-// Dex
-export { getDexAuthProvider } from './dex/registry.js';
-export { AgentError } from './errors/AgentError.js';
-export { PerpsErrorMessage, PerpsErrorName } from './errors/constants.js';
+export { projectAccountConfigSettings } from './client/projectAccountConfigSettings.js';
+export { SigningMode } from './client/types.js';
 // Errors
-export { HTTPError } from './errors/HTTPError.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';
 // Realtime
 export { PerpsWsClient } from './realtime/PerpsWsClient.js';
-// Services
-export { cancelOrder } from './services/cancelOrder.js';
-export { createAuthorization } from './services/createAuthorization.js';
-export { createOrder } from './services/createOrder.js';
-export { createWithdrawal } from './services/createWithdrawal.js';
+export { createAction } from './services/createAction.js';
+export { executeAction } from './services/executeAction.js';
 export { getAccount } from './services/getAccount.js';
-export { getDexes } from './services/getDexes.js';
-export { getHistory } from './services/getHistory.js';
-export { getMarket } from './services/getMarket.js';
-export { getMarkets } from './services/getMarkets.js';
+export { getActivity } from './services/getActivity.js';
+export { getAsset } from './services/getAsset.js';
+export { getAssets } from './services/getAssets.js';
+export { getFills } from './services/getFills.js';
 export { getOhlcv } from './services/getOhlcv.js';
 export { getOrder } from './services/getOrder.js';
 export { getOrderbook } from './services/getOrderbook.js';
+export { getOrders } from './services/getOrders.js';
+export { getPositions } from './services/getPositions.js';
 export { getPrices } from './services/getPrices.js';
-export { submitAuthorization } from './services/submitAuthorization.js';
-export { submitOrder } from './services/submitOrder.js';
-export { submitWithdrawal } from './services/submitWithdrawal.js';
-// Utils
+export { getProviders } from './services/getProviders.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 { calculateAccountSummary } from './utils/accountSummary.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';
 // Version
 export { name, version } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AAET,QAAQ;AACR,cAAc,mBAAmB,CAAA;AACjC,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAS7E,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAarD,MAAM;AACN,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACzE,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,GACb,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAG3D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEjE,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,UAAU;AACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/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/esm/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/esm/providers/hyperliquid/accountConfig.js

@@ -0,0 +1,69 @@
+import { ActionType, PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../../errors/PerpsError.js';
+import { assertNever } from '../../utils/assertNever.js';
+/**
+ * Project a single Hyperliquid descriptor against the typed
+ * `HyperliquidAccountConfig` into an `AccountConfigSetting`.
+ *
+ * Mapping table:
+ *
+ * | descriptor.type          | projected values
+ * |--------------------------|-----------------------------------------------
+ * | APPROVE_AGENT            | []                  (no parameters)
+ * | APPROVE_BUILDER_FEE      | []                  (no parameters)
+ * | ACCOUNT_MODE             | [{ name: 'mode', value: config.abstractionMode }]
+ *
+ * The switch is exhaustive over `ActionType` so enum additions force a
+ * compile error in the `default` arm. ActionTypes that are not valid on
+ * `Provider.setup` / `Provider.options` throw at runtime.
+ */
+function projectHyperliquidDescriptor(descriptor, config) {
+    switch (descriptor.type) {
+        // Zero-parameter user-approval descriptors. The "satisfied or not"
+        // state for these comes from `checkSetup`'s unsatisfied list, not from
+        // a projected value.
+        case ActionType.APPROVE_AGENT:
+        case ActionType.APPROVE_BUILDER_FEE:
+            return { type: descriptor.type, values: [] };
+        // `config.abstractionMode === null` means abstraction has never been set;
+        // callers fall back to the descriptor's `default` ParamOption.
+        case ActionType.ACCOUNT_MODE:
+            return {
+                type: descriptor.type,
+                values: [{ name: 'mode', value: config.abstractionMode }],
+            };
+        case ActionType.ACCOUNT_TYPE:
+        case ActionType.SEND_ASSET:
+        case ActionType.WITHDRAWAL:
+        case ActionType.TRANSFER:
+        case ActionType.PLACE_ORDER:
+        case ActionType.PLACE_TRIGGER_ORDER:
+        case ActionType.CANCEL_ORDER:
+        case ActionType.CANCEL_ALL_ORDERS:
+        case ActionType.MODIFY_ORDER:
+        case ActionType.UPDATE_LEVERAGE:
+        case ActionType.UPDATE_POSITION_MARGIN:
+        case ActionType.REGISTER_API_KEY:
+        case ActionType.APPROVE_READ_ONLY_TOKEN:
+        case ActionType.DEPOSIT:
+            throw new PerpsError(PerpsErrorCode.SDKError, `Hyperliquid account-config mapper has no projection for ` +
+                `descriptor type '${descriptor.type}' — this ActionType is not ` +
+                `valid on Provider.setup / Provider.options for Hyperliquid.`);
+        default:
+            return assertNever(descriptor.type);
+    }
+}
+/**
+ * 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 function projectHyperliquidConfigSettings(config, setup, options) {
+    return [...setup, ...options].map((descriptor) => projectHyperliquidDescriptor(descriptor, config));
+}
+//# sourceMappingURL=accountConfig.js.map

package/dist/esm/providers/hyperliquid/accountConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.js","sourceRoot":"","sources":["../../../../src/providers/hyperliquid/accountConfig.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD;;;;;;;;;;;;;;;GAeG;AACH,SAAS,4BAA4B,CACnC,UAAoC,EACpC,MAAgC;IAEhC,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,mEAAmE;QACnE,uEAAuE;QACvE,qBAAqB;QACrB,KAAK,UAAU,CAAC,aAAa,CAAC;QAC9B,KAAK,UAAU,CAAC,mBAAmB;YACjC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;QAE9C,0EAA0E;QAC1E,+DAA+D;QAC/D,KAAK,UAAU,CAAC,YAAY;YAC1B,OAAO;gBACL,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;aAC1D,CAAA;QAEH,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,QAAQ,CAAC;QACzB,KAAK,UAAU,CAAC,WAAW,CAAC;QAC5B,KAAK,UAAU,CAAC,mBAAmB,CAAC;QACpC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,iBAAiB,CAAC;QAClC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,eAAe,CAAC;QAChC,KAAK,UAAU,CAAC,sBAAsB,CAAC;QACvC,KAAK,UAAU,CAAC,gBAAgB,CAAC;QACjC,KAAK,UAAU,CAAC,uBAAuB,CAAC;QACxC,KAAK,UAAU,CAAC,OAAO;YACrB,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,0DAA0D;gBACxD,oBAAoB,UAAU,CAAC,IAAI,6BAA6B;gBAChE,6DAA6D,CAChE,CAAA;QAEH;YACE,OAAO,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAgC,EAChC,KAAsB,EACtB,OAAyB;IAEzB,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAC/C,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,CACjD,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/providers/lighter/accountConfig.js

@@ -0,0 +1,79 @@
+import { ActionType, PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../../errors/PerpsError.js';
+import { assertNever } from '../../utils/assertNever.js';
+/**
+ * Project a single Lighter descriptor against the typed
+ * `LighterAccountConfig` into an `AccountConfigSetting`.
+ *
+ * Mapping table:
+ *
+ * | descriptor.type           | projected values
+ * |---------------------------|--------------------------------------------------
+ * | REGISTER_API_KEY          | []                  (no parameters)
+ * | APPROVE_READ_ONLY_TOKEN   | []                  (no parameters)
+ * | ACCOUNT_MODE              | [{ name: 'mode', value: null }]  (Lighter has no
+ * |                           |  abstraction-mode equivalent; read-only here)
+ * | ACCOUNT_TYPE              | [{ name: 'tier', value: config.accountType }]
+ *
+ * The switch is exhaustive over `ActionType` so enum additions force a
+ * compile error in the `default` arm. ActionTypes that are not valid on
+ * `Provider.setup` / `Provider.options` throw at runtime.
+ */
+function projectLighterDescriptor(descriptor, config) {
+    switch (descriptor.type) {
+        // Zero-parameter user-approval descriptors. The "satisfied or not"
+        // state comes from `checkSetup`'s unsatisfied list and the
+        // `config.apiKeyRegistered` / `config.readOnlyTokenApproved` flags,
+        // not from a projected value.
+        case ActionType.REGISTER_API_KEY:
+        case ActionType.APPROVE_READ_ONLY_TOKEN:
+            return { type: descriptor.type, values: [] };
+        // Lighter exposes no abstraction-mode equivalent; if a backend descriptor
+        // surfaces ACCOUNT_MODE on Lighter it always projects `null` and callers
+        // fall back to the descriptor's `default` ParamOption.
+        case ActionType.ACCOUNT_MODE:
+            return {
+                type: descriptor.type,
+                values: [{ name: 'mode', value: null }],
+            };
+        // `tier` maps to the raw integer `config.accountType` Lighter publishes;
+        // decoding to a human label is the caller's responsibility.
+        case ActionType.ACCOUNT_TYPE:
+            return {
+                type: descriptor.type,
+                values: [{ name: 'tier', value: config.accountType }],
+            };
+        case ActionType.APPROVE_AGENT:
+        case ActionType.APPROVE_BUILDER_FEE:
+        case ActionType.SEND_ASSET:
+        case ActionType.WITHDRAWAL:
+        case ActionType.TRANSFER:
+        case ActionType.PLACE_ORDER:
+        case ActionType.PLACE_TRIGGER_ORDER:
+        case ActionType.CANCEL_ORDER:
+        case ActionType.CANCEL_ALL_ORDERS:
+        case ActionType.MODIFY_ORDER:
+        case ActionType.UPDATE_LEVERAGE:
+        case ActionType.UPDATE_POSITION_MARGIN:
+        case ActionType.DEPOSIT:
+            throw new PerpsError(PerpsErrorCode.SDKError, `Lighter account-config mapper has no projection for ` +
+                `descriptor type '${descriptor.type}' — this ActionType is not ` +
+                `valid on Provider.setup / Provider.options for Lighter.`);
+        default:
+            return assertNever(descriptor.type);
+    }
+}
+/**
+ * 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 function projectLighterConfigSettings(config, setup, options) {
+    return [...setup, ...options].map((descriptor) => projectLighterDescriptor(descriptor, config));
+}
+//# sourceMappingURL=accountConfig.js.map

package/dist/esm/providers/lighter/accountConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.js","sourceRoot":"","sources":["../../../../src/providers/lighter/accountConfig.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,wBAAwB,CAC/B,UAAoC,EACpC,MAA4B;IAE5B,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,mEAAmE;QACnE,2DAA2D;QAC3D,oEAAoE;QACpE,8BAA8B;QAC9B,KAAK,UAAU,CAAC,gBAAgB,CAAC;QACjC,KAAK,UAAU,CAAC,uBAAuB;YACrC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;QAE9C,0EAA0E;QAC1E,yEAAyE;QACzE,uDAAuD;QACvD,KAAK,UAAU,CAAC,YAAY;YAC1B,OAAO;gBACL,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACxC,CAAA;QAEH,yEAAyE;QACzE,4DAA4D;QAC5D,KAAK,UAAU,CAAC,YAAY;YAC1B,OAAO;gBACL,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;aACtD,CAAA;QAEH,KAAK,UAAU,CAAC,aAAa,CAAC;QAC9B,KAAK,UAAU,CAAC,mBAAmB,CAAC;QACpC,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,QAAQ,CAAC;QACzB,KAAK,UAAU,CAAC,WAAW,CAAC;QAC5B,KAAK,UAAU,CAAC,mBAAmB,CAAC;QACpC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,iBAAiB,CAAC;QAClC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,eAAe,CAAC;QAChC,KAAK,UAAU,CAAC,sBAAsB,CAAC;QACvC,KAAK,UAAU,CAAC,OAAO;YACrB,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,sDAAsD;gBACpD,oBAAoB,UAAU,CAAC,IAAI,6BAA6B;gBAChE,yDAAyD,CAC5D,CAAA;QAEH;YACE,OAAO,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA4B,EAC5B,KAAsB,EACtB,OAAyB;IAEzB,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAC/C,wBAAwB,CAAC,UAAU,EAAE,MAAM,CAAC,CAC7C,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/realtime/PerpsWsClient.js

@@ -1,15 +1,18 @@
-import { getDexes } from '../services/getDexes.js';
-import { getMarkets } from '../services/getMarkets.js';
+import { getProviders } from '../services/getProviders.js';
 import { HyperliquidWsProvider } from './hyperliquid/HyperliquidWsProvider.js';
+import { LighterWsProvider, } from './lighter/LighterWsProvider.js';
 export class PerpsWsClient {
     client;
+    options;
     providers = new Map();
     initPromises = new Map();
-    constructor(client) {
+    constructor(client, options = {}) {
         this.client = client;
+        this.options = options;
     }
     async subscribe(sub, listener) {
-        const provider = await this.getOrCreateProvider(sub.dex);
+        const providerKey = sub.dex;
+        const provider = await this.getOrCreateProvider(providerKey);
         return provider.subscribe(sub, listener);
     }
     close() {
@@ -19,34 +22,44 @@ export class PerpsWsClient {
         this.providers.clear();
         this.initPromises.clear();
     }
-    async getOrCreateProvider(dex) {
-        const existing = this.providers.get(dex);
+    async getOrCreateProvider(provider) {
+        const existing = this.providers.get(provider);
         if (existing) {
             return existing;
         }
-        let initPromise = this.initPromises.get(dex);
+        let initPromise = this.initPromises.get(provider);
         if (!initPromise) {
-            initPromise = this.initProvider(dex);
-            this.initPromises.set(dex, initPromise);
+            initPromise = this.initProvider(provider);
+            this.initPromises.set(provider, initPromise);
         }
         return initPromise;
     }
-    async initProvider(dex) {
-        const [{ dexes }, { markets }] = await Promise.all([
-            getDexes(this.client),
-            getMarkets(this.client, { dex }),
-        ]);
-        const dexInfo = dexes.find((d) => d.key === dex);
-        if (!dexInfo?.wsUrl) {
-            throw new Error(`No WebSocket URL found for dex: ${dex}`);
+    async initProvider(provider) {
+        const { providers } = await getProviders(this.client);
+        const providerInfo = providers.find((d) => d.key === provider);
+        if (!providerInfo?.wsUrl) {
+            throw new Error(`No WebSocket URL found for provider: ${provider}`);
         }
-        const assetIdLookup = new Map();
-        for (const m of markets) {
-            assetIdLookup.set(m.symbol, m.assetId);
+        const allMarkets = (providerInfo.markets ?? []);
+        const providerConfig = this.client.config.providers?.[provider];
+        const configuredMarkets = providerConfig?.markets;
+        const filteredMarkets = configuredMarkets
+            ? allMarkets.filter((m) => configuredMarkets.includes(m.id))
+            : allMarkets;
+        const subProviders = filteredMarkets
+            .map((m) => m.id)
+            .filter((id) => id !== provider && id !== 'spot');
+        const wsProvider = this.createWsProvider(provider, providerInfo.wsUrl, subProviders);
+        this.providers.set(provider, wsProvider);
+        return wsProvider;
+    }
+    createWsProvider(provider, wsUrl, subProviders) {
+        if (provider === 'lighter') {
+            return new LighterWsProvider(wsUrl, provider, {
+                authProvider: this.options.lighterAuthProvider,
+            });
         }
-        const provider = new HyperliquidWsProvider(dexInfo.wsUrl, dex, assetIdLookup);
-        this.providers.set(dex, provider);
-        return provider;
+        return new HyperliquidWsProvider(wsUrl, provider, subProviders);
     }
 }
 //# sourceMappingURL=PerpsWsClient.js.map