@deeeed/metamask-harness 0.39.0 → 0.40.0

package/library/recipes/extension/assets/release-custom-network-token-persistence.recipe.json

@@ -33,6 +33,7 @@
         "chain_id": "{{params.chain_id}}",
         "symbol": "{{params.native_symbol}}",
         "explorer_url": "{{params.explorer_url}}",
+        "require_absent": true,
         "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Add and select the custom network through visible settings",
         "next": "import-token"

package/library/recipes/{perps → extension/perps}/release-activity-filters.recipe.json

@@ -1,7 +1,7 @@
 {
   "$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.",
+  "description": "Selects the Trades, Orders, Funding, and Deposits controls and proves each selected label and route; populated or typed activity rows are not required.",
   "workflow": {
     "entry": "open-activity",
     "nodes": {
@@ -14,25 +14,25 @@
       "trades": {
         "action": "metamask.perps.select_activity_filter",
         "filter": "trades",
-        "intent": "Show only trade-related Perps activity",
+        "intent": "Prove the Trades filter label and route",
         "next": "orders"
       },
       "orders": {
         "action": "metamask.perps.select_activity_filter",
         "filter": "orders",
-        "intent": "Show only order-related Perps activity",
+        "intent": "Prove the Orders filter label and route",
         "next": "funding"
       },
       "funding": {
         "action": "metamask.perps.select_activity_filter",
         "filter": "funding",
-        "intent": "Show only Perps funding activity",
+        "intent": "Prove the Funding filter label and route",
         "next": "deposits"
       },
       "deposits": {
         "action": "metamask.perps.select_activity_filter",
         "filter": "deposits",
-        "intent": "Show only Perps deposit and withdrawal activity",
+        "intent": "Prove the Deposits filter label and route",
         "next": "capture"
       },
       "capture": {

package/library/recipes/{perps → extension/perps}/release-funds-flows.recipe.json

@@ -1,7 +1,7 @@
 {
   "$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.",
+  "description": "Opens the live Perps deposit and withdraw forms, records the currently rendered preview fields, proves zero withdrawal is disabled, and dismisses both without submission.",
   "workflow": {
     "entry": "open-perps-deposit",
     "nodes": {
@@ -20,7 +20,7 @@
       "read-deposit": {
         "action": "metamask.perps.read_funds_confirmation",
         "mode": "deposit",
-        "intent": "Prove the deposit amount, token, fee, and time context loaded",
+        "intent": "Prove the deposit form loaded and record any rendered preview fields",
         "next": "dismiss-deposit"
       },
       "dismiss-deposit": {
@@ -44,7 +44,7 @@
       "read-withdraw": {
         "action": "metamask.perps.read_funds_confirmation",
         "mode": "withdraw",
-        "intent": "Prove available balance, receive token, fee, time, and final amount loaded",
+        "intent": "Prove the withdraw form loaded and record any rendered preview fields",
         "next": "enter-zero"
       },
       "enter-zero": {

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

@@ -5,7 +5,7 @@
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
-    "required": ["confirm_live"],
+    "required": ["confirm_live", "limit_price", "provider", "network"],
     "properties": {
       "market": {
         "type": "string",
@@ -19,15 +19,16 @@
       "leverage": {
         "type": "integer",
         "minimum": 1,
-        "default": 3
-      },
-      "offset_pct": {
-        "type": "number",
-        "default": -2
+        "default": 1
       },
+      "provider": { "type": "string" },
+      "network": { "type": "string", "enum": ["mainnet", "testnet"] },
+      "limit_price": { "type": "string" },
+      "offset_pct": { "type": "number" },
       "confirm_live": {
         "type": "boolean"
-      }
+      },
+      "identity_rounding_tolerance_base_units": { "type": "string", "default": "10000" }
     }
   },
   "workflow": {
@@ -38,14 +39,6 @@
         "page": "perps-market",
         "market": "{{params.market}}",
         "intent": "Open the requested live Perps market",
-        "next": "assert-clean"
-      },
-      "assert-clean": {
-        "action": "metamask.perps.read_visible_state",
-        "surface": "market-details",
-        "market": "{{params.market}}",
-        "maximum_order_count": 0,
-        "intent": "Prove no order is open before submission",
         "next": "place-limit"
       },
       "place-limit": {
@@ -54,9 +47,13 @@
         "side": "long",
         "amount": "{{params.amount}}",
         "leverage": "{{params.leverage}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.network}}",
         "order_type": "limit",
-        "offset_pct": "{{params.offset_pct}}",
+        "limit_price": "{{params.limit_price}}",
         "confirm_live": "{{params.confirm_live}}",
+        "identity_rounding_tolerance_base_units": "{{params.identity_rounding_tolerance_base_units}}",
+        "submit_attempts": 1,
         "timeout_ms": 45000,
         "intent": "Submit one authorized resting limit order through visible controls",
         "next": "assert-open"
@@ -82,6 +79,13 @@
       "cancel-order": {
         "action": "metamask.perps.close_orders",
         "market": "{{params.market}}",
+        "side": "long",
+        "amount": "{{params.amount}}",
+        "leverage": "{{params.leverage}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.network}}",
+        "limit_price": "{{params.limit_price}}",
+        "identity_rounding_tolerance_base_units": "{{params.identity_rounding_tolerance_base_units}}",
         "confirm_live": "{{params.confirm_live}}",
         "timeout_ms": 30000,
         "intent": "Cancel the authorized live limit order through visible controls",
@@ -89,10 +93,11 @@
       },
       "assert-canceled": {
         "action": "metamask.perps.read_visible_state",
-        "surface": "market-details",
-        "market": "{{params.market}}",
+        "surface": "home",
+        "maximum_position_count": 0,
         "maximum_order_count": 0,
-        "intent": "Prove the order card disappears after cancellation",
+        "require_features": ["balance", "market-list"],
+        "intent": "Prove global positions and orders remain empty after cancellation",
         "next": "done"
       },
       "done": {

package/library/recipes/extension/perps/release-market-filters.recipe.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release market filters",
+  "description": "Exercises every stable live Perps market category through visible controls after resetting the market-list surface.",
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Reset transient market-list state on the Perps home surface",
+        "next": "open-market-list"
+      },
+      "open-market-list": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Open the complete live Perps market selection",
+        "next": "wait-market-filter"
+      },
+      "wait-market-filter": {
+        "action": "ui.wait_for",
+        "test_id": "filter-select-button",
+        "expected": "visible",
+        "timeout_ms": 30000,
+        "intent": "Confirm the market filter control is ready",
+        "next": "all"
+      },
+      "all": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "all",
+        "minimum_market_count": 1,
+        "intent": "Prove the complete live market category",
+        "next": "crypto"
+      },
+      "crypto": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "crypto",
+        "minimum_market_count": 0,
+        "intent": "Prove the Crypto market category",
+        "next": "stocks"
+      },
+      "stocks": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "stocks",
+        "minimum_market_count": 0,
+        "intent": "Prove the Stocks market category",
+        "next": "pre-ipo"
+      },
+      "pre-ipo": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "pre-ipo",
+        "minimum_market_count": 0,
+        "intent": "Prove the Pre-IPO market category control",
+        "next": "index"
+      },
+      "index": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "index",
+        "minimum_market_count": 0,
+        "intent": "Prove the Index market category control",
+        "next": "etf"
+      },
+      "etf": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "etf",
+        "minimum_market_count": 0,
+        "intent": "Prove the ETF market category control",
+        "next": "commodities"
+      },
+      "commodities": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "commodities",
+        "minimum_market_count": 0,
+        "intent": "Prove the Commodities market category",
+        "next": "forex"
+      },
+      "forex": {
+        "action": "metamask.perps.select_market_filter",
+        "filter": "forex",
+        "minimum_market_count": 0,
+        "intent": "Prove the Forex market category",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-market-filters.png",
+        "label": "Perps release market filters",
+        "intent": "Preserve reviewer-visible proof of the final market filter",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

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

@@ -5,10 +5,13 @@
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
+    "required": [
+      "market"
+    ],
     "properties": {
       "market": {
         "type": "string",
-        "default": "BTC"
+        "description": "Perps market with no existing position so the New Long and Short controls are available."
       },
       "amount": {
         "type": "string",

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

@@ -5,10 +5,49 @@
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
+    "required": [
+      "market"
+    ],
     "properties": {
       "market": {
         "type": "string",
-        "default": "BTC"
+        "description": "Perps market with no existing position so the New Long order form can be validated."
+      },
+      "below_minimum_amount": {
+        "type": "string",
+        "default": "1"
+      },
+      "valid_amount": {
+        "type": "string",
+        "default": "10"
+      },
+      "percent": {
+        "type": "string",
+        "default": "50"
+      },
+      "minimum_leverage": {
+        "type": "string",
+        "default": "1"
+      },
+      "keyboard_leverage": {
+        "type": "string",
+        "default": "2"
+      },
+      "maximum_leverage": {
+        "type": "string",
+        "default": "40"
+      },
+      "invalid_take_profit": {
+        "type": "string",
+        "default": "1000"
+      },
+      "valid_take_profit": {
+        "type": "string",
+        "default": "70000"
+      },
+      "invalid_stop_loss": {
+        "type": "string",
+        "default": "100000"
       }
     }
   },
@@ -51,7 +90,7 @@
       "enter-below-minimum": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"amount-input-field\"] input",
-        "value": "1",
+        "value": "{{params.below_minimum_amount}}",
         "intent": "Enter an amount below the market minimum",
         "next": "assert-below-minimum"
       },
@@ -61,7 +100,7 @@
         "market": "{{params.market}}",
         "direction": "long",
         "order_type": "market",
-        "amount": "1",
+        "amount": "{{params.below_minimum_amount}}",
         "submit_enabled": false,
         "max_items": 150,
         "intent": "Prove the below-minimum amount cannot be submitted",
@@ -70,14 +109,14 @@
       "enter-valid-amount": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"amount-input-field\"] input",
-        "value": "10",
+        "value": "{{params.valid_amount}}",
         "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",
+        "value": "{{params.percent}}",
         "intent": "Enter a midpoint balance percentage",
         "next": "assert-percent"
       },
@@ -87,7 +126,7 @@
         "market": "{{params.market}}",
         "direction": "long",
         "order_type": "market",
-        "percent": "50",
+        "percent": "{{params.percent}}",
         "submit_enabled": true,
         "max_items": 150,
         "intent": "Prove percent input updates a valid order summary",
@@ -96,7 +135,7 @@
       "enter-min-leverage": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"leverage-input\"] input",
-        "value": "1",
+        "value": "{{params.minimum_leverage}}",
         "intent": "Enter minimum leverage",
         "next": "assert-min-leverage"
       },
