@metamask-previews/perps-controller 4.0.0-preview-e0eba6dbb → 4.0.0-preview-56dd1249f

package/dist/services/TradingReadinessCache.mjs

@@ -8,13 +8,13 @@
  * are recreated on account/network changes, which would reset instance-level caches.
  *
  * Tracks three signing operations:
- * 1. DEX Abstraction enablement (one-time, irreversible)
+ * 1. Unified Account enablement (one-time, replaces deprecated DEX abstraction)
  * 2. Builder Fee approval (required for trading)
  * 3. Referral code setup (one-time per account)
  *
  * Cache Structure:
  * - Key: `network:userAddress` (e.g., "mainnet:0x123...")
- * - Value: { dexAbstraction, builderFee, referral, timestamp }
+ * - Value: { unifiedAccount, builderFee, referral, timestamp }
  *
  * Lifecycle:
  * - Cache persists throughout app session
@@ -82,9 +82,9 @@ class PerpsSigningCacheManager {
             resolvePromise();
         };
     }
-    // ===== DEX Abstraction Methods =====
+    // ===== Unified Account Methods =====
     /**
-     * Get DEX abstraction cache entry (legacy compatibility)
+     * Get unified account cache entry (legacy compatibility)
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
@@ -97,13 +97,13 @@ class PerpsSigningCacheManager {
             return undefined;
         }
         return {
-            attempted: entry.dexAbstraction.attempted,
-            enabled: entry.dexAbstraction.success,
+            attempted: entry.unifiedAccount.attempted,
+            enabled: entry.unifiedAccount.success,
             timestamp: entry.timestamp,
         };
     }
     /**
-     * Set DEX abstraction cache entry (legacy compatibility)
+     * Set unified account cache entry (legacy compatibility)
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
@@ -113,7 +113,7 @@ class PerpsSigningCacheManager {
      */
     set(network, userAddress, data) {
         const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getOrCreateEntry).call(this, network, userAddress);
-        entry.dexAbstraction = { attempted: data.attempted, success: data.enabled };
+        entry.unifiedAccount = { attempted: data.attempted, success: data.enabled };
         entry.timestamp = Date.now();
     }
     // ===== Builder Fee Methods =====
@@ -168,23 +168,23 @@ class PerpsSigningCacheManager {
     }
     // ===== General Methods =====
     /**
-     * Clear only DEX abstraction state for a specific network and user address
+     * Clear only unified account state for a specific network and user address
      * This preserves builder fee and referral states
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
      */
