@deeeed/metamask-harness 0.47.4 → 0.49.0

package/library/recipes/mobile/networks/release-custom-network-persistence.recipe.json

@@ -1,7 +1,7 @@
 {
   "$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.",
+  "description": "Adds a previously absent custom network through native settings, proves it survives lock/unlock, and removes only the network this run confirmed adding. Existing networks are preserved and refused as proof setup.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -11,11 +11,14 @@
       "chain_id": { "type": "integer", "minimum": 1, "default": 369 },
       "symbol": { "type": "string", "default": "PLS" },
       "explorer_url": { "type": "string", "default": "https://scan.pulsechain.com" },
+      "before_capture_path": { "type": "string", "default": "screenshots/custom-network-before-lock.png" },
+      "after_capture_path": { "type": "string", "default": "screenshots/custom-network-after-unlock.png" },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
     }
   },
   "workflow": {
     "entry": "open-wallet",
+    "teardown": "require-owned-network",
     "nodes": {
       "open-wallet": {
         "action": "ui.navigate",
@@ -32,6 +35,14 @@
         "explorer_url": "{{params.explorer_url}}",
         "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Add the custom network through visible settings",
+        "next": "require-added"
+      },
+      "require-added": {
+        "action": "assert_output",
+        "source": "add-network",
+        "stream": "added",
+        "match": "^true$",
+        "intent": "Refuse persistence proof when the requested network already existed",
         "next": "assert-added"
       },
       "assert-added": {
@@ -45,7 +56,7 @@
       },
       "capture-before": {
         "action": "ui.screenshot",
-        "path": "screenshots/custom-network-before-lock.png",
+        "path": "{{params.before_capture_path}}",
         "label": "Custom network before lock",
         "intent": "Preserve pre-lock network evidence",
         "next": "lock-wallet"
@@ -71,9 +82,22 @@
       },
       "capture-after": {
         "action": "ui.screenshot",
-        "path": "screenshots/custom-network-after-unlock.png",
+        "path": "{{params.after_capture_path}}",
         "label": "Custom network after unlock",
         "intent": "Preserve post-unlock network evidence",
+        "next": "done"
+      },
+      "require-owned-network": {
+        "action": "assert_output",
+        "source": "add-network",
+        "stream": "added",
+        "match": "^true$",
+        "intent": "Refuse deletion without completed evidence that this run added the network",
+        "next": "unlock-cleanup"
+      },
+      "unlock-cleanup": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Reach the task-owned network settings even if the lock-cycle proof failed",
         "next": "remove-network"
       },
       "remove-network": {
@@ -81,10 +105,11 @@
         "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"
+        "intent": "Remove only the custom network this run confirmed adding and prove it is absent",
+        "next": "cleanup-done"
       },
-      "done": { "action": "end", "status": "pass" }
+      "done": { "action": "end", "status": "pass" },
+      "cleanup-done": { "action": "end", "status": "pass" }
     }
   }
 }

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

