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

package/dist/types/utils/hyperliquid/liquidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAYpB"}

package/dist/types/utils/hyperliquid/orderFormatting.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Hyperliquid order size and price formatting for exchange submission.
+ *
+ * These encode Hyperliquid-specific order submission rules. Getting size/price
+ * formatting wrong causes rejected orders.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
+ */
+/**
+ * Derive the maximum number of price decimal places for a given asset.
+ *
+ * @param szDecimals - The asset's szDecimals (from market meta)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Maximum allowed price decimals
+ */
+export declare function getMaxPriceDecimals(szDecimals: number, market?: string): number;
+/**
+ * Format a size value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Size must be rounded to the asset's szDecimals
+ * - Trailing zeroes must be removed for signing
+ *
+ * @param size - The size value to format
+ * @param szDecimals - Number of decimal places allowed for this asset (from meta)
+ * @returns Size as a string with correct precision, no trailing zeros
+ */
+export declare function formatOrderSize(size: number, szDecimals: number): string;
+/**
+ * Format a price value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Maximum 5 significant figures
+ * - Max decimals = MAX_DECIMALS - szDecimals (6 for perps, 8 for spot)
+ * - Integer prices always allowed regardless of significant figures
+ * - Trailing zeroes must be removed for signing
+ *
+ * @param price - The price value to format
+ * @param szDecimals - The asset's szDecimals (affects max price decimals)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Price as a string with correct precision, no trailing zeros
+ */
+export declare function formatOrderPrice(price: number, szDecimals: number, market?: string): string;
+//# sourceMappingURL=orderFormatting.d.ts.map

package/dist/types/utils/hyperliquid/orderFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAsBR"}

package/dist/types/utils/orderClassification.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Order classification utilities.
+ *
+ * Type guards and classifiers that operate on SDK types to determine
+ * order categories (TP/SL, open/close). These use the OrderType enum
+ * for classification — no string matching.
+ */
+import type { OpenOrder } from '@lifi/perps-types';
+import { FillClassification, OrderSide } from '@lifi/perps-types';
+export { FillClassification };
+/**
+ * Check if an open order is a Take Profit trigger order.
+ */
+export declare function isTakeProfitOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Check if an open order is a Stop Loss trigger order.
+ */
+export declare function isStopLossOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Check if an open order is a TP or SL trigger order.
+ */
+export declare function isTpSlOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Classify a fill as open or close based on realizedPnl.
+ * @deprecated Use `Fill.classification` instead — it uses startPosition
+ * for accurate open/increase/reduce/close/reverse classification.
+ */
+export declare function classifyFill(side: OrderSide, realizedPnl: string | null | undefined): FillClassification;
+//# sourceMappingURL=orderClassification.d.ts.map

package/dist/types/utils/orderClassification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderClassification.d.ts","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAA;AAG5E,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAY7B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,kBAAkB,CAUpB"}

package/dist/types/utils/orderMath.d.ts

@@ -0,0 +1,40 @@
+import { type OpenOrder, type Position, type TriggerOrder } from '@lifi/perps-types';
+/**
+ * Pick the matching open position for an order's asset, if any.
+ *
+ * @param assetId - The order's `asset.assetId`.
+ * @param positions - Open positions list (any symbol).
+ */
+export declare function findMatchingPosition(assetId: string, positions: readonly Position[]): Position | undefined;
+/**
+ * Resolve the close-size against a position, applying the spec's cap rules:
+ *  - `orderSize === 0` is the Hyperliquid convention for "close entire
+ *    position" → close the full position size.
+ *  - Otherwise cap at the absolute position size; an order larger than the
+ *    position can only close what's open.
+ *
+ * Inputs are non-negative magnitudes.
+ */
+export declare function resolveCloseSize(orderSize: number, positionSize: number): number;
+/**
+ * Expected rPnL for a resting limit order against a matching position.
+ *
+ * Reducing requires opposite sides (long position + SELL, short position +
+ * BUY). Same-side orders add to the position and have no rPnL → `null`.
+ *
+ * @returns Realised PnL if the order would reduce the position, otherwise
+ *   `null`.
+ */
+export declare function expectedRealizedPnlForOpenOrder(order: OpenOrder, position: Position | undefined): number | null;
+/**
+ * Expected rPnL for a TP/SL trigger order against a matching position.
+ *
+ * A trigger order is by construction a closing leg — its direction is the
+ * opposite of the position's. With no matching position there is nothing to
+ * close, so rPnL is `null`. The trigger price (always present on the SDK
+ * `TriggerOrder` shape) is used as the rPnL price; the optional `limitPrice`
+ * for STOP_LIMIT / TAKE_PROFIT_LIMIT is the post-trigger limit, not the rPnL
+ * price.
+ */
+export declare function expectedRealizedPnlForTriggerOrder(order: TriggerOrder, position: Position | undefined): number | null;
+//# sourceMappingURL=orderMath.d.ts.map