-    clearDexAbstraction(network, userAddress) {
+    clearUnifiedAccount(network, userAddress) {
         const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
         const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key);
         if (entry) {
-            entry.dexAbstraction = { attempted: false, success: false };
+            entry.unifiedAccount = { attempted: false, success: false };
             entry.timestamp = Date.now();
         }
     }
     /**
      * Clear only builder fee state for a specific network and user address
-     * This preserves DEX abstraction and referral states
+     * This preserves unified account and referral states
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
@@ -199,7 +199,7 @@ class PerpsSigningCacheManager {
     }
     /**
      * Clear only referral state for a specific network and user address
-     * This preserves DEX abstraction and builder fee states
+     * This preserves unified account and builder fee states
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
@@ -214,7 +214,7 @@ class PerpsSigningCacheManager {
     }
     /**
      * Clear entire cache entry for a specific network and user address
-     * WARNING: This clears ALL signing operation states (dexAbstraction, builderFee, referral)
+     * WARNING: This clears ALL signing operation states (unifiedAccount, builderFee, referral)
      *
      * @param network - The network environment.
      * @param userAddress - The user's wallet address.
@@ -254,7 +254,7 @@ class PerpsSigningCacheManager {
     debugState() {
         const entries = [];
         __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").forEach((entry, key) => {
-            entries.push(`${key}: dex=${entry.dexAbstraction.attempted}/${entry.dexAbstraction.success}, ` +
+            entries.push(`${key}: unified=${entry.unifiedAccount.attempted}/${entry.unifiedAccount.success}, ` +
                 `builder=${entry.builderFee.attempted}/${entry.builderFee.success}, ` +
                 `referral=${entry.referral.attempted}/${entry.referral.success}`);
         });
@@ -268,7 +268,7 @@ _a = PerpsSigningCacheManager, _PerpsSigningCacheManager_cache = new WeakMap(),
     let entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key);
     if (!entry) {
         entry = {
-            dexAbstraction: { attempted: false, success: false },
+            unifiedAccount: { attempted: false, success: false },
             builderFee: { attempted: false, success: false },
             referral: { attempted: false, success: false },
             timestamp: Date.now(),

package/dist/services/TradingReadinessCache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"TradingReadinessCache.mjs","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global singleton cache for Perps signing operations\n *\n * This cache persists across provider reconnections to prevent repeated\n * signing requests for hardware wallets. Critical for preventing QR popup spam.\n *\n * Cache is intentionally kept separate from provider instances because providers\n * are recreated on account/network changes, which would reset instance-level caches.\n *\n * Tracks three signing operations:\n * 1. DEX Abstraction enablement (one-time, irreversible)\n * 2. Builder Fee approval (required for trading)\n * 3. Referral code setup (one-time per account)\n *\n * Cache Structure:\n * - Key: `network:userAddress` (e.g., \"mainnet:0x123...\")\n * - Value: { dexAbstraction, builderFee, referral, timestamp }\n *\n * Lifecycle:\n * - Cache persists throughout app session\n * - Individual entries can be cleared per user/network\n * - Full cache can be cleared on app restart or explicit user action\n */\n\ntype SigningOperationState = {\n  attempted: boolean; // Whether we've attempted this operation\n  success: boolean; // Whether it succeeded (only valid if attempted=true)\n};\n\ntype PerpsSigningCacheEntry = {\n  dexAbstraction: SigningOperationState;\n  builderFee: SigningOperationState;\n  referral: SigningOperationState;\n  timestamp: number; // When this entry was last updated\n};\n\n// Legacy interface for backward compatibility\ntype TradingReadinessCacheEntry = {\n  attempted: boolean;\n  enabled: boolean;\n  timestamp: number;\n};\n\nclass PerpsSigningCacheManager {\n  static #instance: PerpsSigningCacheManager;\n\n  readonly #cache: Map<string, PerpsSigningCacheEntry> = new Map();\n\n  // Global in-flight locks to prevent concurrent signing attempts across providers\n  // Key: operationType:network:userAddress, Value: Promise that resolves when operation completes\n  readonly #inFlightOperations: Map<string, Promise<void>> = new Map();\n\n  // Singleton: use getInstance() instead of new\n  protected constructor() {\n    // Protected constructor for singleton\n  }\n\n  public static getInstance(): PerpsSigningCacheManager {\n    PerpsSigningCacheManager.#instance ??= new PerpsSigningCacheManager();\n    return PerpsSigningCacheManager.#instance;\n  }\n\n  // ===== In-Flight Lock Methods =====\n\n  /**\n   * Check if an operation is currently in-flight for this user/network\n   *\n   * @param operationType - The type of operation being performed.\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public isInFlight(\n    operationType: 'dexAbstraction' | 'builderFee' | 'referral',\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): Promise<void> | undefined {\n    const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;\n    return this.#inFlightOperations.get(key);\n  }\n\n  /**\n   * Set an operation as in-flight\n   * Returns a function to call when operation completes\n   *\n   * @param operationType - The type of operation being performed.\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public setInFlight(\n    operationType: 'dexAbstraction' | 'builderFee' | 'referral',\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): () => void {\n    const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;\n    let resolvePromise: () => void;\n    const promise = new Promise<void>((resolve) => {\n      resolvePromise = resolve;\n    });\n    this.#inFlightOperations.set(key, promise);\n    return () => {\n      this.#inFlightOperations.delete(key);\n      resolvePromise();\n    };\n  }\n\n  #getCacheKey(network: 'mainnet' | 'testnet', userAddress: string): string {\n    return `${network}:${userAddress.toLowerCase()}`;\n  }\n\n  #getOrCreateEntry(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): PerpsSigningCacheEntry {\n    const key = this.#getCacheKey(network, userAddress);\n    let entry = this.#cache.get(key);\n    if (!entry) {\n      entry = {\n        dexAbstraction: { attempted: false, success: false },\n        builderFee: { attempted: false, success: false },\n        referral: { attempted: false, success: false },\n        timestamp: Date.now(),\n      };\n      this.#cache.set(key, entry);\n    }\n    return entry;\n  }\n\n  // ===== DEX Abstraction Methods =====\n\n  /**\n   * Get DEX abstraction cache entry (legacy compatibility)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public get(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): TradingReadinessCacheEntry | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (!entry) {\n      return undefined;\n    }\n    return {\n      attempted: entry.dexAbstraction.attempted,\n      enabled: entry.dexAbstraction.success,\n      timestamp: entry.timestamp,\n    };\n  }\n\n  /**\n   * Set DEX abstraction cache entry (legacy compatibility)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param data - The transaction data payload.\n   * @param data.attempted - Whether the operation was attempted.\n   * @param data.enabled - Whether the feature is enabled.\n   */\n  public set(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    data: { attempted: boolean; enabled: boolean },\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.dexAbstraction = { attempted: data.attempted, success: data.enabled };\n    entry.timestamp = Date.now();\n  }\n\n  // ===== Builder Fee Methods =====\n\n  /**\n   * Check if builder fee approval was attempted\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public getBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): SigningOperationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    return entry?.builderFee;\n  }\n\n  /**\n   * Set builder fee approval state\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param state - The current state.\n   */\n  public setBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    state: SigningOperationState,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.builderFee = state;\n    entry.timestamp = Date.now();\n  }\n\n  // ===== Referral Methods =====\n\n  /**\n   * Check if referral setup was attempted\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public getReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): SigningOperationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    return entry?.referral;\n  }\n\n  /**\n   * Set referral setup state\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param state - The current state.\n   */\n  public setReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    state: SigningOperationState,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.referral = state;\n    entry.timestamp = Date.now();\n  }\n\n  // ===== General Methods =====\n\n  /**\n   * Clear only DEX abstraction state for a specific network and user address\n   * This preserves builder fee and referral states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearDexAbstraction(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.dexAbstraction = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear only builder fee state for a specific network and user address\n   * This preserves DEX abstraction and referral states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.builderFee = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear only referral state for a specific network and user address\n   * This preserves DEX abstraction and builder fee states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.referral = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear entire cache entry for a specific network and user address\n   * WARNING: This clears ALL signing operation states (dexAbstraction, builderFee, referral)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clear(network: 'mainnet' | 'testnet', userAddress: string): void {\n    const key = this.#getCacheKey(network, userAddress);\n    this.#cache.delete(key);\n  }\n\n  /**\n   * Clear all cache entries\n   * WARNING: This clears ALL signing operation states for ALL users\n   */\n  public clearAll(): void {\n    this.#cache.clear();\n  }\n\n  /**\n   * Get all cache entries (for debugging)\n   *\n   * @returns The result of the operation.\n   */\n  public getAll(): Map<string, PerpsSigningCacheEntry> {\n    return new Map(this.#cache);\n  }\n\n  /**\n   * Get cache size (for debugging)\n   *\n   * @returns The resulting numeric value.\n   */\n  public size(): number {\n    return this.#cache.size;\n  }\n\n  /**\n   * Get full cache state for debugging\n   *\n   * @returns The resulting string value.\n   */\n  public debugState(): string {\n    const entries: string[] = [];\n    this.#cache.forEach((entry, key) => {\n      entries.push(\n        `${key}: dex=${entry.dexAbstraction.attempted}/${entry.dexAbstraction.success}, ` +\n          `builder=${entry.builderFee.attempted}/${entry.builderFee.success}, ` +\n          `referral=${entry.referral.attempted}/${entry.referral.success}`,\n      );\n    });\n    return entries.join('\\n') || '(empty)';\n  }\n}\n\n// Export singleton instance with backward-compatible name\nexport const TradingReadinessCache = PerpsSigningCacheManager.getInstance();\n\n// Export with new name for clarity\nexport const PerpsSigningCache = PerpsSigningCacheManager.getInstance();\n"]}
+{"version":3,"file":"TradingReadinessCache.mjs","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global singleton cache for Perps signing operations\n *\n * This cache persists across provider reconnections to prevent repeated\n * signing requests for hardware wallets. Critical for preventing QR popup spam.\n *\n * Cache is intentionally kept separate from provider instances because providers\n * are recreated on account/network changes, which would reset instance-level caches.\n *\n * Tracks three signing operations:\n * 1. Unified Account enablement (one-time, replaces deprecated DEX abstraction)\n * 2. Builder Fee approval (required for trading)\n * 3. Referral code setup (one-time per account)\n *\n * Cache Structure:\n * - Key: `network:userAddress` (e.g., \"mainnet:0x123...\")\n * - Value: { unifiedAccount, builderFee, referral, timestamp }\n *\n * Lifecycle:\n * - Cache persists throughout app session\n * - Individual entries can be cleared per user/network\n * - Full cache can be cleared on app restart or explicit user action\n */\n\ntype SigningOperationState = {\n  attempted: boolean; // Whether we've attempted this operation\n  success: boolean; // Whether it succeeded (only valid if attempted=true)\n};\n\ntype PerpsSigningCacheEntry = {\n  unifiedAccount: SigningOperationState;\n  builderFee: SigningOperationState;\n  referral: SigningOperationState;\n  timestamp: number; // When this entry was last updated\n};\n\n// Legacy interface for backward compatibility\ntype TradingReadinessCacheEntry = {\n  attempted: boolean;\n  enabled: boolean;\n  timestamp: number;\n};\n\nclass PerpsSigningCacheManager {\n  static #instance: PerpsSigningCacheManager;\n\n  readonly #cache: Map<string, PerpsSigningCacheEntry> = new Map();\n\n  // Global in-flight locks to prevent concurrent signing attempts across providers\n  // Key: operationType:network:userAddress, Value: Promise that resolves when operation completes\n  readonly #inFlightOperations: Map<string, Promise<void>> = new Map();\n\n  // Singleton: use getInstance() instead of new\n  protected constructor() {\n    // Protected constructor for singleton\n  }\n\n  public static getInstance(): PerpsSigningCacheManager {\n    PerpsSigningCacheManager.#instance ??= new PerpsSigningCacheManager();\n    return PerpsSigningCacheManager.#instance;\n  }\n\n  // ===== In-Flight Lock Methods =====\n\n  /**\n   * Check if an operation is currently in-flight for this user/network\n   *\n   * @param operationType - The type of operation being performed.\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public isInFlight(\n    operationType: 'unifiedAccount' | 'builderFee' | 'referral',\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): Promise<void> | undefined {\n    const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;\n    return this.#inFlightOperations.get(key);\n  }\n\n  /**\n   * Set an operation as in-flight\n   * Returns a function to call when operation completes\n   *\n   * @param operationType - The type of operation being performed.\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public setInFlight(\n    operationType: 'unifiedAccount' | 'builderFee' | 'referral',\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): () => void {\n    const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;\n    let resolvePromise: () => void;\n    const promise = new Promise<void>((resolve) => {\n      resolvePromise = resolve;\n    });\n    this.#inFlightOperations.set(key, promise);\n    return () => {\n      this.#inFlightOperations.delete(key);\n      resolvePromise();\n    };\n  }\n\n  #getCacheKey(network: 'mainnet' | 'testnet', userAddress: string): string {\n    return `${network}:${userAddress.toLowerCase()}`;\n  }\n\n  #getOrCreateEntry(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): PerpsSigningCacheEntry {\n    const key = this.#getCacheKey(network, userAddress);\n    let entry = this.#cache.get(key);\n    if (!entry) {\n      entry = {\n        unifiedAccount: { attempted: false, success: false },\n        builderFee: { attempted: false, success: false },\n        referral: { attempted: false, success: false },\n        timestamp: Date.now(),\n      };\n      this.#cache.set(key, entry);\n    }\n    return entry;\n  }\n\n  // ===== Unified Account Methods =====\n\n  /**\n   * Get unified account cache entry (legacy compatibility)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public get(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): TradingReadinessCacheEntry | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (!entry) {\n      return undefined;\n    }\n    return {\n      attempted: entry.unifiedAccount.attempted,\n      enabled: entry.unifiedAccount.success,\n      timestamp: entry.timestamp,\n    };\n  }\n\n  /**\n   * Set unified account cache entry (legacy compatibility)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param data - The transaction data payload.\n   * @param data.attempted - Whether the operation was attempted.\n   * @param data.enabled - Whether the feature is enabled.\n   */\n  public set(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    data: { attempted: boolean; enabled: boolean },\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.unifiedAccount = { attempted: data.attempted, success: data.enabled };\n    entry.timestamp = Date.now();\n  }\n\n  // ===== Builder Fee Methods =====\n\n  /**\n   * Check if builder fee approval was attempted\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public getBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): SigningOperationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    return entry?.builderFee;\n  }\n\n  /**\n   * Set builder fee approval state\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param state - The current state.\n   */\n  public setBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    state: SigningOperationState,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.builderFee = state;\n    entry.timestamp = Date.now();\n  }\n\n  // ===== Referral Methods =====\n\n  /**\n   * Check if referral setup was attempted\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The resulting string value.\n   */\n  public getReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): SigningOperationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    return entry?.referral;\n  }\n\n  /**\n   * Set referral setup state\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param state - The current state.\n   */\n  public setReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    state: SigningOperationState,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.referral = state;\n    entry.timestamp = Date.now();\n  }\n\n  // ===== General Methods =====\n\n  /**\n   * Clear only unified account state for a specific network and user address\n   * This preserves builder fee and referral states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearUnifiedAccount(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.unifiedAccount = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear only builder fee state for a specific network and user address\n   * This preserves unified account and referral states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearBuilderFee(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.builderFee = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear only referral state for a specific network and user address\n   * This preserves unified account and builder fee states\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clearReferral(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): void {\n    const key = this.#getCacheKey(network, userAddress);\n    const entry = this.#cache.get(key);\n    if (entry) {\n      entry.referral = { attempted: false, success: false };\n      entry.timestamp = Date.now();\n    }\n  }\n\n  /**\n   * Clear entire cache entry for a specific network and user address\n   * WARNING: This clears ALL signing operation states (unifiedAccount, builderFee, referral)\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   */\n  public clear(network: 'mainnet' | 'testnet', userAddress: string): void {\n    const key = this.#getCacheKey(network, userAddress);\n    this.#cache.delete(key);\n  }\n\n  /**\n   * Clear all cache entries\n   * WARNING: This clears ALL signing operation states for ALL users\n   */\n  public clearAll(): void {\n    this.#cache.clear();\n  }\n\n  /**\n   * Get all cache entries (for debugging)\n   *\n   * @returns The result of the operation.\n   */\n  public getAll(): Map<string, PerpsSigningCacheEntry> {\n    return new Map(this.#cache);\n  }\n\n  /**\n   * Get cache size (for debugging)\n   *\n   * @returns The resulting numeric value.\n   */\n  public size(): number {\n    return this.#cache.size;\n  }\n\n  /**\n   * Get full cache state for debugging\n   *\n   * @returns The resulting string value.\n   */\n  public debugState(): string {\n    const entries: string[] = [];\n    this.#cache.forEach((entry, key) => {\n      entries.push(\n        `${key}: unified=${entry.unifiedAccount.attempted}/${entry.unifiedAccount.success}, ` +\n          `builder=${entry.builderFee.attempted}/${entry.builderFee.success}, ` +\n          `referral=${entry.referral.attempted}/${entry.referral.success}`,\n      );\n    });\n    return entries.join('\\n') || '(empty)';\n  }\n}\n\n// Export singleton instance with backward-compatible name\nexport const TradingReadinessCache = PerpsSigningCacheManager.getInstance();\n\n// Export with new name for clarity\nexport const PerpsSigningCache = PerpsSigningCacheManager.getInstance();\n"]}

