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

package/dist/providers/AggregatedPerpsProvider.cjs

@@ -0,0 +1,508 @@
+"use strict";
+/**
+ * AggregatedPerpsProvider - Multi-provider aggregation wrapper
+ *
+ * Implements PerpsProvider interface to enable seamless multi-provider support.
+ * Aggregates read operations from all providers, routes write operations to specific
+ * providers based on params.providerId or default provider.
+ *
+ * Phase 1 Implementation:
+ * - Read operations: Aggregate from all providers using Promise.allSettled()
+ * - Write operations: Route to params.providerId ?? defaultProvider
+ * - Subscriptions: Multiplex via SubscriptionMultiplexer
+ * - Lifecycle: Delegate to default provider
+ *
+ * All returned data includes providerId field for UI differentiation.
+ */
+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 __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 _AggregatedPerpsProvider_instances, _AggregatedPerpsProvider_providers, _AggregatedPerpsProvider_defaultProvider, _AggregatedPerpsProvider_aggregationMode, _AggregatedPerpsProvider_deps, _AggregatedPerpsProvider_router, _AggregatedPerpsProvider_subscriptionMux, _AggregatedPerpsProvider_getActiveProviders, _AggregatedPerpsProvider_getDefaultProvider, _AggregatedPerpsProvider_getProviderOrDefault, _AggregatedPerpsProvider_extractSuccessfulResults;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregatedPerpsProvider = void 0;
+const SubscriptionMultiplexer_1 = require("../aggregation/SubscriptionMultiplexer.cjs");
+const ProviderRouter_1 = require("../routing/ProviderRouter.cjs");
+/**
+ * AggregatedPerpsProvider implements PerpsProvider by coordinating
+ * multiple backend providers.
+ *
+ * Design principles:
+ * 1. Read operations aggregate from all providers (parallel)
+ * 2. Write operations route to specific provider (explicit > default)
+ * 3. Lifecycle operations delegate to default provider
+ * 4. All returned data includes providerId for UI differentiation
+ *
+ * @example
+ * ```typescript
+ * const aggregated = new AggregatedPerpsProvider({
+ *   providers: new Map([
+ *     ['hyperliquid', hlProvider],
+ *     ['myx', myxProvider],
+ *   ]),
+ *   defaultProvider: 'hyperliquid',
+ *   infrastructure: deps,
+ * });
+ *
+ * // Read: returns positions from all providers
+ * const positions = await aggregated.getPositions();
+ *
+ * // Write: routes to specific or default provider
+ * await aggregated.placeOrder({ symbol: 'BTC', providerId: 'myx', ... });
+ * ```
+ */
+class AggregatedPerpsProvider {
+    constructor(config) {
+        _AggregatedPerpsProvider_instances.add(this);
+        this.protocolId = 'aggregated';
+        _AggregatedPerpsProvider_providers.set(this, void 0);
+        _AggregatedPerpsProvider_defaultProvider.set(this, void 0);
+        _AggregatedPerpsProvider_aggregationMode.set(this, void 0);
+        _AggregatedPerpsProvider_deps.set(this, void 0);
+        _AggregatedPerpsProvider_router.set(this, void 0);
+        _AggregatedPerpsProvider_subscriptionMux.set(this, void 0);
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_providers, config.providers, "f");
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_defaultProvider, config.defaultProvider, "f");
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_aggregationMode, config.aggregationMode ?? 'all', "f");
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_deps, config.infrastructure, "f");
+        // Initialize router with default provider
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_router, new ProviderRouter_1.ProviderRouter({
+            defaultProvider: __classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f"),
+        }), "f");
+        // Initialize subscription multiplexer with logger for error reporting
+        __classPrivateFieldSet(this, _AggregatedPerpsProvider_subscriptionMux, new SubscriptionMultiplexer_1.SubscriptionMultiplexer({
+            logger: __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").logger,
+        }), "f");
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log('[AggregatedPerpsProvider] Initialized', {
+            providers: Array.from(__classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").keys()),
+            defaultProvider: __classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f"),
+            aggregationMode: __classPrivateFieldGet(this, _AggregatedPerpsProvider_aggregationMode, "f"),
+        });
+    }
+    // ============================================================================
+    // Asset Routes (Synchronous - delegate to default provider)
+    // ============================================================================
+    getDepositRoutes(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getDepositRoutes(params);
+    }
+    getWithdrawalRoutes(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getWithdrawalRoutes(params);
+    }
+    // ============================================================================
+    // Read Operations (Aggregate from all providers)
+    // ============================================================================
+    async getPositions(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const positions = await provider.getPositions(params);
+            return positions.map((pos) => ({ ...pos, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getPositions').flat();
+    }
+    async getAccountState(params) {
+        // Return account state from default provider with providerId injected
+        const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this);
+        const state = await provider.getAccountState(params);
+        return { ...state, providerId: __classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f") };
+    }
+    async getMarkets(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const markets = await provider.getMarkets(params);
+            return markets.map((market) => ({ ...market, providerId: id }));
+        }));
+        const allMarkets = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getMarkets').flat();
+        // Deduplicate markets by name (keep first occurrence)
+        const seen = new Set();
+        return allMarkets.filter((market) => {
+            // Use providerId:name as unique key to allow same market from different providers
+            const key = `${market.providerId}:${market.name}`;
+            if (seen.has(key)) {
+                return false;
+            }
+            seen.add(key);
+            return true;
+        });
+    }
+    async getMarketDataWithPrices() {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const data = await provider.getMarketDataWithPrices();
+            return data.map((item) => ({ ...item, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getMarketDataWithPrices').flat();
+    }
+    async getOrderFills(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const fills = await provider.getOrderFills(params);
+            return fills.map((fill) => ({ ...fill, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrderFills').flat();
+    }
+    async getOrFetchFills(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const fills = await provider.getOrFetchFills(params);
+            return fills.map((fill) => ({ ...fill, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrFetchFills').flat();
+    }
+    async getOrders(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const orders = await provider.getOrders(params);
+            return orders.map((order) => ({ ...order, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrders').flat();
+    }
+    async getOpenOrders(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const orders = await provider.getOpenOrders(params);
+            return orders.map((order) => ({ ...order, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOpenOrders').flat();
+    }
+    async getFunding(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([_providerId, provider]) => {
+            const funding = await provider.getFunding(params);
+            // Funding type doesn't have providerId - we could add it if needed
+            return funding;
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getFunding').flat();
+    }
+    async getHistoricalPortfolio(params) {
+        // Delegate to default provider
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getHistoricalPortfolio(params);
+    }
+    /**
+     * Get user non-funding ledger updates from default provider.
+     *
+     * @param params - Optional parameters
+     * @param params.accountId - Account ID to filter by
+     * @param params.startTime - Start time filter
+     * @param params.endTime - End time filter
+     * @returns Raw ledger updates
+     */
+    async getUserNonFundingLedgerUpdates(params) {
+        // Delegate to default provider (protocol-specific)
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getUserNonFundingLedgerUpdates(params);
+    }
+    /**
+     * Get user history from all providers.
+     *
+     * @param params - Optional parameters
+     * @param params.accountId - Account ID to filter by
+     * @param params.startTime - Start time filter
+     * @param params.endTime - End time filter
+     * @returns Aggregated user history with providerId
+     */
+    async getUserHistory(params) {
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
+            const history = await provider.getUserHistory(params);
+            return history.map((item) => ({ ...item, providerId: id }));
+        }));
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getUserHistory').flat();
+    }
+    // ============================================================================
+    // Write Operations (Route to specific provider)
+    // ============================================================================
+    async placeOrder(params) {
+        const [providerId, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log('[AggregatedPerpsProvider] placeOrder routing', {
+            requestedProvider: params.providerId,
+            actualProvider: providerId,
+            symbol: params.symbol,
+        });
+        const result = await provider.placeOrder(params);
+        return { ...result, providerId };
+    }
+    async editOrder(params) {
+        // EditOrderParams contains OrderParams in newOrder which may have providerId
+        const [providerId, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.newOrder.providerId);
+        const result = await provider.editOrder(params);
+        return { ...result, providerId };
+    }
+    async cancelOrder(params) {
+        const [providerId, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        const result = await provider.cancelOrder(params);
+        return { ...result, providerId };
+    }
+    async cancelOrders(params) {
+        // Batch cancel delegates to default provider
+        const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this);
+        if (!provider.cancelOrders) {
+            return {
+                success: false,
+                successCount: 0,
+                failureCount: params.length,
+                results: params.map((param) => ({
+                    orderId: param.orderId,
+                    symbol: param.symbol,
+                    success: false,
+                    error: 'Batch cancel not supported',
+                })),
+            };
+        }
+        return provider.cancelOrders(params);
+    }
+    async closePosition(params) {
+        const [providerId, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        const result = await provider.closePosition(params);
+        return { ...result, providerId };
+    }
+    async closePositions(params) {
+        // Batch close delegates to default provider
+        const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this);
+        if (!provider.closePositions) {
+            return {
+                success: false,
+                successCount: 0,
+                failureCount: 0,
+                results: [],
+            };
+        }
+        return provider.closePositions(params);
+    }
+    async updatePositionTPSL(params) {
+        const [providerId, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        const result = await provider.updatePositionTPSL(params);
+        return { ...result, providerId };
+    }
+    async updateMargin(params) {
+        const [, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        return provider.updateMargin(params);
+    }
+    async withdraw(params) {
+        const [, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        return provider.withdraw(params);
+    }
+    // ============================================================================
+    // Validation (Route to specific provider)
+    // ============================================================================
+    async validateDeposit(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).validateDeposit(params);
+    }
+    async validateOrder(params) {
+        const [, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        return provider.validateOrder(params);
+    }
+    async validateClosePosition(params) {
+        const [, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        return provider.validateClosePosition(params);
+    }
+    async validateWithdrawal(params) {
+        const [, provider] = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getProviderOrDefault).call(this, params.providerId);
+        return provider.validateWithdrawal(params);
+    }
+    // ============================================================================
+    // Protocol Calculations (Delegate to default or route)
+    // ============================================================================
+    async calculateLiquidationPrice(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).calculateLiquidationPrice(params);
+    }
+    async calculateMaintenanceMargin(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).calculateMaintenanceMargin(params);
+    }
+    async getMaxLeverage(asset) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getMaxLeverage(asset);
+    }
+    async calculateFees(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).calculateFees(params);
+    }
+    // ============================================================================
+    // Subscriptions (Multiplex via SubscriptionMultiplexer)
+    // ============================================================================
+    subscribeToPrices(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_subscriptionMux, "f").subscribeToPrices({
+            ...params,
+            providers: __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this),
+            aggregationMode: 'merge',
+        });
+    }
+    subscribeToPositions(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_subscriptionMux, "f").subscribeToPositions({
+            ...params,
+            providers: __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this),
+        });
+    }
+    subscribeToOrderFills(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_subscriptionMux, "f").subscribeToOrderFills({
+            ...params,
+            providers: __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this),
+        });
+    }
+    subscribeToOrders(params) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_subscriptionMux, "f").subscribeToOrders({
+            ...params,
+            providers: __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this),
+        });
+    }
+    subscribeToAccount(params) {
+        // For account subscriptions, we emit as array for multi-provider
+        // but the callback expects single AccountState
+        // Delegate to default provider for now
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).subscribeToAccount(params);
+    }
+    subscribeToOICaps(params) {
+        // Delegate to default provider
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).subscribeToOICaps(params);
+    }
+    subscribeToCandles(params) {
+        // Delegate to default provider
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).subscribeToCandles(params);
+    }
+    subscribeToOrderBook(params) {
+        // Delegate to default provider
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).subscribeToOrderBook(params);
+    }
+    // ============================================================================
+    // Configuration
+    // ============================================================================
+    setLiveDataConfig(config) {
+        // Apply config to all providers
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").forEach((provider) => {
+            provider.setLiveDataConfig(config);
+        });
+    }
+    setUserFeeDiscount(discountBips) {
+        // Apply to all providers that support it
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").forEach((provider) => {
+            if (provider.setUserFeeDiscount) {
+                provider.setUserFeeDiscount(discountBips);
+            }
+        });
+    }
+    // ============================================================================
+    // Lifecycle (Delegate to default provider)
+    // ============================================================================
+    async toggleTestnet() {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).toggleTestnet();
+    }
+    async initialize() {
+        // Initialize default provider
+        const result = await __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).initialize();
+        // Optionally initialize other providers in background
+        // For Phase 1, we only initialize default provider
+        return result;
+    }
+    async isReadyToTrade() {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).isReadyToTrade();
+    }
+    async disconnect() {
+        // Disconnect all providers
+        const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(([, provider]) => provider.disconnect()));
+        // Clear subscription cache
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_subscriptionMux, "f").clearCache();
+        // Return success if at least one succeeded
+        const successCount = results.filter((res) => res.status === 'fulfilled' && res.value.success).length;
+        return {
+            success: successCount > 0,
+        };
+    }
+    async ping(timeoutMs) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).ping(timeoutMs);
+    }
+    // ============================================================================
+    // Block Explorer
+    // ============================================================================
+    getBlockExplorerUrl(address) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getBlockExplorerUrl(address);
+    }
+    // ============================================================================
+    // HIP-3 (Optional)
+    // ============================================================================
+    async getAvailableDexs(params) {
+        const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this);
+        if (!provider.getAvailableDexs) {
+            return [];
+        }
+        return provider.getAvailableDexs(params);
+    }
+    // ============================================================================
+    // Provider Management
+    // ============================================================================
+    /**
+     * Add a new provider to the aggregated provider.
+     *
+     * @param providerId - Unique identifier for the provider
+     * @param provider - Provider instance
+     */
+    addProvider(providerId, provider) {
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").set(providerId, provider);
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log('[AggregatedPerpsProvider] Provider added', {
+            providerId,
+        });
+    }
+    /**
+     * Remove a provider from the aggregated provider.
+     *
+     * @param providerId - Provider to remove
+     * @returns true if removed, false if not found
+     */
+    removeProvider(providerId) {
+        const removed = __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").delete(providerId);
+        if (removed) {
+            __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log('[AggregatedPerpsProvider] Provider removed', {
+                providerId,
+            });
+        }
+        return removed;
+    }
+    /**
+     * Get list of all registered provider IDs.
+     *
+     * @returns The result of the operation.
+     */
+    getProviderIds() {
+        return Array.from(__classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").keys());
+    }
+    /**
+     * Check if a provider is registered.
+     *
+     * @param providerId - The provider id value.
+     * @returns True if the condition is met.
+     */
+    hasProvider(providerId) {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").has(providerId);
+    }
+    /**
+     * Get the router instance for external configuration.
+     *
+     * @returns The result of the operation.
+     */
+    getRouter() {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_router, "f");
+    }
+}
+exports.AggregatedPerpsProvider = AggregatedPerpsProvider;
+_AggregatedPerpsProvider_providers = new WeakMap(), _AggregatedPerpsProvider_defaultProvider = new WeakMap(), _AggregatedPerpsProvider_aggregationMode = new WeakMap(), _AggregatedPerpsProvider_deps = new WeakMap(), _AggregatedPerpsProvider_router = new WeakMap(), _AggregatedPerpsProvider_subscriptionMux = new WeakMap(), _AggregatedPerpsProvider_instances = new WeakSet(), _AggregatedPerpsProvider_getActiveProviders = function _AggregatedPerpsProvider_getActiveProviders() {
+    return Array.from(__classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").entries());
+}, _AggregatedPerpsProvider_getDefaultProvider = function _AggregatedPerpsProvider_getDefaultProvider() {
+    const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").get(__classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f"));
+    if (!provider) {
+        throw new Error(`[AggregatedPerpsProvider] Default provider '${__classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f")}' not available`);
+    }
+    return provider;
+}, _AggregatedPerpsProvider_getProviderOrDefault = function _AggregatedPerpsProvider_getProviderOrDefault(providerId) {
+    const id = providerId ?? __classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f");
+    const provider = __classPrivateFieldGet(this, _AggregatedPerpsProvider_providers, "f").get(id);
+    if (!provider) {
+        __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log(`[AggregatedPerpsProvider] Provider '${id}' not found, using default`);
+        return [__classPrivateFieldGet(this, _AggregatedPerpsProvider_defaultProvider, "f"), __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this)];
+    }
+    return [id, provider];
+}, _AggregatedPerpsProvider_extractSuccessfulResults = function _AggregatedPerpsProvider_extractSuccessfulResults(results, context) {
+    const successful = [];
+    results.forEach((result, index) => {
+        if (result.status === 'fulfilled') {
+            successful.push(result.value);
+        }
+        else {
+            __classPrivateFieldGet(this, _AggregatedPerpsProvider_deps, "f").debugLogger.log(`[AggregatedPerpsProvider] ${context} failed for provider ${index}`, { error: result.reason });
+        }
+    });
+    return successful;
+};
+//# sourceMappingURL=AggregatedPerpsProvider.cjs.map