@@ -104,7 +143,7 @@
         "action": "metamask.perps.read_visible_state",
         "surface": "order-entry",
         "market": "{{params.market}}",
-        "leverage": "1",
+        "leverage": "{{params.minimum_leverage}}",
         "max_items": 150,
         "intent": "Prove minimum leverage is accepted",
         "next": "raise-with-keyboard"
@@ -119,7 +158,7 @@
         "action": "metamask.perps.read_visible_state",
         "surface": "order-entry",
         "market": "{{params.market}}",
-        "leverage": "2",
+        "leverage": "{{params.keyboard_leverage}}",
         "max_items": 150,
         "intent": "Prove the keyboard changes leverage by one step",
         "next": "enter-max-leverage"
@@ -127,7 +166,7 @@
       "enter-max-leverage": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"leverage-input\"] input",
-        "value": "40",
+        "value": "{{params.maximum_leverage}}",
         "intent": "Enter the market maximum leverage",
         "next": "assert-max-leverage"
       },
@@ -135,7 +174,7 @@
         "action": "metamask.perps.read_visible_state",
         "surface": "order-entry",
         "market": "{{params.market}}",
-        "leverage": "40",
+        "leverage": "{{params.maximum_leverage}}",
         "max_items": 150,
         "intent": "Prove maximum leverage is accepted",
         "next": "enable-auto-close"