package/dist/types/hyperliquid-types.cjs

@@ -1,3 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hyperLiquidModeFoldsSpot = exports.HL_UNIFIED_ACCOUNT_MODE = exports.HL_ABSTRACTION_WIRE = void 0;
+/**
+ * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK
+ * types these as a `"i" | "u" | "p"` literal union with no exported constant.
+ *
+ * Only `unifiedAccount` is referenced by the current migration flow; the
+ * other entries document the full SDK wire format so a future caller
+ * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)
+ * does not have to re-discover the codes.
+ */
+exports.HL_ABSTRACTION_WIRE = {
+    disabled: 'i',
+    unifiedAccount: 'u',
+    portfolioMargin: 'p',
+};
+/**
+ * Long-form abstraction-mode value targeted by the migration. Used as the
+ * `abstraction` parameter for `userSetAbstraction` and as the success / target
+ * value reported by Account Setup analytics.
+ */
+exports.HL_UNIFIED_ACCOUNT_MODE = 'unifiedAccount';
+/**
+ * True when the given HL abstraction mode treats spot balances as perps
+ * collateral. Fail-CLOSED on missing mode: until userAbstraction has been
+ * resolved we do not fold spot, because over-reporting withdrawable funds
+ * for Standard / dexAbstraction users (which `withdraw3` cannot actually
+ * draw) is worse than briefly under-reporting for Unified users during the
+ * initial subscription window or a transient REST outage.
+ *
+ * @param mode - Abstraction mode returned by HyperLiquid.
+ * @returns Whether spot balances should fold into perps collateral.
+ */
+function hyperLiquidModeFoldsSpot(mode) {
+    if (mode === null || mode === undefined) {
+        return false;
+    }
+    return mode === 'unifiedAccount' || mode === 'portfolioMargin';
+}
+exports.hyperLiquidModeFoldsSpot = hyperLiquidModeFoldsSpot;
 //# sourceMappingURL=hyperliquid-types.cjs.map

