@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/services/TradingReadinessCache.d.mts

@@ -0,0 +1,174 @@
+/**
+ * Global singleton cache for Perps signing operations
+ *
+ * This cache persists across provider reconnections to prevent repeated
+ * signing requests for hardware wallets. Critical for preventing QR popup spam.
+ *
+ * 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. DEX Abstraction enablement (one-time, irreversible)
+ * 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 }
+ *
+ * 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;
+};
+type PerpsSigningCacheEntry = {
+    dexAbstraction: SigningOperationState;
+    builderFee: SigningOperationState;
+    referral: SigningOperationState;
+    timestamp: number;
+};
+type TradingReadinessCacheEntry = {
+    attempted: boolean;
+    enabled: boolean;
+    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: 'dexAbstraction' | '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: 'dexAbstraction' | 'builderFee' | 'referral', network: 'mainnet' | 'testnet', userAddress: string): () => void;
+    /**
+     * Get DEX abstraction 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 DEX abstraction 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.
+     */
+    set(network: 'mainnet' | 'testnet', userAddress: string, data: {
+        attempted: boolean;
+        enabled: boolean;
+    }): 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 DEX abstraction 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: 'mainnet' | 'testnet', userAddress: string): void;
+    /**
+     * Clear only builder fee state for a specific network and user address
+     * This preserves DEX abstraction 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 DEX abstraction 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 (dexAbstraction, 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.mts.map

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

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

package/dist/services/TradingReadinessCache.mjs

@@ -0,0 +1,285 @@
+/**
+ * Global singleton cache for Perps signing operations
+ *
+ * This cache persists across provider reconnections to prevent repeated
+ * signing requests for hardware wallets. Critical for preventing QR popup spam.
+ *
+ * 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. DEX Abstraction enablement (one-time, irreversible)
+ * 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 }
+ *
+ * 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
+ */
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _PerpsSigningCacheManager_instances, _a, _PerpsSigningCacheManager_instance, _PerpsSigningCacheManager_cache, _PerpsSigningCacheManager_inFlightOperations, _PerpsSigningCacheManager_getCacheKey, _PerpsSigningCacheManager_getOrCreateEntry;
+class PerpsSigningCacheManager {
+    // Singleton: use getInstance() instead of new
+    constructor() {
+        _PerpsSigningCacheManager_instances.add(this);
+        _PerpsSigningCacheManager_cache.set(this, new Map());
+        // Global in-flight locks to prevent concurrent signing attempts across providers
+        // Key: operationType:network:userAddress, Value: Promise that resolves when operation completes
+        _PerpsSigningCacheManager_inFlightOperations.set(this, new Map());
+        // Protected constructor for singleton
+    }
+    static getInstance() {
+        var _b;
+        __classPrivateFieldSet(_b = _a, _a, __classPrivateFieldGet(_b, _a, "f", _PerpsSigningCacheManager_instance) ?? new _a(), "f", _PerpsSigningCacheManager_instance);
+        return __classPrivateFieldGet(_a, _a, "f", _PerpsSigningCacheManager_instance);
+    }
+    // ===== In-Flight Lock Methods =====
+    /**
+     * 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, network, userAddress) {
+        const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;
+        return __classPrivateFieldGet(this, _PerpsSigningCacheManager_inFlightOperations, "f").get(key);
+    }
+    /**
+     * 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, network, userAddress) {
+        const key = `${operationType}:${network}:${userAddress.toLowerCase()}`;
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        __classPrivateFieldGet(this, _PerpsSigningCacheManager_inFlightOperations, "f").set(key, promise);
+        return () => {
+            __classPrivateFieldGet(this, _PerpsSigningCacheManager_inFlightOperations, "f").delete(key);
+            resolvePromise();
+        };
+    }
+    // ===== DEX Abstraction Methods =====
+    /**
+     * Get DEX abstraction cache entry (legacy compatibility)
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     * @returns The resulting string value.
+     */
+    get(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) {
+            return undefined;
+        }
+        return {
+            attempted: entry.dexAbstraction.attempted,
+            enabled: entry.dexAbstraction.success,
+            timestamp: entry.timestamp,
+        };
+    }
+    /**
+     * Set DEX abstraction 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.
+     */
+    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.timestamp = Date.now();
+    }
+    // ===== Builder Fee Methods =====
+    /**
+     * 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, userAddress) {
+        const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
+        const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key);
+        return entry?.builderFee;
+    }
+    /**
+     * Set builder fee approval state
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     * @param state - The current state.
+     */
+    setBuilderFee(network, userAddress, state) {
+        const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getOrCreateEntry).call(this, network, userAddress);
+        entry.builderFee = state;
+        entry.timestamp = Date.now();
+    }
+    // ===== Referral Methods =====
+    /**
+     * 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, userAddress) {
+        const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
+        const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key);
+        return entry?.referral;
+    }
+    /**
+     * Set referral setup state
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     * @param state - The current state.
+     */
+    setReferral(network, userAddress, state) {
+        const entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getOrCreateEntry).call(this, network, userAddress);
+        entry.referral = state;
+        entry.timestamp = Date.now();
+    }
+    // ===== General Methods =====
+    /**
+     * Clear only DEX abstraction 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) {
+        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.timestamp = Date.now();
+        }
+    }
+    /**
+     * Clear only builder fee state for a specific network and user address
+     * This preserves DEX abstraction and referral states
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     */
+    clearBuilderFee(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.builderFee = { attempted: false, success: false };
+            entry.timestamp = Date.now();
+        }
+    }
+    /**
+     * Clear only referral state for a specific network and user address
+     * This preserves DEX abstraction and builder fee states
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     */
+    clearReferral(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.referral = { attempted: false, success: false };
+            entry.timestamp = Date.now();
+        }
+    }
+    /**
+     * Clear entire cache entry for a specific network and user address
+     * WARNING: This clears ALL signing operation states (dexAbstraction, builderFee, referral)
+     *
+     * @param network - The network environment.
+     * @param userAddress - The user's wallet address.
+     */
+    clear(network, userAddress) {
+        const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
+        __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").delete(key);
+    }
+    /**
+     * Clear all cache entries
+     * WARNING: This clears ALL signing operation states for ALL users
+     */
+    clearAll() {
+        __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").clear();
+    }
+    /**
+     * Get all cache entries (for debugging)
+     *
+     * @returns The result of the operation.
+     */
+    getAll() {
+        return new Map(__classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f"));
+    }
+    /**
+     * Get cache size (for debugging)
+     *
+     * @returns The resulting numeric value.
+     */
+    size() {
+        return __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").size;
+    }
+    /**
+     * Get full cache state for debugging
+     *
+     * @returns The resulting string value.
+     */
+    debugState() {
+        const entries = [];
+        __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").forEach((entry, key) => {
+            entries.push(`${key}: dex=${entry.dexAbstraction.attempted}/${entry.dexAbstraction.success}, ` +
+                `builder=${entry.builderFee.attempted}/${entry.builderFee.success}, ` +
+                `referral=${entry.referral.attempted}/${entry.referral.success}`);
+        });
+        return entries.join('\n') || '(empty)';
+    }
+}
+_a = PerpsSigningCacheManager, _PerpsSigningCacheManager_cache = new WeakMap(), _PerpsSigningCacheManager_inFlightOperations = new WeakMap(), _PerpsSigningCacheManager_instances = new WeakSet(), _PerpsSigningCacheManager_getCacheKey = function _PerpsSigningCacheManager_getCacheKey(network, userAddress) {
+    return `${network}:${userAddress.toLowerCase()}`;
+}, _PerpsSigningCacheManager_getOrCreateEntry = function _PerpsSigningCacheManager_getOrCreateEntry(network, userAddress) {
+    const key = __classPrivateFieldGet(this, _PerpsSigningCacheManager_instances, "m", _PerpsSigningCacheManager_getCacheKey).call(this, network, userAddress);
+    let entry = __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").get(key);
+    if (!entry) {
+        entry = {
+            dexAbstraction: { attempted: false, success: false },
+            builderFee: { attempted: false, success: false },
+            referral: { attempted: false, success: false },
+            timestamp: Date.now(),
+        };
+        __classPrivateFieldGet(this, _PerpsSigningCacheManager_cache, "f").set(key, entry);
+    }
+    return entry;
+};
+_PerpsSigningCacheManager_instance = { value: void 0 };
+// Export singleton instance with backward-compatible name
+export const TradingReadinessCache = PerpsSigningCacheManager.getInstance();
+// Export with new name for clarity
+export const PerpsSigningCache = PerpsSigningCacheManager.getInstance();
+//# sourceMappingURL=TradingReadinessCache.mjs.map

package/dist/services/TradingReadinessCache.mjs.map

@@ -0,0 +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"]}