@deeeed/metamask-harness 0.36.0 → 0.38.0

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

@@ -0,0 +1,83 @@
+{
+  "$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.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "ETH",
+        "description": "Perps market symbol to open and verify."
+      },
+      "timeout_ms": {
+        "type": "integer",
+        "minimum": 1000,
+        "default": 45000
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "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",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Show the complete live Perps market selection",
+        "next": "assert-market-list"
+      },
+      "assert-market-list": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-list",
+        "market": "{{params.market}}",
+        "minimum_market_count": 2,
+        "require_features": ["market-list"],
+        "max_items": 100,
+        "intent": "Prove the requested market appears in a populated live market list",
+        "next": "open-market"
+      },
+      "open-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open the requested Perps market through visible product controls",
+        "next": "assert-market"
+      },
+      "assert-market": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-details",
+        "market": "{{params.market}}",
+        "require_features": [
+          "price",
+          "price-change",
+          "stats",
+          "long-short"
+        ],
+        "max_items": 100,
+        "intent": "Prove the selected market, live pricing, statistics, and trade directions are visible",
+        "next": "capture-market"
+      },
+      "capture-market": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-market-details.png",
+        "label": "Perps release market details",
+        "intent": "Preserve reviewer-visible proof of the selected live market",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release market search",
+  "description": "Searches the live Perps market list by product name through trusted keyboard input and proves the filtered result set without development-only bridges.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "query": {
+        "type": "string",
+        "default": "Bitcoin"
+      },
+      "expected_market": {
+        "type": "string",
+        "default": "BTC"
+      },
+      "maximum_results": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 3
+      }
+    }
+  },
+  "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": "Show the complete live Perps market selection",
+        "next": "assert-unfiltered"
+      },
+      "assert-unfiltered": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-list",
+        "minimum_market_count": 20,
+        "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}}",
+        "intent": "Enter the market search through trusted keyboard input",
+        "next": "assert-filtered"
+      },
+      "assert-filtered": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "market-list",
+        "market": "{{params.expected_market}}",
+        "minimum_market_count": 1,
+        "maximum_market_count": "{{params.maximum_results}}",
+        "require_features": ["market-list"],
+        "max_items": 100,
+        "intent": "Prove the search reduced the list and retained the requested market",
+        "next": "capture"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-market-search.png",
+        "label": "Perps release market search",
+        "intent": "Preserve reviewer-visible proof of the filtered market list",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Perps release watchlist persistence",
+  "description": "Adds and removes one live Perps market favorite and proves both states after navigating away and back.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "BTC"
+      }
+    }
+  },
+  "workflow": {
+    "entry": "open-perps",
+    "nodes": {
+      "open-perps": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show the Perps home surface",
+        "next": "open-market-list"
+      },
+      "open-market-list": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Show the complete market list",
+        "next": "open-market"
+      },
+      "open-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Open the market to update its favorite state",
+        "next": "add-favorite"
+      },
+      "add-favorite": {
+        "action": "metamask.perps.set_market_favorite",
+        "market": "{{params.market}}",
+        "favorite": true,
+        "intent": "Ensure the market is added to favorites",
+        "next": "return-home-added"
+      },
+      "return-home-added": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show Perps home after adding the favorite",
+        "next": "assert-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": {
+        "action": "ui.navigate",
+        "page": "perps-market-list",
+        "intent": "Reopen the complete market list",
+        "next": "reopen-market"
+      },
+      "reopen-market": {
+        "action": "ui.navigate",
+        "page": "perps-market",
+        "market": "{{params.market}}",
+        "intent": "Reopen the favorited market",
+        "next": "remove-favorite"
+      },
+      "remove-favorite": {
+        "action": "metamask.perps.set_market_favorite",
+        "market": "{{params.market}}",
+        "favorite": false,
+        "intent": "Ensure the market is removed from favorites",
+        "next": "return-home-removed"
+      },
+      "return-home-removed": {
+        "action": "ui.navigate",
+        "page": "perps",
+        "intent": "Show Perps home after removing the favorite",
+        "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",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/swap-bridge/release-custom-slippage.recipe.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Swap release custom slippage",
+  "description": "Selects a live Swap pair, obtains a quote, sets custom slippage, and proves the configured value through visible product UI.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_symbol": { "type": "string", "default": "ETH" },
+      "destination_symbol": { "type": "string", "default": "WETH" },
+      "source_chain": { "type": "string", "default": "eip155:1" },
+      "destination_chain": { "type": "string", "default": "eip155:1" },
+      "source_query": { "type": "string", "default": "ETH" },
+      "destination_query": { "type": "string", "default": "WETH" },
+      "source_asset_id": { "type": "string", "default": "" },
+      "destination_asset_id": { "type": "string", "default": "" },
+      "amount": { "type": "number", "minimum": 0.00000001, "default": 0.0001 },
+      "slippage": { "type": "number", "minimum": 0.01, "default": 3 },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+    }
+  },
+  "workflow": {
+    "entry": "open-swap",
+    "nodes": {
+      "open-swap": {
+        "action": "ui.navigate",
+        "page": "swap",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open Swap through visible product navigation",
+        "next": "select-assets"
+      },
+      "select-assets": {
+        "action": "metamask.swap_bridge.select_assets",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "source_chain": "{{params.source_chain}}",
+        "destination_chain": "{{params.destination_chain}}",
+        "source_query": "{{params.source_query}}",
+        "destination_query": "{{params.destination_query}}",
+        "source_asset_id": "{{params.source_asset_id}}",
+        "destination_asset_id": "{{params.destination_asset_id}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the exact source and destination assets",
+        "next": "enter-amount"
+      },
+      "enter-amount": {
+        "action": "metamask.swap_bridge.set_amount",
+        "amount": "{{params.amount}}",
+        "wait_for_quote": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Enter the capped amount and wait for a live quote",
+        "next": "set-slippage"
+      },
+      "set-slippage": {
+        "action": "metamask.swap_bridge.set_slippage",
+        "percent": "{{params.slippage}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Set the checklist custom slippage value",
+        "next": "assert-quote"
+      },
+      "assert-quote": {
+        "action": "metamask.swap_bridge.read_visible_state",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "require_amount_inputs": true,
+        "require_settings": true,
+        "require_quote": true,
+        "expected_slippage": "{{params.slippage}}",
+        "intent": "Prove the live quote retains the custom slippage value",
+        "next": "wait-for-quote-display"
+      },
+      "wait-for-quote-display": {
+        "action": "ui.wait_for",
+        "test_id": "minimum-received",
+        "expected": "visible",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Confirm the refreshed quote is visible",
+        "next": "capture-quote"
+      },
+      "capture-quote": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-custom-slippage.png",
+        "label": "Swap custom slippage",
+        "intent": "Preserve reviewer-visible proof of the configured live quote",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/swap-bridge/release-live-max-swap.recipe.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Swap release live Max transaction",
+  "description": "Runs an explicitly authorized Max Swap through confirmed Activity and destination-balance proof.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_symbol": { "type": "string", "default": "USDC" },
+      "destination_symbol": { "type": "string", "default": "ETH" },
+      "source_chain": { "type": "string", "default": "eip155:1" },
+      "destination_chain": { "type": "string", "default": "eip155:1" },
+      "source_query": { "type": "string", "default": "USDC" },
+      "destination_query": { "type": "string", "default": "ETH" },
+      "source_asset_id": { "type": "string", "default": "" },
+      "destination_asset_id": { "type": "string", "default": "" },
+      "slippage": { "type": "number", "minimum": 0.01, "default": 3 },
+      "confirm_live": { "type": "boolean", "default": false },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 },
+      "transaction_timeout_ms": { "type": "integer", "minimum": 1000, "default": 300000 }
+    }
+  },
+  "workflow": {
+    "entry": "open-swap",
+    "nodes": {
+      "open-swap": {
+        "action": "ui.navigate",
+        "page": "swap",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open Swap through visible product navigation",
+        "next": "select-assets"
+      },
+      "select-assets": {
+        "action": "metamask.swap_bridge.select_assets",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "source_chain": "{{params.source_chain}}",
+        "destination_chain": "{{params.destination_chain}}",
+        "source_query": "{{params.source_query}}",
+        "destination_query": "{{params.destination_query}}",
+        "source_asset_id": "{{params.source_asset_id}}",
+        "destination_asset_id": "{{params.destination_asset_id}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the exact return pair",
+        "next": "use-max"
+      },
+      "use-max": {
+        "action": "metamask.swap_bridge.set_max_amount",
+        "wait_for_quote": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Use the visible available token balance",
+        "next": "set-slippage"
+      },
+      "set-slippage": {
+        "action": "metamask.swap_bridge.set_slippage",
+        "percent": "{{params.slippage}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Set the checklist custom slippage value",
+        "next": "assert-quote"
+      },
+      "assert-quote": {
+        "action": "metamask.swap_bridge.read_visible_state",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "require_amount_inputs": true,
+        "require_settings": true,
+        "require_quote": true,
+        "expected_slippage": "{{params.slippage}}",
+        "intent": "Prove the Max return quote and custom slippage",
+        "next": "capture-quote"
+      },
+      "capture-quote": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-live-max-quote.png",
+        "label": "Authorized live Max Swap quote",
+        "intent": "Preserve the reviewed Max quote before submission",
+        "next": "submit-transaction"
+      },
+      "submit-transaction": {
+        "action": "metamask.swap_bridge.submit_transaction",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "amount": "visible",
+        "confirm_live": "{{params.confirm_live}}",
+        "timeout_ms": "{{params.transaction_timeout_ms}}",
+        "intent": "Submit the authorized Max Swap and prove confirmed Activity details",
+        "next": "capture-confirmed"
+      },
+      "capture-confirmed": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-live-max-confirmed.png",
+        "label": "Confirmed live Max Swap",
+        "intent": "Preserve the confirmed destination balance evidence",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/swap-bridge/release-live-swap.recipe.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Swap release live transaction",
+  "description": "Runs an explicitly authorized live Swap from pair selection through confirmed Activity and destination-balance proof.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_symbol": { "type": "string", "default": "ETH" },
+      "destination_symbol": { "type": "string", "default": "USDC" },
+      "source_chain": { "type": "string", "default": "eip155:1" },
+      "destination_chain": { "type": "string", "default": "eip155:1" },
+      "source_query": { "type": "string", "default": "ETH" },
+      "destination_query": { "type": "string", "default": "USDC" },
+      "source_asset_id": { "type": "string", "default": "" },
+      "destination_asset_id": { "type": "string", "default": "" },
+      "amount": { "type": "number", "minimum": 0.00000001, "default": 0.002 },
+      "slippage": { "type": "number", "minimum": 0.01, "default": 3 },
+      "confirm_live": { "type": "boolean", "default": false },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 },
+      "transaction_timeout_ms": { "type": "integer", "minimum": 1000, "default": 300000 }
+    }
+  },
+  "workflow": {
+    "entry": "open-swap",
+    "nodes": {
+      "open-swap": {
+        "action": "ui.navigate",
+        "page": "swap",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open Swap through visible product navigation",
+        "next": "select-assets"
+      },
+      "select-assets": {
+        "action": "metamask.swap_bridge.select_assets",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "source_chain": "{{params.source_chain}}",
+        "destination_chain": "{{params.destination_chain}}",
+        "source_query": "{{params.source_query}}",
+        "destination_query": "{{params.destination_query}}",
+        "source_asset_id": "{{params.source_asset_id}}",
+        "destination_asset_id": "{{params.destination_asset_id}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the exact source and destination assets",
+        "next": "enter-amount"
+      },
+      "enter-amount": {
+        "action": "metamask.swap_bridge.set_amount",
+        "amount": "{{params.amount}}",
+        "wait_for_quote": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Enter the authorized live amount and wait for a quote",
+        "next": "set-slippage"
+      },
+      "set-slippage": {
+        "action": "metamask.swap_bridge.set_slippage",
+        "percent": "{{params.slippage}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Set the checklist custom slippage value",
+        "next": "assert-quote"
+      },
+      "assert-quote": {
+        "action": "metamask.swap_bridge.read_visible_state",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "require_amount_inputs": true,
+        "require_settings": true,
+        "require_quote": true,
+        "expected_slippage": "{{params.slippage}}",
+        "intent": "Prove the authorized live quote and custom slippage",
+        "next": "capture-quote"
+      },
+      "capture-quote": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-live-quote.png",
+        "label": "Authorized live Swap quote",
+        "intent": "Preserve the reviewed quote before live submission",
+        "next": "submit-transaction"
+      },
+      "submit-transaction": {
+        "action": "metamask.swap_bridge.submit_transaction",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "amount": "{{params.amount}}",
+        "confirm_live": "{{params.confirm_live}}",
+        "timeout_ms": "{{params.transaction_timeout_ms}}",
+        "intent": "Submit the authorized live Swap and prove confirmed Activity details",
+        "next": "capture-confirmed"
+      },
+      "capture-confirmed": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-live-confirmed.png",
+        "label": "Confirmed live Swap",
+        "intent": "Preserve the confirmed destination balance evidence",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/swap-bridge/release-max-quote.recipe.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Swap release Max quote",
+  "description": "Selects an exact live pair, uses the visible Max balance, and proves the resulting quote without submission.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_symbol": { "type": "string" },
+      "destination_symbol": { "type": "string" },
+      "source_chain": { "type": "string" },
+      "destination_chain": { "type": "string" },
+      "source_query": { "type": "string" },
+      "destination_query": { "type": "string" },
+      "source_asset_id": { "type": "string", "default": "" },
+      "destination_asset_id": { "type": "string", "default": "" },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 120000 }
+    },
+    "required": ["source_symbol", "destination_symbol", "source_chain", "destination_chain", "source_query", "destination_query"]
+  },
+  "workflow": {
+    "entry": "open-swap",
+    "nodes": {
+      "open-swap": {
+        "action": "ui.navigate",
+        "page": "swap",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open Swap through visible product navigation",
+        "next": "select-assets"
+      },
+      "select-assets": {
+        "action": "metamask.swap_bridge.select_assets",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "source_chain": "{{params.source_chain}}",
+        "destination_chain": "{{params.destination_chain}}",
+        "source_query": "{{params.source_query}}",
+        "destination_query": "{{params.destination_query}}",
+        "source_asset_id": "{{params.source_asset_id}}",
+        "destination_asset_id": "{{params.destination_asset_id}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the exact source and destination assets",
+        "next": "use-max"
+      },
+      "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",
+        "next": "assert-quote"
+      },
+      "assert-quote": {
+        "action": "metamask.swap_bridge.read_visible_state",
+        "source_symbol": "{{params.source_symbol}}",
+        "destination_symbol": "{{params.destination_symbol}}",
+        "require_amount_inputs": true,
+        "require_settings": true,
+        "require_quote": true,
+        "intent": "Prove the selected pair and Max quote remain visible",
+        "next": "capture-quote"
+      },
+      "capture-quote": {
+        "action": "ui.screenshot",
+        "path": "screenshots/swap-max-quote.png",
+        "label": "Swap Max quote",
+        "intent": "Preserve reviewer-visible proof of the Max quote",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}