@deeeed/metamask-harness 0.38.0 → 0.39.0

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

@@ -407,6 +407,14 @@
           "symbol": {
             "type": "string"
           },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "lite",
+              "pro"
+            ],
+            "default": "lite"
+          },
           "url": {
             "type": "string"
           },
@@ -1400,6 +1408,22 @@
       ],
       "execution_capabilities": ["app-mutation"]
     },
+    "metamask.wallet.lock": {
+      "description": "Lock the Mobile wallet through the visible menu and confirm the login screen.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.wallet.lock",
+        "intent": "Lock the wallet through visible native controls",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.wallet.select_account": {
       "description": "mobile action to select a wallet account by address, id, or display name.",
       "schema": {
@@ -1535,6 +1559,184 @@
       ],
       "execution_capabilities": ["host-read-export"]
     },
+    "metamask.assets.open_details": {
+      "description": "Open one visible Mobile asset by symbol through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "symbol": { "type": "string" },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["symbol"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.assets.open_details",
+        "symbol": "ETH",
+        "intent": "Open the funded ETH details",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.assets.read_details": {
+      "description": "Read and assert the visible Mobile token details surface through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "expected_symbol": { "type": "string" },
+          "require_chart": { "type": "boolean", "default": false },
+          "require_market_cap": { "type": "boolean", "default": false },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.assets.read_details",
+        "expected_symbol": "ETH",
+        "require_chart": true,
+        "require_market_cap": true,
+        "intent": "Prove current asset market data",
+        "next": "done"
+      }],
+      "execution_capabilities": ["host-read-export"]
+    },
+    "metamask.assets.verify_sorting": {
+      "description": "Select alphabetical and declining-fiat token sorting and assert the visible native row order.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.assets.verify_sorting",
+        "intent": "Verify both token-list sort modes",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.assets.set_token_visibility": {
+      "description": "Import or remove one Mobile token through visible native controls and verify the resulting state.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string" },
+          "visible": { "type": "boolean" },
+          "require_unchanged": { "type": "boolean", "default": false },
+          "require_change": { "type": "boolean", "default": false },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
+        },
+        "required": ["query", "visible"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.assets.set_token_visibility",
+        "query": "DAI",
+        "visible": true,
+        "intent": "Import DAI through visible token search",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.assets.import_custom_token": {
+      "description": "Import one ERC-20 on a selected Mobile network through the visible custom-token form and verify its row.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "network": { "type": "string" },
+          "chain_id": { "type": "integer", "minimum": 1 },
+          "address": { "type": "string" },
+          "expected_symbol": { "type": "string" },
+          "decimals": { "type": "integer", "minimum": 0 },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+        },
+        "required": ["network", "chain_id", "address", "expected_symbol"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.assets.import_custom_token",
+        "network": "Arbitrum",
+        "chain_id": 42161,
+        "address": "0xDA10009cbd5D07dd0CeCc66161FC93D7c9000da1",
+        "expected_symbol": "DAI",
+        "decimals": 18,
+        "intent": "Import Arbitrum DAI by contract address",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.networks.read_visible_state": {
+      "description": "Read one Mobile network from visible network settings and prove it persists across a bounded settle window.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "network": { "type": "string" },
+          "chain_id": { "type": "integer", "minimum": 1 },
+          "settle_ms": { "type": "integer", "minimum": 0, "default": 0 },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["network", "chain_id"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.networks.read_visible_state",
+        "network": "PulseChain",
+        "chain_id": 369,
+        "settle_ms": 1000,
+        "intent": "Prove PulseChain remains in Mobile network settings",
+        "next": "done"
+      }],
+      "execution_capabilities": ["host-read-export"]
+    },
+    "metamask.networks.add_custom": {
+      "description": "Add or locate one custom Mobile network through visible native network settings.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "network": { "type": "string" },
+          "rpc_url": { "type": "string" },
+          "chain_id": { "type": "integer", "minimum": 1 },
+          "symbol": { "type": "string" },
+          "explorer_url": { "type": "string" },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+        },
+        "required": ["network", "rpc_url", "chain_id", "symbol"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.networks.add_custom",
+        "network": "PulseChain",
+        "rpc_url": "https://rpc.pulsechain.com",
+        "chain_id": 369,
+        "symbol": "PLS",
+        "explorer_url": "https://scan.pulsechain.com",
+        "intent": "Add PulseChain through Mobile network settings",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.networks.remove_custom": {
+      "description": "Remove one custom Mobile network through visible native network settings.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "network": { "type": "string" },
+          "chain_id": { "type": "integer", "minimum": 1 },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["network", "chain_id"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.networks.remove_custom",
+        "network": "PulseChain",
+        "chain_id": 369,
+        "intent": "Remove PulseChain through Mobile network settings",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.swap_bridge.read_visible_state": {
       "description": "Read and assert the visible Swap surface from an opaque Mobile runtime through native accessibility.",
       "schema": {
@@ -1543,7 +1745,9 @@
           "source_symbol": { "type": "string" },
           "destination_symbol": { "type": "string" },
           "require_amount_inputs": { "type": "boolean", "default": true },
-          "require_settings": { "type": "boolean", "default": false }
+          "require_settings": { "type": "boolean", "default": false },
+          "require_quote": { "type": "boolean", "default": false },
+          "expected_slippage": { "type": "number", "minimum": 0 }
         },
         "additionalProperties": false
       },
@@ -1558,6 +1762,68 @@
       ],
       "execution_capabilities": ["host-read-export"]
     },
