@deeeed/metamask-harness 0.22.0 → 0.23.1

package/library/manifests/core.action-manifest.json

@@ -707,6 +707,14 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
           }
         },
         "additionalProperties": false
@@ -721,7 +729,7 @@
       "execution_capabilities": []
     },
     "metamask.perps.place_order": {
-      "description": "core Place a real Perps order on HyperLiquid testnet by driving the headless perps controller placeOrder() through the full signing/provider path. Testnet only Supports market (default) and resting limit orders (order_type=limit with price/offset_pct).",
+      "description": "core Place a real Perps order on HyperLiquid testnet by driving the headless perps controller placeOrder() through the full signing/provider path. Supports market (default), resting limit orders (order_type=limit with price/offset_pct), and resting trigger placements (stop_market | stop_limit | take_profit_market | take_profit_limit with trigger_price/trigger_offset_pct), plus reduce_only and attached/partial TP/SL (take_profit_price/take_profit_size, stop_loss_price/stop_loss_size, tpsl_linkage). Venue is selected with network (testnet default; mainnet signs with REAL funds and also requires CORE_PERPS_ALLOW_MAINNET_WRITES=1). Plain limit orders accept time_in_force GTC | ALO (post-only).",
       "schema": {
         "type": "object",
         "properties": {
@@ -797,17 +805,45 @@
             "type": "string",
             "enum": [
               "market",
-              "limit"
+              "limit",
+              "stop_market",
+              "stop_limit",
+              "take_profit_market",
+              "take_profit_limit"
+            ],
+            "description": "market (default) fills immediately; limit places a RESTING order at price/offset_pct that does not fill; stop_market | stop_limit | take_profit_market | take_profit_limit place a RESTING TRIGGER order that activates at trigger_price and then executes as a market or limit order per the suffix. Alias: orderType."
+          },
+          "orderType": {
+            "type": "string",
+            "enum": [
+              "market",
+              "limit",
+              "stop_market",
+              "stop_limit",
+              "take_profit_market",
+              "take_profit_limit"
             ],
-            "description": "market (default) fills immediately; limit places a RESTING order at price/offset_pct that does not fill. Alias: orderType."
+            "description": "Alias for order_type."
           },
           "limit_price": {
             "type": "string",
             "description": "Absolute resting limit price (limit orders). Takes precedence over offset_pct. Alias: price/limitPrice."
           },
+          "limitPrice": {
+            "type": "string",
+            "description": "Alias for limit_price."
+          },
+          "price": {
+            "type": "string",
+            "description": "Alias for limit_price."
+          },
           "offset_pct": {
             "type": "number",
-            "description": "Resting limit price as a percent offset from live mid for limit orders (e.g. -30 = 30%% below mid for a non-filling BUY; default -30 buy / +30 sell). Alias: offsetPct."
+            "description": "Limit price as a percent offset from live mid for plain limits, or from the trigger for *_limit orders. Plain limits default to -30 buy / +30 sell; trigger limits default to +1 buy / -1 sell so they are executable after activation. Alias: offsetPct."
+          },
+          "offsetPct": {
+            "type": "number",
+            "description": "Alias for offset_pct."
           },
           "amount": {
             "type": [
@@ -833,6 +869,120 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+          "trigger_price": {
+            "type": "string",
+            "description": "Absolute trigger price for stop_*/take_profit_* placements. Takes precedence over trigger_offset_pct. Alias: triggerPrice."
+          },
+          "triggerPrice": {
+            "type": "string",
+            "description": "Alias for trigger_price."
+          },
+          "trigger_offset_pct": {
+            "type": "number",
+            "description": "Trigger price as a percent offset from live mid (default keeps the trigger ~30% away so it does not fire during a proof). Alias: triggerOffsetPct."
+          },
+          "triggerOffsetPct": {
+            "type": "number",
+            "description": "Alias for trigger_offset_pct."
+          },
+          "reduce_only": {
+            "type": "boolean",
+            "description": "Place as reduce-only, so the order can only close an existing position. Alias: reduceOnly."
+          },
+          "reduceOnly": {
+            "type": "boolean",
+            "description": "Alias for reduce_only."
+          },
+          "take_profit_price": {
+            "type": "string",
+            "description": "Attached take profit price. Alias: takeProfitPrice."
+          },
+          "takeProfitPrice": {
+            "type": "string",
+            "description": "Alias for take_profit_price."
+          },
+          "take_profit_size": {
+            "type": "string",
+            "description": "Quantity covered by the attached take profit (partial TP). Omit to cover the whole order. Alias: takeProfitSize."
+          },
+          "takeProfitSize": {
+            "type": "string",
+            "description": "Alias for take_profit_size."
+          },
+          "stop_loss_price": {
+            "type": "string",
+            "description": "Attached stop loss price. Alias: stopLossPrice."
+          },
+          "stopLossPrice": {
+            "type": "string",
+            "description": "Alias for stop_loss_price."
+          },
+          "stop_loss_size": {
+            "type": "string",
+            "description": "Quantity covered by the attached stop loss (partial SL). Omit to cover the whole order. Alias: stopLossSize."
+          },
+          "stopLossSize": {
+            "type": "string",
+            "description": "Alias for stop_loss_size."
+          },
+          "tpsl_linkage": {
+            "type": "string",
+            "enum": [
+              "none",
+              "order",
+              "position"
+            ],
+            "description": "How an attached TP/SL is linked: to this order ('order'), to the resulting position ('position'), or absent ('none'). Provider-agnostic replacement for HyperLiquid grouping. Alias: tpslLinkage."
+          },
+          "tpslLinkage": {
+            "type": "string",
+            "enum": [
+              "none",
+              "order",
+              "position"
+            ],
+            "description": "Alias for tpsl_linkage."
+          },
+          "max_slippage_bps": {
+            "type": "number",
+            "description": "Slippage tolerance in basis points; also caps the limit price derived from the trigger for *_market trigger placements. Alias: maxSlippageBps."
+          },
+          "maxSlippageBps": {
+            "type": "number",
+            "description": "Alias for max_slippage_bps."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
+          },
+          "time_in_force": {
+            "type": "string",
+            "enum": [
+              "GTC",
+              "ALO"
+            ],
+            "description": "Time in force for plain limit orders: GTC (default) or ALO (post-only). Alias: timeInForce."
+          },
+          "timeInForce": {
+            "type": "string",
+            "enum": [
+              "GTC",
+              "ALO"
+            ],
+            "description": "Alias for time_in_force."
+          },
+          "post_only": {
+            "type": "boolean",
+            "description": "Protocol-agnostic post-only flag; maps to the controller time-in-force ALO. Alias: postOnly."
+          },
+          "postOnly": {
+            "type": "boolean",
+            "description": "Alias for post_only."
           }
         },
         "additionalProperties": false
@@ -951,6 +1101,14 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
           }
         },
         "additionalProperties": false
@@ -1208,6 +1366,14 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
           }
         },
         "required": [
@@ -1321,6 +1487,14 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
           }
         },
         "additionalProperties": false
