@deeeed/metamask-harness 0.45.1 → 0.46.0

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

@@ -3321,7 +3321,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.start_state": {
-      "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that first restores the fixture-backed unlocked wallet, then composes reusable domain operations before the proof window.",
+      "description": "Restores the fixture-backed wallet, then changes only the account, provider, network, market route, mode, and trading-state policy supplied directly or by a named profile. Omitted values keep the app's current selection.",
       "schema": {
         "type": "object",
         "properties": {
@@ -3340,18 +3340,21 @@
             "description": "Bound for the fixture-backed wallet unlock within Perps state setup."
           },
           "account": {
-            "type": "string"
+            "type": "string",
+            "description": "Optional exact account name. Omit it to keep the currently selected account."
           },
           "provider": {
             "type": "string",
-            "description": "Requested Perps provider, e.g. hyperliquid."
+            "description": "Requested Perps provider, e.g. hyperliquid. Omit it to keep the current provider unless a named profile supplies one."
           },
           "network": {
             "type": "string",
-            "enum": ["testnet", "mainnet"]
+            "enum": ["testnet", "mainnet"],
+            "description": "Requested Perps network. Omit it to keep the current network unless a named profile supplies one."
           },
           "market": {
-            "type": "string"
+            "type": "string",
+            "description": "Requested market symbol. Omit it to keep the current market route unless a named profile supplies one."
           },
           "symbol": {
             "type": "string"
@@ -3373,7 +3376,18 @@
             "type": ["string", "boolean"],
             "enum": [false, "home", "perps", "perps_home", "market", "market_details"]
           },
+          "market_mode": {
+            "type": "string",
+            "enum": ["lite", "pro"],
+            "description": "Optional market-detail mode to inspect and converge after navigation."
+          },
+          "trading_state": {
+            "type": "string",
+            "enum": ["preserve", "clean_selected_testnet_market"],
+            "description": "High-level state policy. The clean policy removes matching positions, ordinary orders, TWAPs, and Chase sessions only on testnet and preserves them on mainnet."
+          },
           "positions": {
+            "description": "Requested position state. Omit it or pass false to preserve current positions.",
             "type": ["object", "boolean"],
             "properties": {
               "mode": {
@@ -3461,6 +3475,7 @@
             "additionalProperties": false
           },
           "orders": {
+            "description": "Requested ordinary-order state. Omit it or pass false to preserve current orders.",
             "type": ["object", "boolean"],
             "properties": {
               "mode": {
@@ -3547,6 +3562,46 @@
             },
             "additionalProperties": false
           },
+          "strategies": {
+            "description": "Matching active TWAP and Chase strategies to remove. Omit it or pass false to preserve them.",
+            "type": ["object", "boolean"],
+            "properties": {
+              "mode": {
+                "type": "string",
+                "enum": ["matching", "all"]
+              },
+              "market": {
+                "type": "string"
+              },
+              "symbol": {
+                "type": "string"
+              },
+              "markets": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "symbols": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "side": {
+                "type": "string",
+                "enum": ["long", "short"]
+              },
+              "state": {
+                "type": "string",
+                "enum": ["none", "closed", "absent"]
+              },
+              "timeout_ms": {
+                "type": "number"
+              }
+            },
+            "additionalProperties": false
+          },
           "hud": {
             "type": "object",
             "properties": {},
@@ -3620,10 +3675,50 @@
       "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.teardown_state": {
-      "description": "mobile Recommended configurable Perps teardown state that restores the selected environment after proof.",
+      "description": "mobile Configurable Perps teardown that defaults to Hyperliquid testnet, verifies the environment before mutation, and permits explicit mainnet overrides.",
       "schema": {
         "type": "object",
         "properties": {
+          "strategies": {
+            "description": "Matching active TWAP and Chase strategies to remove; false preserves them.",
+            "type": ["object", "boolean"],
+            "properties": {
+              "mode": {
+                "type": "string",
+                "enum": ["matching", "all"]
+              },
+              "market": {
+                "type": "string"
+              },
+              "symbol": {
+                "type": "string"
+              },
+              "markets": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "symbols": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "side": {
+                "type": "string",
+                "enum": ["long", "short"]
+              },
+              "state": {
+                "type": "string",
+                "enum": ["none", "closed", "absent"]
+              },
+              "timeout_ms": {
+                "type": "number"
+              }
+            },
+            "additionalProperties": false
+          },
           "profile": {
             "type": "string",
             "description": "Optional profile such as clean_market_testnet, open_position_testnet, open_order_testnet, or provider_mainnet_readonly."

package/library/recipes/mobile/perps/chase-assert-running.recipe.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assert a foreground Mobile Pro Chase order",
+  "description": "Keeps MetaMask foregrounded during a dwell and fails if the selected market's running Chase row vanishes.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Optional exact fixture account name, such as Trading or dev1. Omit it to keep the currently selected account."
+      },
+      "provider": { "type": "string", "default": "hyperliquid" },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Assertions are read-only and may inspect either network."
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "dwell_ms": {
+        "type": "integer",
+        "minimum": 1000,
+        "default": 12000
+      }
+    }
+  },
+  "workflow": {
+    "entry": "prepare",
+    "nodes": {
+      "prepare": {
+        "action": "call",
+        "ref": "perps.pro-order-start-state",
+        "params": {
+          "account": "{{params.account}}",
+          "provider": "{{params.provider}}",
+          "network": "{{params.network}}",
+          "market": "{{params.market}}"
+        },
+        "intent": "Reach and prove the requested Pro market without changing Chase orders.",
+        "next": "position-tab"
+      },
+      "position-tab": {
+        "action": "ui.scroll",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "scroll_into_view": true,
+        "intent": "Expose the Chase tab for visible review.",
+        "next": "wait-tab"
+      },
+      "wait-tab": {
+        "action": "ui.wait_for",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "expected": "visible",
+        "timeout_ms": 15000,
+        "intent": "Require the Chase tab to be visible.",
+        "next": "open-tab"
+      },
+      "open-tab": {
+        "action": "ui.press",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "intent": "Open Chase monitoring.",
+        "next": "wait-running-before"
+      },
+      "wait-running-before": {
+        "action": "ui.wait_for",
+        "test_id": "perps-chase-status-active-{{params.market}}",
+        "expected": "visible",
+        "timeout_ms": 20000,
+        "intent": "Require the running Chase row before the foreground dwell.",
+        "next": "dwell"
+      },
+      "dwell": {
+        "action": "wait",
+        "duration_ms": "{{params.dwell_ms}}",
+        "intent": "Keep the app foregrounded while the Chase session reprices.",
+        "next": "position-running-after"
+      },
+      "position-running-after": {
+        "action": "ui.scroll",
+        "test_id": "perps-chase-status-active-{{params.market}}",
+        "offset": 600,
+        "intent": "Expose the surviving Chase row after the foreground dwell.",
+        "next": "wait-running-after"
+      },
+      "wait-running-after": {
+        "action": "ui.wait_for",
+        "test_id": "perps-chase-status-active-{{params.market}}",
+        "expected": "visible",
+        "timeout_ms": 5000,
+        "intent": "Fail if the Chase row vanished during the foreground dwell.",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/evidence-chase-running-{{params.market}}.png",
+        "label": "The Chase row is still Running after a foreground dwell.",
+        "intent": "Preserve the surviving running Chase row for review.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/chase-place.recipe.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Place a Mobile Pro Chase order",
+  "description": "Places one parameterized Chase order through visible Mobile Pro controls, cleaning only the testnet path.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Optional exact fixture account name, such as Trading or dev1. Omit it to keep the currently selected account."
+      },
+      "provider": { "type": "string", "default": "hyperliquid" },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Mainnet placement requires an explicit user request."
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "side": {
+        "type": "string",
+        "enum": [
+          "long",
+          "short"
+        ],
+        "default": "long"
+      },
+      "notional": {
+        "type": "string",
+        "default": "100"
+      },
+      "max_distance": {
+        "type": "string",
+        "default": "5000",
+        "description": "USD guard; keep this wider than expected movement during a persistence dwell."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "prepare",
+    "nodes": {
+      "prepare": {
+        "action": "call",
+        "ref": "perps.pro-order-setup",
+        "params": {
+          "account": "{{params.account}}",
+          "provider": "{{params.provider}}",
+          "network": "{{params.network}}",
+          "market": "{{params.market}}",
+          "side": "{{params.side}}"
+        },
+        "intent": "Prepare the requested Pro order form and Advanced picker.",
+        "next": "position-chase"
+      },
+      "position-chase": {
+        "action": "ui.scroll",
+        "test_id": "perps-order-type-chase",
+        "scroll_into_view": true,
+        "intent": "Expose the Chase option for visible selection.",
+        "next": "wait-chase"
+      },
+      "wait-chase": {
+        "action": "ui.wait_for",
+        "test_id": "perps-order-type-chase",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Fail closed unless Chase is visibly offered.",
+        "next": "select-chase"
+      },
+      "select-chase": {
+        "action": "ui.press",
+        "test_id": "perps-order-type-chase",
+        "intent": "Select Chase.",
+        "next": "position-size"
+      },
+      "position-size": {
+        "action": "ui.scroll",
+        "test_id": "perps-pro-order-form-size-card",
+        "scroll_into_view": true,
+        "intent": "Expose the Chase size input for visible entry.",
+        "next": "wait-size"
+      },
+      "wait-size": {
+        "action": "ui.wait_for",
+        "test_id": "perps-pro-order-form-size-card",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Confirm the Chase size card is visible.",
+        "next": "set-size"
+      },
+      "set-size": {
+        "action": "ui.set_input",
+        "test_id": "perps-pro-order-form-size-input",
+        "value": "{{params.notional}}",
+        "intent": "Enter the requested USD notional.",
+        "next": "set-distance"
+      },
+      "set-distance": {
+        "action": "ui.set_input",
+        "test_id": "perps-pro-chase-max-distance-field",
+        "value": "{{params.max_distance}}",
+        "intent": "Bound Chase repricing to the requested distance.",
+        "next": "position-submit"
+      },
+      "position-submit": {
+        "action": "ui.scroll",
+        "test_id": "perps-pro-order-form-summary-fees",
+        "scroll_into_view": true,
+        "intent": "Expose the final Chase fee row directly above submission.",
+        "next": "wait-submit"
+      },
+      "wait-submit": {
+        "action": "ui.wait_for",
+        "test_id": "perps-pro-order-form-place-order",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Confirm the Chase order can be submitted.",
+        "next": "submit"
+      },
+      "submit": {
+        "action": "ui.press",
+        "test_id": "perps-pro-order-form-place-order",
+        "intent": "Start the Chase session on the selected provider and network.",
+        "next": "wait-active-count"
+      },
+      "wait-active-count": {
+        "action": "ui.wait_for",
+        "test_id": "perps-pro-chase-active-count-1",
+        "expected": "present",
+        "timeout_ms": 20000,
+        "intent": "Require the form to report one live Chase session after submission.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/chase-terminate.recipe.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Terminate a Mobile Pro Chase order",
+  "description": "Terminates the selected market's primary active Chase session and proves it leaves the active list.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Optional exact fixture account name, such as Trading or dev1. Omit it to keep the currently selected account."
+      },
+      "provider": { "type": "string", "default": "hyperliquid" },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Mainnet termination requires an explicit user request."
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "prepare",
+    "nodes": {
+      "prepare": {
+        "action": "call",
+        "ref": "perps.pro-order-start-state",
+        "params": {
+          "account": "{{params.account}}",
+          "provider": "{{params.provider}}",
+          "network": "{{params.network}}",
+          "market": "{{params.market}}"
+        },
+        "intent": "Reach and prove the requested Pro market without changing Chase orders.",
+        "next": "position-tab"
+      },
+      "position-tab": {
+        "action": "ui.scroll",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "scroll_into_view": true,
+        "intent": "Expose the Chase tab for visible termination.",
+        "next": "wait-tab"
+      },
+      "wait-tab": {
+        "action": "ui.wait_for",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "expected": "visible",
+        "timeout_ms": 15000,
+        "intent": "Require the Chase tab to be visible before termination.",
+        "next": "open-tab"
+      },
+      "open-tab": {
+        "action": "ui.press",
+        "test_id": "perps-pro-market-positions-panel-tab-chase",
+        "intent": "Open Chase monitoring before termination.",
+        "next": "position-terminate"
+      },
+      "position-terminate": {
+        "action": "ui.scroll",
+        "test_id": "perps-chase-terminate-active-{{params.market}}",
+        "scroll_into_view": true,
+        "intent": "Expose the active Chase termination control.",
+        "next": "wait-terminate"
+      },
+      "wait-terminate": {
+        "action": "ui.wait_for",
+        "test_id": "perps-chase-terminate-active-{{params.market}}",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Require a visible active Chase session to terminate.",
+        "next": "terminate"
+      },
+      "terminate": {
+        "action": "ui.press",
+        "test_id": "perps-chase-terminate-active-{{params.market}}",
+        "intent": "Terminate the active Chase session.",
+        "next": "wait-removed"
+      },
+      "wait-removed": {
+        "action": "ui.wait_for",
+        "test_id": "perps-chase-status-active-{{params.market}}",
+        "expected": "absent",
+        "timeout_ms": 20000,
+        "intent": "Require the terminated Chase session to leave the active list.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/pro-order-setup.recipe.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Prepare a Mobile Pro advanced-order form",
+  "description": "Prepares the current or requested account, cleans only the selected testnet market, and opens the Advanced Pro order picker.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Optional exact fixture account name, such as Trading or dev1. Omit it to keep the currently selected account."
+      },
+      "provider": { "type": "string", "default": "hyperliquid" },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Mainnet requires an explicit user request and preserves existing trading state."
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "side": {
+        "type": "string",
+        "enum": ["long", "short"],
+        "default": "long"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "ensure-state",
+    "nodes": {
+      "ensure-state": {
+        "action": "call",
+        "ref": "perps.pro-order-start-state",
+        "params": {
+          "account": "{{params.account}}",
+          "provider": "{{params.provider}}",
+          "network": "{{params.network}}",
+          "market": "{{params.market}}",
+          "trading_state": "clean_selected_testnet_market"
+        },
+        "intent": "Reach and prove the requested Pro market before placement setup.",
+        "next": "position-side"
+      },
+      "position-side": {
+        "action": "ui.scroll",
+        "test_id": "perps-pro-order-form-direction-control",
+        "scroll_into_view": true,
+        "intent": "Expose the direction control without resetting an already-matching market route.",
+        "next": "choose-side"
+      },
+      "choose-side": {
+        "action": "switch",
+        "value": "{{params.side}}",
+        "equals": "short",
+        "cases": {
+          "match": "select-short"
+        },
+        "default": "select-long",
+        "intent": "Choose the declared order direction."
+      },
+      "select-long": {
+        "action": "ui.press",
+        "test_id": "perps-pro-order-form-direction-long",
+        "intent": "Select the long direction explicitly.",
+        "next": "open-types"
+      },
+      "select-short": {
+        "action": "ui.press",
+        "test_id": "perps-pro-order-form-direction-short",
+        "intent": "Select the short direction explicitly.",
+        "next": "open-types"
+      },
+      "open-types": {
+        "action": "ui.press",
+        "test_id": "perps-pro-order-form-order-type",
+        "intent": "Open the order-type picker.",
+        "next": "wait-advanced-tab"
+      },
+      "wait-advanced-tab": {
+        "action": "ui.wait_for",
+        "test_id": "perps-order-type-tab-advanced",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Require the Advanced tab before selecting it.",
+        "next": "open-advanced"
+      },
+      "open-advanced": {
+        "action": "ui.press",
+        "test_id": "perps-order-type-tab-advanced",
+        "intent": "Open the Advanced order section.",
+        "next": "wait-advanced-content"
+      },
+      "wait-advanced-content": {
+        "action": "ui.wait_for",
+        "test_id": "perps-order-type-twap",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Prove the Advanced order section is open.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/pro-order-start-state.recipe.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Converge Mobile Pro order start state",
+  "description": "Idempotently reaches Mobile Pro. An omitted account keeps the current selection; provider, network, and market use the declared smart defaults.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Optional exact fixture account name, such as Trading or dev1. Omit it to keep the currently selected account."
+      },
+      "provider": { "type": "string", "default": "hyperliquid" },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet"
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "trading_state": {
+        "type": "string",
+        "enum": ["preserve", "clean_selected_testnet_market"],
+        "default": "preserve"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "ensure-state",
+    "nodes": {
+      "ensure-state": {
+        "action": "metamask.perps.start_state",
+        "account": "{{params.account}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.network}}",
+        "market": "{{params.market}}",
+        "page": "market",
+        "market_mode": "pro",
+        "trading_state": "{{params.trading_state}}",
+        "timeout_ms": 120000,
+        "intent": "Reach and prove the requested account, provider, network, market, Pro mode, and trading-state policy.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}