package/dist/types/hyperliquid-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hyperliquid-types.cjs","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * HyperLiquid SDK Type Aliases\n *\n * The @nktkas/hyperliquid SDK only exports Response types (e.g., ClearinghouseStateResponse).\n * We extract commonly-used nested types here to avoid repetitive type extraction syntax.\n *\n * Pattern: Import Response types, extract nested types using TypeScript index access.\n * This is the SDK's intentional design - not bad practice!\n */\nimport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  MetaAndAssetCtxsResponse,\n  AllMidsResponse,\n  PredictedFundingsResponse,\n  OrderParameters,\n  SpotMetaResponse,\n} from '@nktkas/hyperliquid';\n\n// Clearinghouse (Account) Types\nexport type AssetPosition =\n  ClearinghouseStateResponse['assetPositions'][number];\nexport type SpotBalance = SpotClearinghouseStateResponse['balances'][number];\n\n// Market/Asset Types\nexport type PerpsUniverse = MetaResponse['universe'][number];\nexport type PerpsAssetCtx = MetaAndAssetCtxsResponse[1][number];\nexport type PredictedFunding = PredictedFundingsResponse[number];\n\n// Order Types\nexport type FrontendOrder = FrontendOpenOrdersResponse[number];\nexport type SDKOrderParams = OrderParameters['orders'][number];\nexport type OrderType = FrontendOrder['orderType'];\n\n// Re-export Response types for convenience\nexport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  AllMidsResponse,\n  MetaAndAssetCtxsResponse,\n  PredictedFundingsResponse,\n  SpotMetaResponse,\n};\n"]}
+{"version":3,"file":"hyperliquid-types.cjs","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":";;;AAsBA;;;;;;;;GAQG;AACU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE,GAAG;IACb,cAAc,EAAE,GAAG;IACnB,eAAe,EAAE,GAAG;CACZ,CAAC;AAEX;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,gBAAyB,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,SAAgB,wBAAwB,CACtC,IAAqC;IAErC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,iBAAiB,CAAC;AACjE,CAAC;AARD,4DAQC","sourcesContent":["/**\n * HyperLiquid SDK Type Aliases\n *\n * The @nktkas/hyperliquid SDK only exports Response types (e.g., ClearinghouseStateResponse).\n * We extract commonly-used nested types here to avoid repetitive type extraction syntax.\n *\n * Pattern: Import Response types, extract nested types using TypeScript index access.\n * This is the SDK's intentional design - not bad practice!\n */\nimport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  MetaAndAssetCtxsResponse,\n  AllMidsResponse,\n  PredictedFundingsResponse,\n  OrderParameters,\n  SpotMetaResponse,\n  UserAbstractionResponse,\n} from '@nktkas/hyperliquid';\n\n/**\n * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK\n * types these as a `\"i\" | \"u\" | \"p\"` literal union with no exported constant.\n *\n * Only `unifiedAccount` is referenced by the current migration flow; the\n * other entries document the full SDK wire format so a future caller\n * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)\n * does not have to re-discover the codes.\n */\nexport const HL_ABSTRACTION_WIRE = {\n  disabled: 'i',\n  unifiedAccount: 'u',\n  portfolioMargin: 'p',\n} as const;\n\n/**\n * Long-form abstraction-mode value targeted by the migration. Used as the\n * `abstraction` parameter for `userSetAbstraction` and as the success / target\n * value reported by Account Setup analytics.\n */\nexport const HL_UNIFIED_ACCOUNT_MODE = 'unifiedAccount' as const;\n\n/**\n * True when the given HL abstraction mode treats spot balances as perps\n * collateral. Fail-CLOSED on missing mode: until userAbstraction has been\n * resolved we do not fold spot, because over-reporting withdrawable funds\n * for Standard / dexAbstraction users (which `withdraw3` cannot actually\n * draw) is worse than briefly under-reporting for Unified users during the\n * initial subscription window or a transient REST outage.\n *\n * @param mode - Abstraction mode returned by HyperLiquid.\n * @returns Whether spot balances should fold into perps collateral.\n */\nexport function hyperLiquidModeFoldsSpot(\n  mode?: UserAbstractionResponse | null,\n): boolean {\n  if (mode === null || mode === undefined) {\n    return false;\n  }\n\n  return mode === 'unifiedAccount' || mode === 'portfolioMargin';\n}\n\n// Clearinghouse (Account) Types\nexport type AssetPosition =\n  ClearinghouseStateResponse['assetPositions'][number];\nexport type SpotBalance = SpotClearinghouseStateResponse['balances'][number];\n\n// Market/Asset Types\nexport type PerpsUniverse = MetaResponse['universe'][number];\nexport type PerpsAssetCtx = MetaAndAssetCtxsResponse[1][number];\nexport type PredictedFunding = PredictedFundingsResponse[number];\n\n// Order Types\nexport type FrontendOrder = FrontendOpenOrdersResponse[number];\nexport type SDKOrderParams = OrderParameters['orders'][number];\nexport type OrderType = FrontendOrder['orderType'];\n\n// Re-export Response types for convenience\nexport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  AllMidsResponse,\n  MetaAndAssetCtxsResponse,\n  PredictedFundingsResponse,\n  SpotMetaResponse,\n  UserAbstractionResponse,\n};\n"]}