package/dist/types/utils/orderMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderMath.d.ts","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,QAAQ,EAEb,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAkCf;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA2Bf"}

package/dist/types/utils/parse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Robust string-to-number parsing utilities.
+ */
+/**
+ * Parse a string to a float, stripping common formatting artefacts.
+ *
+ * Handles:
+ * - Currency prefixes/suffixes ($, USD, etc.)
+ * - Explicit sign prefixes (+/-)
+ * - Thousands separators (commas)
+ * - Percentage suffixes (%)
+ * - Whitespace
+ *
+ * @param value - The string to parse
+ * @returns Parsed number, or NaN if the string contains no valid number
+ */
+export declare function stringToFloat(value: string): number;
+//# sourceMappingURL=parse.d.ts.map

package/dist/types/utils/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnD"}

package/dist/types/utils/positionMath.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Pure-function helpers for predicting how a perp position changes after a
+ * fill.
+ *
+ * Sign convention: long = +1, short = -1. Sizes passed to these helpers are
+ * always non-negative magnitudes; direction is carried by `isLong`.
+ */
+/**
+ * Direction sign for a position.
+ *
+ * @param isLong - True for long positions, false for short.
+ * @returns +1 for long, -1 for short.
+ */
+export declare function directionSign(isLong: boolean): 1 | -1;
+/**
+ * Predicted average entry price after adding to an existing position.
+ *
+ * Weighted average of the current entry and the new fill price, weighted by
+ * the size of each leg in coin units. Both legs assumed in the same direction
+ * (this helper is for adding to, not flipping, a position).
+ *
+ * @param currentSize - Existing position size in coin units (>= 0).
+ * @param currentEntry - Existing position's average entry price.
+ * @param addSize - Size being added in coin units (>= 0).
+ * @param fillPrice - Price the new size is expected to fill at (mid for
+ *   market, limitPrice for limit orders).
+ * @returns The new weighted-average entry price, or undefined if the inputs
+ *   cannot produce a valid average (zero combined size, non-finite values).
+ */
+export declare function predictAverageEntryPrice(params: {
+    currentSize: number;
+    currentEntry: number;
+    addSize: number;
+    fillPrice: number;
+}): number | undefined;
+/**
+ * Predicted effective leverage after adding margin and notional.
+ *
+ * leverage = totalNotional / totalMargin. The caller computes notional from
+ * size and price (`calculateNotionalValue`) and supplies the additional
+ * margin the user is about to put up.
+ *
+ * @returns The new effective leverage, or undefined if total margin is
+ *   non-positive.
+ */
+export declare function predictNewLeverage(params: {
+    currentNotional: number;
+    currentMargin: number;
+    addNotional: number;
+    addMargin: number;
+}): number | undefined;
+/**
+ * Predicted unrealised PnL at the current mark price.
+ *
+ * `pnl = (markPrice - entryPrice) * size * directionSign(isLong)`
+ *
+ * @param size - Position size as a non-negative magnitude.
+ */
+export declare function predictUnrealizedPnl(params: {
+    entryPrice: number;
+    markPrice: number;
+    size: number;
+    isLong: boolean;
+}): number;
+/**
+ * Realised PnL on the portion of a position being closed.
+ *
+ * `rPnl = (closePrice - entryPrice) * closeSize * directionSign(isLong)`
+ *
+ * @param closeSize - Size being closed as a non-negative magnitude.
+ */
+export declare function realizedPnlOnClose(params: {
+    entryPrice: number;
+    closePrice: number;
+    closeSize: number;
+    isLong: boolean;
+}): number;
+//# sourceMappingURL=positionMath.d.ts.map

