@deeeed/metamask-harness 0.38.1 → 0.40.0

package/library/actions/extension/ui/activate_and_observe.mjs

@@ -1,96 +0,0 @@
-import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
-
-function nonEmpty(value, name) {
-  if (value == null) return undefined;
-  const result = String(value).trim();
-  if (!result) throw new Error(`ui.activate_and_observe ${name} must not be empty.`);
-  return result;
-}
-
-function boundedInteger(value, fallback, minimum, maximum, name) {
-  const result = value == null ? fallback : Number(value);
-  if (!Number.isInteger(result) || result < minimum || result > maximum) {
-    throw new Error(`ui.activate_and_observe ${name} must be an integer from ${minimum} to ${maximum}.`);
-  }
-  return result;
-}
-
-function stringList(value, name) {
-  if (value == null) return [];
-  if (!Array.isArray(value)) throw new Error(`ui.activate_and_observe ${name} must be an array.`);
-  return [...new Set(value.map((entry) => String(entry).trim()).filter(Boolean))];
-}
-
-runAdapter(async (input) => withExtensionPage(input, async (page) => {
-  const testId = nonEmpty(input.node?.test_id ?? input.node?.testID, 'test_id');
-  const selector = nonEmpty(input.node?.selector, 'selector');
-  if (Number(Boolean(testId)) + Number(Boolean(selector)) !== 1) {
-    throw new Error('ui.activate_and_observe requires exactly one of test_id or selector.');
-  }
-  const target = selector ?? dataTestId(testId);
-  const timeoutMs = boundedInteger(input.node?.timeout_ms, 10_000, 1, 60_000, 'timeout_ms');
-  const settleMs = boundedInteger(input.node?.settle_ms, 250, 0, 10_000, 'settle_ms');
-  const maxItems = boundedInteger(input.node?.max_items, 100, 1, 200, 'max_items');
-  const requireTestIds = stringList(input.node?.require_test_ids, 'require_test_ids');
-  const requireText = stringList(input.node?.require_text, 'require_text');
-
-  const deadline = Date.now() + timeoutMs;
-  let targetVisible = false;
-  while (Date.now() <= deadline) {
-    targetVisible = await page.evaluate(`(() => {
-      const element = document.querySelector(${JSON.stringify(target)});
-      if (!element) return false;
-      const style = getComputedStyle(element);
-      const rect = element.getBoundingClientRect();
-      return style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0;
-    })()`);
-    if (targetVisible) break;
-    await new Promise((resolve) => setTimeout(resolve, 100));
-  }
-  if (!targetVisible) throw new Error(`ui.activate_and_observe target did not become visible: ${target}`);
-  const interaction = await page.click(target);
-  if (settleMs > 0) await new Promise((resolve) => setTimeout(resolve, settleMs));
-  const observed = await page.evaluate(`(() => {
-    const maximum = ${JSON.stringify(maxItems)};
-    const controls = [];
-    for (const element of document.querySelectorAll('[data-testid]')) {
-      const testId = element.getAttribute('data-testid');
-      if (!testId) continue;
-      const style = getComputedStyle(element);
-      const rect = element.getBoundingClientRect();
-      if (style.display === 'none' || style.visibility === 'hidden' || rect.width <= 0 || rect.height <= 0) continue;
-      controls.push({
-        testId,
-        label: String(element.getAttribute('aria-label') || element.innerText || '')
-          .replace(/\\s+/gu, ' ')
-          .trim()
-          .slice(0, 500),
-      });
-      if (controls.length >= maximum) break;
-    }
-    return {
-      route: location.hash,
-      text: String(document.body?.innerText || '').replace(/\\s+/gu, ' ').trim().slice(0, 20_000),
-      controls,
-    };
-  })()`);
-  const observedTestIds = observed.controls.map((entry) => entry.testId);
-  const observedText = [observed.text, ...observed.controls.map((entry) => entry.label)].join(' ');
-  const missingTestIds = requireTestIds.filter((entry) => !observedTestIds.includes(entry));
-  const missingText = requireText.filter((entry) => !observedText.includes(entry));
-  if (missingTestIds.length > 0 || missingText.length > 0) {
-    throw new Error([
-      missingTestIds.length > 0 ? `missing test IDs: ${missingTestIds.join(', ')}` : '',
-      missingText.length > 0 ? `missing text: ${missingText.join(', ')}` : '',
-    ].filter(Boolean).join('; '));
-  }
-  return {
-    action: input.action,
-    interaction,
-    route: observed.route,
-    controls: observed.controls,
-    observedTestIds,
-    matchedText: requireText,
-    proofPath: 'trusted-pointer-visible-ui',
-  };
-}));

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

@@ -1,88 +0,0 @@
-{
-  "$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-native-max-cancel.recipe.json

@@ -1,70 +0,0 @@
-{
-  "$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

@@ -1,78 +0,0 @@
-{
-  "$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" }
-    }
-  }
-}

package/library/recipes/assets/release-own-account-send.recipe.json

@@ -1,80 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "Assets release own-account token send",
-  "description": "Sends a tiny token amount between owned accounts and proves its 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" },
-      "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 own-account token send",
-        "next": "review-send"
-      },
-      "review-send": {
-        "action": "metamask.assets.review_send",
-        "timeout_ms": "{{params.timeout_ms}}",
-        "intent": "Review the send and prove its network fee",
-        "next": "capture-confirmation"
-      },
-      "capture-confirmation": {
-        "action": "ui.screenshot",
-        "path": "screenshots/assets-own-account-send-confirmation.png",
-        "label": "Own-account token send confirmation",
-        "intent": "Preserve the reviewed send 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 send and prove its Activity details",
-        "next": "capture-confirmed"
-      },
-      "capture-confirmed": {
-        "action": "ui.screenshot",
-        "path": "screenshots/assets-own-account-send-confirmed.png",
-        "label": "Own-account token send confirmed",
-        "intent": "Preserve the confirmed transaction evidence",
-        "next": "done"
-      },
-      "done": { "action": "end", "status": "pass" }
-    }
-  }
-}