@deeeed/metamask-harness 0.8.0 → 0.9.0

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

@@ -407,13 +407,330 @@
           }
         }
       ]
+    },
+    "app.status": {
+      "description": "Report the adapter's static status — platform, project root, resolved checkout shape, and headless compatibility mode (no live route or account).",
+      "examples": [
+        {
+          "node": {
+            "action": "app.status",
+            "intent": "Report the resolved checkout status"
+          }
+        }
+      ]
+    },
+    "cdp.target": {
+      "description": "Probe the platform debug transport — Chrome CDP for extension, the React Native debug bridge for mobile — and report whether it is reachable.",
+      "examples": [
+        {
+          "node": {
+            "action": "cdp.target",
+            "require_reachable": true,
+            "intent": "Confirm the mobile React Native debug bridge is reachable"
+          }
+        }
+      ]
+    },
+    "metamask.wallet.fixture_status": {
+      "description": "Report the on-disk wallet fixture status (accounts and password presence) without launching or mutating the app.",
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.fixture_status",
+            "intent": "Check wallet fixture status"
+          }
+        }
+      ]
+    },
+    "metamask.wallet.setup": {
+      "description": "Import the wallet fixture accounts and password so the app starts from a known signed-in state.",
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.setup",
+            "intent": "Prepare the wallet fixture for recipe execution"
+          }
+        }
+      ]
+    },
+    "metamask.wallet.ensure_unlocked": {
+      "description": "Unlock the wallet with the fixture password when it is currently locked.",
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.ensure_unlocked",
+            "intent": "Ensure the wallet is unlocked before proof steps"
+          }
+        }
+      ]
+    },
+    "metamask.wallet.select_account": {
+      "description": "Select a wallet account by address, id, or display name.",
+      "examples": [
+        {
+          "description": "Select by deterministic fixture address",
+          "node": {
+            "action": "metamask.wallet.select_account",
+            "address": "0x8dc623e964475d4d669da601fd15ea9125469003",
+            "intent": "Select the requested wallet account"
+          }
+        },
+        {
+          "description": "Select by fixture display name",
+          "node": {
+            "action": "metamask.wallet.select_account",
+            "name": "dev1",
+            "intent": "Select the requested wallet account"
+          }
+        }
+      ]
+    },
+    "metamask.wallet.read_state": {
+      "description": "Read the redacted wallet state (selected account, route, and device) from the running app.",
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.read_state",
+            "intent": "Read wallet state needed for the proof"
+          }
+        }
+      ]
+    },
+    "metamask.perps.read_positions": {
+      "description": "Read live Perps positions and return the selected subset.",
+      "examples": [
+        {
+          "description": "Read selected live state",
+          "node": {
+            "action": "metamask.perps.read_positions",
+            "market": "BTC",
+            "intent": "Read Perps positions needed for the proof"
+          }
+        }
+      ]
+    },
+    "metamask.perps.read_orders": {
+      "description": "Read live Perps open orders and return the selected subset.",
+      "examples": [
+        {
+          "description": "Read selected live state",
+          "node": {
+            "action": "metamask.perps.read_orders",
+            "market": "BTC",
+            "intent": "Read Perps open orders needed for the proof"
+          }
+        }
+      ]
+    },
+    "metamask.perps.close_positions": {
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Close selected live Perps positions. Use selector/mode params to close matching symbols or all positions. The network field in examples is an authoring convention: only start_state/teardown_state enforce the network (ensureNetwork); the mutation handlers themselves do not read it.",
+      "examples": [
+        {
+          "description": "Close every open position",
+          "node": {
+            "action": "metamask.perps.close_positions",
+            "mode": "all",
+            "intent": "Close selected Perps positions before continuing",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Close selected BTC/ETH positions",
+          "node": {
+            "action": "metamask.perps.close_positions",
+            "markets": [
+              "BTC",
+              "ETH"
+            ],
+            "intent": "Close selected Perps positions before continuing",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.close_orders": {
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Cancel selected live Perps open orders. Use selector/mode params to cancel matching symbols or all orders. The network field in examples is an authoring convention: only start_state/teardown_state enforce the network (ensureNetwork); the mutation handlers themselves do not read it.",
+      "examples": [
+        {
+          "description": "Cancel every open order",
+          "node": {
+            "action": "metamask.perps.close_orders",
+            "mode": "all",
+            "intent": "Cancel selected Perps orders before continuing",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Cancel BTC orders only",
+          "node": {
+            "action": "metamask.perps.close_orders",
+            "market": "BTC",
+            "intent": "Cancel selected Perps orders before continuing",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.place_order": {
+      "description": "Place a Perps order through a supported app/API path. Default to testnet; mainnet order placement requires an explicit user request. The network field in examples is an authoring convention: only start_state/teardown_state enforce the network (ensureNetwork); the mutation handlers themselves do not read it.",
+      "examples": [
+        {
+          "description": "Place BTC market order",
+          "node": {
+            "action": "metamask.perps.place_order",
+            "market": "BTC",
+            "side": "long",
+            "notional": "10",
+            "leverage": 2,
+            "intent": "Place the requested Perps order",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.assert_positions": {
+      "description": "Assert selected live Perps positions are present or absent.",
+      "examples": [
+        {
+          "description": "Assert BTC position is open",
+          "node": {
+            "action": "metamask.perps.assert_positions",
+            "state": "open",
+            "market": "BTC",
+            "intent": "Assert the expected Perps position state"
+          }
+        }
+      ]
+    },
+    "metamask.perps.assert_orders": {
+      "description": "Assert selected live Perps open orders are present or absent.",
+      "examples": [
+        {
+          "description": "Assert no BTC open orders",
+          "node": {
+            "action": "metamask.perps.assert_orders",
+            "state": "none",
+            "market": "BTC",
+            "intent": "Assert the expected Perps open order state"
+          }
+        }
+      ]
+    },
+    "metamask.perps.ensure_positions": {
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected positions, closes or places when needed, then asserts final position state. The network field in examples is an authoring convention: only start_state/teardown_state enforce the network (ensureNetwork); the mutation handlers themselves do not read it.",
+      "examples": [
+        {
+          "description": "Ensure no BTC position before proof window",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "state": "none",
+            "market": "BTC",
+            "intent": "Converge Perps positions to the requested state",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Ensure any existing positions are closed",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "state": "none",
+            "mode": "all",
+            "intent": "Converge Perps positions to the requested state",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.ensure_orders": {
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected orders, cancels when needed, then asserts final order state. The network field in examples is an authoring convention: only start_state/teardown_state enforce the network (ensureNetwork); the mutation handlers themselves do not read it.",
+      "examples": [
+        {
+          "description": "Ensure no open orders before proof window",
+          "node": {
+            "action": "metamask.perps.ensure_orders",
+            "state": "none",
+            "mode": "all",
+            "intent": "Converge Perps orders to the requested state",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.start_state": {
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that composes reusable domain operations before the proof window.",
+      "examples": [
+        {
+          "description": "Clean BTC testnet market state",
+          "node": {
+            "action": "metamask.perps.start_state",
+            "profile": "clean_market_testnet",
+            "market": "BTC",
+            "positions": {
+              "state": "none"
+            },
+            "orders": {
+              "state": "none"
+            },
+            "intent": "Prepare the Perps start state for the proof",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Start with an open ETH long position",
+          "node": {
+            "action": "metamask.perps.start_state",
+            "profile": "open_position_testnet",
+            "market": "ETH",
+            "side": "long",
+            "positions": {
+              "state": "open",
+              "notional": "10",
+              "leverage": 2
+            },
+            "intent": "Prepare the Perps start state for the proof",
+            "network": "testnet"
+          }
+        }
+      ]
+    },
+    "metamask.perps.teardown_state": {
+      "description": "Recommended configurable Perps teardown state that restores the selected environment after proof.",
+      "examples": [
+        {
+          "description": "Return BTC test account to clean state",
+          "node": {
+            "action": "metamask.perps.teardown_state",
+            "market": "BTC",
+            "positions": {
+              "state": "none"
+            },
+            "orders": {
+              "state": "none"
+            },
+            "page": "home",
+            "intent": "Restore Perps state after the proof"
+          }
+        },
+        {
+          "description": "Teardown only state created by selected market",
+          "node": {
+            "action": "metamask.perps.teardown_state",
+            "market": "BTC",
+            "intent": "Restore Perps state after the proof"
+          }
+        }
+      ]
     }
   },
   "custom_actions": [
     {
       "name": "metamask.wallet.fixture_status",
       "owner": "metamask",
-      "description": "mobile manifest-declared action metamask.wallet.fixture_status.",
+      "description": "Report the on-disk wallet fixture status (accounts and password presence) without launching or mutating the app.",
       "schema": {
         "type": "object",
         "properties": {
@@ -440,7 +757,7 @@
     {
       "name": "metamask.wallet.setup",
       "owner": "metamask",
-      "description": "mobile manifest-declared action metamask.wallet.setup.",
+      "description": "Import the wallet fixture accounts and password so the app starts from a known signed-in state.",
       "schema": {
         "type": "object",
         "properties": {
@@ -467,7 +784,7 @@
     {
       "name": "metamask.wallet.ensure_unlocked",
       "owner": "metamask",
-      "description": "mobile manifest-declared action metamask.wallet.ensure_unlocked.",
+      "description": "Unlock the wallet with the fixture password when it is currently locked.",
       "schema": {
         "type": "object",
         "properties": {
@@ -559,7 +876,7 @@
     {
       "name": "metamask.wallet.read_state",
       "owner": "metamask",
-      "description": "mobile manifest-declared action metamask.wallet.read_state.",
+      "description": "Read the redacted wallet state (selected account, route, and device) from the running app.",
       "schema": {
         "type": "object",
         "properties": {

package/package.json

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