package/dist/types/utils/positionMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionMath.d.ts","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAErD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAUrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT"}

package/dist/types/utils/request.d.ts

@@ -11,8 +11,7 @@ export interface RequestOptions extends RequestInit {
  * @param options - Fetch options plus retries
  * @param sdkOptions - SDK-specific options (signal, etc.)
  * @returns Parsed JSON response
- * @throws {HTTPError} On non-2xx responses
- * @throws {PerpsError} On network or parsing errors
+ * @throws {PerpsError} On non-2xx responses or network errors
  */
 export declare function request<T>(config: PerpsBaseConfig, url: string, options?: RequestOptions, sdkOptions?: SDKRequestOptions): Promise<T>;
 /**

package/dist/types/utils/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/utils/request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAMvC,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,EAC5B,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA2DZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CAWR"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/utils/request.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAKvC,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,EAC5B,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA+EZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CAWR"}

package/dist/types/utils/signTypedData.d.ts

@@ -1,15 +1,13 @@
 import type { Hex, PerpsTypedData } from '@lifi/perps-types';
+import type { Account, WalletClient } from 'viem';
 /**
- * Sign EIP-712 typed data with a private key.
- *
- * @param privateKey - The private key to sign with
- * @param typedData - The typed data to sign
- * @returns The signature as a hex string
- *
- * @example
- * ```ts
- * const signature = await signTypedData(agentPrivateKey, typedData)
- * ```
+ * Sign EIP-712 typed data with a raw private key (agent keypair).
  */
 export declare function signTypedData(privateKey: Hex, typedData: PerpsTypedData): Promise<Hex>;
+/**
+ * Sign EIP-712 typed data with an externally-provided WalletClient. Works
+ * with browser wallets (wagmi), private keys, mnemonics — any viem
+ * WalletClient.
+ */
+export declare function signTypedDataWithSigner(signer: WalletClient<any, any, Account>, typedData: PerpsTypedData): Promise<Hex>;
 //# sourceMappingURL=signTypedData.d.ts.map

package/dist/types/utils/signTypedData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signTypedData.d.ts","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAYd"}
+{"version":3,"file":"signTypedData.d.ts","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAOd;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EACvC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAOd"}

package/dist/types/utils/units.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Token unit conversion utilities.
+ */
+/**
+ * Convert a base-unit amount (bigint string) to a human-readable decimal string.
+ *
+ * @param amount - Amount in base units (e.g. "1000000" for 1 USDC)
+ * @param decimals - Token decimals (e.g. 6 for USDC)
+ * @returns Decimal string (e.g. "1.0")
+ */
+export declare function fromBaseUnits(amount: string, decimals: number): string;
+/**
+ * Convert a base-unit amount to a number.
+ *
+ * @param amount - Amount in base units
+ * @param decimals - Token decimals
+ * @returns Numeric value, or 0 if parsing fails
+ */
+export declare function fromBaseUnitsNumber(amount: string, decimals: number): number;
+//# sourceMappingURL=units.d.ts.map

package/dist/types/utils/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/types/utils/validation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Order validation utilities.
+ */
+/**
+ * Validate margin input against available balance and exchange minimums.
+ *
+ * @param margin - Margin amount in USD
+ * @param _leverage - Position leverage (reserved for future use)
+ * @param availableBalance - Available balance, or null if unknown
+ * @param _feeRate - Fee rate as decimal, or null if unknown (reserved for future use)
+ * @param minMarginUsd - Minimum margin requirement in USD (exchange-specific)
+ * @returns Error code: 'insufficient' | 'below-minimum' | '' (valid)
+ */
+export declare function validateMargin(margin: number, _leverage: number, availableBalance: number | null, _feeRate: number | null, minMarginUsd: number): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR"}

package/dist/types/version.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "@lifi/perps-sdk";
-export declare const version = "0.1.1-alpha.8";
+export declare const version = "0.2.0-alpha.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk",
-  "version": "0.1.1-alpha.8",
+  "version": "0.2.0-alpha.0",
   "description": "LI.FI Perps SDK for perpetuals trading",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -27,11 +27,17 @@
       "import": "./dist/esm/index.js",
       "default": "./dist/cjs/index.js"
     },
