@deeeed/metamask-harness 0.38.1 → 0.40.0

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

@@ -7,14 +7,14 @@
     "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" },
+      "destination_symbol": { "type": "string", "default": "USDC" },
+      "source_chain": { "type": "string", "default": "eip155:42161" },
+      "destination_chain": { "type": "string", "default": "eip155:42161" },
       "source_query": { "type": "string", "default": "ETH" },
-      "destination_query": { "type": "string", "default": "WETH" },
+      "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.0001 },
+      "amount": { "type": "number", "minimum": 0.00000001, "default": 0.002 },
       "slippage": { "type": "number", "minimum": 0.01, "default": 3 },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
     }
@@ -67,14 +67,6 @@
         "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": {

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

@@ -56,6 +56,7 @@
         "destination_symbol": "{{params.destination_symbol}}",
         "require_amount_inputs": true,
         "require_settings": true,
+        "require_quote": true,
         "intent": "Prove the selected pair and quoted destination amount remain visible",
         "next": "capture-quote"
       },

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

@@ -1,7 +1,7 @@
 {
   "$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.",
+  "description": "Make a Mobile or Extension wallet ready through its selected setup method; Extension method=ui uses visible onboarding or proves the exact selected account in the existing visible session.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -10,7 +10,7 @@
         "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."
+        "description": "Choose automatically from visible wallet state, require an existing profile, or require visible UI. Extension ui imports a fresh wallet or proves the exact account in an existing session; Mobile ui requires fresh onboarding."
       },
       "credential_source": {
         "type": "string",
@@ -66,13 +66,8 @@
     }
   },
   "workflow": {
-    "entry": "fixture-status",
+    "entry": "import",
     "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}}",
@@ -85,12 +80,7 @@
         "skip_wallet_tour": "{{params.skip_wallet_tour}}",
         "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",
+        "intent": "Make the wallet ready and prove the selected account through the requested setup method",
         "next": "done"
       },
       "done": {

package/package.json

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

package/library/actions/extension/assets/finish_send.mjs

@@ -1,128 +0,0 @@
-import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
-import { activityItem, bodyState, selectors, tokenRow, transactionState, visible, waitFor } from './send.mjs';
-
-runAdapter(async (input) => withExtensionPage(input, async (page) => {
-  const decision = String(input.node?.decision || '').trim();
-  const symbol = String(input.node?.symbol || '').trim().toUpperCase();
-  const amount = String(input.node?.amount || '').trim();
-  const resumeSubmitted = input.node?.resume_submitted === true;
-  const resumedHash = String(input.node?.transaction_hash || '').trim();
-  const timeoutMs = Number(input.node?.timeout_ms ?? 120_000);
-  if (!['confirm', 'cancel'].includes(decision) || !symbol || !amount) {
-    throw new Error('metamask.assets.finish_send requires decision=confirm|cancel, symbol, and amount.');
-  }
-  if (decision === 'confirm' && input.node?.confirm_live !== true) {
-    throw new Error('metamask.assets.finish_send decision=confirm requires confirm_live=true.');
-  }
-  const control = decision === 'confirm' ? selectors.confirm : selectors.cancel;
-  let state = await bodyState(page);
-  let submittedTransaction = null;
-  let submittedNow = false;
-  if (await visible(page, control)) {
-    const beforeTransactions = decision === 'confirm' ? await transactionState(page) : null;
-    if (decision === 'confirm' && !beforeTransactions?.available) {
-      throw new Error('Transaction state is unavailable; refusing to submit without proof binding.');
-    }
-    const beforeById = new Map((beforeTransactions?.transactions ?? []).map((transaction) => [transaction.id, transaction]));
-    await page.click(control);
-    submittedNow = decision === 'confirm';
-    state = await waitFor(page, async () => {
-      const current = await bodyState(page);
-      return current.route === '' || current.route === '#/' ? current : null;
-    }, 'Wallet did not return after send decision.', timeoutMs);
-    if (decision === 'confirm') {
-      submittedTransaction = await waitFor(page, async () => {
-        const current = await transactionState(page);
-        const changed = current.transactions.filter((transaction) => {
-          const before = beforeById.get(transaction.id);
-          if (!before) return true;
-          const wasAwaitingApproval = ['unapproved', 'approved'].includes(String(before.status).toLowerCase());
-          return wasAwaitingApproval && (before.status !== transaction.status || before.hash !== transaction.hash);
-        });
-        if (changed.length > 1) {
-          throw new Error(`Send submission changed multiple transaction records: ${changed.map((transaction) => transaction.id).join(', ')}.`);
-        }
-        return changed[0] ?? null;
-      }, 'Send confirmation did not change one transaction record.', timeoutMs);
-    }
-  } else if (decision === 'cancel') {
-    throw new Error('Send cancel control was not visible.');
-  } else if (!resumeSubmitted) {
-    throw new Error('Send confirm control was not visible. Next: rerun with resume_submitted=true only if this exact transaction was already submitted.');
-  } else if (!resumedHash) {
-    throw new Error('metamask.assets.finish_send resume_submitted=true requires transaction_hash.');
-  } else if (!/^0x[0-9a-f]{64}$/iu.test(resumedHash)) {
-    throw new Error('metamask.assets.finish_send transaction_hash must be a full EVM transaction hash.');
-  }
-  if (decision === 'cancel') {
-    return { action: input.action, decision, cancelled: true, proofPath: 'trusted-pointer-visible-ui' };
-  }
-  submittedTransaction = await waitFor(page, async () => {
-    const current = await transactionState(page);
-    const transaction = submittedNow
-      ? current.transactions.find((entry) => entry.id === submittedTransaction?.id)
-      : current.transactions.find((entry) => entry.hash?.toLowerCase() === resumedHash.toLowerCase());
-    if (!transaction) return null;
-    if (['failed', 'rejected', 'dropped'].includes(String(transaction.status).toLowerCase())) {
-      throw new Error(`Send transaction ${transaction.id} reached ${transaction.status}.`);
-    }
-    return String(transaction.status).toLowerCase() === 'confirmed' && /^0x[0-9a-f]{64}$/iu.test(transaction.hash || '')
-      ? transaction
-      : null;
-  }, `Sent ${amount} ${symbol} did not produce one confirmed transaction record.`, timeoutMs);
-  let tokenAfter = null;
-  if (!state.route.includes('/tx/')) {
-    if (state.route.includes('/activity')) {
-      await page.click(selectors.home);
-    }
-    tokenAfter = await waitFor(page, () => tokenRow(page, symbol), `${symbol} did not reappear after send.`, timeoutMs);
-    await waitFor(page, async () => {
-      const current = await bodyState(page);
-      if (current.route.includes('/activity') || current.route.includes('/tx/')) return current;
-      await page.click(selectors.activity);
-      return null;
-    }, 'Activity did not open after send.', timeoutMs);
-  }
-  let activity = null;
-  if (!state.route.includes('/tx/')) {
-    activity = await waitFor(page, () => activityItem(page, symbol, amount), `Sent ${amount} ${symbol} did not appear in Activity.`, timeoutMs);
-    await waitFor(page, async () => {
-      const current = await bodyState(page);
-      if (current.route.includes('/tx/')) return current;
-      const currentActivity = await activityItem(page, symbol, amount);
-      if (currentActivity) {
-        activity = currentActivity;
-        await page.click(currentActivity.selector);
-      }
-      return null;
-    }, `Sent ${amount} ${symbol} transaction details did not open.`, timeoutMs);
-  }
-  const details = await waitFor(page, async () => {
-    const current = await bodyState(page);
-    if (!current.route.includes('/tx/') || !/\bConfirmed\b/u.test(current.text)) return null;
-    return current;
-  }, `Sent ${amount} ${symbol} did not reach Confirmed.`, timeoutMs);
-  const explorerUrl = await page.evaluate(`document.querySelector('[data-testid="transaction-details-block-explorer"]')?.getAttribute('data-explorer-url') || null`);
-  const transactionHash = details.route.match(/\/(0x[0-9a-f]{64})(?:\?|$)/iu)?.[1]
-    ?? details.text.match(/\b0x[0-9a-f]{64}\b/iu)?.[0]
-    ?? String(explorerUrl || '').match(/\/(0x[0-9a-f]{64})(?:[/?#]|$)/iu)?.[1]
-    ?? null;
-  if (!transactionHash) throw new Error('Confirmed transaction details did not expose a full transaction hash.');
-  if (transactionHash.toLowerCase() !== submittedTransaction.hash.toLowerCase()) {
-    throw new Error(`Confirmed Activity details opened ${transactionHash}, expected ${submittedTransaction.hash}.`);
-  }
-  return {
-    action: input.action,
-    decision,
-    symbol,
-    amount,
-    activity,
-    tokenAfter,
-    details,
-    explorerUrl,
-    transactionHash,
-    transactionId: submittedTransaction.id,
-    resumed: !submittedNow,
-    proofPath: 'trusted-pointer-visible-ui',
-  };
-}));

package/library/actions/extension/swap_bridge/submit_transaction.mjs

@@ -1,363 +0,0 @@
-import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
-import { bodyState, tokenRow, transactionState, visible, waitFor } from '../assets/send.mjs';
-
-const selectors = {
-  cta: dataTestId('bridge-cta-button'),
-  warningProceed: `${dataTestId('bridge-alert-modal-proceed-button')}:not([disabled])`,
-  confirm: dataTestId('confirm-sign-and-send-transaction-confirm-snap-footer-button'),
-  close: 'button[aria-label="Close"]',
-  activity: dataTestId('bottom-nav-activity'),
-  home: dataTestId('bottom-nav-home'),
-  swap: dataTestId('bottom-nav-swaps'),
-};
-
-async function pause(timeoutMs = 200) {
-  await new Promise((resolve) => setTimeout(resolve, timeoutMs));
-}
-
-async function activatePoint(page, point) {
-  await page.session.call('Input.dispatchMouseEvent', { type: 'mouseMoved', x: point.x, y: point.y });
-  await page.session.call('Input.dispatchMouseEvent', {
-    type: 'mousePressed',
-    x: point.x,
-    y: point.y,
-    button: 'left',
-    clickCount: 1,
-  });
-  await page.session.call('Input.dispatchMouseEvent', {
-    type: 'mouseReleased',
-    x: point.x,
-    y: point.y,
-    button: 'left',
-    clickCount: 1,
-  });
-}
-
-async function activateSelector(page, selector) {
-  const point = await page.evaluate(`(() => {
-    const element = document.querySelector(${JSON.stringify(selector)});
-    if (!element) return null;
-    const style = getComputedStyle(element);
-    const rect = element.getBoundingClientRect();
-    if (style.display === 'none' || style.visibility === 'hidden' || rect.width <= 0 || rect.height <= 0) return null;
-    return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 };
-  })()`);
-  if (!point) return false;
-  await activatePoint(page, point);
-  return true;
-}
-
-function isActivityRoute(route) {
-  return route.includes('/activity') || /[?&]tab=activity(?:&|$)/u.test(route);
-}
-
-function transactionIdentifier(value) {
-  const identifier = String(value);
-  return /^0x/iu.test(identifier) ? identifier.toLowerCase() : identifier;
-}
-
-async function openActivity(page, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  let lastActivationAt = 0;
-  let lastResetAt = 0;
-  while (Date.now() < deadline) {
-    const state = await bodyState(page);
-    if (isActivityRoute(state.route) && await visible(page, dataTestId('activity-list-item'))) return state;
-    if (isActivityRoute(state.route) && await visible(page, selectors.swap) && Date.now() - lastResetAt >= 1000) {
-      await activateSelector(page, selectors.swap);
-      lastResetAt = Date.now();
-      await pause();
-      continue;
-    }
-    if (await visible(page, selectors.activity) && Date.now() - lastActivationAt >= 1000) {
-      await activateSelector(page, selectors.activity);
-      lastActivationAt = Date.now();
-    }
-    await pause();
-  }
-  throw new Error('Activity did not open after swap.');
-}
-
-async function quoteState(page) {
-  return page.evaluate(`(() => {
-    const value = (testId) => {
-      const root = document.querySelector('[data-testid="' + testId + '"]');
-      const input = root?.matches('input, textarea') ? root : root?.querySelector('input, textarea');
-      return String(input?.value ?? '').trim();
-    };
-    const label = (testId) => String(document.querySelector('[data-testid="' + testId + '"]')?.innerText || '').replace(/\\s+/gu, ' ').trim();
-    const cta = document.querySelector('[data-testid="bridge-cta-button"]');
-    return {
-      route: location.hash,
-      sourceSymbol: label('bridge-source-button'),
-      destinationSymbol: label('bridge-destination-button'),
-      sourceAmount: value('from-amount'),
-      destinationAmount: value('to-amount'),
-      cta: cta ? String(cta.innerText || '').replace(/\\s+/gu, ' ').trim() : null,
-      ctaEnabled: Boolean(cta && !cta.disabled),
-      loading: Boolean(document.querySelector('[data-testid="multichain-bridge-quote-card-loading"]')),
-      warning: String(document.body?.innerText || '').match(/(?:might be reverted|may fail|likely to fail|insufficient funds|trade route isn't available)[^.]{0,300}/iu)?.[0] || null,
-    };
-  })()`);
-}
-
-async function submittableQuote(page, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    const quote = await quoteState(page);
-    if (/^(?:Get new quote|Refresh quote)$/iu.test(String(quote.cta)) && quote.ctaEnabled) {
-      await page.click(selectors.cta);
-      await pause(500);
-      continue;
-    }
-    if (/^(?:Swap|Bridge)$/iu.test(String(quote.cta)) && quote.ctaEnabled && !quote.loading) return quote;
-    await pause();
-  }
-  throw new Error('Swap did not expose a fresh submittable quote.');
-}
-
-async function activityRow(page, sourceSymbol, destinationSymbol, occurrence = 0) {
-  return page.evaluate(`(() => {
-    const source = ${JSON.stringify(sourceSymbol)};
-    const destination = ${JSON.stringify(destinationSymbol)};
-    const occurrence = ${JSON.stringify(occurrence)};
-    let matched = 0;
-    for (const row of document.querySelectorAll('[data-testid="activity-list-item"]')) {
-      const label = String(row.innerText || row.textContent || '').replace(/\\s+/gu, ' ').trim();
-      const upper = label.toUpperCase();
-      const pair = upper.includes(source + ' → ' + destination)
-        || upper.includes(source + ' -> ' + destination);
-      const bridgeSource = upper.includes('BRIDGED ' + source);
-      if (!pair && !bridgeSource) continue;
-      const style = getComputedStyle(row);
-      const rect = row.getBoundingClientRect();
-      if (style.display === 'none' || style.visibility === 'hidden' || rect.width <= 0 || rect.height <= 0) continue;
-      if (matched < occurrence) {
-        matched += 1;
-        continue;
-      }
-      return {
-        label: label.slice(0, 1000),
-        status: String(row.getAttribute('data-tx-status') || ''),
-        x: rect.left + rect.width / 2,
-        y: rect.top + rect.height / 2,
-      };
-    }
-    return null;
-  })()`);
-}
-
-async function activateActivityRow(page, row) {
-  await activatePoint(page, row);
-}
-
-runAdapter(async (input) => withExtensionPage(input, async (page) => {
-  const sourceSymbol = String(input.node?.source_symbol || '').trim().toUpperCase();
-  const destinationSymbol = String(input.node?.destination_symbol || '').trim().toUpperCase();
-  const requestedAmount = String(input.node?.amount || '').trim();
-  const resumeSubmitted = input.node?.resume_submitted === true;
-  const resumedHash = String(input.node?.transaction_hash || '').trim();
-  const activityOccurrence = Number(input.node?.activity_occurrence ?? 0);
-  const requireDestinationBalance = input.node?.require_destination_balance !== false;
-  const timeoutMs = Number(input.node?.timeout_ms ?? 300_000);
-  if (!sourceSymbol || !destinationSymbol || !requestedAmount || !Number.isInteger(activityOccurrence) || activityOccurrence < 0) {
-    throw new Error('metamask.swap_bridge.submit_transaction requires source_symbol, destination_symbol, and amount.');
-  }
-  if (!resumeSubmitted && input.node?.confirm_live !== true) {
-    throw new Error('metamask.swap_bridge.submit_transaction requires confirm_live=true.');
-  }
-  if (resumeSubmitted && !resumedHash) {
-    throw new Error('metamask.swap_bridge.submit_transaction resume_submitted=true requires transaction_hash.');
-  }
-
-  let submitted = resumeSubmitted;
-  let confirmed = resumeSubmitted;
-  let amount = requestedAmount;
-  let beforeTransactionIdentifiers = new Set();
-  if (!resumeSubmitted) {
-    let quote = await submittableQuote(page, Math.min(timeoutMs, 60_000));
-    if (requestedAmount === 'visible') amount = quote.sourceAmount;
-    if (!quote.sourceSymbol.toUpperCase().includes(sourceSymbol)
-      || !quote.destinationSymbol.toUpperCase().includes(destinationSymbol)
-      || quote.sourceAmount !== amount
-      || !(Number(quote.destinationAmount) > 0)
-      || !quote.ctaEnabled
-      || quote.loading
-      || quote.warning) {
-      throw new Error(`Swap quote is not safe to submit: ${JSON.stringify(quote)}.`);
-    }
-    await pause(2000);
-    quote = await submittableQuote(page, Math.min(timeoutMs, 60_000));
-    if (!quote.sourceSymbol.toUpperCase().includes(sourceSymbol)
-      || !quote.destinationSymbol.toUpperCase().includes(destinationSymbol)
-      || quote.sourceAmount !== amount
-      || !(Number(quote.destinationAmount) > 0)
-      || !quote.ctaEnabled
-      || quote.loading
-      || quote.warning) {
-      throw new Error(`Swap quote changed before submission: ${JSON.stringify(quote)}.`);
-    }
-    const beforeTransactions = await transactionState(page);
-    if (!beforeTransactions.available) {
-      throw new Error('Transaction state is unavailable; refusing to submit without proof binding.');
-    }
-    beforeTransactionIdentifiers = new Set(beforeTransactions.transactions.flatMap((transaction) => [
-      transaction.id,
-      transaction.hash,
-    ].filter(Boolean).map(transactionIdentifier)));
-    await page.click(selectors.cta);
-    const submissionDeadline = Date.now() + Math.min(timeoutMs, 120_000);
-    while (Date.now() < submissionDeadline) {
-      if (await visible(page, selectors.warningProceed)) {
-        await page.click(selectors.warningProceed);
-        await pause();
-        continue;
-      }
-      if (await visible(page, selectors.confirm)) {
-        await page.click(selectors.confirm);
-        confirmed = true;
-        submitted = true;
-        await pause();
-        continue;
-      }
-      const state = await bodyState(page);
-      if (state.route !== '#/cross-chain/swaps/prepare-bridge-page'
-        && !state.route.includes('/confirmation')) {
-        submitted = true;
-      }
-      if (submitted && (state.route === '' || state.route === '#/' || isActivityRoute(state.route) || /Processing|Transaction complete|submitted/iu.test(state.text))) {
-        break;
-      }
-      await pause();
-    }
-    if (!submitted) {
-      throw new Error('Swap submission did not reach a signed or submitted state.');
-    }
-  }
-
-  let activity = null;
-  let details = await bodyState(page);
-  const resumedFromDetails = details.route.includes('/tx/')
-    && /\bConfirmed\b/u.test(details.text)
-    && /\bYou sent\b/u.test(details.text)
-    && /\bYou received\b/u.test(details.text)
-    && details.text.toUpperCase().includes(sourceSymbol)
-    && details.text.toUpperCase().includes(destinationSymbol);
-  if (!resumedFromDetails) {
-    await waitFor(page, async () => {
-      const state = await bodyState(page);
-      if (isActivityRoute(state.route) || await visible(page, selectors.activity)) return state;
-      if (await visible(page, selectors.close)) await page.click(selectors.close);
-      return null;
-    }, 'Swap did not expose Activity after submission.', timeoutMs);
-    await openActivity(page, timeoutMs);
-
-    let lastActivityRefresh = 0;
-    const activityTarget = await waitFor(page, async () => {
-      const row = await activityRow(page, sourceSymbol, destinationSymbol, activityOccurrence);
-      if (row?.status === 'failed') throw new Error(`Swap Activity failed: ${row.label}.`);
-      if (row?.status === 'confirmed') return row;
-      if (Date.now() - lastActivityRefresh >= 5000 && await visible(page, selectors.home)) {
-        await page.click(selectors.home);
-        await pause(500);
-        await openActivity(page, Math.min(10_000, Math.max(1, timeoutMs)));
-        lastActivityRefresh = Date.now();
-      }
-      return null;
-    }, `Swap ${sourceSymbol} to ${destinationSymbol} did not reach Confirmed in Activity.`, timeoutMs);
-    activity = { label: activityTarget.label, status: activityTarget.status };
-    confirmed = true;
-    let lastDetailsActivationAt = 0;
-    details = await waitFor(page, async () => {
-      const current = await bodyState(page);
-      if (current.route.includes('/tx/') && /\bConfirmed\b/u.test(current.text)) return current;
-      if (Date.now() - lastDetailsActivationAt >= 1000) {
-        await activateActivityRow(page, activityTarget);
-        lastDetailsActivationAt = Date.now();
-      }
-      return null;
-    }, 'Confirmed swap transaction details did not open.', timeoutMs);
-  }
-  const explorerUrl = await page.evaluate(`document.querySelector('[data-testid="transaction-details-block-explorer"]')?.getAttribute('data-explorer-url') || null`);
-  const routeIdentifier = details.route.match(/\/([^/?#]+)(?:\?|$)/u)?.[1] ?? null;
-  const transactionHash = details.route.match(/\/(0x[0-9a-f]{64})(?:\?|$)/iu)?.[1]
-    ?? details.text.match(/\b0x[0-9a-f]{64}\b/iu)?.[0]
-    ?? String(explorerUrl || '').match(/\/(0x[0-9a-f]{64})(?:[/?#]|$)/iu)?.[1]
-    ?? (/^[1-9A-HJ-NP-Za-km-z]{64,100}$/u.test(String(routeIdentifier)) ? routeIdentifier : null)
-    ?? String(explorerUrl || '').match(/\/(?:tx|transaction)\/([1-9A-HJ-NP-Za-km-z]{64,100})(?:[/?#]|$)/u)?.[1]
-    ?? null;
-  if (!transactionHash) throw new Error('Confirmed swap details did not expose a full transaction hash.');
-  if (resumeSubmitted && transactionIdentifier(transactionHash) !== transactionIdentifier(resumedHash)) {
-    throw new Error(`Confirmed swap details opened ${transactionHash}, expected ${resumedHash}.`);
-  }
-  if (!resumeSubmitted) {
-    const confirmedIdentifier = transactionIdentifier(transactionHash);
-    if (beforeTransactionIdentifiers.has(confirmedIdentifier)) {
-      throw new Error(`Confirmed swap details opened pre-existing transaction ${transactionHash}.`);
-    }
-    const afterTransactions = await transactionState(page);
-    const submittedTransaction = afterTransactions.transactions.find((transaction) =>
-      transactionIdentifier(transaction.hash) === confirmedIdentifier &&
-      !beforeTransactionIdentifiers.has(transactionIdentifier(transaction.id)));
-    if (!submittedTransaction) {
-      throw new Error(`Confirmed swap ${transactionHash} is not bound to a newly created transaction record.`);
-    }
-  }
-  const detailText = details.text.toUpperCase();
-  const sentSource = new RegExp('YOU SENT[\\s\\S]{0,120}\\b' + sourceSymbol + '\\b', 'u');
-  const receivedDestination = new RegExp('YOU RECEIVED[\\s\\S]{0,120}\\b' + destinationSymbol + '\\b', 'u');
-  if (!sentSource.test(detailText) || !receivedDestination.test(detailText)) {
-    throw new Error(`Confirmed swap details do not prove ${sourceSymbol} to ${destinationSymbol}.`);
-  }
-  const back = dataTestId('transaction-details-back-button');
-  let lastBackActivationAt = 0;
-  await waitFor(page, async () => {
-    const current = await bodyState(page);
-    if (isActivityRoute(current.route)) return current;
-    if (await visible(page, back) && Date.now() - lastBackActivationAt >= 1000) {
-      await page.click(back);
-      lastBackActivationAt = Date.now();
-    }
-    return null;
-  }, 'Swap details did not return to Activity.', timeoutMs);
-  await waitFor(page, async () => await visible(page, selectors.home), 'Home navigation did not return after swap details.', timeoutMs);
-  let lastHomeActivationAt = 0;
-  await waitFor(page, async () => {
-    const current = await bodyState(page);
-    if (current.route === '' || current.route === '#/' || current.route.startsWith('#/?')) return current;
-    if (await visible(page, selectors.home) && Date.now() - lastHomeActivationAt >= 1000) {
-      await page.click(selectors.home);
-      lastHomeActivationAt = Date.now();
-    }
-    return null;
-  }, 'Home did not open after the confirmed swap.', timeoutMs);
-  const destinationAfter = requireDestinationBalance
-    ? await waitFor(
-      page,
-      async () => {
-        const row = await tokenRow(page, destinationSymbol);
-        const numeric = Number(String(row?.amount || '').replace(/[^0-9.eE+-]/gu, ''));
-        return row && Number.isFinite(numeric) && numeric > 0 ? row : null;
-      },
-      `${destinationSymbol} did not reach a positive Home balance after the transaction.`,
-      timeoutMs,
-    )
-    : null;
-  return {
-    action: input.action,
-    sourceSymbol,
-    destinationSymbol,
-    amount,
-    submitted,
-    confirmed,
-    activity,
-    details,
-    destinationAfter,
-    explorerUrl,
-    transactionHash,
-    resumed: resumeSubmitted,
-    activityOccurrence,
-    destinationBalanceRequired: requireDestinationBalance,
-    proofPath: 'trusted-pointer-visible-ui',
-  };
-}));