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

package/dist/services/TradingService.d.mts

@@ -0,0 +1,195 @@
+import type { RewardsIntegrationService } from "./RewardsIntegrationService.mjs";
+import type { ServiceContext } from "./ServiceContext.mjs";
+import type { PerpsProvider, OrderParams, OrderResult, EditOrderParams, CancelOrderParams, CancelOrderResult, CancelOrdersParams, CancelOrdersResult, ClosePositionParams, ClosePositionsParams, ClosePositionsResult, Position, UpdatePositionTPSLParams, PerpsPlatformDependencies } from "../types/index.mjs";
+/**
+ * Controller-level dependencies for TradingService.
+ * These are singletons that don't change per-call, injected once via setControllerDependencies().
+ */
+export type TradingServiceControllerDeps = {
+    rewardsIntegrationService: RewardsIntegrationService;
+};
+/**
+ * TradingService
+ *
+ * Handles trading operations with fee discount management.
+ * Controller is responsible for analytics, state management, and tracing.
+ *
+ * Instance-based service with constructor injection of platform dependencies.
+ * Controller-level dependencies (RewardsController, NetworkController, etc.)
+ * are injected via setControllerDependencies() after construction.
+ */
+export declare class TradingService {
+    #private;
+    /**
+     * Create a new TradingService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     */
+    constructor(deps: PerpsPlatformDependencies);
+    /**
+     * Set controller-level dependencies for fee discount calculation.
+     * Called by PerpsController after construction to inject singleton dependencies.
+     *
+     * @param controllerDeps - Controller-level dependencies (RewardsController, etc.)
+     */
+    setControllerDependencies(controllerDeps: TradingServiceControllerDeps): void;
+    /**
+     * Place a new order with full orchestration
+     * Handles tracing, fee discounts, state management, analytics, and data lake reporting
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @param options.reportOrderToDataLake - The report order to data lake value.
+     * @returns The result of the operation.
+     */
+    placeOrder(options: {
+        provider: PerpsProvider;
+        params: OrderParams;
+        context: ServiceContext;
+        reportOrderToDataLake: (params: {
+            action: 'open' | 'close';
+            symbol: string;
+            slPrice?: number;
+            tpPrice?: number;
+        }) => Promise<{
+            success: boolean;
+            error?: string;
+        }>;
+    }): Promise<OrderResult>;
+    /**
+     * Edit an existing order with full orchestration
+     * Handles tracing, fee discounts, state management, and analytics
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    editOrder(options: {
+        provider: PerpsProvider;
+        params: EditOrderParams;
+        context: ServiceContext;
+    }): Promise<OrderResult>;
+    /**
+     * Cancel a single order with full orchestration
+     * Handles tracing, state management, and analytics
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    cancelOrder(options: {
+        provider: PerpsProvider;
+        params: CancelOrderParams;
+        context: ServiceContext;
+    }): Promise<CancelOrderResult>;
+    /**
+     * Cancel multiple orders with full orchestration
+     * Handles tracing, stream pausing, filtering, batch operations, and analytics
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @param options.withStreamPause - The with stream pause value.
+     * @returns The result of the operation.
+     */
+    cancelOrders(options: {
+        provider: PerpsProvider;
+        params: CancelOrdersParams;
+        context: ServiceContext;
+        withStreamPause: <TResult>(operation: () => Promise<TResult>, channels: string[]) => Promise<TResult>;
+    }): Promise<CancelOrdersResult>;
+    /**
+     * Close a single position with full orchestration
+     * Handles tracing, fee discounts, state management, analytics, and data lake reporting
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @param options.reportOrderToDataLake - The report order to data lake value.
+     * @returns The result of the operation.
+     */
+    closePosition(options: {
+        provider: PerpsProvider;
+        params: ClosePositionParams;
+        context: ServiceContext;
+        reportOrderToDataLake: (params: {
+            action: 'open' | 'close';
+            symbol: string;
+        }) => Promise<{
+            success: boolean;
+            error?: string;
+        }>;
+    }): Promise<OrderResult>;
+    /**
+     * Close multiple positions with full orchestration
+     * Handles tracing, fee discounts, batch operations, and analytics
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    closePositions(options: {
+        provider: PerpsProvider;
+        params: ClosePositionsParams;
+        context: ServiceContext;
+    }): Promise<ClosePositionsResult>;
+    /**
+     * Update TP/SL for an existing position with full orchestration
+     * Handles tracing, fee discounts, state management, and analytics
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.params - The operation parameters.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    updatePositionTPSL(options: {
+        provider: PerpsProvider;
+        params: UpdatePositionTPSLParams;
+        context: ServiceContext;
+    }): Promise<OrderResult>;
+    /**
+     * Update margin for an existing position (add or remove)
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.symbol - The trading pair symbol.
+     * @param options.amount - The amount value.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    updateMargin(options: {
+        provider: PerpsProvider;
+        symbol: string;
+        amount: string;
+        context: ServiceContext;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Flip position (reverse direction while keeping size and leverage)
+     *
+     * @param options - The configuration options.
+     * @param options.provider - The perps provider instance.
+     * @param options.position - The position data.
+     * @param options.context - The service context for dependencies.
+     * @returns The result of the operation.
+     */
+    flipPosition(options: {
+        provider: PerpsProvider;
+        position: Position;
+        context: ServiceContext;
+    }): Promise<OrderResult>;
+}
+//# sourceMappingURL=TradingService.d.mts.map

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

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