package/dist/types/hyperliquid-types.d.cts

@@ -7,7 +7,39 @@
  * Pattern: Import Response types, extract nested types using TypeScript index access.
  * This is the SDK's intentional design - not bad practice!
  */
-import type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, MetaAndAssetCtxsResponse, AllMidsResponse, PredictedFundingsResponse, OrderParameters, SpotMetaResponse } from "@nktkas/hyperliquid";
+import type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, MetaAndAssetCtxsResponse, AllMidsResponse, PredictedFundingsResponse, OrderParameters, SpotMetaResponse, UserAbstractionResponse } from "@nktkas/hyperliquid";
+/**
+ * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK
+ * types these as a `"i" | "u" | "p"` literal union with no exported constant.
+ *
+ * Only `unifiedAccount` is referenced by the current migration flow; the
+ * other entries document the full SDK wire format so a future caller
+ * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)
+ * does not have to re-discover the codes.
+ */
+export declare const HL_ABSTRACTION_WIRE: {
+    readonly disabled: "i";
+    readonly unifiedAccount: "u";
+    readonly portfolioMargin: "p";
+};
+/**
+ * Long-form abstraction-mode value targeted by the migration. Used as the
+ * `abstraction` parameter for `userSetAbstraction` and as the success / target
+ * value reported by Account Setup analytics.
+ */
+export declare const HL_UNIFIED_ACCOUNT_MODE: "unifiedAccount";
+/**
+ * True when the given HL abstraction mode treats spot balances as perps
+ * collateral. Fail-CLOSED on missing mode: until userAbstraction has been
+ * resolved we do not fold spot, because over-reporting withdrawable funds
+ * for Standard / dexAbstraction users (which `withdraw3` cannot actually
+ * draw) is worse than briefly under-reporting for Unified users during the
+ * initial subscription window or a transient REST outage.
+ *
+ * @param mode - Abstraction mode returned by HyperLiquid.
+ * @returns Whether spot balances should fold into perps collateral.
+ */
+export declare function hyperLiquidModeFoldsSpot(mode?: UserAbstractionResponse | null): boolean;
 export type AssetPosition = ClearinghouseStateResponse['assetPositions'][number];
 export type SpotBalance = SpotClearinghouseStateResponse['balances'][number];
 export type PerpsUniverse = MetaResponse['universe'][number];
