@metamask-previews/perps-controller 6.2.0-preview-e43dfcb → 6.2.0-preview-c7c3c44

package/dist/services/TradingReadinessCache.d.cts

@@ -25,16 +25,23 @@
 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 {
@@ -76,10 +83,12 @@ declare class PerpsSigningCacheManager {
      * @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
@@ -121,6 +130,26 @@ declare class PerpsSigningCacheManager {
      * @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

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

@@ -1 +1 @@
-{"version":3,"file":"TradingReadinessCache.d.cts","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,cAAc,EAAE,qBAAqB,CAAC;IACtC,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAGF,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,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;IAqCb;;;;;;OAMG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,0BAA0B,GAAG,SAAS;IAazC;;;;;;;;OAQG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAC7C,IAAI;IAQP;;;;;;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;IASP;;;;;;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;CAW5B;AAGD,eAAO,MAAM,qBAAqB,0BAAyC,CAAC;AAG5E,eAAO,MAAM,iBAAiB,0BAAyC,CAAC"}
+{"version":3,"file":"TradingReadinessCache.d.cts","sourceRoot":"","sources":["../../src/services/TradingReadinessCache.ts"],"names":[],"mappings":"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"}

package/dist/services/TradingReadinessCache.d.mts

@@ -25,16 +25,23 @@
 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 {
@@ -76,10 +83,12 @@ declare class PerpsSigningCacheManager {
      * @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
@@ -121,6 +130,26 @@ declare class PerpsSigningCacheManager {
      * @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

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

@@ -1 +1 @@
-{"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;CAClB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,cAAc,EAAE,qBAAqB,CAAC;IACtC,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAGF,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,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;IAqCb;;;;;;OAMG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAClB,0BAA0B,GAAG,SAAS;IAazC;;;;;;;;OAQG;IACI,GAAG,CACR,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAC7C,IAAI;IAQP;;;;;;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;IASP;;;;;;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;CAW5B;AAGD,eAAO,MAAM,qBAAqB,0BAAyC,CAAC;AAG5E,eAAO,MAAM,iBAAiB,0BAAyC,CAAC"}
+{"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

@@ -100,6 +100,7 @@ class PerpsSigningCacheManager {
         return {
             attempted: entry.unifiedAccount.attempted,
             enabled: entry.unifiedAccount.success,
+            reason: entry.unifiedAccount.reason,
             timestamp: entry.timestamp,
         };
     }
@@ -111,10 +112,15 @@ class PerpsSigningCacheManager {
      * @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, userAddress, data) {
         const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getOrCreateEntry).call(this, network, userAddress);
-        entry.unifiedAccount = { attempted: data.attempted, success: data.enabled };
+        entry.unifiedAccount = {
+            attempted: data.attempted,
+            success: data.enabled,
+            reason: data.reason,
+        };
         entry.timestamp = Date.now();
     }
     // ===== Builder Fee Methods =====
@@ -183,6 +189,38 @@ class PerpsSigningCacheManager {
             entry.timestamp = Date.now();
         }
     }
+    // ===== Wallet Registration Methods =====
+    /**
+     * 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, userAddress) {
+        const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
+        return __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key)?.walletRegistered;
+    }
+    /**
+     * 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, userAddress, registered) {
+        const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getOrCreateEntry).call(this, network, userAddress);
+        if (entry.walletRegistered.registered && !registered) {
+            // Monotonic: once registered, never demote.
+            return;
+        }
+        entry.walletRegistered = { known: true, registered };
+        entry.timestamp = Date.now();
+    }
     /**
      * Clear only builder fee state for a specific network and user address
      * This preserves unified account and referral states
@@ -257,7 +295,8 @@ class PerpsSigningCacheManager {
         __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").forEach((entry, key) => {
             entries.push(`${key}: unified=${entry.unifiedAccount.attempted}/${entry.unifiedAccount.success}, ` +
                 `builder=${entry.builderFee.attempted}/${entry.builderFee.success}, ` +
-                `referral=${entry.referral.attempted}/${entry.referral.success}`);
+                `referral=${entry.referral.attempted}/${entry.referral.success}, ` +
+                `walletRegistered=${entry.walletRegistered.known}/${entry.walletRegistered.registered}`);
         });
         return entries.join('\n') || '(empty)';
     }
@@ -272,6 +311,7 @@ _a = PerpsSigningCacheManager, _PerpsSigningCacheManager_cache = new WeakMap(),
             unifiedAccount: { attempted: false, success: false },
             builderFee: { attempted: false, success: false },
             referral: { attempted: false, success: false },
+            walletRegistered: { known: false, registered: false },
             timestamp: Date.now(),
         };
         __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").set(key, entry);

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 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};\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"]}
+{"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"]}

package/dist/services/TradingService.cjs

@@ -1052,11 +1052,12 @@ class TradingService {
      * @param options - The configuration options.
      * @param options.provider - The perps provider instance.
      * @param options.position - The position data.
+     * @param options.trackingData - Optional tracking data for analytics events.
      * @param options.context - The service context for dependencies.
      * @returns The result of the operation.
      */
     async flipPosition(options) {
-        const { provider, position, context } = options;
+        const { provider, position, trackingData, context } = options;
         const traceId = (0, uuid_1.v4)();
         const startTime = __classPrivateFieldGet(this, _TradingService_deps, "f").performance.now();
         try {
@@ -1113,6 +1114,12 @@ class TradingService {
                     [eventNames_1.PERPS_EVENT_PROPERTY.COMPLETION_DURATION]: completionDuration,
                     [eventNames_1.PERPS_EVENT_PROPERTY.ACTION]: flipAction,
                     [eventNames_1.PERPS_EVENT_PROPERTY.ORDER_VALUE]: positionSize * executedPrice,
+                    ...(trackingData?.vipTier !== undefined && {
+                        [eventNames_1.PERPS_EVENT_PROPERTY.VIP_TIER]: trackingData.vipTier,
+                    }),
+                    ...(trackingData?.vipDiscount !== undefined && {
+                        [eventNames_1.PERPS_EVENT_PROPERTY.VIP_DISCOUNT]: trackingData.vipDiscount,
+                    }),
                 });
                 // Invalidate standalone caches so external hooks refresh
                 __classPrivateFieldGet(this, _TradingService_deps, "f").cacheInvalidator.invalidate({ cacheType: 'positions' });
@@ -1140,6 +1147,12 @@ class TradingService {
                 [eventNames_1.PERPS_EVENT_PROPERTY.ACTION]: failFlipAction,
                 [eventNames_1.PERPS_EVENT_PROPERTY.COMPLETION_DURATION]: completionDuration,
                 [eventNames_1.PERPS_EVENT_PROPERTY.ERROR_MESSAGE]: errorMessage,
+                ...(trackingData?.vipTier !== undefined && {
+                    [eventNames_1.PERPS_EVENT_PROPERTY.VIP_TIER]: trackingData.vipTier,
+                }),
+                ...(trackingData?.vipDiscount !== undefined && {
+                    [eventNames_1.PERPS_EVENT_PROPERTY.VIP_DISCOUNT]: trackingData.vipDiscount,
+                }),
             });
             __classPrivateFieldGet(this, _TradingService_deps, "f").tracer.endTrace({
                 name: types_1.PerpsTraceNames.FlipPosition,
@@ -1251,6 +1264,13 @@ _TradingService_deps = new WeakMap(), _TradingService_controllerDeps = new WeakM
         properties[eventNames_1.PERPS_EVENT_PROPERTY.ERROR_MESSAGE] =
             error?.message ?? result?.error ?? 'Unknown error';
     }
+    if (params.trackingData?.vipTier !== undefined) {
+        properties[eventNames_1.PERPS_EVENT_PROPERTY.VIP_TIER] = params.trackingData.vipTier;
+    }
+    if (params.trackingData?.vipDiscount !== undefined) {
+        properties[eventNames_1.PERPS_EVENT_PROPERTY.VIP_DISCOUNT] =
+            params.trackingData.vipDiscount;
+    }
     if (params.trackingData?.abTests &&
         Object.keys(params.trackingData.abTests).length > 0) {
         properties[eventNames_1.PERPS_EVENT_PROPERTY.AB_TESTS] = params.trackingData.abTests;
@@ -1429,6 +1449,12 @@ async function _TradingService_loadPositionData(options) {
         ...(params.trackingData?.source && {
             [eventNames_1.PERPS_EVENT_PROPERTY.SOURCE]: params.trackingData.source,
         }),
+        ...(params.trackingData?.vipTier !== undefined && {
+            [eventNames_1.PERPS_EVENT_PROPERTY.VIP_TIER]: params.trackingData.vipTier,
+        }),
+        ...(params.trackingData?.vipDiscount !== undefined && {
+            [eventNames_1.PERPS_EVENT_PROPERTY.VIP_DISCOUNT]: params.trackingData.vipDiscount,
+        }),
     };
     // Calculate and add order value in USD (size * price)
     const closeAssetPrice = result?.averagePrice