package/dist/providers/AggregatedPerpsProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregatedPerpsProvider.cjs","sourceRoot":"","sources":["../../src/providers/AggregatedPerpsProvider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AggregatedPerpsProvider - Multi-provider aggregation wrapper\n *\n * Implements PerpsProvider interface to enable seamless multi-provider support.\n * Aggregates read operations from all providers, routes write operations to specific\n * providers based on params.providerId or default provider.\n *\n * Phase 1 Implementation:\n * - Read operations: Aggregate from all providers using Promise.allSettled()\n * - Write operations: Route to params.providerId ?? defaultProvider\n * - Subscriptions: Multiplex via SubscriptionMultiplexer\n * - Lifecycle: Delegate to default provider\n *\n * All returned data includes providerId field for UI differentiation.\n */\n\nimport type { CaipAccountId } from '@metamask/utils';\n\nimport { SubscriptionMultiplexer } from '../aggregation/SubscriptionMultiplexer';\nimport { ProviderRouter } from '../routing/ProviderRouter';\nimport type {\n  AccountState,\n  AggregatedProviderConfig,\n  AggregationMode,\n  AssetRoute,\n  BatchCancelOrdersParams,\n  CancelOrderParams,\n  CancelOrderResult,\n  CancelOrdersResult,\n  ClosePositionParams,\n  ClosePositionsParams,\n  ClosePositionsResult,\n  DepositParams,\n  DisconnectResult,\n  EditOrderParams,\n  FeeCalculationParams,\n  FeeCalculationResult,\n  Funding,\n  GetAccountStateParams,\n  GetAvailableDexsParams,\n  GetFundingParams,\n  GetHistoricalPortfolioParams,\n  GetMarketsParams,\n  GetOrderFillsParams,\n  GetOrdersParams,\n  GetOrFetchFillsParams,\n  GetPositionsParams,\n  GetSupportedPathsParams,\n  HistoricalPortfolioResult,\n  InitializeResult,\n  PerpsPlatformDependencies,\n  PerpsProvider,\n  LiquidationPriceParams,\n  LiveDataConfig,\n  MaintenanceMarginParams,\n  MarginResult,\n  MarketInfo,\n  Order,\n  OrderFill,\n  OrderParams,\n  OrderResult,\n  PerpsMarketData,\n  PerpsProviderType,\n  Position,\n  ReadyToTradeResult,\n  SubscribeAccountParams,\n  SubscribeCandlesParams,\n  SubscribeOICapsParams,\n  SubscribeOrderBookParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribePositionsParams,\n  SubscribePricesParams,\n  ToggleTestnetResult,\n  UpdateMarginParams,\n  UpdatePositionTPSLParams,\n  UserHistoryItem,\n  WithdrawParams,\n  WithdrawResult,\n  RawLedgerUpdate,\n} from '../types';\n\n/**\n * AggregatedPerpsProvider implements PerpsProvider by coordinating\n * multiple backend providers.\n *\n * Design principles:\n * 1. Read operations aggregate from all providers (parallel)\n * 2. Write operations route to specific provider (explicit > default)\n * 3. Lifecycle operations delegate to default provider\n * 4. All returned data includes providerId for UI differentiation\n *\n * @example\n * ```typescript\n * const aggregated = new AggregatedPerpsProvider({\n *   providers: new Map([\n *     ['hyperliquid', hlProvider],\n *     ['myx', myxProvider],\n *   ]),\n *   defaultProvider: 'hyperliquid',\n *   infrastructure: deps,\n * });\n *\n * // Read: returns positions from all providers\n * const positions = await aggregated.getPositions();\n *\n * // Write: routes to specific or default provider\n * await aggregated.placeOrder({ symbol: 'BTC', providerId: 'myx', ... });\n * ```\n */\nexport class AggregatedPerpsProvider implements PerpsProvider {\n  readonly protocolId = 'aggregated';\n\n  readonly #providers: Map<PerpsProviderType, PerpsProvider>;\n\n  readonly #defaultProvider: PerpsProviderType;\n\n  readonly #aggregationMode: AggregationMode;\n\n  readonly #deps: PerpsPlatformDependencies;\n\n  readonly #router: ProviderRouter;\n\n  readonly #subscriptionMux: SubscriptionMultiplexer;\n\n  constructor(config: AggregatedProviderConfig) {\n    this.#providers = config.providers;\n    this.#defaultProvider = config.defaultProvider;\n    this.#aggregationMode = config.aggregationMode ?? 'all';\n    this.#deps = config.infrastructure;\n\n    // Initialize router with default provider\n    this.#router = new ProviderRouter({\n      defaultProvider: this.#defaultProvider,\n    });\n\n    // Initialize subscription multiplexer with logger for error reporting\n    this.#subscriptionMux = new SubscriptionMultiplexer({\n      logger: this.#deps.logger,\n    });\n\n    this.#deps.debugLogger.log('[AggregatedPerpsProvider] Initialized', {\n      providers: Array.from(this.#providers.keys()),\n      defaultProvider: this.#defaultProvider,\n      aggregationMode: this.#aggregationMode,\n    });\n  }\n\n  // ============================================================================\n  // Helper Methods\n  // ============================================================================\n\n  /**\n   * Get list of active providers as tuples for iteration.\n   * Returns array of [providerId, provider] pairs.\n   *\n   * @returns The result of the operation.\n   */\n  #getActiveProviders(): [PerpsProviderType, PerpsProvider][] {\n    return Array.from(this.#providers.entries());\n  }\n\n  /**\n   * Get the default provider instance.\n   * Throws if default provider is not available.\n   *\n   * @returns The result of the operation.\n   */\n  #getDefaultProvider(): PerpsProvider {\n    const provider = this.#providers.get(this.#defaultProvider);\n    if (!provider) {\n      throw new Error(\n        `[AggregatedPerpsProvider] Default provider '${this.#defaultProvider}' not available`,\n      );\n    }\n    return provider;\n  }\n\n  /**\n   * Get provider by ID, falling back to default if not found.\n   *\n   * @param providerId - The provider id value.\n   * @returns The result of the operation.\n   */\n  #getProviderOrDefault(\n    providerId?: PerpsProviderType,\n  ): [PerpsProviderType, PerpsProvider] {\n    const id = providerId ?? this.#defaultProvider;\n    const provider = this.#providers.get(id);\n    if (!provider) {\n      this.#deps.debugLogger.log(\n        `[AggregatedPerpsProvider] Provider '${id}' not found, using default`,\n      );\n      return [this.#defaultProvider, this.#getDefaultProvider()];\n    }\n    return [id, provider];\n  }\n\n  /**\n   * Extract successful results from Promise.allSettled.\n   * Logs errors for failed promises.\n   *\n   * @param results - Results from Promise.allSettled\n   * @param context - Context string for logging\n   * @returns Array of successful values\n   */\n  #extractSuccessfulResults<TResult>(\n    results: PromiseSettledResult<TResult>[],\n    context: string,\n  ): TResult[] {\n    const successful: TResult[] = [];\n    results.forEach((result, index) => {\n      if (result.status === 'fulfilled') {\n        successful.push(result.value);\n      } else {\n        this.#deps.debugLogger.log(\n          `[AggregatedPerpsProvider] ${context} failed for provider ${index}`,\n          { error: result.reason },\n        );\n      }\n    });\n    return successful;\n  }\n\n  // ============================================================================\n  // Asset Routes (Synchronous - delegate to default provider)\n  // ============================================================================\n\n  getDepositRoutes(params?: GetSupportedPathsParams): AssetRoute[] {\n    return this.#getDefaultProvider().getDepositRoutes(params);\n  }\n\n  getWithdrawalRoutes(params?: GetSupportedPathsParams): AssetRoute[] {\n    return this.#getDefaultProvider().getWithdrawalRoutes(params);\n  }\n\n  // ============================================================================\n  // Read Operations (Aggregate from all providers)\n  // ============================================================================\n\n  async getPositions(params?: GetPositionsParams): Promise<Position[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const positions = await provider.getPositions(params);\n        return positions.map((pos) => ({ ...pos, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getPositions').flat();\n  }\n\n  async getAccountState(params?: GetAccountStateParams): Promise<AccountState> {\n    // Return account state from default provider with providerId injected\n    const provider = this.#getDefaultProvider();\n    const state = await provider.getAccountState(params);\n    return { ...state, providerId: this.#defaultProvider };\n  }\n\n  async getMarkets(params?: GetMarketsParams): Promise<MarketInfo[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const markets = await provider.getMarkets(params);\n        return markets.map((market) => ({ ...market, providerId: id }));\n      }),\n    );\n\n    const allMarkets = this.#extractSuccessfulResults(\n      results,\n      'getMarkets',\n    ).flat();\n\n    // Deduplicate markets by name (keep first occurrence)\n    const seen = new Set<string>();\n    return allMarkets.filter((market) => {\n      // Use providerId:name as unique key to allow same market from different providers\n      const key = `${market.providerId}:${market.name}`;\n      if (seen.has(key)) {\n        return false;\n      }\n      seen.add(key);\n      return true;\n    });\n  }\n\n  async getMarketDataWithPrices(): Promise<PerpsMarketData[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const data = await provider.getMarketDataWithPrices();\n        return data.map((item) => ({ ...item, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(\n      results,\n      'getMarketDataWithPrices',\n    ).flat();\n  }\n\n  async getOrderFills(params?: GetOrderFillsParams): Promise<OrderFill[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const fills = await provider.getOrderFills(params);\n        return fills.map((fill) => ({ ...fill, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getOrderFills').flat();\n  }\n\n  async getOrFetchFills(params?: GetOrFetchFillsParams): Promise<OrderFill[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const fills = await provider.getOrFetchFills(params);\n        return fills.map((fill) => ({ ...fill, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getOrFetchFills').flat();\n  }\n\n  async getOrders(params?: GetOrdersParams): Promise<Order[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const orders = await provider.getOrders(params);\n        return orders.map((order) => ({ ...order, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getOrders').flat();\n  }\n\n  async getOpenOrders(params?: GetOrdersParams): Promise<Order[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const orders = await provider.getOpenOrders(params);\n        return orders.map((order) => ({ ...order, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getOpenOrders').flat();\n  }\n\n  async getFunding(params?: GetFundingParams): Promise<Funding[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([_providerId, provider]) => {\n        const funding = await provider.getFunding(params);\n        // Funding type doesn't have providerId - we could add it if needed\n        return funding;\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getFunding').flat();\n  }\n\n  async getHistoricalPortfolio(\n    params?: GetHistoricalPortfolioParams,\n  ): Promise<HistoricalPortfolioResult> {\n    // Delegate to default provider\n    return this.#getDefaultProvider().getHistoricalPortfolio(params);\n  }\n\n  /**\n   * Get user non-funding ledger updates from default provider.\n   *\n   * @param params - Optional parameters\n   * @param params.accountId - Account ID to filter by\n   * @param params.startTime - Start time filter\n   * @param params.endTime - End time filter\n   * @returns Raw ledger updates\n   */\n  async getUserNonFundingLedgerUpdates(params?: {\n    accountId?: string;\n    startTime?: number;\n    endTime?: number;\n  }): Promise<RawLedgerUpdate[]> {\n    // Delegate to default provider (protocol-specific)\n    return this.#getDefaultProvider().getUserNonFundingLedgerUpdates(params);\n  }\n\n  /**\n   * Get user history from all providers.\n   *\n   * @param params - Optional parameters\n   * @param params.accountId - Account ID to filter by\n   * @param params.startTime - Start time filter\n   * @param params.endTime - End time filter\n   * @returns Aggregated user history with providerId\n   */\n  async getUserHistory(params?: {\n    accountId?: CaipAccountId;\n    startTime?: number;\n    endTime?: number;\n  }): Promise<UserHistoryItem[]> {\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(async ([id, provider]) => {\n        const history = await provider.getUserHistory(params);\n        return history.map((item) => ({ ...item, providerId: id }));\n      }),\n    );\n\n    return this.#extractSuccessfulResults(results, 'getUserHistory').flat();\n  }\n\n  // ============================================================================\n  // Write Operations (Route to specific provider)\n  // ============================================================================\n\n  async placeOrder(params: OrderParams): Promise<OrderResult> {\n    const [providerId, provider] = this.#getProviderOrDefault(\n      params.providerId,\n    );\n\n    this.#deps.debugLogger.log('[AggregatedPerpsProvider] placeOrder routing', {\n      requestedProvider: params.providerId,\n      actualProvider: providerId,\n      symbol: params.symbol,\n    });\n\n    const result = await provider.placeOrder(params);\n    return { ...result, providerId };\n  }\n\n  async editOrder(params: EditOrderParams): Promise<OrderResult> {\n    // EditOrderParams contains OrderParams in newOrder which may have providerId\n    const [providerId, provider] = this.#getProviderOrDefault(\n      params.newOrder.providerId,\n    );\n    const result = await provider.editOrder(params);\n    return { ...result, providerId };\n  }\n\n  async cancelOrder(params: CancelOrderParams): Promise<CancelOrderResult> {\n    const [providerId, provider] = this.#getProviderOrDefault(\n      params.providerId,\n    );\n    const result = await provider.cancelOrder(params);\n    return { ...result, providerId };\n  }\n\n  async cancelOrders(\n    params: BatchCancelOrdersParams,\n  ): Promise<CancelOrdersResult> {\n    // Batch cancel delegates to default provider\n    const provider = this.#getDefaultProvider();\n    if (!provider.cancelOrders) {\n      return {\n        success: false,\n        successCount: 0,\n        failureCount: params.length,\n        results: params.map((param) => ({\n          orderId: param.orderId,\n          symbol: param.symbol,\n          success: false,\n          error: 'Batch cancel not supported',\n        })),\n      };\n    }\n    return provider.cancelOrders(params);\n  }\n\n  async closePosition(params: ClosePositionParams): Promise<OrderResult> {\n    const [providerId, provider] = this.#getProviderOrDefault(\n      params.providerId,\n    );\n    const result = await provider.closePosition(params);\n    return { ...result, providerId };\n  }\n\n  async closePositions(\n    params: ClosePositionsParams,\n  ): Promise<ClosePositionsResult> {\n    // Batch close delegates to default provider\n    const provider = this.#getDefaultProvider();\n    if (!provider.closePositions) {\n      return {\n        success: false,\n        successCount: 0,\n        failureCount: 0,\n        results: [],\n      };\n    }\n    return provider.closePositions(params);\n  }\n\n  async updatePositionTPSL(\n    params: UpdatePositionTPSLParams,\n  ): Promise<OrderResult> {\n    const [providerId, provider] = this.#getProviderOrDefault(\n      params.providerId,\n    );\n    const result = await provider.updatePositionTPSL(params);\n    return { ...result, providerId };\n  }\n\n  async updateMargin(params: UpdateMarginParams): Promise<MarginResult> {\n    const [, provider] = this.#getProviderOrDefault(params.providerId);\n    return provider.updateMargin(params);\n  }\n\n  async withdraw(params: WithdrawParams): Promise<WithdrawResult> {\n    const [, provider] = this.#getProviderOrDefault(params.providerId);\n    return provider.withdraw(params);\n  }\n\n  // ============================================================================\n  // Validation (Route to specific provider)\n  // ============================================================================\n\n  async validateDeposit(\n    params: DepositParams,\n  ): Promise<{ isValid: boolean; error?: string }> {\n    return this.#getDefaultProvider().validateDeposit(params);\n  }\n\n  async validateOrder(\n    params: OrderParams,\n  ): Promise<{ isValid: boolean; error?: string }> {\n    const [, provider] = this.#getProviderOrDefault(params.providerId);\n    return provider.validateOrder(params);\n  }\n\n  async validateClosePosition(\n    params: ClosePositionParams,\n  ): Promise<{ isValid: boolean; error?: string }> {\n    const [, provider] = this.#getProviderOrDefault(params.providerId);\n    return provider.validateClosePosition(params);\n  }\n\n  async validateWithdrawal(\n    params: WithdrawParams,\n  ): Promise<{ isValid: boolean; error?: string }> {\n    const [, provider] = this.#getProviderOrDefault(params.providerId);\n    return provider.validateWithdrawal(params);\n  }\n\n  // ============================================================================\n  // Protocol Calculations (Delegate to default or route)\n  // ============================================================================\n\n  async calculateLiquidationPrice(\n    params: LiquidationPriceParams,\n  ): Promise<string> {\n    return this.#getDefaultProvider().calculateLiquidationPrice(params);\n  }\n\n  async calculateMaintenanceMargin(\n    params: MaintenanceMarginParams,\n  ): Promise<number> {\n    return this.#getDefaultProvider().calculateMaintenanceMargin(params);\n  }\n\n  async getMaxLeverage(asset: string): Promise<number> {\n    return this.#getDefaultProvider().getMaxLeverage(asset);\n  }\n\n  async calculateFees(\n    params: FeeCalculationParams,\n  ): Promise<FeeCalculationResult> {\n    return this.#getDefaultProvider().calculateFees(params);\n  }\n\n  // ============================================================================\n  // Subscriptions (Multiplex via SubscriptionMultiplexer)\n  // ============================================================================\n\n  subscribeToPrices(params: SubscribePricesParams): () => void {\n    return this.#subscriptionMux.subscribeToPrices({\n      ...params,\n      providers: this.#getActiveProviders(),\n      aggregationMode: 'merge',\n    });\n  }\n\n  subscribeToPositions(params: SubscribePositionsParams): () => void {\n    return this.#subscriptionMux.subscribeToPositions({\n      ...params,\n      providers: this.#getActiveProviders(),\n    });\n  }\n\n  subscribeToOrderFills(params: SubscribeOrderFillsParams): () => void {\n    return this.#subscriptionMux.subscribeToOrderFills({\n      ...params,\n      providers: this.#getActiveProviders(),\n    });\n  }\n\n  subscribeToOrders(params: SubscribeOrdersParams): () => void {\n    return this.#subscriptionMux.subscribeToOrders({\n      ...params,\n      providers: this.#getActiveProviders(),\n    });\n  }\n\n  subscribeToAccount(params: SubscribeAccountParams): () => void {\n    // For account subscriptions, we emit as array for multi-provider\n    // but the callback expects single AccountState\n    // Delegate to default provider for now\n    return this.#getDefaultProvider().subscribeToAccount(params);\n  }\n\n  subscribeToOICaps(params: SubscribeOICapsParams): () => void {\n    // Delegate to default provider\n    return this.#getDefaultProvider().subscribeToOICaps(params);\n  }\n\n  subscribeToCandles(params: SubscribeCandlesParams): () => void {\n    // Delegate to default provider\n    return this.#getDefaultProvider().subscribeToCandles(params);\n  }\n\n  subscribeToOrderBook(params: SubscribeOrderBookParams): () => void {\n    // Delegate to default provider\n    return this.#getDefaultProvider().subscribeToOrderBook(params);\n  }\n\n  // ============================================================================\n  // Configuration\n  // ============================================================================\n\n  setLiveDataConfig(config: Partial<LiveDataConfig>): void {\n    // Apply config to all providers\n    this.#providers.forEach((provider) => {\n      provider.setLiveDataConfig(config);\n    });\n  }\n\n  setUserFeeDiscount(discountBips: number | undefined): void {\n    // Apply to all providers that support it\n    this.#providers.forEach((provider) => {\n      if (provider.setUserFeeDiscount) {\n        provider.setUserFeeDiscount(discountBips);\n      }\n    });\n  }\n\n  // ============================================================================\n  // Lifecycle (Delegate to default provider)\n  // ============================================================================\n\n  async toggleTestnet(): Promise<ToggleTestnetResult> {\n    return this.#getDefaultProvider().toggleTestnet();\n  }\n\n  async initialize(): Promise<InitializeResult> {\n    // Initialize default provider\n    const result = await this.#getDefaultProvider().initialize();\n\n    // Optionally initialize other providers in background\n    // For Phase 1, we only initialize default provider\n    return result;\n  }\n\n  async isReadyToTrade(): Promise<ReadyToTradeResult> {\n    return this.#getDefaultProvider().isReadyToTrade();\n  }\n\n  async disconnect(): Promise<DisconnectResult> {\n    // Disconnect all providers\n    const results = await Promise.allSettled(\n      this.#getActiveProviders().map(([, provider]) => provider.disconnect()),\n    );\n\n    // Clear subscription cache\n    this.#subscriptionMux.clearCache();\n\n    // Return success if at least one succeeded\n    const successCount = results.filter(\n      (res) => res.status === 'fulfilled' && res.value.success,\n    ).length;\n\n    return {\n      success: successCount > 0,\n    };\n  }\n\n  async ping(timeoutMs?: number): Promise<void> {\n    return this.#getDefaultProvider().ping(timeoutMs);\n  }\n\n  // ============================================================================\n  // Block Explorer\n  // ============================================================================\n\n  getBlockExplorerUrl(address?: string): string {\n    return this.#getDefaultProvider().getBlockExplorerUrl(address);\n  }\n\n  // ============================================================================\n  // HIP-3 (Optional)\n  // ============================================================================\n\n  async getAvailableDexs(params?: GetAvailableDexsParams): Promise<string[]> {\n    const provider = this.#getDefaultProvider();\n    if (!provider.getAvailableDexs) {\n      return [];\n    }\n    return provider.getAvailableDexs(params);\n  }\n\n  // ============================================================================\n  // Provider Management\n  // ============================================================================\n\n  /**\n   * Add a new provider to the aggregated provider.\n   *\n   * @param providerId - Unique identifier for the provider\n   * @param provider - Provider instance\n   */\n  addProvider(providerId: PerpsProviderType, provider: PerpsProvider): void {\n    this.#providers.set(providerId, provider);\n    this.#deps.debugLogger.log('[AggregatedPerpsProvider] Provider added', {\n      providerId,\n    });\n  }\n\n  /**\n   * Remove a provider from the aggregated provider.\n   *\n   * @param providerId - Provider to remove\n   * @returns true if removed, false if not found\n   */\n  removeProvider(providerId: PerpsProviderType): boolean {\n    const removed = this.#providers.delete(providerId);\n    if (removed) {\n      this.#deps.debugLogger.log('[AggregatedPerpsProvider] Provider removed', {\n        providerId,\n      });\n    }\n    return removed;\n  }\n\n  /**\n   * Get list of all registered provider IDs.\n   *\n   * @returns The result of the operation.\n   */\n  getProviderIds(): PerpsProviderType[] {\n    return Array.from(this.#providers.keys());\n  }\n\n  /**\n   * Check if a provider is registered.\n   *\n   * @param providerId - The provider id value.\n   * @returns True if the condition is met.\n   */\n  hasProvider(providerId: PerpsProviderType): boolean {\n    return this.#providers.has(providerId);\n  }\n\n  /**\n   * Get the router instance for external configuration.\n   *\n   * @returns The result of the operation.\n   */\n  getRouter(): ProviderRouter {\n    return this.#router;\n  }\n}\n"]}