@@ -16,5 +48,5 @@ export type PredictedFunding = PredictedFundingsResponse[number];
 export type FrontendOrder = FrontendOpenOrdersResponse[number];
 export type SDKOrderParams = OrderParameters['orders'][number];
 export type OrderType = FrontendOrder['orderType'];
-export type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, AllMidsResponse, MetaAndAssetCtxsResponse, PredictedFundingsResponse, SpotMetaResponse, };
+export type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, AllMidsResponse, MetaAndAssetCtxsResponse, PredictedFundingsResponse, SpotMetaResponse, UserAbstractionResponse, };
 //# sourceMappingURL=hyperliquid-types.d.cts.map

package/dist/types/hyperliquid-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"hyperliquid-types.d.cts","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EACjB,4BAA4B;AAG7B,MAAM,MAAM,aAAa,GACvB,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7E,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAGjE,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAGnD,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"hyperliquid-types.d.cts","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACxB,4BAA4B;AAE7B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,kBAA4B,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,CAAC,EAAE,uBAAuB,GAAG,IAAI,GACpC,OAAO,CAMT;AAGD,MAAM,MAAM,aAAa,GACvB,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7E,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAGjE,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAGnD,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,GACxB,CAAC"}

package/dist/types/hyperliquid-types.d.mts

@@ -7,7 +7,39 @@
  * Pattern: Import Response types, extract nested types using TypeScript index access.
  * This is the SDK's intentional design - not bad practice!
  */
