@deeeed/metamask-harness 0.36.0 → 0.38.0

package/library/recipes/extension/perps/release-order-entry.recipe.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release order entry",
+  "description": "Exercises the live Perps order form through semantic visible controls without submitting an order.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "amount": {
+        "type": "string",
+        "default": "10"
+      },
+      "leverage": {
+        "type": "string",
+        "default": "5"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Reset transient Perps navigation state",
+        "next": "open-market-list"
+      },
+      "open-market-list": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Show the live Perps market list",
+        "next": "open-market"
+      },
+      "open-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Open the requested Perps market",
+        "next": "open-long"
+      },
+      "open-long": {
+        "action": "ui.press",
+        "test_id": "perps-long-cta-button",
+        "intent": "Open a new long market order",
+        "next": "wait-order-entry"
+      },
+      "wait-order-entry": {
+        "action": "ui.wait_for",
+        "test_id": "perps-order-entry-page",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Confirm the order form finished opening",
+        "next": "assert-long"
+      },
+      "assert-long": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "long",
+        "order_type": "market",
+        "require_test_ids": [
+          "direction-tab-long",
+          "direction-tab-short",
+          "order-type-market",
+          "order-type-limit",
+          "amount-input-field",
+          "leverage-input",
+          "auto-close-toggle",
+          "submit-order-button"
+        ],
+        "max_items": 150,
+        "intent": "Prove the long market form and its semantic controls",
+        "next": "set-amount"
+      },
+      "set-amount": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"amount-input-field\"] input",
+        "value": "{{params.amount}}",
+        "intent": "Enter the USD order amount through the amount field",
+        "next": "set-leverage"
+      },
+      "set-leverage": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"leverage-input\"] input",
+        "value": "{{params.leverage}}",
+        "intent": "Enter leverage through the leverage field",
+        "next": "assert-configured"
+      },
+      "assert-configured": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "long",
+        "order_type": "market",
+        "amount": "{{params.amount}}",
+        "leverage": "{{params.leverage}}",
+        "submit_enabled": true,
+        "max_items": 150,
+        "intent": "Prove amount, leverage, and submit eligibility update together",
+        "next": "select-short"
+      },
+      "select-short": {
+        "action": "ui.press",
+        "test_id": "direction-tab-short",
+        "intent": "Switch the same order form to Short",
+        "next": "assert-short"
+      },
+      "assert-short": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "short",
+        "order_type": "market",
+        "amount": "{{params.amount}}",
+        "submit_enabled": true,
+        "max_items": 150,
+        "intent": "Prove direction changes without losing configured values",
+        "next": "select-limit"
+      },
+      "select-limit": {
+        "action": "ui.press",
+        "test_id": "order-type-limit",
+        "intent": "Switch the order form to Limit",
+        "next": "assert-limit"
+      },
+      "assert-limit": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "short",
+        "order_type": "limit",
+        "amount": "{{params.amount}}",
+        "require_test_ids": ["limit-price-input", "limit-price-mid-button"],
+        "max_items": 150,
+        "intent": "Prove Limit mode exposes its price controls",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-order-entry.png",
+        "label": "Perps release order entry",
+        "intent": "Preserve reviewer-visible proof of the configured order form",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/extension/perps/release-order-validation.recipe.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release order validation",
+  "description": "Exercises Perps minimum amount, percent, leverage, keyboard, and auto-close validation through semantic visible controls without submitting an order.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Reset transient Perps navigation state",
+        "next": "open-market-list"
+      },
+      "open-market-list": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Show the live Perps market list",
+        "next": "open-market"
+      },
+      "open-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Open the requested Perps market",
+        "next": "open-long"
+      },
+      "open-long": {
+        "action": "ui.press",
+        "test_id": "perps-long-cta-button",
+        "intent": "Open a new long market order",
+        "next": "wait-order-entry"
+      },
+      "wait-order-entry": {
+        "action": "ui.wait_for",
+        "test_id": "perps-order-entry-page",
+        "expected": "visible",
+        "timeout_ms": 10000,
+        "intent": "Confirm the order form finished opening",
+        "next": "enter-below-minimum"
+      },
+      "enter-below-minimum": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"amount-input-field\"] input",
+        "value": "1",
+        "intent": "Enter an amount below the market minimum",
+        "next": "assert-below-minimum"
+      },
+      "assert-below-minimum": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "long",
+        "order_type": "market",
+        "amount": "1",
+        "submit_enabled": false,
+        "max_items": 150,
+        "intent": "Prove the below-minimum amount cannot be submitted",
+        "next": "enter-valid-amount"
+      },
+      "enter-valid-amount": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"amount-input-field\"] input",
+        "value": "10",
+        "intent": "Enter the minimum valid USD amount",
+        "next": "enter-percent"
+      },
+      "enter-percent": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"balance-percent-input\"] input",
+        "value": "50",
+        "intent": "Enter a midpoint balance percentage",
+        "next": "assert-percent"
+      },
+      "assert-percent": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "direction": "long",
+        "order_type": "market",
+        "percent": "50",
+        "submit_enabled": true,
+        "max_items": 150,
+        "intent": "Prove percent input updates a valid order summary",
+        "next": "enter-min-leverage"
+      },
+      "enter-min-leverage": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"leverage-input\"] input",
+        "value": "1",
+        "intent": "Enter minimum leverage",
+        "next": "assert-min-leverage"
+      },
+      "assert-min-leverage": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "leverage": "1",
+        "max_items": 150,
+        "intent": "Prove minimum leverage is accepted",
+        "next": "raise-with-keyboard"
+      },
+      "raise-with-keyboard": {
+        "action": "ui.key_press",
+        "key": "ArrowUp",
+        "intent": "Raise leverage with the keyboard",
+        "next": "assert-keyboard-leverage"
+      },
+      "assert-keyboard-leverage": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "leverage": "2",
+        "max_items": 150,
+        "intent": "Prove the keyboard changes leverage by one step",
+        "next": "enter-max-leverage"
+      },
+      "enter-max-leverage": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"leverage-input\"] input",
+        "value": "40",
+        "intent": "Enter the market maximum leverage",
+        "next": "assert-max-leverage"
+      },
+      "assert-max-leverage": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "leverage": "40",
+        "max_items": 150,
+        "intent": "Prove maximum leverage is accepted",
+        "next": "enable-auto-close"
+      },
+      "enable-auto-close": {
+        "action": "ui.press",
+        "selector": "label:has([data-testid=\"auto-close-toggle\"])",
+        "intent": "Enable take-profit and stop-loss controls",
+        "next": "assert-auto-close"
+      },
+      "assert-auto-close": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "auto_close": true,
+        "require_test_ids": [
+          "tp-price-input",
+          "tp-percent-input",
+          "sl-price-input",
+          "sl-percent-input"
+        ],
+        "max_items": 150,
+        "intent": "Prove auto-close exposes linked take-profit and stop-loss fields",
+        "next": "enter-invalid-take-profit"
+      },
+      "enter-invalid-take-profit": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"tp-price-input\"] input",
+        "value": "1000",
+        "intent": "Enter a take-profit below the long entry price",
+        "next": "assert-invalid-take-profit"
+      },
+      "assert-invalid-take-profit": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "auto_close": true,
+        "submit_enabled": false,
+        "require_test_ids": ["tp-validation-error"],
+        "max_items": 150,
+        "intent": "Prove an unsafe long take-profit is blocked",
+        "next": "enter-valid-take-profit"
+      },
+      "enter-valid-take-profit": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"tp-price-input\"] input",
+        "value": "70000",
+        "intent": "Enter a take-profit above the long entry price",
+        "next": "enter-invalid-stop-loss"
+      },
+      "enter-invalid-stop-loss": {
+        "action": "ui.set_input",
+        "selector": "[data-testid=\"sl-price-input\"] input",
+        "value": "100000",
+        "intent": "Enter a stop-loss above the long entry price",
+        "next": "assert-invalid-stop-loss"
+      },
+      "assert-invalid-stop-loss": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "order-entry",
+        "market": "{{params.market}}",
+        "auto_close": true,
+        "submit_enabled": false,
+        "require_test_ids": ["sl-validation-error"],
+        "max_items": 150,
+        "intent": "Prove an unsafe long stop-loss is blocked",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-order-validation.png",
+        "label": "Perps release order validation",
+        "intent": "Preserve reviewer-visible proof of the validation controls",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/extension/runner/action-validation.recipe.json

