@metamask-previews/perps-controller 13.1.0-preview-8c2a2eeb2 → 13.1.0-preview-4f4c98e

package/dist/services/TradingReadinessCache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"TradingReadinessCache.cjs","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 repeated\n * hardware wallet signing prompts.\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  reason?: 'no_hl_account' | 'user_rejected' | 'transient'; // optional discriminator\n};\n\n// Tracks whether the wallet has ever been observed on Hyperliquid.\n// Hyperliquid accounts only come into existence on first USDC deposit.\n// Before then, user-scoped exchange writes (agentSetAbstraction,\n// userSetAbstraction, setReferrer, ...) reject with\n// \"User or API Wallet 0x... does not exist.\"\n// Used to skip those writes proactively rather than catching the rejection.\ntype WalletRegistrationState = {\n  known: boolean; // Whether we have signal at all\n  registered: boolean; // True once observed on Hyperliquid (monotonic)\n};\n\ntype PerpsSigningCacheEntry = {\n  unifiedAccount: SigningOperationState;\n  builderFee: SigningOperationState;\n  referral: SigningOperationState;\n  walletRegistered: WalletRegistrationState;\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  reason?: 'no_hl_account' | 'user_rejected' | 'transient';\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        walletRegistered: { known: false, registered: 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      reason: entry.unifiedAccount.reason,\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   * @param data.reason - Optional discriminator explaining a non-success outcome.\n   */\n  public set(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    data: {\n      attempted: boolean;\n      enabled: boolean;\n      reason?: 'no_hl_account' | 'user_rejected' | 'transient';\n    },\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.unifiedAccount = {\n      attempted: data.attempted,\n      success: data.enabled,\n      reason: data.reason,\n    };\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  // ===== Wallet Registration Methods =====\n\n  /**\n   * Read the wallet's Hyperliquid registration signal.\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The current signal, or undefined if no entry exists.\n   */\n  public getWalletRegistered(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): WalletRegistrationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    return this.#cache.get(key)?.walletRegistered;\n  }\n\n  /**\n   * Record whether the wallet has been observed on Hyperliquid. Once\n   * `registered=true` is set, it stays true for the session — the goal\n   * is to skip doomed exchange writes for unfunded wallets, not to\n   * gate them after they fund.\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param registered - True once any evidence (clearinghouseState balance,\n   * userFills, successful deposit, ...) confirms the wallet exists on HL.\n   */\n  public setWalletRegistered(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    registered: boolean,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    if (entry.walletRegistered.registered && !registered) {\n      // Monotonic: once registered, never demote.\n      return;\n    }\n    entry.walletRegistered = { known: true, registered };\n    entry.timestamp = Date.now();\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          `walletRegistered=${entry.walletRegistered.known}/${entry.walletRegistered.registered}`,\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/services/TradingReadinessCache.d.cts

