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

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/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,CA2EZ;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/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
+ * @param availableBalance - Available balance, or null if unknown
+ * @param feeRate - Fee rate as decimal, or null if unknown
+ * @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,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,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.4";
+export declare const version = "0.1.1-alpha.40";
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,kBAAkB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk",
-  "version": "0.1.1-alpha.4",
+  "version": "0.1.1-alpha.40",
   "description": "LI.FI Perps SDK for perpetuals trading",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -27,10 +27,15 @@
       "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"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@lifi/perps-types": "0.1.1-alpha.5",
+    "@lifi/perps-types": "0.1.1-alpha.21",
     "viem": "^2.21.0"
   },
   "devDependencies": {
@@ -96,7 +101,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> => {