@deeeed/metamask-harness 0.38.1 → 0.40.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/{assets → 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"
+      }
+    }
+  }
+}