@@ -1,204 +0,0 @@
-/**
- * Global singleton cache for Perps signing operations
- *
- * This cache persists across provider reconnections to prevent repeated
- * signing requests for hardware wallets. Critical for preventing repeated
- * hardware wallet signing prompts.
- *
- * Cache is intentionally kept separate from provider instances because providers
- * are recreated on account/network changes, which would reset instance-level caches.
- *
- * Tracks three signing operations:
- * 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: { unifiedAccount, builderFee, referral, timestamp }
- *
- * Lifecycle:
- * - Cache persists throughout app session
- * - Individual entries can be cleared per user/network
- * - Full cache can be cleared on app restart or explicit user action
- */
-type SigningOperationState = {
-    attempted: boolean;
-    success: boolean;
-    reason?: 'no_hl_account' | 'user_rejected' | 'transient';
-};
-type WalletRegistrationState = {
-    known: boolean;
-    registered: boolean;
-};
-type PerpsSigningCacheEntry = {
-    unifiedAccount: SigningOperationState;
-    builderFee: SigningOperationState;
-    referral: SigningOperationState;
-    walletRegistered: WalletRegistrationState;
-    timestamp: number;
-};
-type TradingReadinessCacheEntry = {
-    attempted: boolean;
-    enabled: boolean;
-    reason?: 'no_hl_account' | 'user_rejected' | 'transient';
-    timestamp: number;
-};
-declare class PerpsSigningCacheManager {
-    #private;
-    protected constructor();
-    static getInstance(): PerpsSigningCacheManager;
-    /**
-     * Check if an operation is currently in-flight for this user/network
-     *
-     * @param operationType - The type of operation being performed.
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The resulting string value.
-     */
-    isInFlight(operationType: 'unifiedAccount' | 'builderFee' | 'referral', network: 'mainnet' | 'testnet', userAddress: string): Promise<void> | undefined;
-    /**
-     * Set an operation as in-flight
-     * Returns a function to call when operation completes
-     *
-     * @param operationType - The type of operation being performed.
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The resulting string value.
-     */
-    setInFlight(operationType: 'unifiedAccount' | 'builderFee' | 'referral', network: 'mainnet' | 'testnet', userAddress: string): () => void;
-    /**
-     * Get unified account cache entry (legacy compatibility)
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The resulting string value.
-     */
-    get(network: 'mainnet' | 'testnet', userAddress: string): TradingReadinessCacheEntry | undefined;
-    /**
-     * Set unified account cache entry (legacy compatibility)
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @param data - The transaction data payload.
-     * @param data.attempted - Whether the operation was attempted.
-     * @param data.enabled - Whether the feature is enabled.
-     * @param data.reason - Optional discriminator explaining a non-success outcome.
-     */
-    set(network: 'mainnet' | 'testnet', userAddress: string, data: {
-        attempted: boolean;
-        enabled: boolean;
-        reason?: 'no_hl_account' | 'user_rejected' | 'transient';
-    }): void;
-    /**
-     * Check if builder fee approval was attempted
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The resulting string value.
-     */
-    getBuilderFee(network: 'mainnet' | 'testnet', userAddress: string): SigningOperationState | undefined;
-    /**
-     * Set builder fee approval state
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @param state - The current state.
-     */
-    setBuilderFee(network: 'mainnet' | 'testnet', userAddress: string, state: SigningOperationState): void;
-    /**
-     * Check if referral setup was attempted
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The resulting string value.
-     */
-    getReferral(network: 'mainnet' | 'testnet', userAddress: string): SigningOperationState | undefined;
-    /**
-     * Set referral setup state
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @param state - The current state.
-     */
-    setReferral(network: 'mainnet' | 'testnet', userAddress: string, state: SigningOperationState): void;
-    /**
-     * 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.
-     */
-    clearUnifiedAccount(network: 'mainnet' | 'testnet', userAddress: string): void;
-    /**
-     * Read the wallet's Hyperliquid registration signal.
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @returns The current signal, or undefined if no entry exists.
-     */
-    getWalletRegistered(network: 'mainnet' | 'testnet', userAddress: string): WalletRegistrationState | undefined;
-    /**
-     * Record whether the wallet has been observed on Hyperliquid. Once
-     * `registered=true` is set, it stays true for the session — the goal
-     * is to skip doomed exchange writes for unfunded wallets, not to
-     * gate them after they fund.
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     * @param registered - True once any evidence (clearinghouseState balance,
-     * userFills, successful deposit, ...) confirms the wallet exists on HL.
-     */
-    setWalletRegistered(network: 'mainnet' | 'testnet', userAddress: string, registered: boolean): void;
-    /**
-     * Clear only builder fee state for a specific network and user address
-     * This preserves unified account and referral states
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     */
-    clearBuilderFee(network: 'mainnet' | 'testnet', userAddress: string): void;
-    /**
-     * Clear only referral state for a specific network and user address
-     * This preserves unified account and builder fee states
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     */
-    clearReferral(network: 'mainnet' | 'testnet', userAddress: string): void;
-    /**
-     * Clear entire cache entry for a specific network and user address
-     * WARNING: This clears ALL signing operation states (unifiedAccount, builderFee, referral)
-     *
-     * @param network - The network environment.
-     * @param userAddress - The user's wallet address.
-     */
-    clear(network: 'mainnet' | 'testnet', userAddress: string): void;
-    /**
-     * Clear all cache entries
-     * WARNING: This clears ALL signing operation states for ALL users
-     */
-    clearAll(): void;
-    /**
-     * Get all cache entries (for debugging)
-     *
-     * @returns The result of the operation.
-     */
-    getAll(): Map<string, PerpsSigningCacheEntry>;
-    /**
-     * Get cache size (for debugging)
-     *
-     * @returns The resulting numeric value.
-     */
-    size(): number;
-    /**
-     * Get full cache state for debugging
-     *
-     * @returns The resulting string value.
-     */
-    debugState(): string;
-}
-export declare const TradingReadinessCache: PerpsSigningCacheManager;
-export declare const PerpsSigningCache: PerpsSigningCacheManager;
-export {};
-//# sourceMappingURL=TradingReadinessCache.d.cts.map

package/dist/services/TradingReadinessCache.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TradingReadinessCache.d.cts","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"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"}