+    "./utils/hyperliquid": {
+      "types": "./dist/types/utils/hyperliquid/index.d.ts",
+      "import": "./dist/esm/utils/hyperliquid/index.js",
+      "default": "./dist/cjs/utils/hyperliquid/index.js"
+    },
+    "./wasm/*": "./wasm/*",
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@lifi/perps-types": "0.1.1-alpha.7",
-    "viem": "^2.21.0"
+    "@lifi/perps-types": "0.2.0-alpha.0",
+    "viem": "2.48.8"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
@@ -62,7 +68,9 @@
     "!**/__mocks__/**",
     "!*.tmp",
     "!*.env",
-    "!tsconfig.json"
+    "!tsconfig.json",
+    "wasm/lighter-signer.wasm",
+    "wasm/wasm_exec.js"
   ],
   "keywords": [
     "perps",
@@ -76,9 +84,10 @@
     "hyperliquid"
   ],
   "scripts": {
-    "build": "pnpm clean && pnpm build:version && pnpm build:cjs && pnpm build:esm && pnpm build:types && pnpm build:clean",
+    "build": "pnpm clean && pnpm build:version && pnpm build:cjs && pnpm build:esm && pnpm build:types && pnpm build:wasm && pnpm build:clean",
     "build:cjs": "tsc --project ./tsconfig.json --module commonjs --outDir ./dist/cjs --removeComments --verbatimModuleSyntax false && mkdir -p ./dist/cjs && printf '{\"type\":\"commonjs\"}' > ./dist/cjs/package.json",
-    "build:esm": "tsc --project ./tsconfig.json --module es2015 --outDir ./dist/esm && mkdir -p ./dist/esm && printf '{\"type\": \"module\",\"sideEffects\":false}' > ./dist/esm/package.json",
+    "build:esm": "tsc --project ./tsconfig.json --module es2022 --outDir ./dist/esm && mkdir -p ./dist/esm && printf '{\"type\": \"module\",\"sideEffects\":false}' > ./dist/esm/package.json",
+    "build:wasm": "mkdir -p ./dist/esm/wasm ./dist/cjs/wasm && cp ./wasm/lighter-signer.wasm ./wasm/wasm_exec.js ./dist/esm/wasm/ && cp ./wasm/lighter-signer.wasm ./wasm/wasm_exec.js ./dist/cjs/wasm/",
     "build:types": "tsc --project ./tsconfig.json --module esnext --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
     "build:clean": "rm -rf tsconfig.tsbuildinfo ./dist/tsconfig.tsbuildinfo",
     "build:version": "node scripts/version.js",
@@ -96,7 +105,6 @@
     "test:cov": "vitest --run --coverage",
     "test:unit": "vitest --run .unit.spec.ts --passWithNoTests",
     "pre-commit": "pnpm check && pnpm check:types && pnpm check:circular-deps && pnpm knip:check",
-    "pre-push": "pnpm test:unit",
-    "postinstall": "husky"
+    "pre-push": "pnpm test:unit"
   }
 }

package/src/agent/AgentManager.ts

