@deeeed/metamask-harness 0.64.0 → 0.65.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.65.0 - 2026-09-25
+
+### Added
+
+- Explicit Extension `wallet.accept-terms` setup recipe with caller-authorized consent and enabled-state checks.
+- Structured visible market-detail identity and price observations, with null for missing or ambiguous fields.
+
+### Fixed
+
+- Give bundled market-detail and search recipes portable runtime assertions so composed QA cases can validate their existing behavioral contract.
+
 ## 0.64.0 - 2026-09-25
 
 ### Added

package/README.md

@@ -226,6 +226,8 @@ mm-harness run --list
 mm-harness run perps.smoke --describe
 mm-harness run wallet.smoke --describe
 mm-harness run wallet.import method=auto
+# When a visible Terms of Use gate follows import and acceptance is authorized:
+mm-harness run wallet.accept-terms accept=true
 
 # Use visible client UI to delete and import the wallet again.
 mm-harness run wallet.reset-import

package/library/actions/shared/perps/visible-state.mjs

@@ -232,11 +232,25 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
     ...(item.label ? { label: item.label } : {}),
     visible: item.visible,
   }));
+  const detailField = (pattern) => {
+    const matches = items.filter((item) => item.visible && pattern.test(item.testId));
+    const values = [...new Set(matches.map((item) => item.label).filter(Boolean))];
+    return values.length === 1 ? values[0] : null;
+  };
+  const detailPair = detailField(/^(?:perps-market-detail-pair|perps-(?:pro-)?market-header-subtitle)$/u);
+  const detailSymbol = detailPair?.match(/^(.+?)-(?:USDC|USD|PERP)(?:\s+perp)?$/iu)?.[1]?.toUpperCase() ?? null;
   const state = {
     source: 'visible-ui',
     platform,
     surface,
     favorite,
+    marketDetails: surface === 'market-details' ? {
+      symbol: detailSymbol,
+      pair: detailPair,
+      name: detailField(/^(?:perps-market-detail-name|perps-(?:pro-)?market-header-title)$/u),
+      price: detailField(/^perps-(?:market-detail-(?:header-)?price|market-header-price|pro-market-price)$/u),
+      priceChange: detailField(/^perps-(?:market-detail-(?:header-)?change|market-header-price-change|pro-market-price-change)$/u),
+    } : null,
     ...(route ? { route } : {}),
     ...(text(raw.title) ? { title: text(raw.title) } : {}),
     balance: compactEntries(
@@ -244,6 +258,7 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
       1,
     )[0] ?? null,
     markets: marketItems,
+    marketCount: marketItems.length,
     positions: compactEntries(
       selected(unique, (item) => /^(?:position-card-(?!roe-)|perps-position-row-|perps-position-size-value$|perps-pro-market-position-row-|perps-home-position-card-)/u.test(item.testId), options.maxItems),
       options.maxItems,

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

@@ -2809,7 +2809,7 @@
       ]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state without product background hooks. favorite is boolean only when the requested market pair and one favorite control are both visible; otherwise null, never an assumed false.",
+      "description": "Read and assert bounded visible Perps UI state without product background hooks. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total. favorite is boolean only when the requested market pair and one favorite control are both visible; otherwise null, never an assumed false.",
       "schema": {
         "type": "object",
         "properties": {

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

@@ -2178,7 +2178,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state through native accessibility. favorite is boolean only when the requested market pair and one favorite control are both observed as visible; otherwise null, never an assumed false.",
+      "description": "Read and assert bounded visible Perps UI state through native accessibility. favorite is boolean only when the requested market pair and one favorite control are both observed as visible; otherwise null, never an assumed false. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total.",
       "schema": {
         "type": "object",
         "properties": {

package/library/recipes/extension/wallet/accept-terms.recipe.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Accept the visible wallet Terms of Use",
+  "description": "Setup-only Extension journey for a visible Terms of Use gate. Requires explicit caller authority to accept the displayed terms. Scrolls through the agreement, checks consent and waits until Agree is enabled, then proves the gate is absent. Does not import, unlock or change network/trading state; call after wallet.import when this gate is present.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "accept"
+    ],
+    "properties": {
+      "accept": {
+        "type": "boolean",
+        "enum": [
+          true
+        ],
+        "description": "The caller authorizes accepting the displayed terms for this fixture."
+      },
+      "timeout_ms": {
+        "type": "integer",
+        "minimum": 1000,
+        "default": 15000
+      }
+    }
+  },
+  "proofTargets": [
+    {
+      "id": "terms-dismissed",
+      "claim": "The visible Terms of Use gate is accepted through its controls and no longer covers the wallet."
+    }
+  ],
+  "workflow": {
+    "entry": "require-terms",
+    "nodes": {
+      "require-terms": {
+        "action": "ui.wait_for",
+        "test_id": "terms-of-use-agree-button",
+        "expected": "visible",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Require the agreement to be visible before changing consent",
+        "next": "scroll-terms"
+      },
+      "scroll-terms": {
+        "action": "ui.press",
+        "test_id": "terms-of-use-scroll-button",
+        "intent": "Reach the end of the displayed agreement",
+        "next": "wait-checkbox"
+      },
+      "wait-checkbox": {
+        "action": "ui.wait_for",
+        "selector": "[data-testid=\"terms-of-use-checkbox\"]:not([disabled])",
+        "expected": "visible",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "The displayed agreement allows the caller to record consent",
+        "next": "check-consent"
+      },
+      "check-consent": {
+        "action": "ui.press",
+        "test_id": "terms-of-use-checkbox",
+        "intent": "Record the caller-authorized consent through the checkbox",
+        "next": "wait-agree"
+      },
+      "wait-agree": {
+        "action": "ui.wait_for",
+        "selector": "[data-testid=\"terms-of-use-agree-button\"]:not([disabled])",
+        "expected": "visible",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "The completed agreement review enables its confirmation control",
+        "next": "agree"
+      },
+      "agree": {
+        "action": "ui.press",
+        "test_id": "terms-of-use-agree-button",
+        "intent": "Accept the displayed terms for the authorized fixture",
+        "next": "verify-dismissed"
+      },
+      "verify-dismissed": {
+        "action": "ui.wait_for",
+        "test_id": "terms-of-use-agree-button",
+        "expected": "absent",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "proves": [
+          "terms-dismissed"
+        ],
+        "intent": "Prove the agreement no longer covers wallet controls",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

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

@@ -40,7 +40,9 @@
         "surface": "market-list",
         "market": "{{params.market}}",
         "minimum_market_count": 2,
-        "require_features": ["market-list"],
+        "require_features": [
+          "market-list"
+        ],
         "max_items": 100,
         "intent": "Prove the requested market appears in a populated live market list",
         "next": "open-market"
@@ -65,7 +67,7 @@
         ],
         "max_items": 100,
         "intent": "Prove the selected market, live pricing, statistics, and trade directions are visible",
-        "next": "capture-market"
+        "next": "verify-directions"
       },
       "capture-market": {
         "action": "ui.screenshot",
@@ -77,7 +79,55 @@
       "done": {
         "action": "end",
         "status": "pass"
+      },
+      "verify-price": {
+        "action": "assert_output",
+        "source": "assert-market",
+        "assert": {
+          "path": "$.features.price",
+          "operator": "eq",
+          "value": true
+        },
+        "proves": [
+          "market-details"
+        ],
+        "intent": "The requested market displays a price quote",
+        "next": "capture-market"
+      },
+      "verify-stats": {
+        "action": "assert_output",
+        "source": "assert-market",
+        "assert": {
+          "path": "$.features.stats",
+          "operator": "eq",
+          "value": true
+        },
+        "proves": [
+          "market-details"
+        ],
+        "intent": "The requested market displays its statistics",
+        "next": "verify-price"
+      },
+      "verify-directions": {
+        "action": "assert_output",
+        "source": "assert-market",
+        "assert": {
+          "path": "$.features.long-short",
+          "operator": "eq",
+          "value": true
+        },
+        "proves": [
+          "market-details"
+        ],
+        "intent": "Both trading directions are available for the requested market",
+        "next": "verify-stats"
       }
     }
-  }
+  },
+  "proofTargets": [
+    {
+      "id": "market-details",
+      "claim": "The requested market shows its live price, statistics and both trade directions."
+    }
+  ]
 }

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

@@ -45,7 +45,9 @@
         "action": "metamask.perps.read_visible_state",
         "surface": "market-list",
         "minimum_market_count": "{{params.minimum_unfiltered_results}}",
-        "require_features": ["market-list"],
+        "require_features": [
+          "market-list"
+        ],
         "max_items": 100,
         "intent": "Prove the live market list is populated before filtering",
         "next": "search"
@@ -62,10 +64,12 @@
         "market": "{{params.expected_market}}",
         "minimum_market_count": 1,
         "maximum_market_count": "{{params.maximum_results}}",
-        "require_features": ["market-list"],
+        "require_features": [
+          "market-list"
+        ],
         "max_items": 100,
         "intent": "Prove the search reduced the list and retained the requested market",
-        "next": "capture"
+        "next": "verify-result"
       },
       "capture": {
         "action": "ui.screenshot",
@@ -77,7 +81,55 @@
       "done": {
         "action": "end",
         "status": "pass"
+      },
+      "verify-result": {
+        "action": "assert_output",
+        "source": "assert-filtered",
+        "assert": {
+          "path": "$.markets",
+          "operator": "length_lte",
+          "value": "{{params.maximum_results}}"
+        },
+        "proves": [
+          "filtered-market"
+        ],
+        "intent": "Assert the observed filtered result count stays within the requested bounds",
+        "next": "verify-nonempty"
+      },
+      "verify-nonempty": {
+        "action": "assert_output",
+        "source": "assert-filtered",
+        "assert": {
+          "path": "$.markets",
+          "operator": "length_gte",
+          "value": 1
+        },
+        "proves": [
+          "filtered-market"
+        ],
+        "intent": "The filtered market list contains at least one result",
+        "next": "verify-reduction"
+      },
+      "verify-reduction": {
+        "action": "assert_output",
+        "source": "assert-filtered",
+        "assert": {
+          "path": "$.markets",
+          "operator": "length_lt",
+          "value": "{{outputs.assert-unfiltered.marketCount}}"
+        },
+        "proves": [
+          "filtered-market"
+        ],
+        "intent": "The query reduces the observed market list from its unfiltered count",
+        "next": "capture"
       }
     }
-  }
+  },
+  "proofTargets": [
+    {
+      "id": "filtered-market",
+      "claim": "The entered query reduces the live market list and retains the expected market."
+    }
+  ]
 }

package/package.json

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