package/dist/services/TradingReadinessCache.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TradingReadinessCache.d.mts","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC;CAC1D,CAAC;AAQF,KAAK,uBAAuB,GAAG;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,cAAc,EAAE,qBAAqB,CAAC;IACtC,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAGF,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,cAAM,wBAAwB;;IAU5B,SAAS;WAIK,WAAW,IAAI,wBAAwB;IAOrD;;;;;;;OAOG;IACI,UAAU,CACf,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,UAAU,EAC3D,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;IAK5B;;;;;;;;OAQG;IACI,WAAW,CAChB,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,UAAU,EAC3D,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,MAAM,IAAI;IAsCb;;;;;;OAMG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,0BAA0B,GAAG,SAAS;IAczC;;;;;;;;;OASG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACJ,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC;KAC1D,GACA,IAAI;IAYP;;;;;;OAMG;IACI,aAAa,CAClB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,qBAAqB,GAAG,SAAS;IAMpC;;;;;;OAMG;IACI,aAAa,CAClB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,qBAAqB,GAC3B,IAAI;IAQP;;;;;;OAMG;IACI,WAAW,CAChB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,qBAAqB,GAAG,SAAS;IAMpC;;;;;;OAMG;IACI,WAAW,CAChB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,qBAAqB,GAC3B,IAAI;IAQP;;;;;;OAMG;IACI,mBAAmB,CACxB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,IAAI;IAWP;;;;;;OAMG;IACI,mBAAmB,CACxB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,uBAAuB,GAAG,SAAS;IAKtC;;;;;;;;;;OAUG;IACI,mBAAmB,CACxB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,OAAO,GAClB,IAAI;IAUP;;;;;;OAMG;IACI,eAAe,CACpB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,IAAI;IASP;;;;;;OAMG;IACI,aAAa,CAClB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,IAAI;IASP;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKvE;;;OAGG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;;OAIG;IACI,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAIpD;;;;OAIG;IACI,IAAI,IAAI,MAAM;IAIrB;;;;OAIG;IACI,UAAU,IAAI,MAAM;CAY5B;AAGD,eAAO,MAAM,qBAAqB,0BAAyC,CAAC;AAG5E,eAAO,MAAM,iBAAiB,0BAAyC,CAAC"}

package/dist/services/TradingReadinessCache.mjs.map

@@ -1 +0,0 @@
-{"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 repeated\n * hardware wallet signing prompts.\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  reason?: 'no_hl_account' | 'user_rejected' | 'transient'; // optional discriminator\n};\n\n// Tracks whether the wallet has ever been observed on Hyperliquid.\n// Hyperliquid accounts only come into existence on first USDC deposit.\n// Before then, user-scoped exchange writes (agentSetAbstraction,\n// userSetAbstraction, setReferrer, ...) reject with\n// \"User or API Wallet 0x... does not exist.\"\n// Used to skip those writes proactively rather than catching the rejection.\ntype WalletRegistrationState = {\n  known: boolean; // Whether we have signal at all\n  registered: boolean; // True once observed on Hyperliquid (monotonic)\n};\n\ntype PerpsSigningCacheEntry = {\n  unifiedAccount: SigningOperationState;\n  builderFee: SigningOperationState;\n  referral: SigningOperationState;\n  walletRegistered: WalletRegistrationState;\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  reason?: 'no_hl_account' | 'user_rejected' | 'transient';\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        walletRegistered: { known: false, registered: 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      reason: entry.unifiedAccount.reason,\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   * @param data.reason - Optional discriminator explaining a non-success outcome.\n   */\n  public set(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    data: {\n      attempted: boolean;\n      enabled: boolean;\n      reason?: 'no_hl_account' | 'user_rejected' | 'transient';\n    },\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    entry.unifiedAccount = {\n      attempted: data.attempted,\n      success: data.enabled,\n      reason: data.reason,\n    };\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  // ===== Wallet Registration Methods =====\n\n  /**\n   * Read the wallet's Hyperliquid registration signal.\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @returns The current signal, or undefined if no entry exists.\n   */\n  public getWalletRegistered(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n  ): WalletRegistrationState | undefined {\n    const key = this.#getCacheKey(network, userAddress);\n    return this.#cache.get(key)?.walletRegistered;\n  }\n\n  /**\n   * Record whether the wallet has been observed on Hyperliquid. Once\n   * `registered=true` is set, it stays true for the session — the goal\n   * is to skip doomed exchange writes for unfunded wallets, not to\n   * gate them after they fund.\n   *\n   * @param network - The network environment.\n   * @param userAddress - The user's wallet address.\n   * @param registered - True once any evidence (clearinghouseState balance,\n   * userFills, successful deposit, ...) confirms the wallet exists on HL.\n   */\n  public setWalletRegistered(\n    network: 'mainnet' | 'testnet',\n    userAddress: string,\n    registered: boolean,\n  ): void {\n    const entry = this.#getOrCreateEntry(network, userAddress);\n    if (entry.walletRegistered.registered && !registered) {\n      // Monotonic: once registered, never demote.\n      return;\n    }\n    entry.walletRegistered = { known: true, registered };\n    entry.timestamp = Date.now();\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          `walletRegistered=${entry.walletRegistered.known}/${entry.walletRegistered.registered}`,\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"]}