@@ -1,11 +1,12 @@
 {
   "$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.",
+  "description": "Checks that the requested asset symbols and formatted fiat values appear together in the Mobile wallet. Symbols alone do not prove network identity or funding.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
+      "capture_path": { "type": "string", "default": "screenshots/mobile-multichain-assets.png" },
       "symbols": {
         "type": "array",
         "items": { "type": "string" },
@@ -39,14 +40,14 @@
         "minimum_asset_count": "{{params.minimum_asset_count}}",
         "require_fiat": true,
         "max_items": 100,
-        "intent": "Prove assets from the requested protocol families are simultaneously visible",
+        "intent": "Prove the requested asset symbols and formatted fiat values appear together",
         "next": "capture-wallet"
       },
       "capture-wallet": {
         "action": "ui.screenshot",
-        "path": "screenshots/mobile-multichain-assets.png",
+        "path": "{{params.capture_path}}",
         "label": "Mobile multi-network asset visibility",
-        "intent": "Preserve reviewer-visible proof of aggregate multi-network holdings",
+        "intent": "Preserve reviewer-visible proof of the requested asset rows",
         "next": "done"
       },
       "done": {

package/library/recipes/mobile/wallet/smoke.recipe.json

@@ -2,18 +2,27 @@
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Mobile wallet smoke",
   "description": "Fixture-backed proof that the Mobile wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "capture_path": { "type": "string", "default": "screenshots/wallet-smoke.png" }
+    }
+  },
   "workflow": {
-    "entry": "status",
+    "entry": "fixture",
     "nodes": {
-      "status": {
-        "action": "app.status",
-        "next": "fixture",
-        "intent": "Confirm the Mobile runtime is reachable"
-      },
       "fixture": {
         "action": "metamask.wallet.fixture_status",
+        "next": "require-fixture",
+        "intent": "Read the checkout's wallet fixture readiness without changing it"
+      },
+      "require-fixture": {
+        "action": "assert_output",
+        "source": "fixture",
+        "assert": { "path": "$.status", "operator": "eq", "value": "ready" },
         "next": "unlock",
-        "intent": "Confirm the checkout wallet fixture is ready"
+        "intent": "Require a ready on-disk fixture before interacting with the wallet; this does not prove imported account identity"
       },
       "unlock": {
         "action": "metamask.wallet.ensure_unlocked",
@@ -27,7 +36,7 @@
       },
       "screenshot": {
         "action": "ui.screenshot",
-        "path": "screenshots/wallet-smoke.png",
+        "path": "{{params.capture_path}}",
         "next": "done",
         "intent": "Record the visible wallet state as evidence"
       },

package/library/recipes/{assets → shared/assets}/release-token-address-import.recipe.json

@@ -32,6 +32,13 @@
         "decimals": "{{params.decimals}}",
         "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Import the token by address on the selected network and verify its metadata",
+        "next": "assert-imported"
+      },
+      "assert-imported": {
+        "action": "assert_output",
+        "source": "import-token",
+        "assert": { "path": "$.changed", "operator": "eq", "value": true },
+        "intent": "Require a completed import rather than reusing an already-imported token",
         "next": "capture-imported-token"
       },
       "capture-imported-token": {

package/library/recipes/{assets → shared/assets}/release-token-details.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Assets release token details",
-  "description": "Opens the first visible asset and proves its live chart and market cap render through visible product UI.",
+  "description": "Open a visible token matching symbol and assert its chart and market cap through product UI. Symbol-only selection does not identify a network or token contract; use a uniquely matching row for this proof. Native reader compatibility must be validated on the tested build.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -24,7 +24,7 @@
         "action": "metamask.assets.open_details",
         "symbol": "{{params.symbol}}",
         "timeout_ms": "{{params.timeout_ms}}",
-        "intent": "Open the requested visible funded asset",
+        "intent": "Open the visible token matching the requested symbol; no funding or network claim",
         "next": "assert-details"
       },
       "assert-details": {

package/library/recipes/shared/assets/release-token-hide-readd.recipe.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assets release token hide and re-add",
+  "description": "Requires an enabled imported token, hides and re-enables it through Manage tokens, and restores the enabled baseline on failure. Both proof transitions must change state.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "query": { "type": "string", "default": "DAI" },
+      "asset_id": { "type": "string", "default": "", "description": "Exact ERC-20 identity on Extension; leave empty for Mobile query-only selection." },
+      "hidden_capture_path": { "type": "string", "default": "screenshots/assets-token-hidden.png" },
+      "restored_capture_path": { "type": "string", "default": "screenshots/assets-token-restored.png" },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
+    }
+  },
+  "workflow": {
+    "entry": "open-wallet",
+    "teardown": "baseline-known",
+    "nodes": {
+      "open-wallet": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Open the all-network asset list",
+        "next": "assert-baseline"
+      },
+      "assert-baseline": {
+        "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
+        "query": "{{params.query}}",
+        "visible": true,
+        "require_unchanged": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Verify the original enabled token before authorizing any restoration",
+        "next": "hide-token"
+      },
+      "hide-token": {
+        "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
+        "query": "{{params.query}}",
+        "visible": false,
+        "require_change": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Disable the imported token and prove its row disappears",
+        "next": "capture-hidden"
+      },
+      "capture-hidden": {
+        "action": "ui.screenshot",
+        "path": "{{params.hidden_capture_path}}",
+        "label": "Token hidden",
+        "intent": "Preserve reviewer-visible hidden state",
+        "next": "readd-token"
+      },
+      "readd-token": {
+        "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
+        "query": "{{params.query}}",
+        "visible": true,
+        "require_change": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Re-enable the token and prove its metadata row returns",
+        "next": "capture-restored"
+      },
+      "capture-restored": {
+        "action": "ui.screenshot",
+        "path": "{{params.restored_capture_path}}",
+        "label": "Token restored",
+        "intent": "Preserve reviewer-visible restored state",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" },
+      "baseline-known": {
+        "action": "assert_output",
+        "source": "assert-baseline",
+        "stream": "requested",
+        "match": "^true$",
+        "intent": "Refuse restoration when this run did not verify the original enabled token",
+        "next": "restore-enabled"
+      },
+      "restore-enabled": {
+        "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
+        "query": "{{params.query}}",
+        "visible": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Restore the original enabled token after success or failure without changing the proof verdict",
+        "next": "cleanup-done"
+      },
+      "cleanup-done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/{assets → shared/assets}/release-token-persistence.recipe.json

@@ -6,6 +6,7 @@
     "type": "object",
     "additionalProperties": false,
     "properties": {
+      "asset_id": { "type": "string", "default": "", "description": "Optional exact ERC-20 identity on Extension; Mobile supports only empty/query-only mode." },
       "query": { "type": "string", "default": "DAI" },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
     }
@@ -21,6 +22,7 @@
       },
       "assert-prestate": {
         "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
         "query": "{{params.query}}",
         "visible": true,
         "require_unchanged": true,
@@ -53,6 +55,7 @@
       },
       "assert-persisted": {
         "action": "metamask.assets.set_token_visibility",
+        "asset_id": "{{params.asset_id}}",
         "query": "{{params.query}}",
         "visible": true,
         "require_unchanged": true,

package/library/recipes/{assets → shared/assets}/release-token-search-import.recipe.json

@@ -1,12 +1,13 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Assets release token search import",
-  "description": "Imports one token through live Manage tokens search and proves it appears in the token list.",
+  "description": "Requires a token that is not already enabled, imports it through live Manage tokens search, and proves it appears in the token list.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
       "query": { "type": "string", "default": "DAI" },
+      "asset_id": { "type": "string", "default": "", "description": "Optional exact ERC-20 identity on Extension to disambiguate search results; leave empty for Mobile query-only selection." },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
     }
   },
