@lifi/perps-sdk 0.1.1-alpha.4 → 0.1.1-alpha.40

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

@@ -1,51 +1,53 @@
-import type { Address, AuthorizationAction, AuthorizationInput, AuthorizationsResponse, OrderSide, OrderType, SignedAuthorization, TimeInForce, TriggerOrderInput, WithdrawalInput } from '@lifi/perps-types';
+import type { 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 { 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;
-    /** Base API URL. Defaults to https://li.quest/v1/perps */
+    /** 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;
 }
 /**
- * Parameters for building authorization payloads.
+ * Parameters for checking prerequisites (previously: building authorization payloads).
  */
-export interface BuildAuthorizationParams {
-    /** DEX to authorize */
-    dex: string;
+export interface CheckPrerequisitesParams {
+    /** Provider to check prerequisites 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 */
@@ -67,68 +69,93 @@ export interface PlaceOrderParams {
     /** Stop loss trigger */
     stopLoss?: TriggerOrderInput;
 }
+/**
+ * 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 building a withdrawal payload.
  */
 export interface BuildWithdrawalParams {
-    /** DEX to withdraw from */
-    dex: string;
+    /** 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 ModifyOrdersParams {
+    /** Provider to modify orders on */
+    provider: string;
+    /** User wallet address */
+    address: Address;
+    /** Modifications to apply */
+    modifications: ModifyOrderInput[];
+}
+/**
+ * Parameters for checkPrerequisites().
  */
-export interface GetRequiredAuthorizationsParams {
-    /** DEX to check authorizations for */
-    dex: string;
+export interface GetPrerequisitesParams {
+    /** Provider to check prerequisites for */
+    provider: string;
     /** User wallet address */
     address: Address;
 }
 /**
- * Result from getRequiredAuthorizations().
+ * Result from checkPrerequisites().
  */
-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 PrerequisitesResult {
+    /** Prerequisite steps requiring user wallet signature */
+    userPrerequisites: ActionStep[];
+    /** Prerequisite steps the SDK auto-signs with the agent */
+    agentPrerequisites: ActionStep[];
+    /** Whether all prerequisites are already satisfied (ready to trade) */
     isReady: boolean;
 }
 /**
- * Parameters for executeAuthorizations().
+ * Parameters for executePrerequisites().
  */
-export interface ExecuteAuthorizationsParams {
-    /** DEX to authorize */
-    dex: string;
+export interface ExecutePrerequisitesParams {
+    /** Provider to authorize */
+    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 checkPrerequisites() */
+    required: PrerequisitesResult;
+    /** User-signed actions corresponding to required.userPrerequisites */
+    userSignedActions: SignedActionStep[];
 }
 /**
- * Result from executeAuthorizations().
+ * Result from executePrerequisites().
  */
-export interface ExecuteAuthorizationsResult {
-    /** Results from user-signed authorization submission */
-    userResults: AuthorizationsResponse;
-    /** Results from agent-signed authorization submission (if any) */
-    agentResults?: AuthorizationsResponse;
+export interface ExecutePrerequisitesResult {
+    /** Results from user-signed prerequisite submission */
+    userResults: ExecuteActionResponse;
+    /** Results from agent-signed prerequisite submission (if any) */
+    agentResults?: ExecuteActionResponse;
+    /** Fallback user prerequisites when agent prerequisites fail (e.g. USER_SET_ABSTRACTION when AGENT_SET_ABSTRACTION cannot upgrade from dexAbstraction) */
+    fallbackUserPrerequisites?: ActionStep[];
 }
 //# 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":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,+BAA+B;IAC/B,cAAc,EAAE,kBAAkB,EAAE,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,oBAAoB;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,UAAU,EAAE,eAAe,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0FAA0F;IAC1F,kBAAkB,EAAE,mBAAmB,EAAE,CAAA;IACzC,gFAAgF;IAChF,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;IAC1C,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,QAAQ,EAAE,4BAA4B,CAAA;IACtC,uEAAuE;IACvE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,WAAW,EAAE,sBAAsB,CAAA;IACnC,kEAAkE;IAClE,YAAY,CAAC,EAAE,sBAAsB,CAAA;CACtC"}
+{"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,53 @@
 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 } 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 type { BuildWithdrawalParams, CancelOrdersParams, CheckPrerequisitesParams, ExecutePrerequisitesParams, ExecutePrerequisitesResult, GetPrerequisitesParams, HyperliquidConfig, ModifyOrdersParams, PerpsClientOptions, PlaceOrderParams as ClientPlaceOrderParams, PlaceTriggerOrderParams as ClientPlaceTriggerOrderParams, PrerequisitesResult, ProviderConfig, ProviderConfigs, } 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 { 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 { 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 { stringToFloat } from './utils/parse.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/realtime/PerpsWsClient.d.ts

@@ -10,5 +10,6 @@ export declare class PerpsWsClient {
     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,KAAK,EACV,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAEnB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAyC;gBAEjD,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;IAMtB,KAAK;YAQS,mBAAmB;YAcnB,YAAY;IA6B1B,OAAO,CAAC,gBAAgB;CASzB"}

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;IAmBnB,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"}

package/dist/types/services/createAction.d.ts

@@ -0,0 +1,11 @@
+import type { ActionParamsMap, ActionType, Address, CreateActionResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface CreateActionParams<T extends ActionType = ActionType> {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: T;
+    params: ActionParamsMap[T];
+}
+export declare function createAction<T extends ActionType>(client: PerpsSDKClient, params: CreateActionParams<T>, options?: SDKRequestOptions): Promise<CreateActionResponse>;
+//# sourceMappingURL=createAction.d.ts.map

package/dist/types/services/createAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAction.d.ts","sourceRoot":"","sources":["../../../src/services/createAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,OAAO,EACP,oBAAoB,EACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,CAAC,CAAA;IACT,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC3B;AAED,wBAAsB,YAAY,CAAC,CAAC,SAAS,UAAU,EACrD,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAgB/B"}

package/dist/types/services/executeAction.d.ts

@@ -0,0 +1,11 @@
+import type { ActionType, Address, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface ExecuteActionParams {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: ActionType;
+    actions: SignedActionStep[];
+}
+export declare function executeAction(client: PerpsSDKClient, params: ExecuteActionParams, options?: SDKRequestOptions): Promise<ExecuteActionResponse>;
+//# sourceMappingURL=executeAction.d.ts.map

package/dist/types/services/executeAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeAction.d.ts","sourceRoot":"","sources":["../../../src/services/executeAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAgBhC"}

package/dist/types/services/getAccount.d.ts

@@ -1,31 +1,31 @@
 import type { AccountResponse, Address } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetAccountParams {
-    /** DEX to get account from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get account from (e.g., 'hyperliquid') */
+    provider: string;
     /** Wallet address */
     address: Address;
 }
 /**
- * Get account information including balances, positions, and open orders.
+ * Get account information including balances and margin details.
+ *
+ * Use {@link getPositions} and {@link getOrders} to fetch positions and orders separately.
  *
  * @param client - The SDK client instance
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Account details
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const account = await getAccount(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   address: '0x1234...'
  * })
  * console.log(account.balances) // [{ currency: 'USDC', amount: '10000.00' }]
- * console.log(account.positions) // [{ symbol: 'BTC', side: 'LONG', ... }]
- * console.log(account.openOrders) // [{ id: '123', symbol: 'BTC', ... }]
  * ```
  */
 export declare function getAccount(client: PerpsSDKClient, params: GetAccountParams, options?: SDKRequestOptions): Promise<AccountResponse>;

package/dist/types/services/getAccount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}
+{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}

package/dist/types/services/getActivity.d.ts

@@ -0,0 +1,49 @@
+import type { ActivitiesResponse, ActivityType, Address } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetActivityParams {
+    /** Provider to get activity from (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Maximum number of items to return */
+    limit?: number;
+    /** Cursor for pagination */
+    cursor?: string;
+    /** Filter: activity after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: activity before this timestamp (ms) */
+    endTime?: number;
+    /** Filter by activity type(s) */
+    type?: ActivityType[];
+}
+/**
+ * Get account activity (deposits, withdrawals, liquidations, funding payments).
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Activity items with pagination
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { items, pagination } = await getActivity(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50
+ * })
+ *
+ * // Fetch next page
+ * if (pagination.hasMore) {
+ *   const nextPage = await getActivity(client, {
+ *     provider: 'hyperliquid',
+ *     address: '0x1234...',
+ *     cursor: pagination.cursor
+ *   })
+ * }
+ * ```
+ */
+export declare function getActivity(client: PerpsSDKClient, params: GetActivityParams, options?: SDKRequestOptions): Promise<ActivitiesResponse>;
+//# sourceMappingURL=getActivity.d.ts.map

package/dist/types/services/getActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.d.ts","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACR,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}