@@ -1345,7 +1519,7 @@
       ]
     },
     "metamask.perps.assert_orders": {
-      "description": "core Assert live Perps open orders are present or absent for an explicit market selection or mode=all.",
+      "description": "core Assert live Perps open orders are present or absent for an explicit market selection or mode=all. Optional expect_* fields assert the trigger data of the matching orders (placement type, trigger price, execution mode, reduce-only flag, size).",
       "schema": {
         "type": "object",
         "properties": {
@@ -1447,6 +1621,40 @@
               "present"
             ],
             "description": "Desired/expected selected collection state."
+          },
+          "expect_trigger_order_type": {
+            "type": "string",
+            "enum": [
+              "stop_market",
+              "stop_limit",
+              "take_profit_market",
+              "take_profit_limit"
+            ],
+            "description": "Require every matching order to be this trigger placement type (read back from the exchange)."
+          },
+          "expect_trigger_price": {
+            "type": "string",
+            "description": "Require every matching order to carry this trigger price."
+          },
+          "expect_execution": {
+            "type": "string",
+            "enum": [
+              "market",
+              "limit"
+            ],
+            "description": "Require the execution mode a matching trigger order runs as once it fires."
+          },
+          "expect_reduce_only": {
+            "type": "boolean",
+            "description": "Require the reduce-only flag on every matching order."
+          },
+          "expect_size": {
+            "type": "string",
+            "description": "Require this size on every matching order (proves a partial TP/SL quantity)."
+          },
+          "only_trigger_orders": {
+            "type": "boolean",
+            "description": "Consider only trigger orders (stop / take profit) on the selected market, so expectations are not applied to a plain parent order resting alongside them. Alias: onlyTriggerOrders."
           }
         },
         "required": [
@@ -1577,6 +1785,14 @@
               "present"
             ],
             "description": "Desired/expected selected collection state."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds: reads work with network=mainnet alone, while signing additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1 in the environment."
           }
         },
         "required": [
@@ -2239,6 +2455,109 @@
         "app-mutation",
         "external-mutation"
       ]
