@deeeed/metamask-harness 0.36.0 → 0.38.0

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

@@ -399,7 +399,7 @@
         "properties": {
           "page": {
             "type": "string",
-            "enum": ["home", "perps", "perps-market"]
+            "enum": ["home", "perps", "perps-market-list", "perps-market", "swap"]
           },
           "market": {
             "type": "string"
@@ -1316,6 +1316,22 @@
             "default": false,
             "description": "Enable MetaMetrics during visible onboarding."
           },
+          "biometrics": {
+            "type": "boolean",
+            "enum": [false],
+            "default": false,
+            "description": "Biometric authentication is disabled because unattended recipes cannot satisfy the device prompt."
+          },
+          "notifications": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable push notifications during Mobile onboarding; defaults off."
+          },
+          "skip_wallet_tour": {
+            "type": "boolean",
+            "default": true,
+            "description": "Skip the Mobile wallet-home tour after onboarding; defaults on so recipes reach a usable wallet."
+          },
           "interests": {
             "type": "array",
             "items": {
@@ -1464,6 +1480,224 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.assets.read_visible_state": {
+      "description": "Read and assert bounded visible wallet assets from an opaque Mobile runtime through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "minimum_asset_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "minimum_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "minimum_without_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "require_symbols": {
+            "type": "array",
+            "items": { "type": "string" },
+            "maxItems": 50
+          },
+          "require_fiat": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_price_change_styling": {
+            "type": "boolean",
+            "default": false
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.read_visible_state",
+          "minimum_asset_count": 2,
+          "require_symbols": ["USDC", "BNB"],
+          "require_fiat": true,
+          "minimum_price_change_count": 1,
+          "minimum_without_price_change_count": 1,
+          "intent": "Assert live wallet assets through native accessibility",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["host-read-export"]
+    },
+    "metamask.swap_bridge.read_visible_state": {
+      "description": "Read and assert the visible Swap surface from an opaque Mobile runtime through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "source_symbol": { "type": "string" },
+          "destination_symbol": { "type": "string" },
+          "require_amount_inputs": { "type": "boolean", "default": true },
+          "require_settings": { "type": "boolean", "default": false }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.read_visible_state",
+          "require_amount_inputs": true,
+          "require_settings": true,
+          "intent": "Assert the visible Swap surface",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["host-read-export"]
+    },
+    "metamask.swap_bridge.select_assets": {
+      "description": "Select exact Swap source and destination assets through native accessibility.",
+      "schema": {
+        "type": "object",
+        "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" },
+          "destination_asset_id": { "type": "string" },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+        },
+        "required": ["source_symbol", "destination_symbol", "source_chain", "destination_chain"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.swap_bridge.select_assets",
+        "source_symbol": "ETH",
+        "destination_symbol": "WETH",
+        "source_chain": "eip155:1",
+        "destination_chain": "eip155:1",
+        "intent": "Select the funded Swap pair",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.swap_bridge.set_amount": {
+      "description": "Enter a positive Swap amount through native accessibility and wait for a quote or explicit no-route state.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "amount": { "type": "number", "minimum": 0.00000001 },
+          "wait_for_quote": { "type": "boolean", "default": true },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+        },
+        "required": ["amount"],
+        "additionalProperties": false
+      },
+      "examples": [{
+        "action": "metamask.swap_bridge.set_amount",
+        "amount": 0.0001,
+        "intent": "Enter a capped Swap amount and wait for the quote",
+        "next": "done"
+      }],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.perps.read_visible_state": {
+      "description": "Read and assert bounded visible Perps UI state from an opaque Mobile runtime through native accessibility.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "surface": {
+            "type": "string",
+            "enum": ["auto", "home", "market-list", "market-details", "order-entry", "activity", "funds"],
+            "default": "auto"
+          },
+          "market": {
+            "type": "string",
+            "description": "Optional market that must be present in the visible state."
+          },
+          "minimum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_position_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_position_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_order_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_order_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_activity_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "forbid_test_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "maxItems": 100
+          },
+          "require_test_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "maxItems": 100
+          },
+          "require_features": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["activity", "balance", "chart", "long-short", "market-list", "order-entry", "price", "price-change", "stats"]
+            },
+            "maxItems": 9
+          },
+          "include_offscreen": {
+            "type": "boolean",
+            "default": true
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_visible_state",
+          "surface": "market-details",
+          "market": "ETH",
+          "require_features": ["price", "stats", "long-short"],
+          "intent": "Assert the selected live Perps market through native accessibility",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["host-read-export"]
+    },
     "metamask.perps.read_positions": {
       "description": "mobile Read live Perps positions; without a selector, return all live positions.",
       "schema": {

package/library/recipes/assets/release-custom-gas-send.recipe.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assets release custom-gas token send",
+  "description": "Applies a custom gas limit to a tiny token send and proves the confirmed Activity details.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_address": { "type": "string", "default": "0x8dc623e964475d4d669da601fd15ea9125469003" },
+      "network": { "type": "string", "default": "Arbitrum" },
+      "chain_id": { "type": "integer", "minimum": 1, "default": 42161 },
+      "symbol": { "type": "string", "default": "USDC" },
+      "recipient": { "type": "string", "default": "0x5993d2153f080470bfe765ae81f4fa5fa2080916" },
+      "amount": { "type": ["string", "number"], "default": "0.01" },
+      "gas_limit": { "type": ["string", "number"], "default": 70000 },
+      "confirm_live": { "type": "boolean", "default": false },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 120000 }
+    }
+  },
+  "workflow": {
+    "entry": "select-source",
+    "nodes": {
+      "select-source": {
+        "action": "metamask.wallet.select_account",
+        "address": "{{params.source_address}}",
+        "intent": "Select the funded source account",
+        "next": "select-network"
+      },
+      "select-network": {
+        "action": "ui.navigate",
+        "page": "network",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "add_if_missing": false,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the funded token network",
+        "next": "prepare-send"
+      },
+      "prepare-send": {
+        "action": "metamask.assets.prepare_send",
+        "symbol": "{{params.symbol}}",
+        "recipient": "{{params.recipient}}",
+        "amount": "{{params.amount}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prepare the tiny token send",
+        "next": "review-send"
+      },
+      "review-send": {
+        "action": "metamask.assets.review_send",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Open the send confirmation",
+        "next": "set-custom-gas"
+      },
+      "set-custom-gas": {
+        "action": "metamask.assets.set_custom_gas",
+        "gas_limit": "{{params.gas_limit}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Apply and prove the requested custom gas limit",
+        "next": "capture-confirmation"
+      },
+      "capture-confirmation": {
+        "action": "ui.screenshot",
+        "path": "screenshots/assets-custom-gas-confirmation.png",
+        "label": "Custom-gas token send confirmation",
+        "intent": "Preserve the custom-gas review evidence",
+        "next": "finish-send"
+      },
+      "finish-send": {
+        "action": "metamask.assets.finish_send",
+        "decision": "confirm",
+        "symbol": "{{params.symbol}}",
+        "amount": "{{params.amount}}",
+        "confirm_live": "{{params.confirm_live}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Confirm the authorized tiny custom-gas send and prove Activity details",
+        "next": "capture-confirmed"
+      },
+      "capture-confirmed": {
+        "action": "ui.screenshot",
+        "path": "screenshots/assets-custom-gas-confirmed.png",
+        "label": "Custom-gas token send confirmed",
+        "intent": "Preserve the confirmed custom-gas transaction evidence",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/assets/release-custom-network-token-persistence.recipe.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assets release custom-network token persistence",
+  "description": "Adds PulseChain and PLSX, proves both survive lock/unlock, then removes the custom network.",
+  "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 },
+      "native_symbol": { "type": "string", "default": "PLS" },
+      "explorer_url": { "type": "string", "default": "https://scan.pulsechain.com" },
+      "token_address": { "type": "string", "default": "0x95B303987A60C71504D99Aa1b13B4DA07b0790ab" },
+      "token_symbol": { "type": "string", "default": "PLSX" },
+      "token_decimals": { "type": "integer", "minimum": 0, "default": 18 },
+      "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.native_symbol}}",
+        "explorer_url": "{{params.explorer_url}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Add and select the custom network through visible settings",
+        "next": "import-token"
+      },
+      "import-token": {
+        "action": "metamask.assets.import_custom_token",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "address": "{{params.token_address}}",
+        "expected_symbol": "{{params.token_symbol}}",
+        "decimals": "{{params.token_decimals}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Import the custom-network token and verify its metadata",
+        "next": "capture-before"
+      },
+      "capture-before": {
+        "action": "ui.screenshot",
+        "path": "screenshots/custom-network-token-before-lock.png",
+        "label": "Custom network token before lock",
+        "intent": "Preserve pre-lock PulseChain and PLSX evidence",
+        "next": "lock-wallet"
+      },
+      "lock-wallet": {
+        "action": "metamask.wallet.lock",
+        "intent": "Lock the wallet through visible UI",
+        "next": "unlock-wallet"
+      },
+      "unlock-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Unlock the same persisted profile",
+        "next": "select-persisted-network"
+      },
+      "select-persisted-network": {
+        "action": "ui.navigate",
+        "page": "network",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "add_if_missing": false,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove the custom network persisted and select it",
+        "next": "assert-persisted-token"
+      },
+      "assert-persisted-token": {
+        "action": "metamask.networks.read_visible_state",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "require_symbols": ["{{params.token_symbol}}"],
+        "minimum_asset_count": 1,
+        "settle_ms": 1000,
+        "intent": "Prove the custom token persisted on the custom network",
+        "next": "capture-after"
+      },
+      "capture-after": {
+        "action": "ui.screenshot",
+        "path": "screenshots/custom-network-token-after-unlock.png",
+        "label": "Custom network token after unlock",
+        "intent": "Preserve post-unlock PulseChain and PLSX 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 its token during cleanup",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/assets/release-native-max-cancel.recipe.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assets release native Max cancellation",
+  "description": "Prepares a native Max send, proves the fee-adjusted review, and cancels without broadcasting.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_address": { "type": "string", "default": "0x8dc623e964475d4d669da601fd15ea9125469003" },
+      "network": { "type": "string", "default": "Ethereum" },
+      "chain_id": { "type": "integer", "minimum": 1, "default": 1 },
+      "symbol": { "type": "string", "default": "ETH" },
+      "recipient": { "type": "string", "default": "0x5993d2153f080470bfe765ae81f4fa5fa2080916" },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+    }
+  },
+  "workflow": {
+    "entry": "select-source",
+    "nodes": {
+      "select-source": {
+        "action": "metamask.wallet.select_account",
+        "address": "{{params.source_address}}",
+        "intent": "Select the funded source account",
+        "next": "select-network"
+      },
+      "select-network": {
+        "action": "ui.navigate",
+        "page": "network",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "add_if_missing": false,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the native asset network",
+        "next": "prepare-max"
+      },
+      "prepare-max": {
+        "action": "metamask.assets.prepare_send",
+        "symbol": "{{params.symbol}}",
+        "recipient": "{{params.recipient}}",
+        "max": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prepare a fee-adjusted native Max send",
+        "next": "review-max"
+      },
+      "review-max": {
+        "action": "metamask.assets.review_send",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove the Max amount and network fee at review",
+        "next": "capture-max"
+      },
+      "capture-max": {
+        "action": "ui.screenshot",
+        "path": "screenshots/assets-native-max-review.png",
+        "label": "Native Max send review",
+        "intent": "Preserve the fee-adjusted Max evidence",
+        "next": "cancel-max"
+      },
+      "cancel-max": {
+        "action": "metamask.assets.finish_send",
+        "decision": "cancel",
+        "symbol": "{{params.symbol}}",
+        "amount": "max",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Cancel the Max send without broadcasting",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}

package/library/recipes/assets/release-native-max-send.recipe.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Assets release native Max self-send",
+  "description": "Submits a native Max self-send and proves its confirmed Activity details.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "source_address": { "type": "string", "default": "0x8dc623e964475d4d669da601fd15ea9125469003" },
+      "network": { "type": "string", "default": "Ethereum" },
+      "chain_id": { "type": "integer", "minimum": 1, "default": 1 },
+      "symbol": { "type": "string", "default": "ETH" },
+      "confirm_live": { "type": "boolean", "default": false },
+      "timeout_ms": { "type": "integer", "minimum": 1000, "default": 120000 }
+    }
+  },
+  "workflow": {
+    "entry": "select-source",
+    "nodes": {
+      "select-source": {
+        "action": "metamask.wallet.select_account",
+        "address": "{{params.source_address}}",
+        "intent": "Select the funded source account",
+        "next": "select-network"
+      },
+      "select-network": {
+        "action": "ui.navigate",
+        "page": "network",
+        "network": "{{params.network}}",
+        "chain_id": "{{params.chain_id}}",
+        "add_if_missing": false,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Select the native asset network",
+        "next": "prepare-max"
+      },
+      "prepare-max": {
+        "action": "metamask.assets.prepare_send",
+        "symbol": "{{params.symbol}}",
+        "recipient": "{{params.source_address}}",
+        "max": true,
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prepare a native Max self-send",
+        "next": "review-max"
+      },
+      "review-max": {
+        "action": "metamask.assets.review_send",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Prove the confirmation amount and network fee",
+        "next": "capture-confirmation"
+      },
+      "capture-confirmation": {
+        "action": "ui.screenshot",
+        "path": "screenshots/assets-native-max-send-confirmation.png",
+        "label": "Native Max self-send confirmation",
+        "intent": "Preserve the reviewed Max evidence",
+        "next": "finish-send"
+      },
+      "finish-send": {
+        "action": "metamask.assets.finish_send",
+        "decision": "confirm",
+        "symbol": "{{params.symbol}}",
+        "amount": "max",
+        "confirm_live": "{{params.confirm_live}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Submit the authorized Max self-send and prove confirmed Activity details",
+        "next": "capture-confirmed"
+      },
+      "capture-confirmed": {
+        "action": "ui.screenshot",
+        "path": "screenshots/assets-native-max-send-confirmed.png",
+        "label": "Native Max self-send confirmed",
+        "intent": "Preserve the confirmed self-send evidence",
+        "next": "done"
+      },
+      "done": { "action": "end", "status": "pass" }
+    }
+  }
+}