@@ -22,7 +23,9 @@
       "import-token": {
         "action": "metamask.assets.set_token_visibility",
         "query": "{{params.query}}",
+        "asset_id": "{{params.asset_id}}",
         "visible": true,
+        "require_change": true,
         "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Find the token through the live API and enable its management toggle",
         "next": "capture-imported-token"

package/library/recipes/{assets → shared/assets}/release-token-sorting.recipe.json

@@ -2,6 +2,17 @@
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Assets release token sorting",
   "description": "Exercises and verifies both token-list sort modes through visible product controls.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "capture_path": {
+        "type": "string",
+        "default": "screenshots/assets-sorted.png",
+        "description": "Final sort-state capture; pass distinct paths when composing repeated checks."
+      }
+    }
+  },
   "workflow": {
     "entry": "open-wallet",
     "nodes": {
@@ -18,8 +29,8 @@
       },
       "capture-sorted-list": {
         "action": "ui.screenshot",
-        "path": "screenshots/assets-sorted-high-low.png",
-        "label": "Assets sorted by declining balance",
+        "path": "{{params.capture_path}}",
+        "label": "Final asset sort state",
         "intent": "Preserve reviewer-visible sorted token list evidence",
         "next": "done"
       },

package/library/recipes/{swap-bridge → shared/swap-bridge}/release-quote.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Swap release quote",
-  "description": "Selects an exact live Swap pair, enters a capped amount, and proves a destination quote through visible product UI without submitting a transaction.",
+  "description": "Select an exact Swap pair, enter a fixed amount or use Max, and verify a reviewable destination quote without submitting. Extension quote identity requires exposed bridge quote state; an opaque build without it is not certified by UI amounts alone.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -14,7 +14,18 @@
       "destination_query": { "type": "string", "default": "WETH" },
       "source_asset_id": { "type": "string", "default": "" },
       "destination_asset_id": { "type": "string", "default": "" },
+      "amount_mode": {
+        "type": "string",
+        "enum": ["fixed", "max"],
+        "default": "fixed",
+        "description": "Enter amount or use the visible Max balance. Neither branch submits a transaction."
+      },
       "amount": { "type": "number", "minimum": 0.00000001, "default": 0.0001 },
+      "capture_path": {
+        "type": "string",
+        "default": "screenshots/swap-quote.png",
+        "description": "Use a distinct artifact path for each call when composing several quotes in one run."
+      },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
     }
   },
@@ -40,7 +51,22 @@
         "destination_asset_id": "{{params.destination_asset_id}}",
         "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Select the exact source and destination assets",
-        "next": "enter-amount"
+        "next": "choose-amount"
+      },
+      "choose-amount": {
+        "action": "switch",
+        "value": "{{params.amount_mode}}",
+        "equals": "max",
+        "cases": { "match": "use-max" },
+        "default": "enter-amount",
+        "intent": "Run only the requested amount-entry method"
+      },
+      "use-max": {
+        "action": "metamask.swap_bridge.set_max_amount",
+        "wait_for_quote": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Use the visible available source balance and wait for its quote",
+        "next": "assert-quote"
       },
       "enter-amount": {
         "action": "metamask.swap_bridge.set_amount",
@@ -62,7 +88,7 @@
       },
       "capture-quote": {
         "action": "ui.screenshot",
-        "path": "screenshots/swap-quote.png",
+        "path": "{{params.capture_path}}",
         "label": "Swap release quote",
         "intent": "Preserve reviewer-visible proof of the live quote",
         "next": "done"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.47.4",
+  "version": "0.49.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,10 +21,10 @@
   },
   "dependencies": {
     "@farmslot/agent-runtime": "0.8.1",
-    "@farmslot/expo-recipe": "0.8.1",
+    "@farmslot/expo-recipe": "0.9.0",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "0.21.0",
-    "@farmslot/recipe-harness": "0.15.1",
+    "@farmslot/recipe-harness": "0.16.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
     "es-module-lexer": "2.3.1",