@deeeed/metamask-harness 0.35.0 → 0.36.0

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

@@ -1237,6 +1237,45 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.wallet.validate_import": {
+      "description": "Validate wallet recovery credentials and derive the expected primary address without launching or mutating the app.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "credential_source": {
+            "type": "string",
+            "enum": ["auto", "environment", "fixture"]
+          },
+          "srp_env": {
+            "type": "string"
+          },
+          "password_env": {
+            "type": "string"
+          },
+          "metametrics": {
+            "type": "boolean"
+          },
+          "interests": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.validate_import",
+          "credential_source": "auto",
+          "intent": "Validate recovery credentials before resetting a wallet",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "host-read-export"
+      ]
+    },
     "metamask.wallet.setup": {
       "description": "Import the wallet fixture accounts and password so the app starts from a known signed-in state.",
       "schema": {
@@ -1253,6 +1292,75 @@
       ],
       "execution_capabilities": ["app-mutation"]
     },
+    "metamask.wallet.import": {
+      "description": "Make the wallet ready by reusing a fixture-backed profile or importing the primary mnemonic through visible onboarding UI.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "method": {
+            "type": "string",
+            "enum": ["auto", "profile", "ui"]
+          },
+          "credential_source": {
+            "type": "string",
+            "enum": ["auto", "environment", "fixture"]
+          },
+          "srp_env": {
+            "type": "string"
+          },
+          "password_env": {
+            "type": "string"
+          },
+          "metametrics": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable MetaMetrics during visible onboarding."
+          },
+          "interests": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+            },
+            "default": [],
+            "description": "Select optional onboarding interests; an empty list skips the questionnaire."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.import",
+          "method": "auto",
+          "intent": "Use an existing fixture profile or import through onboarding",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.wallet.reset": {
+      "description": "Delete the current wallet through the visible client reset flow and reach fresh onboarding.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.reset",
+          "intent": "Reset the wallet through visible UI before importing it again",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.wallet.ensure_unlocked": {
       "description": "Unlock the wallet with the fixture password when it is currently locked.",
       "schema": {

package/library/recipes/wallet/import.recipe.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Import or reuse a MetaMask wallet",
+  "description": "Make a Mobile or Extension wallet ready by reusing its fixture-backed profile or importing the primary mnemonic through visible onboarding UI.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "method": {
+        "type": "string",
+        "enum": ["auto", "profile", "ui"],
+        "default": "auto",
+        "description": "Choose automatically from visible wallet state, require an existing profile, or require real-user onboarding UI."
+      },
+      "credential_source": {
+        "type": "string",
+        "enum": ["auto", "environment", "fixture"],
+        "default": "auto",
+        "description": "Read secrets from the named environment variables first, or require one source explicitly."
+      },
+      "srp_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_SRP",
+        "description": "Environment variable containing the Secret Recovery Phrase; the value is never stored in the recipe or evidence."
+      },
+      "password_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_PASSWORD",
+        "description": "Environment variable containing the wallet password; the value is never stored in the recipe or evidence."
+      },
+      "metametrics": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable MetaMetrics during visible onboarding; defaults off."
+      },
+      "interests": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+        },
+        "default": [],
+        "description": "Mobile-only onboarding interests; an empty list skips the optional questionnaire."
+      },
+      "timeout_ms": {
+        "type": "number",
+        "default": 120000,
+        "description": "Maximum time for each onboarding transition and final wallet readiness."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "fixture-status",
+    "nodes": {
+      "fixture-status": {
+        "action": "metamask.wallet.fixture_status",
+        "intent": "Record whether a canonical fixture is available without exposing its secrets",
+        "next": "import"
+      },
+      "import": {
+        "action": "metamask.wallet.import",
+        "method": "{{params.method}}",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Reuse the fixture-backed wallet or import it through the visible onboarding flow",
+        "next": "state"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "intent": "Prove the wallet has a selected account after setup",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/wallet/reset-import.recipe.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Reset and import a MetaMask wallet through visible UI",
+  "description": "Delete the current Mobile or Extension wallet through its visible reset flow, import the primary mnemonic through onboarding, and prove a selected account is ready.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "credential_source": {
+        "type": "string",
+        "enum": ["auto", "environment", "fixture"],
+        "default": "auto",
+        "description": "Read secrets from the named environment variables first, or require one source explicitly."
+      },
+      "srp_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_SRP",
+        "description": "Environment variable containing the Secret Recovery Phrase; the value is never stored in the recipe or evidence."
+      },
+      "password_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_PASSWORD",
+        "description": "Environment variable containing the wallet password; the value is never stored in the recipe or evidence."
+      },
+      "metametrics": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable MetaMetrics during visible onboarding; defaults off."
+      },
+      "interests": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+        },
+        "default": [],
+        "description": "Mobile-only onboarding interests; an empty list skips the optional questionnaire."
+      },
+      "timeout_ms": {
+        "type": "number",
+        "default": 120000,
+        "description": "Maximum time for each reset/import transition and final wallet readiness."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "validate_import",
+    "nodes": {
+      "validate_import": {
+        "action": "metamask.wallet.validate_import",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "intent": "Validate recovery credentials before deleting the current wallet",
+        "next": "reset"
+      },
+      "reset": {
+        "action": "metamask.wallet.reset",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Delete the current wallet through the client-visible reset flow and reach fresh onboarding",
+        "next": "import"
+      },
+      "import": {
+        "action": "metamask.wallet.import",
+        "method": "ui",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Import the primary mnemonic through visible onboarding UI",
+        "next": "state"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "intent": "Prove the imported wallet has a selected account",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"

package/scripts/completions.sh

@@ -77,7 +77,7 @@ if [ -n "${BASH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "ios android" -- "$cur")) ;;
-      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set generate finalize" -- "$cur")) ;;
+      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set reset generate finalize" -- "$cur")) ;;
       checklist)   [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "mark closeout" -- "$cur")) ;;
       completions) [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "install bash zsh status" -- "$cur")) ;;
       call)        [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "$(_mmh_actions)" -- "$cur")) ;;
@@ -111,7 +111,7 @@ if [ -n "${ZSH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      (( CURRENT == 3 )) && { candidates=(ios android); compadd -a candidates; } ;;
-      fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set generate finalize); compadd -a candidates; } ;;
+      fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set reset generate finalize); compadd -a candidates; } ;;
       checklist)   (( CURRENT == 3 )) && { candidates=(mark closeout); compadd -a candidates; } ;;
       completions) (( CURRENT == 3 )) && { candidates=(install bash zsh status); compadd -a candidates; } ;;
       call)        (( CURRENT == 3 )) && { candidates=("${(@f)$(_mmh_actions)}"); compadd -a candidates; } ;;