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

package/dist/providers/AggregatedPerpsProvider.d.cts

@@ -0,0 +1,171 @@
+/**
+ * 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.
+ */
+import type { CaipAccountId } from "@metamask/utils";
+import { ProviderRouter } from "../routing/ProviderRouter.cjs";
+import type { AccountState, AggregatedProviderConfig, AssetRoute, BatchCancelOrdersParams, CancelOrderParams, CancelOrderResult, CancelOrdersResult, ClosePositionParams, ClosePositionsParams, ClosePositionsResult, DepositParams, DisconnectResult, EditOrderParams, FeeCalculationParams, FeeCalculationResult, Funding, GetAccountStateParams, GetAvailableDexsParams, GetFundingParams, GetHistoricalPortfolioParams, GetMarketsParams, GetOrderFillsParams, GetOrdersParams, GetOrFetchFillsParams, GetPositionsParams, GetSupportedPathsParams, HistoricalPortfolioResult, InitializeResult, PerpsProvider, LiquidationPriceParams, LiveDataConfig, MaintenanceMarginParams, MarginResult, MarketInfo, Order, OrderFill, OrderParams, OrderResult, PerpsMarketData, PerpsProviderType, Position, ReadyToTradeResult, SubscribeAccountParams, SubscribeCandlesParams, SubscribeOICapsParams, SubscribeOrderBookParams, SubscribeOrderFillsParams, SubscribeOrdersParams, SubscribePositionsParams, SubscribePricesParams, ToggleTestnetResult, UpdateMarginParams, UpdatePositionTPSLParams, UserHistoryItem, WithdrawParams, WithdrawResult, RawLedgerUpdate } from "../types/index.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', ... });
+ * ```
+ */
+export declare class AggregatedPerpsProvider implements PerpsProvider {
+    #private;
+    readonly protocolId = "aggregated";
+    constructor(config: AggregatedProviderConfig);
+    getDepositRoutes(params?: GetSupportedPathsParams): AssetRoute[];
+    getWithdrawalRoutes(params?: GetSupportedPathsParams): AssetRoute[];
+    getPositions(params?: GetPositionsParams): Promise<Position[]>;
+    getAccountState(params?: GetAccountStateParams): Promise<AccountState>;
+    getMarkets(params?: GetMarketsParams): Promise<MarketInfo[]>;
+    getMarketDataWithPrices(): Promise<PerpsMarketData[]>;
+    getOrderFills(params?: GetOrderFillsParams): Promise<OrderFill[]>;
+    getOrFetchFills(params?: GetOrFetchFillsParams): Promise<OrderFill[]>;
+    getOrders(params?: GetOrdersParams): Promise<Order[]>;
+    getOpenOrders(params?: GetOrdersParams): Promise<Order[]>;
+    getFunding(params?: GetFundingParams): Promise<Funding[]>;
+    getHistoricalPortfolio(params?: GetHistoricalPortfolioParams): Promise<HistoricalPortfolioResult>;
+    /**
+     * 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
+     */
+    getUserNonFundingLedgerUpdates(params?: {
+        accountId?: string;
+        startTime?: number;
+        endTime?: number;
+    }): Promise<RawLedgerUpdate[]>;
+    /**
+     * 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
+     */
+    getUserHistory(params?: {
+        accountId?: CaipAccountId;
+        startTime?: number;
+        endTime?: number;
+    }): Promise<UserHistoryItem[]>;
+    placeOrder(params: OrderParams): Promise<OrderResult>;
+    editOrder(params: EditOrderParams): Promise<OrderResult>;
+    cancelOrder(params: CancelOrderParams): Promise<CancelOrderResult>;
+    cancelOrders(params: BatchCancelOrdersParams): Promise<CancelOrdersResult>;
+    closePosition(params: ClosePositionParams): Promise<OrderResult>;
+    closePositions(params: ClosePositionsParams): Promise<ClosePositionsResult>;
+    updatePositionTPSL(params: UpdatePositionTPSLParams): Promise<OrderResult>;
+    updateMargin(params: UpdateMarginParams): Promise<MarginResult>;
+    withdraw(params: WithdrawParams): Promise<WithdrawResult>;
+    validateDeposit(params: DepositParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateOrder(params: OrderParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateClosePosition(params: ClosePositionParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateWithdrawal(params: WithdrawParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    calculateLiquidationPrice(params: LiquidationPriceParams): Promise<string>;
+    calculateMaintenanceMargin(params: MaintenanceMarginParams): Promise<number>;
+    getMaxLeverage(asset: string): Promise<number>;
+    calculateFees(params: FeeCalculationParams): Promise<FeeCalculationResult>;
+    subscribeToPrices(params: SubscribePricesParams): () => void;
+    subscribeToPositions(params: SubscribePositionsParams): () => void;
+    subscribeToOrderFills(params: SubscribeOrderFillsParams): () => void;
+    subscribeToOrders(params: SubscribeOrdersParams): () => void;
+    subscribeToAccount(params: SubscribeAccountParams): () => void;
+    subscribeToOICaps(params: SubscribeOICapsParams): () => void;
+    subscribeToCandles(params: SubscribeCandlesParams): () => void;
+    subscribeToOrderBook(params: SubscribeOrderBookParams): () => void;
+    setLiveDataConfig(config: Partial<LiveDataConfig>): void;
+    setUserFeeDiscount(discountBips: number | undefined): void;
+    toggleTestnet(): Promise<ToggleTestnetResult>;
+    initialize(): Promise<InitializeResult>;
+    isReadyToTrade(): Promise<ReadyToTradeResult>;
+    disconnect(): Promise<DisconnectResult>;
+    ping(timeoutMs?: number): Promise<void>;
+    getBlockExplorerUrl(address?: string): string;
+    getAvailableDexs(params?: GetAvailableDexsParams): Promise<string[]>;
+    /**
+     * Add a new provider to the aggregated provider.
+     *
+     * @param providerId - Unique identifier for the provider
+     * @param provider - Provider instance
+     */
+    addProvider(providerId: PerpsProviderType, provider: PerpsProvider): void;
+    /**
+     * Remove a provider from the aggregated provider.
+     *
+     * @param providerId - Provider to remove
+     * @returns true if removed, false if not found
+     */
+    removeProvider(providerId: PerpsProviderType): boolean;
+    /**
+     * Get list of all registered provider IDs.
+     *
+     * @returns The result of the operation.
+     */
+    getProviderIds(): PerpsProviderType[];
+    /**
+     * Check if a provider is registered.
+     *
+     * @param providerId - The provider id value.
+     * @returns True if the condition is met.
+     */
+    hasProvider(providerId: PerpsProviderType): boolean;
+    /**
+     * Get the router instance for external configuration.
+     *
+     * @returns The result of the operation.
+     */
+    getRouter(): ProviderRouter;
+}
+//# sourceMappingURL=AggregatedPerpsProvider.d.cts.map

package/dist/providers/AggregatedPerpsProvider.d.cts.map

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

package/dist/providers/AggregatedPerpsProvider.d.mts

@@ -0,0 +1,171 @@
+/**
+ * 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.
+ */
+import type { CaipAccountId } from "@metamask/utils";
+import { ProviderRouter } from "../routing/ProviderRouter.mjs";
+import type { AccountState, AggregatedProviderConfig, AssetRoute, BatchCancelOrdersParams, CancelOrderParams, CancelOrderResult, CancelOrdersResult, ClosePositionParams, ClosePositionsParams, ClosePositionsResult, DepositParams, DisconnectResult, EditOrderParams, FeeCalculationParams, FeeCalculationResult, Funding, GetAccountStateParams, GetAvailableDexsParams, GetFundingParams, GetHistoricalPortfolioParams, GetMarketsParams, GetOrderFillsParams, GetOrdersParams, GetOrFetchFillsParams, GetPositionsParams, GetSupportedPathsParams, HistoricalPortfolioResult, InitializeResult, PerpsProvider, LiquidationPriceParams, LiveDataConfig, MaintenanceMarginParams, MarginResult, MarketInfo, Order, OrderFill, OrderParams, OrderResult, PerpsMarketData, PerpsProviderType, Position, ReadyToTradeResult, SubscribeAccountParams, SubscribeCandlesParams, SubscribeOICapsParams, SubscribeOrderBookParams, SubscribeOrderFillsParams, SubscribeOrdersParams, SubscribePositionsParams, SubscribePricesParams, ToggleTestnetResult, UpdateMarginParams, UpdatePositionTPSLParams, UserHistoryItem, WithdrawParams, WithdrawResult, RawLedgerUpdate } from "../types/index.mjs";
+/**
+ * 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', ... });
+ * ```
+ */
+export declare class AggregatedPerpsProvider implements PerpsProvider {
+    #private;
+    readonly protocolId = "aggregated";
+    constructor(config: AggregatedProviderConfig);
+    getDepositRoutes(params?: GetSupportedPathsParams): AssetRoute[];
+    getWithdrawalRoutes(params?: GetSupportedPathsParams): AssetRoute[];
+    getPositions(params?: GetPositionsParams): Promise<Position[]>;
+    getAccountState(params?: GetAccountStateParams): Promise<AccountState>;
+    getMarkets(params?: GetMarketsParams): Promise<MarketInfo[]>;
+    getMarketDataWithPrices(): Promise<PerpsMarketData[]>;
+    getOrderFills(params?: GetOrderFillsParams): Promise<OrderFill[]>;
+    getOrFetchFills(params?: GetOrFetchFillsParams): Promise<OrderFill[]>;
+    getOrders(params?: GetOrdersParams): Promise<Order[]>;
+    getOpenOrders(params?: GetOrdersParams): Promise<Order[]>;
+    getFunding(params?: GetFundingParams): Promise<Funding[]>;
+    getHistoricalPortfolio(params?: GetHistoricalPortfolioParams): Promise<HistoricalPortfolioResult>;
+    /**
+     * 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
+     */
+    getUserNonFundingLedgerUpdates(params?: {
+        accountId?: string;
+        startTime?: number;
+        endTime?: number;
+    }): Promise<RawLedgerUpdate[]>;
+    /**
+     * 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
+     */
+    getUserHistory(params?: {
+        accountId?: CaipAccountId;
+        startTime?: number;
+        endTime?: number;
+    }): Promise<UserHistoryItem[]>;
+    placeOrder(params: OrderParams): Promise<OrderResult>;
+    editOrder(params: EditOrderParams): Promise<OrderResult>;
+    cancelOrder(params: CancelOrderParams): Promise<CancelOrderResult>;
+    cancelOrders(params: BatchCancelOrdersParams): Promise<CancelOrdersResult>;
+    closePosition(params: ClosePositionParams): Promise<OrderResult>;
+    closePositions(params: ClosePositionsParams): Promise<ClosePositionsResult>;
+    updatePositionTPSL(params: UpdatePositionTPSLParams): Promise<OrderResult>;
+    updateMargin(params: UpdateMarginParams): Promise<MarginResult>;
+    withdraw(params: WithdrawParams): Promise<WithdrawResult>;
+    validateDeposit(params: DepositParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateOrder(params: OrderParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateClosePosition(params: ClosePositionParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    validateWithdrawal(params: WithdrawParams): Promise<{
+        isValid: boolean;
+        error?: string;
+    }>;
+    calculateLiquidationPrice(params: LiquidationPriceParams): Promise<string>;
+    calculateMaintenanceMargin(params: MaintenanceMarginParams): Promise<number>;
+    getMaxLeverage(asset: string): Promise<number>;
+    calculateFees(params: FeeCalculationParams): Promise<FeeCalculationResult>;
+    subscribeToPrices(params: SubscribePricesParams): () => void;
+    subscribeToPositions(params: SubscribePositionsParams): () => void;
+    subscribeToOrderFills(params: SubscribeOrderFillsParams): () => void;
+    subscribeToOrders(params: SubscribeOrdersParams): () => void;
+    subscribeToAccount(params: SubscribeAccountParams): () => void;
+    subscribeToOICaps(params: SubscribeOICapsParams): () => void;
+    subscribeToCandles(params: SubscribeCandlesParams): () => void;
+    subscribeToOrderBook(params: SubscribeOrderBookParams): () => void;
+    setLiveDataConfig(config: Partial<LiveDataConfig>): void;
+    setUserFeeDiscount(discountBips: number | undefined): void;
+    toggleTestnet(): Promise<ToggleTestnetResult>;
+    initialize(): Promise<InitializeResult>;
+    isReadyToTrade(): Promise<ReadyToTradeResult>;
+    disconnect(): Promise<DisconnectResult>;
+    ping(timeoutMs?: number): Promise<void>;
+    getBlockExplorerUrl(address?: string): string;
+    getAvailableDexs(params?: GetAvailableDexsParams): Promise<string[]>;
+    /**
+     * Add a new provider to the aggregated provider.
+     *
+     * @param providerId - Unique identifier for the provider
+     * @param provider - Provider instance
+     */
+    addProvider(providerId: PerpsProviderType, provider: PerpsProvider): void;
+    /**
+     * Remove a provider from the aggregated provider.
+     *
+     * @param providerId - Provider to remove
+     * @returns true if removed, false if not found
+     */
+    removeProvider(providerId: PerpsProviderType): boolean;
+    /**
+     * Get list of all registered provider IDs.
+     *
+     * @returns The result of the operation.
+     */
+    getProviderIds(): PerpsProviderType[];
+    /**
+     * Check if a provider is registered.
+     *
+     * @param providerId - The provider id value.
+     * @returns True if the condition is met.
+     */
+    hasProvider(providerId: PerpsProviderType): boolean;
+    /**
+     * Get the router instance for external configuration.
+     *
+     * @returns The result of the operation.
+     */
+    getRouter(): ProviderRouter;
+}
+//# sourceMappingURL=AggregatedPerpsProvider.d.mts.map

package/dist/providers/AggregatedPerpsProvider.d.mts.map

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