+    "metamask.swap_bridge.set_slippage": {
+      "description": "Set a custom Swap slippage percentage through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "percent": { "type": "number", "minimum": 0.01 },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["percent"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.swap_bridge.set_slippage",
+        "percent": 3,
+        "intent": "Set the release checklist custom slippage value",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.swap_bridge.submit_transaction": {
+      "description": "Submit an explicitly authorized live Mobile Swap and prove its terminal post-trade status and visible Activity entry.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "source_symbol": { "type": "string" },
+          "destination_symbol": { "type": "string" },
+          "amount": { "type": ["string", "number"] },
+          "confirm_live": { "type": "boolean", "default": false },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 300000 }
+        },
+        "required": ["source_symbol", "destination_symbol", "amount"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.swap_bridge.submit_transaction",
+        "source_symbol": "ETH",
+        "destination_symbol": "DAI",
+        "amount": "0.00005",
+        "confirm_live": true,
+        "intent": "Submit the authorized release-check Swap and prove its Activity entry",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation", "external-mutation"]
+    },
+    "metamask.swap_bridge.set_max_amount": {
+      "description": "Use the visible Swap Max control and wait for the derived live quote through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "wait_for_quote": { "type": "boolean", "default": true },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.swap_bridge.set_max_amount",
+        "wait_for_quote": true,
+        "intent": "Use the available token balance for the return Swap",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.swap_bridge.select_assets": {
       "description": "Select exact Swap source and destination assets through native accessibility.",
       "schema": {
@@ -1698,6 +1964,47 @@
       ],
       "execution_capabilities": ["host-read-export"]
     },
+    "metamask.perps.search_markets": {
+      "description": "Enter a Perps market query through native accessibility and prove visible results are returned.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string" },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["query"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.perps.search_markets",
+        "query": "Bitcoin",
+        "intent": "Filter the visible Perps market list",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.perps.set_market_favorite": {
+      "description": "Converge one visible Perps market watchlist state through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": { "type": "string" },
+          "favorite": { "type": "boolean" },
+          "require_unchanged": { "type": "boolean", "default": false },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+        },
+        "required": ["market", "favorite"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.perps.set_market_favorite",
+        "market": "BTC",
+        "favorite": true,
+        "intent": "Ensure BTC appears in the Perps watchlist",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.perps.read_positions": {
       "description": "mobile Read live Perps positions; without a selector, return all live positions.",
       "schema": {

package/library/recipes/assets/release-token-details.recipe.json

@@ -21,10 +21,10 @@
         "next": "open-first-asset"
       },
       "open-first-asset": {
-        "action": "ui.press",
-        "test_id": "multichain-token-list-button",
-        "settle": true,
-        "intent": "Open the first visible funded asset through a trusted pointer",
+        "action": "metamask.assets.open_details",
+        "symbol": "{{params.symbol}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open the requested visible funded asset",
         "next": "assert-details"
       },
       "assert-details": {
@@ -32,6 +32,7 @@
         "expected_symbol": "{{params.symbol}}",
         "require_chart": true,
         "require_market_cap": true,
+        "timeout_ms": "{{params.timeout_ms}}",
         "intent": "Prove live asset price history and market data render without malformed values",
         "next": "capture-details"
       },

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

@@ -23,6 +23,7 @@
         "action": "metamask.assets.set_token_visibility",
         "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"
@@ -38,6 +39,7 @@
         "action": "metamask.assets.set_token_visibility",
         "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"

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-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": {