feat(perps): PerpsController advanced order types, proven e2e (stop market/limit, take-profit market/limit, reduce-only, partial TP/SL)

knip.config.mts

@@ -22,10 +22,11 @@ const config: KnipConfig = {
       ignoreDependencies: ['bats'],
     },
     'packages/perps-controller': {
+      // Run directly (`npx tsx tests/e2e/...`) rather than imported, so knip
+      // needs telling it is an entry point — otherwise the dependencies only
+      // it uses look unused.
+      entry: ['tests/e2e/*.ts'],
       ignoreDependencies: ['@metamask/accounts-controller'],
-      // The mobile client provides `core/Engine`; tests mock it via a
-      // relative path that doesn't resolve inside this monorepo.
-      ignoreUnresolved: [/^\.\.\/\.\.\/\.\.\/core\/Engine$/u],
     },
 
     // -- Per-workspace `ignoreDependencies` snapshots --

packages/perps-controller/package.json

@@ -129,7 +129,8 @@
     "tsx": "^4.20.5",
     "typedoc": "^0.25.13",
     "typedoc-plugin-missing-exports": "^2.0.0",
-    "typescript": "~5.3.3"
+    "typescript": "~5.3.3",
+    "viem": "^2.55.8"
   },
   "optionalDependencies": {
     "@myx-trade/sdk": "^0.1.265"

packages/perps-controller/src/constants/eventNames.ts

@@ -254,6 +254,12 @@ export const PERPS_EVENT_VALUE = {
   ORDER_TYPE: {
     MARKET: 'market',
     LIMIT: 'limit',
+    // Trigger placements are emitted verbatim by TradingService, so the enum has
+    // to list them for dashboards keyed on `order_type`.
+    STOP_MARKET: 'stop_market',
+    STOP_LIMIT: 'stop_limit',
+    TAKE_PROFIT_MARKET: 'take_profit_market',
+    TAKE_PROFIT_LIMIT: 'take_profit_limit',
   },
   ORDER_TYPE_CAPITALIZED: {
     MARKET: 'market',

packages/perps-controller/src/index.ts

@@ -157,6 +157,11 @@ export type {
   GetUserHistoryParams,
   TradeConfiguration,
   OrderType,
+  TriggerOrderType,
+  OrderExecution,
+  TriggerDirection,
+  TpslLinkage,
+  PositionTriggerOrder,
   MarketType,
   MarketTypeFilter,
   InputMethod,
@@ -475,6 +480,20 @@ export {
   validateOrderParams,
   validateCoinExists,
 } from './utils/index.js';
+export {
+  TRIGGER_ORDER_TYPES,
+  isTriggerOrderType,
+  isLimitExecutionOrderType,
+  getTriggerExecution,
+  getTriggerDirection,
+  buildTriggerOrderType,
+  buildPositionTriggerOrderFromOrder,
+} from './utils/index.js';
+export {
+  adaptTriggerOrderTypeFromSDK,
+  adaptPositionTriggerOrderFromSDK,
+  adaptTpslLinkageToGrouping,
+} from './utils/index.js';
 export {
   generatePerpsId,
   generateDepositId,

packages/perps-controller/src/perpsErrorCodes.ts

@@ -43,6 +43,19 @@ export const PERPS_ERROR_CODES = {
   ORDER_LEVERAGE_INVALID: 'ORDER_LEVERAGE_INVALID',
   ORDER_LEVERAGE_BELOW_POSITION: 'ORDER_LEVERAGE_BELOW_POSITION',
   ORDER_MAX_VALUE_EXCEEDED: 'ORDER_MAX_VALUE_EXCEEDED',
+  // Validation errors - trigger placement (stop / take profit) and partial TP/SL
+  ORDER_TRIGGER_PRICE_REQUIRED: 'ORDER_TRIGGER_PRICE_REQUIRED', // stop_*/take_profit_* placed without a trigger price
+  ORDER_TRIGGER_PRICE_POSITIVE: 'ORDER_TRIGGER_PRICE_POSITIVE',
+  ORDER_TRIGGER_PRICE_NOT_SUPPORTED: 'ORDER_TRIGGER_PRICE_NOT_SUPPORTED', // Trigger price supplied for a market/limit order
+  ORDER_TRIGGER_TPSL_UNSUPPORTED: 'ORDER_TRIGGER_TPSL_UNSUPPORTED', // Attached TP/SL on a trigger placement
+  ORDER_TPSL_SIZE_INVALID: 'ORDER_TPSL_SIZE_INVALID', // Partial TP/SL size non-positive, larger than the order, or missing its price
+  ORDER_EDIT_TRIGGER_UNSUPPORTED: 'ORDER_EDIT_TRIGGER_UNSUPPORTED', // editOrder cannot turn a resting order into a trigger placement
+  ORDER_TPSL_LINKAGE_CONFLICT: 'ORDER_TPSL_LINKAGE_CONFLICT', // tpslLinkage and the deprecated grouping disagree
+  ORDER_TPSL_POSITION_LINKAGE_UNSUPPORTED:
+    'ORDER_TPSL_POSITION_LINKAGE_UNSUPPORTED', // Position-linked TP/SL requested on an order placement; use updatePositionTPSL
+  ORDER_TPSL_LINKAGE_REQUIRED: 'ORDER_TPSL_LINKAGE_REQUIRED', // Attached TP/SL requested with no linkage to parent or position
+  ORDER_EDIT_ORDER_UNVERIFIABLE: 'ORDER_EDIT_ORDER_UNVERIFIABLE', // editOrder cannot confirm the resting order's placement type
+  ORDER_TIME_IN_FORCE_NOT_SUPPORTED: 'ORDER_TIME_IN_FORCE_NOT_SUPPORTED', // Time in force supplied for an order shape that cannot carry one
   // HyperLiquid client/service errors
   EXCHANGE_CLIENT_NOT_AVAILABLE: 'EXCHANGE_CLIENT_NOT_AVAILABLE',
   INFO_CLIENT_NOT_AVAILABLE: 'INFO_CLIENT_NOT_AVAILABLE',