-import type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, MetaAndAssetCtxsResponse, AllMidsResponse, PredictedFundingsResponse, OrderParameters, SpotMetaResponse } from "@nktkas/hyperliquid";
+import type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, MetaAndAssetCtxsResponse, AllMidsResponse, PredictedFundingsResponse, OrderParameters, SpotMetaResponse, UserAbstractionResponse } from "@nktkas/hyperliquid";
+/**
+ * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK
+ * types these as a `"i" | "u" | "p"` literal union with no exported constant.
+ *
+ * Only `unifiedAccount` is referenced by the current migration flow; the
+ * other entries document the full SDK wire format so a future caller
+ * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)
+ * does not have to re-discover the codes.
+ */
+export declare const HL_ABSTRACTION_WIRE: {
+    readonly disabled: "i";
+    readonly unifiedAccount: "u";
+    readonly portfolioMargin: "p";
+};
+/**
+ * Long-form abstraction-mode value targeted by the migration. Used as the
+ * `abstraction` parameter for `userSetAbstraction` and as the success / target
+ * value reported by Account Setup analytics.
+ */
+export declare const HL_UNIFIED_ACCOUNT_MODE: "unifiedAccount";
+/**
+ * True when the given HL abstraction mode treats spot balances as perps
+ * collateral. Fail-CLOSED on missing mode: until userAbstraction has been
+ * resolved we do not fold spot, because over-reporting withdrawable funds
+ * for Standard / dexAbstraction users (which `withdraw3` cannot actually
+ * draw) is worse than briefly under-reporting for Unified users during the
+ * initial subscription window or a transient REST outage.
+ *
+ * @param mode - Abstraction mode returned by HyperLiquid.
+ * @returns Whether spot balances should fold into perps collateral.
+ */
+export declare function hyperLiquidModeFoldsSpot(mode?: UserAbstractionResponse | null): boolean;
 export type AssetPosition = ClearinghouseStateResponse['assetPositions'][number];
 export type SpotBalance = SpotClearinghouseStateResponse['balances'][number];
 export type PerpsUniverse = MetaResponse['universe'][number];
@@ -16,5 +48,5 @@ export type PredictedFunding = PredictedFundingsResponse[number];
 export type FrontendOrder = FrontendOpenOrdersResponse[number];
 export type SDKOrderParams = OrderParameters['orders'][number];
 export type OrderType = FrontendOrder['orderType'];
-export type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, AllMidsResponse, MetaAndAssetCtxsResponse, PredictedFundingsResponse, SpotMetaResponse, };
+export type { ClearinghouseStateResponse, SpotClearinghouseStateResponse, MetaResponse, FrontendOpenOrdersResponse, AllMidsResponse, MetaAndAssetCtxsResponse, PredictedFundingsResponse, SpotMetaResponse, UserAbstractionResponse, };
 //# sourceMappingURL=hyperliquid-types.d.mts.map

package/dist/types/hyperliquid-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hyperliquid-types.d.mts","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EACjB,4BAA4B;AAG7B,MAAM,MAAM,aAAa,GACvB,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7E,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAGjE,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAGnD,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"hyperliquid-types.d.mts","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACxB,4BAA4B;AAE7B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,kBAA4B,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,CAAC,EAAE,uBAAuB,GAAG,IAAI,GACpC,OAAO,CAMT;AAGD,MAAM,MAAM,aAAa,GACvB,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7E,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAGjE,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAGnD,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,GACxB,CAAC"}

package/dist/types/hyperliquid-types.mjs

@@ -1,2 +1,38 @@
-export {};
+/**
+ * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK
+ * types these as a `"i" | "u" | "p"` literal union with no exported constant.
+ *
+ * Only `unifiedAccount` is referenced by the current migration flow; the
+ * other entries document the full SDK wire format so a future caller
+ * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)
+ * does not have to re-discover the codes.
+ */
+export const HL_ABSTRACTION_WIRE = {
+    disabled: 'i',
+    unifiedAccount: 'u',
+    portfolioMargin: 'p',
+};
+/**
+ * Long-form abstraction-mode value targeted by the migration. Used as the
+ * `abstraction` parameter for `userSetAbstraction` and as the success / target
+ * value reported by Account Setup analytics.
+ */
+export const HL_UNIFIED_ACCOUNT_MODE = 'unifiedAccount';
+/**
+ * True when the given HL abstraction mode treats spot balances as perps
+ * collateral. Fail-CLOSED on missing mode: until userAbstraction has been
+ * resolved we do not fold spot, because over-reporting withdrawable funds
+ * for Standard / dexAbstraction users (which `withdraw3` cannot actually
+ * draw) is worse than briefly under-reporting for Unified users during the
+ * initial subscription window or a transient REST outage.
+ *
+ * @param mode - Abstraction mode returned by HyperLiquid.
+ * @returns Whether spot balances should fold into perps collateral.
+ */
+export function hyperLiquidModeFoldsSpot(mode) {
+    if (mode === null || mode === undefined) {
+        return false;
+    }
+    return mode === 'unifiedAccount' || mode === 'portfolioMargin';
+}
 //# sourceMappingURL=hyperliquid-types.mjs.map