+    },
+    "metamask.perps.update_position_tpsl": {
+      "description": "core Set or replace the TP/SL attached to an existing Perps POSITION by driving the headless perps controller updatePositionTPSL() through the full signing/provider path. Covers whole-position TP/SL and PARTIAL (quantity-scoped) TP/SL via take_profit_size / stop_loss_size, which the provider expresses as standalone reduce-only trigger orders because a position-bound TP/SL always closes the whole position. Venue is selected with network (testnet default; mainnet signs with REAL funds and also requires CORE_PERPS_ALLOW_MAINNET_WRITES=1).",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol whose position the TP/SL attaches to. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Explicit market list (requires exactly one)."
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Alias for markets."
+          },
+          "selector": {
+            "type": "object",
+            "description": "Optional structured selector with mode and symbols/markets."
+          },
+          "take_profit_price": {
+            "type": "string",
+            "description": "Take profit trigger price. Omit to leave the take profit unset. Alias: takeProfitPrice."
+          },
+          "takeProfitPrice": {
+            "type": "string",
+            "description": "Alias for take_profit_price."
+          },
+          "take_profit_size": {
+            "type": "string",
+            "description": "Quantity the take profit covers (partial TP). Omit to cover the whole position. Alias: takeProfitSize."
+          },
+          "takeProfitSize": {
+            "type": "string",
+            "description": "Alias for take_profit_size."
+          },
+          "stop_loss_price": {
+            "type": "string",
+            "description": "Stop loss trigger price. Omit to leave the stop loss unset. Alias: stopLossPrice."
+          },
+          "stopLossPrice": {
+            "type": "string",
+            "description": "Alias for stop_loss_price."
+          },
+          "stop_loss_size": {
+            "type": "string",
+            "description": "Quantity the stop loss covers (partial SL). Omit to cover the whole position. Alias: stopLossSize."
+          },
+          "stopLossSize": {
+            "type": "string",
+            "description": "Alias for stop_loss_size."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to act on. Defaults to testnet. Mainnet uses REAL funds and additionally requires CORE_PERPS_ALLOW_MAINNET_WRITES=1."
+          },
+          "account": {
+            "type": "string",
+            "description": "EVM address to act for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.update_position_tpsl",
+          "market": "BTC",
+          "take_profit_price": "120000",
+          "intent": "Attach a whole-position take profit to the open BTC position",
+          "next": "done"
+        },
+        {
+          "action": "metamask.perps.update_position_tpsl",
+          "market": "BTC",
+          "take_profit_price": "120000",
+          "take_profit_size": "0.0002",
+          "intent": "Attach a partial (quantity-scoped) take profit to the open BTC position",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ]
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"