@@ -158,11 +158,22 @@
       },
       "perps-navigate-market": {
         "action": "ui.navigate",
-        "next": "start-state",
+        "next": "read-snapshot",
         "intent": "Show the ETH Perps market details",
         "page": "perps-market",
         "market": "ETH"
       },
+      "read-snapshot": {
+        "action": "metamask.perps.read_snapshot",
+        "include": [
+          "markets"
+        ],
+        "markets": [
+          "ETH"
+        ],
+        "next": "start-state",
+        "intent": "Read a bounded live Perps market snapshot"
+      },
       "ensure-clean": {
         "action": "metamask.perps.ensure_positions",
         "market": "ETH",

package/library/recipes/perps/release-activity-filters.recipe.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release activity filters",
+  "description": "Opens live Perps activity and exercises the Trades, Orders, Funding, and Deposits filters through semantic visible controls.",
+  "workflow": {
+    "entry": "open-activity",
+    "nodes": {
+      "open-activity": {
+        "action": "ui.navigate",
+        "page": "perps-activity",
+        "intent": "Open the full live Perps activity surface",
+        "next": "trades"
+      },
+      "trades": {
+        "action": "metamask.perps.select_activity_filter",
+        "filter": "trades",
+        "intent": "Show only trade-related Perps activity",
+        "next": "orders"
+      },
+      "orders": {
+        "action": "metamask.perps.select_activity_filter",
+        "filter": "orders",
+        "intent": "Show only order-related Perps activity",
+        "next": "funding"
+      },
+      "funding": {
+        "action": "metamask.perps.select_activity_filter",
+        "filter": "funding",
+        "intent": "Show only Perps funding activity",
+        "next": "deposits"
+      },
+      "deposits": {
+        "action": "metamask.perps.select_activity_filter",
+        "filter": "deposits",
+        "intent": "Show only Perps deposit and withdrawal activity",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-activity-filters.png",
+        "label": "Perps activity filters",
+        "intent": "Preserve reviewer-visible proof of the activity surface",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/perps/release-funds-flows.recipe.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release funds flows",
+  "description": "Opens the live Perps deposit and withdraw confirmations, proves their loaded amount contexts, and dismisses each without submitting funds.",
+  "workflow": {
+    "entry": "open-perps-deposit",
+    "nodes": {
+      "open-perps-deposit": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show Perps home before opening Add funds",
+        "next": "open-deposit"
+      },
+      "open-deposit": {
+        "action": "metamask.perps.open_balance_action",
+        "balance_action": "add-funds",
+        "intent": "Open the Perps Add funds confirmation",
+        "next": "read-deposit"
+      },
+      "read-deposit": {
+        "action": "metamask.perps.read_funds_confirmation",
+        "mode": "deposit",
+        "intent": "Prove the deposit amount, token, fee, and time context loaded",
+        "next": "dismiss-deposit"
+      },
+      "dismiss-deposit": {
+        "action": "ui.press",
+        "test_id": "wallet-initiated-header-back-button",
+        "intent": "Dismiss the deposit without submitting funds",
+        "next": "open-perps-withdraw"
+      },
+      "open-perps-withdraw": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show Perps home before opening Withdraw",
+        "next": "open-withdraw"
+      },
+      "open-withdraw": {
+        "action": "metamask.perps.open_balance_action",
+        "balance_action": "withdraw",
+        "intent": "Open the Perps Withdraw confirmation",
+        "next": "read-withdraw"
+      },
+      "read-withdraw": {
+        "action": "metamask.perps.read_funds_confirmation",
+        "mode": "withdraw",
+        "intent": "Prove available balance, receive token, fee, time, and final amount loaded",
+        "next": "enter-zero"
+      },
+      "enter-zero": {
+        "action": "ui.set_input",
+        "test_id": "custom-amount-input",
+        "value": "0",
+        "intent": "Enter zero to exercise withdrawal validation",
+        "next": "assert-zero"
+      },
+      "assert-zero": {
+        "action": "metamask.perps.read_funds_confirmation",
+        "mode": "withdraw",
+        "expected_submit_enabled": false,
+        "intent": "Prove zero remains non-submittable",
+        "next": "dismiss-withdraw"
+      },
+      "dismiss-withdraw": {
+        "action": "ui.press",
+        "test_id": "wallet-initiated-header-back-button",
+        "intent": "Dismiss the withdrawal without submitting funds",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/perps/release-live-market-order.recipe.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release live market order",
+  "description": "Places one small live Perps market order through visible product controls and proves the resulting position and activity.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["confirm_live"],
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "amount": {
+        "type": "integer",
+        "minimum": 10,
+        "default": 10
+      },
+      "leverage": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 3
+      },
+      "confirm_live": {
+        "type": "boolean"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show the live Perps home surface",
+        "next": "assert-clean"
+      },
+      "assert-clean": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "home",
+        "maximum_position_count": 0,
+        "require_features": ["balance", "market-list"],
+        "max_items": 150,
+        "intent": "Prove there is no open position before placing the order",
+        "next": "open-market-list"
+      },
+      "open-market-list": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Show the live Perps market list",
+        "next": "open-market"
+      },
+      "open-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Open the requested Perps market",
+        "next": "submit-once"
+      },
+      "submit-once": {
+        "action": "metamask.perps.place_order",
+        "market": "{{params.market}}",
+        "side": "long",
+        "amount": "{{params.amount}}",
+        "leverage": "{{params.leverage}}",
+        "order_type": "market",
+        "confirm_live": "{{params.confirm_live}}",
+        "timeout_ms": 45000,
+        "intent": "Submit the authorized order exactly once",
+        "next": "wait-position"
+      },
+      "wait-position": {
+        "action": "ui.wait_for",
+        "test_id": "perps-position-size-value",
+        "expected": "visible",
+        "timeout_ms": 45000,
+        "intent": "Confirm the filled position becomes visible",
+        "next": "assert-position"
+      },
+      "assert-position": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-details",
+        "market": "{{params.market}}",
+        "minimum_position_count": 1,
+        "maximum_order_count": 0,
+        "minimum_activity_count": 1,
+        "require_test_ids": ["perps-position-size-value", "perps-position-leverage"],
+        "max_items": 150,
+        "intent": "Prove the filled position appears once with market activity",
+        "next": "capture-open"
+      },
+      "capture-open": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-live-position.png",
+        "label": "Perps live position",
+        "intent": "Preserve reviewer-visible proof of the filled live position",
+        "next": "close-position"
+      },
+      "close-position": {
+        "action": "metamask.perps.close_visible_position",
+        "market": "{{params.market}}",
+        "confirm_live": "{{params.confirm_live}}",
+        "intent": "Close the live position after proving it",
+        "next": "assert-closed"
+      },
+      "assert-closed": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-details",
+        "market": "{{params.market}}",
+        "maximum_position_count": 0,
+        "minimum_activity_count": 1,
+        "max_items": 150,
+        "intent": "Prove the position was removed and close activity was recorded",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}