package/dist/types/hyperliquid-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hyperliquid-types.mjs","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * HyperLiquid SDK Type Aliases\n *\n * The @nktkas/hyperliquid SDK only exports Response types (e.g., ClearinghouseStateResponse).\n * We extract commonly-used nested types here to avoid repetitive type extraction syntax.\n *\n * Pattern: Import Response types, extract nested types using TypeScript index access.\n * This is the SDK's intentional design - not bad practice!\n */\nimport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  MetaAndAssetCtxsResponse,\n  AllMidsResponse,\n  PredictedFundingsResponse,\n  OrderParameters,\n  SpotMetaResponse,\n} from '@nktkas/hyperliquid';\n\n// Clearinghouse (Account) Types\nexport type AssetPosition =\n  ClearinghouseStateResponse['assetPositions'][number];\nexport type SpotBalance = SpotClearinghouseStateResponse['balances'][number];\n\n// Market/Asset Types\nexport type PerpsUniverse = MetaResponse['universe'][number];\nexport type PerpsAssetCtx = MetaAndAssetCtxsResponse[1][number];\nexport type PredictedFunding = PredictedFundingsResponse[number];\n\n// Order Types\nexport type FrontendOrder = FrontendOpenOrdersResponse[number];\nexport type SDKOrderParams = OrderParameters['orders'][number];\nexport type OrderType = FrontendOrder['orderType'];\n\n// Re-export Response types for convenience\nexport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  AllMidsResponse,\n  MetaAndAssetCtxsResponse,\n  PredictedFundingsResponse,\n  SpotMetaResponse,\n};\n"]}
+{"version":3,"file":"hyperliquid-types.mjs","sourceRoot":"","sources":["../../src/types/hyperliquid-types.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,GAAG;IACb,cAAc,EAAE,GAAG;IACnB,eAAe,EAAE,GAAG;CACZ,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAyB,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAqC;IAErC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,iBAAiB,CAAC;AACjE,CAAC","sourcesContent":["/**\n * HyperLiquid SDK Type Aliases\n *\n * The @nktkas/hyperliquid SDK only exports Response types (e.g., ClearinghouseStateResponse).\n * We extract commonly-used nested types here to avoid repetitive type extraction syntax.\n *\n * Pattern: Import Response types, extract nested types using TypeScript index access.\n * This is the SDK's intentional design - not bad practice!\n */\nimport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  MetaAndAssetCtxsResponse,\n  AllMidsResponse,\n  PredictedFundingsResponse,\n  OrderParameters,\n  SpotMetaResponse,\n  UserAbstractionResponse,\n} from '@nktkas/hyperliquid';\n\n/**\n * Wire codes accepted by `agentSetAbstraction({ abstraction })`. The SDK\n * types these as a `\"i\" | \"u\" | \"p\"` literal union with no exported constant.\n *\n * Only `unifiedAccount` is referenced by the current migration flow; the\n * other entries document the full SDK wire format so a future caller\n * (e.g. emergency rollback to `disabled`, or opting into `portfolioMargin`)\n * does not have to re-discover the codes.\n */\nexport const HL_ABSTRACTION_WIRE = {\n  disabled: 'i',\n  unifiedAccount: 'u',\n  portfolioMargin: 'p',\n} as const;\n\n/**\n * Long-form abstraction-mode value targeted by the migration. Used as the\n * `abstraction` parameter for `userSetAbstraction` and as the success / target\n * value reported by Account Setup analytics.\n */\nexport const HL_UNIFIED_ACCOUNT_MODE = 'unifiedAccount' as const;\n\n/**\n * True when the given HL abstraction mode treats spot balances as perps\n * collateral. Fail-CLOSED on missing mode: until userAbstraction has been\n * resolved we do not fold spot, because over-reporting withdrawable funds\n * for Standard / dexAbstraction users (which `withdraw3` cannot actually\n * draw) is worse than briefly under-reporting for Unified users during the\n * initial subscription window or a transient REST outage.\n *\n * @param mode - Abstraction mode returned by HyperLiquid.\n * @returns Whether spot balances should fold into perps collateral.\n */\nexport function hyperLiquidModeFoldsSpot(\n  mode?: UserAbstractionResponse | null,\n): boolean {\n  if (mode === null || mode === undefined) {\n    return false;\n  }\n\n  return mode === 'unifiedAccount' || mode === 'portfolioMargin';\n}\n\n// Clearinghouse (Account) Types\nexport type AssetPosition =\n  ClearinghouseStateResponse['assetPositions'][number];\nexport type SpotBalance = SpotClearinghouseStateResponse['balances'][number];\n\n// Market/Asset Types\nexport type PerpsUniverse = MetaResponse['universe'][number];\nexport type PerpsAssetCtx = MetaAndAssetCtxsResponse[1][number];\nexport type PredictedFunding = PredictedFundingsResponse[number];\n\n// Order Types\nexport type FrontendOrder = FrontendOpenOrdersResponse[number];\nexport type SDKOrderParams = OrderParameters['orders'][number];\nexport type OrderType = FrontendOrder['orderType'];\n\n// Re-export Response types for convenience\nexport type {\n  ClearinghouseStateResponse,\n  SpotClearinghouseStateResponse,\n  MetaResponse,\n  FrontendOpenOrdersResponse,\n  AllMidsResponse,\n  MetaAndAssetCtxsResponse,\n  PredictedFundingsResponse,\n  SpotMetaResponse,\n  UserAbstractionResponse,\n};\n"]}

package/dist/types/index.cjs

@@ -45,6 +45,7 @@ var PerpsAnalyticsEvent;
     PerpsAnalyticsEvent["UiInteraction"] = "Perp UI Interaction";
     PerpsAnalyticsEvent["RiskManagement"] = "Perp Risk Management";
     PerpsAnalyticsEvent["PerpsError"] = "Perp Error";
+    PerpsAnalyticsEvent["AccountSetup"] = "Perp Account Setup";
 })(PerpsAnalyticsEvent || (exports.PerpsAnalyticsEvent = PerpsAnalyticsEvent = {}));
 /**
  * Perps trace name constants. Values match TraceName enum in mobile.