@@ -164,7 +203,7 @@
       "enter-invalid-take-profit": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"tp-price-input\"] input",
-        "value": "1000",
+        "value": "{{params.invalid_take_profit}}",
         "intent": "Enter a take-profit below the long entry price",
         "next": "assert-invalid-take-profit"
       },
@@ -182,14 +221,14 @@
       "enter-valid-take-profit": {
         "action": "ui.set_input",
         "selector": "[data-testid=\"tp-price-input\"] input",
-        "value": "70000",
+        "value": "{{params.valid_take_profit}}",
         "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",
+        "value": "{{params.invalid_stop_loss}}",
         "intent": "Enter a stop-loss above the long entry price",
         "next": "assert-invalid-stop-loss"
       },

package/library/recipes/extension/perps/release-visible-consistency.recipe.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release visible consistency",
+  "description": "Proves bounded visible market-list row changes and containment of recent Perps activity across every activity filter on packaged Extension builds; it does not assert other market-detail surfaces.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "sample_count": { "type": "integer", "minimum": 2, "default": 3 },
+      "sample_interval_ms": { "type": "integer", "minimum": 100, "default": 1000 },
+      "minimum_changed_count": { "type": "integer", "minimum": 1, "default": 1 },
+      "minimum_recent_activity_count": { "type": "integer", "minimum": 1, "default": 1 },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+    }
+  },
+  "workflow": {
+    "entry": "market-stream",
+    "nodes": {
+      "market-stream": {
+        "action": "metamask.perps.assert_visible_consistency",
+        "mode": "market-stream",
+        "sample_count": "{{params.sample_count}}",
+        "sample_interval_ms": "{{params.sample_interval_ms}}",
+        "minimum_changed_count": "{{params.minimum_changed_count}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove bounded changes in rendered market-row facts",
+        "next": "activity-containment"
+      },
+      "activity-containment": {
+        "action": "metamask.perps.assert_visible_consistency",
+        "mode": "activity-containment",
+        "minimum_recent_activity_count": "{{params.minimum_recent_activity_count}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove recent visible activity identities are contained in full activity",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-visible-consistency.png",
+        "label": "Perps visible activity consistency",
+        "intent": "Preserve reviewer-visible proof of the full activity surface",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/extension/perps/source-dev-snapshot-consistency.recipe.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps source-dev snapshot consistency",
+  "description": "Uses the optional source-dev Extension background hook to sample bounded Perps market data and compare one generic visible activity-card identity with normalized history.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "sample_count": {
+        "type": "integer",
+        "minimum": 2,
+        "default": 3
+      },
+      "sample_interval_ms": {
+        "type": "integer",
+        "minimum": 100,
+        "default": 1000
+      },
+      "minimum_changed_market_count": {
+        "type": "integer",
+        "minimum": 0,
+        "default": 0,
+        "description": "Optional live-price movement assertion. Set above zero only when the proof requires observed market changes."
+      },
+      "minimum_history_count": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 1
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-activity",
+    "nodes": {
+      "open-activity": {
+        "action": "ui.navigate",
+        "page": "perps-activity",
+        "intent": "Open live Perps activity through visible controls",
+        "next": "show-funds-activity"
+      },
+      "show-funds-activity": {
+        "action": "metamask.perps.select_activity_filter",
+        "filter": "deposits",
+        "intent": "Show visible activity cards before generic identity comparison",
+        "next": "sample"
+      },
+      "sample": {
+        "action": "metamask.perps.read_snapshot",
+        "include": ["markets", "history"],
+        "sampling": {
+          "count": "{{params.sample_count}}",
+          "interval_ms": "{{params.sample_interval_ms}}"
+        },
+        "expect": {
+          "minimum_changed_market_count": "{{params.minimum_changed_market_count}}",
+          "minimum_history_count": "{{params.minimum_history_count}}",
+          "require_activity_history_agreement": true
+        },
+        "max_items_per_section": 100,
+        "intent": "Prove bounded market changes and one exact visible activity-to-history identity",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-snapshot-consistency.png",
+        "label": "Perps snapshot activity agreement",
+        "intent": "Preserve reviewer-visible proof of the compared activity surface",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

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

@@ -19,11 +19,25 @@
       "leverage": {
         "type": "integer",
         "minimum": 1,
-        "default": 3
+      "default": 1
+      },
+      "provider": {
+        "type": "string",
+        "default": "hyperliquid"
+      },
+      "network": {
+        "type": "string",
+        "enum": [
+          "mainnet",
+          "testnet"
+        ],
+        "default": "mainnet"
       },
       "confirm_live": {
         "type": "boolean"
-      }
+      },
+      "identity_rounding_tolerance_base_units": { "type": "string", "default": "10000" },
+      "balance_reconciliation_tolerance_base_units": { "type": "string", "default": "1000000" }
     }
   },
   "workflow": {
@@ -33,15 +47,6 @@
         "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": {
@@ -63,8 +68,12 @@
         "side": "long",
         "amount": "{{params.amount}}",
         "leverage": "{{params.leverage}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.network}}",
         "order_type": "market",
         "confirm_live": "{{params.confirm_live}}",
+        "identity_rounding_tolerance_base_units": "{{params.identity_rounding_tolerance_base_units}}",
+        "submit_attempts": 1,
         "timeout_ms": 45000,
         "intent": "Submit the authorized order exactly once",
         "next": "wait-position"
@@ -100,14 +109,22 @@
         "action": "metamask.perps.close_visible_position",
         "market": "{{params.market}}",
         "confirm_live": "{{params.confirm_live}}",
+        "funding_side": "long",
+        "funding_amount": "{{params.amount}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.network}}",
+        "leverage": "{{params.leverage}}",
+        "identity_rounding_tolerance_base_units": "{{params.identity_rounding_tolerance_base_units}}",
+        "balance_reconciliation_tolerance_base_units": "{{params.balance_reconciliation_tolerance_base_units}}",
         "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}}",
+        "surface": "home",
         "maximum_position_count": 0,
+        "maximum_order_count": 0,
+        "require_features": ["balance", "market-list"],
         "minimum_activity_count": 1,
         "max_items": 150,
         "intent": "Prove the position was removed and close activity was recorded",

package/library/recipes/perps/release-market-details.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Perps release market details",
-  "description": "Opens one live Perps market through visible UI and proves its price, change, statistics, and Long/Short controls without development-only bridges.",
+  "description": "Opens one live Perps market through visible UI and proves its header price, change, statistics, and Long/Short controls; it does not assert chart data.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,