@@ -10,7 +10,7 @@ const STORAGE_PREFIX = 'lifi-perps-agent'
 
 /**
  * Manages agent keypairs for USER_AGENT signing mode.
- * Agent keys are stored per user address + DEX combination.
+ * Agent keys are stored per user address + provider combination.
  */
 export class AgentManager {
   private storage: StorageAdapter
@@ -23,17 +23,17 @@ export class AgentManager {
   /**
    * Get the storage key for an agent.
    */
-  private storageKey(address: Address, dex: string): string {
-    return `${STORAGE_PREFIX}:${address.toLowerCase()}:${dex.toLowerCase()}`
+  private storageKey(address: Address, provider: string): string {
+    return `${STORAGE_PREFIX}:${address.toLowerCase()}:${provider.toLowerCase()}`
   }
 
   /**
-   * Get an existing agent for a user + DEX pair.
+   * Get an existing agent for a user + provider pair.
    *
    * @throws {PerpsError} If agent not found
    */
-  async getAgent(address: Address, dex: string): Promise<Agent> {
-    const key = this.storageKey(address, dex)
+  async getAgent(address: Address, provider: string): Promise<Agent> {
+    const key = this.storageKey(address, provider)
 
     // Check cache first
     const cached = this.cache.get(key)
@@ -49,18 +49,20 @@ export class AgentManager {
       return agent
     }
 
-    throw new PerpsError(
-      PerpsErrorCode.AgentUnauthorized,
+    const error = new PerpsError(
+      PerpsErrorCode.SDKError,
       PerpsErrorMessage.AgentNotFound
     )
+    error.tool = '@lifi/perps-sdk'
+    throw error
   }
 
   /**
    * Get an existing agent or create a new one.
    */
-  async getOrCreateAgent(address: Address, dex: string): Promise<Agent> {
+  async getOrCreateAgent(address: Address, provider: string): Promise<Agent> {
     try {
-      return await this.getAgent(address, dex)
+      return await this.getAgent(address, provider)
     } catch {
       // Generate new agent
       const privateKey = generatePrivateKey()
@@ -72,7 +74,7 @@ export class AgentManager {
       }
 
       // Store
-      const key = this.storageKey(address, dex)
+      const key = this.storageKey(address, provider)
       await this.storage.set(key, JSON.stringify(agent))
       this.cache.set(key, agent)
 
@@ -81,11 +83,11 @@ export class AgentManager {
   }
 
   /**
-   * Check if an agent exists for a user + DEX pair.
+   * Check if an agent exists for a user + provider pair.
    */
-  async hasAgent(address: Address, dex: string): Promise<boolean> {
+  async hasAgent(address: Address, provider: string): Promise<boolean> {
     try {
-      await this.getAgent(address, dex)
+      await this.getAgent(address, provider)
       return true
     } catch {
       return false
@@ -93,11 +95,11 @@ export class AgentManager {
   }
 
   /**
-   * Remove an agent for a user + DEX pair.
+   * Remove an agent for a user + provider pair.
    * Call this when the user revokes agent authorization.
    */
-  async removeAgent(address: Address, dex: string): Promise<void> {
-    const key = this.storageKey(address, dex)
+  async removeAgent(address: Address, provider: string): Promise<void> {
+    const key = this.storageKey(address, provider)
     this.cache.delete(key)
     await this.storage.remove(key)
   }
@@ -108,7 +110,7 @@ export class AgentManager {
    */
   async importAgent(
     address: Address,
-    dex: string,
+    provider: string,
     privateKey: Hex
   ): Promise<Agent> {
     const account = privateKeyToAccount(privateKey)
@@ -118,7 +120,7 @@ export class AgentManager {
       privateKey,
     }
 
-    const key = this.storageKey(address, dex)
+    const key = this.storageKey(address, provider)
     await this.storage.set(key, JSON.stringify(agent))
     this.cache.set(key, agent)
 

package/src/agent/storage.ts

@@ -3,7 +3,7 @@ import type { StorageAdapter } from './types.js'
 /**
  * localStorage adapter for browser environments.
  * Agent keys are stored as JSON strings with the key pattern:
- * `lifi-perps-agent:{address}:{dex}`
+ * `lifi-perps-agent:{address}:{provider}`
  */
 export const localStorageAdapter: StorageAdapter = {
   get: (key: string): Promise<string | null> => {