@deeeed/metamask-harness 0.38.1 → 0.40.0

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/mobile/networks/release-custom-network-persistence.recipe.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Mobile release custom-network persistence",
+  "description": "Adds a custom network through native settings, proves it survives lock/unlock, and removes it.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "network": { "type": "string", "default": "PulseChain" },
+      "rpc_url": { "type": "string", "default": "https://rpc.pulsechain.com" },
+      "chain_id": { "type": "integer", "minimum": 1, "default": 369 },
+      "symbol": { "type": "string", "default": "PLS" },
+      "explorer_url": { "type": "string", "default": "https://scan.pulsechain.com" },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+    }
+  },
+  "workflow": {
+    "entry": "open-wallet",
+    "nodes": {
+      "open-wallet": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Open the wallet before custom-network setup",
+        "next": "add-network"
+      },
+      "add-network": {
+        "action": "metamask.networks.add_custom",
+        "network": "{{params.network}}",
+        "rpc_url": "{{params.rpc_url}}",
+        "chain_id": "{{params.chain_id}}",
+        "symbol": "{{params.symbol}}",
+        "explorer_url": "{{params.explorer_url}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Add the custom network through visible settings",
+        "next": "assert-added"
+      },
+      "assert-added": {
+        "action": "metamask.networks.read_visible_state",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "settle_ms": 1000,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove the custom network is present",
+        "next": "capture-before"
+      },
+      "capture-before": {
+        "action": "ui.screenshot",
+        "path": "screenshots/custom-network-before-lock.png",
+        "label": "Custom network before lock",
+        "intent": "Preserve pre-lock network evidence",
+        "next": "lock-wallet"
+      },
+      "lock-wallet": {
+        "action": "metamask.wallet.lock",
+        "intent": "Lock the wallet through visible native controls",
+        "next": "unlock-wallet"
+      },
+      "unlock-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Unlock the same persisted profile",
+        "next": "assert-persisted"
+      },
+      "assert-persisted": {
+        "action": "metamask.networks.read_visible_state",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "settle_ms": 1000,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove the custom network survived lock and unlock",
+        "next": "capture-after"
+      },
+      "capture-after": {
+        "action": "ui.screenshot",
+        "path": "screenshots/custom-network-after-unlock.png",
+        "label": "Custom network after unlock",
+        "intent": "Preserve post-unlock network evidence",
+        "next": "remove-network"
+      },
+      "remove-network": {
+        "action": "metamask.networks.remove_custom",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Remove the custom network and prove it is absent",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/mobile/networks/release-multichain-visibility.recipe.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Mobile multi-network asset visibility",
+  "description": "Proves funded assets from multiple protocol families are visible together in the opaque Mobile wallet.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "symbols": {
+        "type": "array",
+        "items": { "type": "string" },
+        "default": ["ETH", "SOL"]
+      },
+      "minimum_asset_count": {
+        "type": "integer",
+        "minimum": 2,
+        "default": 2
+      },
+      "timeout_ms": {
+        "type": "integer",
+        "minimum": 1000,
+        "default": 45000
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-wallet",
+    "nodes": {
+      "open-wallet": {
+        "action": "ui.navigate",
+        "page": "home",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open the aggregate Mobile wallet token list",
+        "next": "assert-multichain-assets"
+      },
+      "assert-multichain-assets": {
+        "action": "metamask.assets.read_visible_state",
+        "require_symbols": "{{params.symbols}}",
+        "minimum_asset_count": "{{params.minimum_asset_count}}",
+        "require_fiat": true,
+        "max_items": 100,
+        "intent": "Prove assets from the requested protocol families are simultaneously visible",
+        "next": "capture-wallet"
+      },
+      "capture-wallet": {
+        "action": "ui.screenshot",
+        "path": "screenshots/mobile-multichain-assets.png",
+        "label": "Mobile multi-network asset visibility",
+        "intent": "Preserve reviewer-visible proof of aggregate multi-network holdings",
+        "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,

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

@@ -18,6 +18,11 @@
         "type": "integer",
         "minimum": 1,
         "default": 3
+      },
+      "minimum_unfiltered_results": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 5
       }
     }
   },
@@ -39,16 +44,15 @@
       "assert-unfiltered": {
         "action": "metamask.perps.read_visible_state",
         "surface": "market-list",
-        "minimum_market_count": 20,
+        "minimum_market_count": "{{params.minimum_unfiltered_results}}",
         "require_features": ["market-list"],
         "max_items": 100,
         "intent": "Prove the live market list is populated before filtering",
         "next": "search"
       },
       "search": {
-        "action": "ui.set_input",
-        "test_id": "search-input",
-        "value": "{{params.query}}",
+        "action": "metamask.perps.search_markets",
+        "query": "{{params.query}}",
         "intent": "Enter the market search through trusted keyboard input",
         "next": "assert-filtered"
       },

package/library/recipes/perps/release-watchlist.recipe.json

@@ -45,28 +45,27 @@
         "action": "ui.navigate",
         "page": "perps",
         "intent": "Show Perps home after adding the favorite",
-        "next": "assert-added"
+        "next": "reopen-market-list-added"
       },
-      "assert-added": {
-        "action": "metamask.perps.read_visible_state",
-        "surface": "home",
-        "market": "{{params.market}}",
-        "require_test_ids": ["perps-watchlist-{{params.market}}"],
-        "max_items": 150,
-        "intent": "Prove the favorite persists on the home watchlist",
-        "next": "reopen-market-list"
-      },
-      "reopen-market-list": {
+      "reopen-market-list-added": {
         "action": "ui.navigate",
         "page": "perps-market-list",
-        "intent": "Reopen the complete market list",
-        "next": "reopen-market"
+        "intent": "Reopen the market list after adding the favorite",
+        "next": "reopen-market-added"
       },
-      "reopen-market": {
+      "reopen-market-added": {
         "action": "ui.navigate",
         "page": "perps-market",
         "market": "{{params.market}}",
         "intent": "Reopen the favorited market",
+        "next": "assert-added"
+      },
+      "assert-added": {
+        "action": "metamask.perps.set_market_favorite",
+        "market": "{{params.market}}",
+        "favorite": true,
+        "require_unchanged": true,
+        "intent": "Prove the favorite persisted after navigating away and back",
         "next": "remove-favorite"
       },
       "remove-favorite": {
@@ -80,14 +79,27 @@
         "action": "ui.navigate",
         "page": "perps",
         "intent": "Show Perps home after removing the favorite",
+        "next": "reopen-market-list-removed"
+      },
+      "reopen-market-list-removed": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Reopen the market list after removing the favorite",
+        "next": "reopen-market-removed"
+      },
+      "reopen-market-removed": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Reopen the unfavorited market",
         "next": "assert-removed"
       },
       "assert-removed": {
-        "action": "metamask.perps.read_visible_state",
-        "surface": "home",
-        "forbid_test_ids": ["perps-watchlist-{{params.market}}"],
-        "max_items": 150,
-        "intent": "Prove the removed favorite no longer appears on the watchlist",
+        "action": "metamask.perps.set_market_favorite",
+        "market": "{{params.market}}",
+        "favorite": false,
+        "require_unchanged": true,
+        "intent": "Prove the removal persisted after navigating away and back",
         "next": "done"
       },
       "done": {