@deeeed/metamask-harness 0.47.4 → 0.49.0

package/library/actions/extension/perps/place_order.mjs

@@ -1,3 +1,4 @@
+// Place a Perps order and return visible-control evidence or assert the resulting order or position state.
 import { runAdapter } from '../platform/cdp.mjs';
 import { assertOrders, assertPositions, placeOrder } from './perps.mjs';
 runAdapter(async (input) => {

package/library/actions/extension/perps/read_eligibility.mjs

@@ -1,3 +1,4 @@
+// Fetch MetaMask geolocation and report it alongside the product's current Perps eligibility state.
 import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 
 runAdapter(async (input) => {

package/library/actions/extension/perps/read_funds_confirmation.mjs

@@ -1,3 +1,5 @@
+// Read the displayed Perps deposit or withdrawal confirmation and check requested UI expectations.
+// Report preview fields, submit availability, and layout without submitting funds.
 import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 
 function expectedList(value, name) {
@@ -117,6 +119,14 @@ export async function readFundsConfirmation(page, node, mode, timeoutMs = 30_000
   if (observed?.title !== expectedTitle || observed?.amount === null) {
     throw new Error(`Perps ${mode} confirmation did not finish loading.`);
   }
+  if (node.require_preview_fields === true) {
+    const missing = ['transactionFee', 'estimatedTime', 'receive'].filter((field) => !observed[field]);
+    if (!observed.payToken && !observed.receiveToken) missing.push('payToken/receiveToken');
+    if (observed.loadingVisible) missing.push('loading not settled');
+    if (missing.length > 0) {
+      throw new Error(`Perps ${mode} preview is incomplete: ${missing.join(', ')}.\nNext: mm-harness logs --full`);
+    }
+  }
   if (node.require_no_horizontal_overflow === true && (
     observed.layout.horizontalOverflow || observed.layout.clippedTestIds.length > 0
   )) {

package/library/actions/extension/perps/read_orders.mjs

@@ -1,3 +1,4 @@
+// Read live Perps orders with optional selection and network checks, returning redacted order fields.
 import { runAdapter } from '../platform/cdp.mjs';
 import { readOrders } from './perps.mjs';
 

package/library/actions/extension/perps/read_positions.mjs

@@ -1,3 +1,4 @@
+// Read runtime Perps positions with optional selection and network checks, returning redacted position fields.
 import { runAdapter } from '../platform/cdp.mjs';
 import { readPositions } from './perps.mjs';
 runAdapter(readPositions);

package/library/actions/extension/perps/read_snapshot.mjs

@@ -1,3 +1,5 @@
+// Read bounded, normalized Perps snapshots through background APIs, optionally sampling market changes.
+// History checks can require a matching visible activity card identity.
 import { pathToFileURL } from 'node:url';
 
 import { normalizeMarketSymbol, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
@@ -499,7 +501,8 @@ async function visibleActivityCards(page) {
     return {
       testId: String(element.getAttribute('data-testid') || '').slice(0, 500),
       label: String(element.innerText || '').replace(/\\s+/gu, ' ').trim().slice(0, 500),
-      visible: style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0,
+      visible: style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0 &&
+        rect.bottom > 0 && rect.right > 0 && rect.top < innerHeight && rect.left < innerWidth,
     };
   })`);
 }

package/library/actions/extension/perps/read_visible_state.mjs

@@ -1,3 +1,7 @@
+// Capture Perps DOM controls, order-entry values, and layout within configured item and visibility bounds.
+// Normalize the observation and check requested visible-state expectations.
+import { pathToFileURL } from 'node:url';
+
 import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 import {
   normalizeVisiblePerpsState,
@@ -38,7 +42,7 @@ export async function readVisiblePerpsState(page, node = {}) {
   const raw = await page.evaluate(`(() => {
     const includeOffscreen = ${JSON.stringify(options.includeOffscreen)};
     const maximum = ${JSON.stringify(options.maxItems)};
-    const relevant = /^(?:perps-|explore-markets-|market-list-view|market-row-|filter-select-button|sort-dropdown-button|search-input|position-card-|order-card-|transaction-card-|bottom-nav-|back-button|direction-|order-type-|amount-|balance-percent-|leverage-|auto-close|submit-order-button|limit-price-|tp-|sl-|custom-amount-|pay-with-|confirm-footer-button|wallet-initiated-header-back-button|transaction-fee-|bridge-(?:fee|time)-|receive-(?:row|value))/u;
+    const relevant = /^(?:perps-|parent-selector-perps-(?:market-list|order-entry)|explore-markets-|market-list-view|market-row-|filter-select-button|sort-dropdown-button|search-input|position-card-|order-card-|transaction-card-|bottom-nav-|back-button|direction-|order-type-|amount-|balance-percent-|leverage-|auto-close|submit-order-button|limit-price-|tp-|sl-|custom-amount-|pay-with-|confirm-footer-button|wallet-initiated-header-back-button|transaction-fee-|bridge-(?:fee|time)-|receive-(?:row|value))/u;
     const items = [];
     const offscreenItems = [];
     const clippedTestIds = [];
@@ -115,7 +119,7 @@ export async function readVisiblePerpsState(page, node = {}) {
       items,
       offscreenItems,
       truncated: matched > items.length + offscreenItems.length,
-      orderEntry: document.querySelector('[data-testid="perps-order-entry-page"]') ? {
+      orderEntry: document.querySelector('[data-testid="parent-selector-perps-order-entry"], [data-testid="perps-order-entry-page"]') ? {
         symbol: field('perps-order-entry-asset-symbol')?.label || null,
         direction,
         orderType: field('order-type-limit')?.pressed === 'true' ? 'limit' : 'market',
@@ -150,7 +154,9 @@ export async function readVisiblePerpsState(page, node = {}) {
   };
 }
 
-runAdapter(async (input) => withExtensionPage(input, async (page) => ({
-  action: input.action,
-  ...await readVisiblePerpsState(page, input.node),
-})));
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  runAdapter(async (input) => withExtensionPage(input, async (page) => ({
+    action: input.action,
+    ...await readVisiblePerpsState(page, input.node),
+  })));
+}

package/library/actions/extension/perps/search_markets.mjs

@@ -1,10 +1,16 @@
+// Enter a Perps market search query and wait for at least one displayed result row.
 import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 
 runAdapter(async (input) => withExtensionPage(input, async (page) => {
   const query = String(input.node?.query ?? '').trim();
   const timeoutMs = Number(input.node?.timeout_ms ?? 30_000);
   if (!query) throw new Error('metamask.perps.search_markets requires a non-empty query.');
-  await page.setInput(dataTestId('search-input'), query);
+  const searchInput = dataTestId('search-input');
+  if (!await page.evaluate(`Boolean(document.querySelector(${JSON.stringify(searchInput)}))`)) {
+    await page.click(dataTestId('market-list-search-toggle'));
+    await page.waitForSelector(searchInput, { timeoutMs });
+  }
+  await page.setInput(searchInput, query);
   const deadline = Date.now() + timeoutMs;
   let marketIds = [];
   while (Date.now() <= deadline) {
@@ -18,7 +24,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       .filter(Boolean)
       .slice(0, 100))()`);
     if (marketIds.length > 0) break;
-    await page.evaluate('new Promise((resolve) => setTimeout(resolve, 200))');
+    await new Promise((resolve) => setTimeout(resolve, 200));
   }
   if (marketIds.length === 0) {
     throw new Error(`Perps market search returned no visible rows for ${JSON.stringify(query)}.`);

package/library/actions/extension/perps/select_activity_filter.mjs

@@ -1,3 +1,4 @@
+// Select a Perps activity filter and wait for its route, label, and loaded cards or empty state.
 import { pathToFileURL } from 'node:url';
 
 import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
@@ -62,7 +63,7 @@ export async function selectActivityFilter(page, input, options = {}) {
         entries: cards.map((card) => card.label),
         loadedBoundary: visible(document.querySelector('[data-testid="perps-activity-page-skeleton"]'))
           ? null
-          : visible(document.querySelector('[data-testid="perps-activity-page"]'))
+          : visible(document.querySelector('[data-testid="perps-activity-page"],[data-testid="parent-selector-perps-activity"]'))
             ? cards.length > 0 ? 'visible-cards' : 'loaded-empty'
             : null,
         empty: String(document.body?.innerText || '').replace(/\\s+/gu, ' ').trim().slice(0, 2_000),

package/library/actions/extension/perps/select_market_filter.mjs

@@ -1,10 +1,8 @@
+// Select a Perps market category through the dropdown or category rail and inspect the resulting list.
 import { pathToFileURL } from 'node:url';
 
 import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
-import {
-  normalizeVisiblePerpsState,
-  resolveVisibleStateOptions,
-} from '../../shared/perps/visible-state.mjs';
+import { readVisiblePerpsState } from './read_visible_state.mjs';
 
 const FILTERS = new Map([
   ['all', 'all'],
@@ -34,21 +32,7 @@ async function visibleLabel(page, selector) {
   })()`);
 }
 
-export async function selectMarketFilter(page, input, pollOptions = {}) {
-  const filter = String(input.node?.filter ?? '').trim().toLowerCase();
-  const option = FILTERS.get(filter);
-  if (!option) {
-    throw new Error(`metamask.perps.select_market_filter received unsupported filter ${JSON.stringify(filter)}.`);
-  }
-  const options = resolveVisibleStateOptions({
-    surface: 'market-list',
-    include_offscreen: true,
-    max_items: input.node?.max_items ?? 100,
-    minimum_market_count: input.node?.minimum_market_count ?? 1,
-    maximum_market_count: input.node?.maximum_market_count ?? 200,
-  });
-  const timeoutMs = pollOptions.timeoutMs ?? input.node?.timeout_ms ?? 10_000;
-  const pollIntervalMs = pollOptions.pollIntervalMs ?? 100;
+async function selectDropdownFilter(page, filter, option, timeoutMs, pollIntervalMs) {
   await page.click(dataTestId('filter-select-button'));
   const optionSelector = dataTestId(`filter-select-option-${option}`);
   try {
@@ -76,37 +60,83 @@ export async function selectMarketFilter(page, input, pollOptions = {}) {
     }
     await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
   }
-  const raw = await page.evaluate(`(() => {
-    const maximum = ${JSON.stringify(options.maxItems)};
-    const items = [];
-    let matched = 0;
-    for (const element of document.querySelectorAll('[data-testid]')) {
-      const testId = element.getAttribute('data-testid');
-      if (!testId || !/^(?:market-list-view|market-row-|perps-token-logo-|filter-select-button)/u.test(testId)) continue;
-      const style = getComputedStyle(element);
-      const rect = element.getBoundingClientRect();
-      if (style.display === 'none' || style.visibility === 'hidden' || rect.width <= 0 || rect.height <= 0) continue;
-      matched += 1;
-      if (items.length >= maximum) break;
-      items.push({
-        testId,
-        label: String(element.getAttribute('aria-label') || element.innerText || element.getAttribute('value') || '')
-          .replace(/\\s+/gu, ' ')
-          .trim()
-          .slice(0, 500),
-        role: element.getAttribute('role') || element.tagName.toLowerCase(),
-        enabled: !element.disabled && element.getAttribute('aria-disabled') !== 'true',
-        visible: rect.bottom > 0 && rect.right > 0 && rect.top < innerHeight && rect.left < innerWidth,
-      });
+  return { selectedLabel: selectedState.label, controlKind: 'dropdown', alreadySelected: false };
+}
+
+async function categoryRailState(page) {
+  return page.evaluate(`(() => ({
+    active: [...document.querySelectorAll('[data-testid^="market-list-categories-pill-"][aria-pressed="true"]')].map((element) => ({
+      id: element.getAttribute('data-testid'),
+      option: element.getAttribute('data-testid').slice('market-list-categories-pill-'.length),
+      label: String(element.innerText || '').trim(),
+    })),
+    watchlist: document.querySelector('[data-testid="market-list-watchlist-toggle"]')?.getAttribute('aria-pressed') === 'true',
+  }))()`);
+}
+
+async function selectCategoryRail(page, option, timeoutMs, pollIntervalMs) {
+  const deadline = Date.now() + timeoutMs;
+  const matches = (state) => !state.watchlist && (option === 'all'
+    ? state.active.length === 0
+    : state.active.length === 1 && state.active[0].option === option);
+  const initial = await categoryRailState(page);
+  const alreadySelected = matches(initial);
+  if (!alreadySelected) {
+    if (option === 'all') {
+      if (initial.watchlist) await page.click(dataTestId('market-list-watchlist-toggle'));
+      for (const selected of initial.active) await page.click(dataTestId(selected.id));
+    } else {
+      let selector = dataTestId(`market-list-categories-pill-${option}`);
+      if (!(await visibleLabel(page, selector)).visible) {
+        const more = dataTestId('market-list-categories-more-button');
+        selector = dataTestId(`market-list-categories-more-option-${option}`);
+        if (!(await visibleLabel(page, selector)).visible) {
+          if (!(await visibleLabel(page, more)).visible) {
+            throw new Error(`Perps market filter ${JSON.stringify(option)} is not available in this release.`);
+          }
+          await page.click(more);
+        }
+        await page.waitForSelector(selector, { timeoutMs: Math.max(1, deadline - Date.now()) });
+      }
+      await page.click(selector);
     }
-    return { route: location.hash, title: document.title, items, offscreenItems: [], truncated: matched > items.length };
-  })()`);
+  }
+  let selected = await categoryRailState(page);
+  while (!matches(selected)) {
+    if (Date.now() >= deadline) {
+      throw new Error(`Perps category ${JSON.stringify(option)} did not become selected: ${JSON.stringify(selected)}.`);
+    }
+    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    selected = await categoryRailState(page);
+  }
+  return { selectedLabel: selected.active[0]?.label ?? null, controlKind: 'category-rail', alreadySelected };
+}
+
+export async function selectMarketFilter(page, input, pollOptions = {}) {
+  const filter = String(input.node?.filter ?? '').trim().toLowerCase();
+  const option = FILTERS.get(filter);
+  if (!option) {
+    throw new Error(`metamask.perps.select_market_filter received unsupported filter ${JSON.stringify(filter)}.`);
+  }
+  const timeoutMs = pollOptions.timeoutMs ?? input.node?.timeout_ms ?? 10_000;
+  const pollIntervalMs = pollOptions.pollIntervalMs ?? 100;
+  const rail = await visibleLabel(page, dataTestId('market-list-categories'));
+  const selection = rail.visible
+    ? await selectCategoryRail(page, option, timeoutMs, pollIntervalMs)
+    : await selectDropdownFilter(page, filter, option, timeoutMs, pollIntervalMs);
+  const state = await readVisiblePerpsState(page, {
+    surface: 'market-list',
+    include_offscreen: true,
+    max_items: input.node?.max_items ?? 100,
+    minimum_market_count: input.node?.minimum_market_count ?? 1,
+    maximum_market_count: input.node?.maximum_market_count ?? 200,
+  });
   return {
     action: input.action,
     filter,
     option,
-    selectedLabel: selectedState.label,
-    ...normalizeVisiblePerpsState(raw, options, 'extension'),
+    ...selection,
+    ...state,
     proofPath: 'trusted-pointer-visible-ui',
   };
 }

package/library/actions/extension/perps/set_market_favorite.mjs

@@ -1,3 +1,4 @@
+// Set the current market's favorite state through its visible control, or require it to be unchanged.
 import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 
 runAdapter(async (input) => withExtensionPage(input, async (page) => {
@@ -20,9 +21,15 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
     const button = document.querySelector(${JSON.stringify(selector)});
     if (!button) throw new Error('Perps favorite control is not visible.');
     const label = String(button.getAttribute('aria-label') || button.innerText || '').trim();
+    if (!/^(?:add to|remove from) favorites$/iu.test(label)) {
+      throw new Error('Perps favorite control has an unsupported label: ' + JSON.stringify(label));
+    }
     return { label, favorite: /^remove from favorites$/iu.test(label) };
   })()`);
   const before = await readState();
+  if (requireUnchanged && before.favorite !== desired) {
+    throw new Error(`Perps favorite state for ${market} did not persist across navigation; no change was made.`);
+  }
   if (before.favorite !== desired) {
     await page.click(selector);
   }
@@ -37,9 +44,6 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
     throw new Error(`Perps favorite state did not become ${desired}.`);
   }
   const changed = before.favorite !== after.favorite;
-  if (requireUnchanged && changed) {
-    throw new Error(`Perps favorite state for ${market} did not persist across navigation.`);
-  }
   return {
     action: input.action,
     market,

package/library/actions/extension/perps/state.mjs

@@ -1,3 +1,4 @@
+// Build a page expression that reads Perps provider, network, initialization, and eligibility from state hooks.
 export function readPerpsRuntimeStateExpression() {
   return `(async () => {
     const hooks = globalThis.stateHooks || {};
@@ -11,6 +12,7 @@ export function readPerpsRuntimeStateExpression() {
     return {
       available: typeof request === 'function',
       activeProvider: metamask.activeProvider || nestedPerps.activeProvider || 'hyperliquid',
+      providerKnown: typeof (metamask.activeProvider ?? nestedPerps.activeProvider) === 'string',
       networkKnown: typeof metamask.isTestnet === 'boolean' || typeof nestedPerps.isTestnet === 'boolean',
       isTestnet: Boolean(metamask.isTestnet ?? nestedPerps.isTestnet),
       initializationState: metamask.initializationState || nestedPerps.initializationState || null,

package/library/actions/extension/perps/update_position_tpsl.mjs

@@ -1,3 +1,5 @@
+// Submit live take-profit and stop-loss changes through visible controls with mutation receipts.
+// Check the funded position identity and observe the exact requested prices.
 import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
 import {
   assertTrustedExternalMutationTarget,
@@ -229,7 +231,6 @@ export async function updatePositionTpsl(input) {
       let dispatchTarget;
       try {
         await requireCurrentVisibleFundingBalance(input, page, timeoutMs, fundingBalance.observedBaseUnits);
-        await requirePerpsTradingContext(input, page);
         assertTrustedExternalMutationTarget(input, page, identity);
         const current = await readPosition(page, market);
         if (current.size !== before.size || current.direction !== before.direction
@@ -246,6 +247,7 @@ export async function updatePositionTpsl(input) {
           const rect = element.getBoundingClientRect();
           return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 };
         })()`);
+        await requirePerpsTradingContext(input, page);
         assertTrustedExternalMutationTarget(input, page, identity);
       } catch (error) {
         throw externalMutationNotDispatched(error instanceof Error ? error.message : String(error));

package/library/actions/extension/perps/visible-mutation-identity.mjs

@@ -1,3 +1,5 @@
+// Parse and match visible Perps position and order identities using USD base-unit tolerances.
+// Also wait for a stable, loaded Perps home view, optionally requiring zero positions and orders.
 const INTEGER = /^(0|[1-9][0-9]{0,29})$/u;
 
 export function parseUsdBaseUnits(value) {
@@ -129,10 +131,12 @@ export async function waitForStableGlobalPerpsHome(page, options = {}) {
         return rect.width > 0 && rect.height > 0 && style.display !== 'none' && style.visibility !== 'hidden';
       };
       const visibleCount = (selector) => [...document.querySelectorAll(selector)].filter(visible).length;
-      const balance = document.querySelector('[data-testid="perps-balance-dropdown-balance"]');
+      const balance = document.querySelector('[data-testid="perps-balance-actions-available-value"]')
+        ?? document.querySelector('[data-testid="perps-balance-dropdown-balance"]');
       return {
         route: String(location.hash),
-        viewVisible: visible(document.querySelector('[data-testid="perps-view"]')),
+        viewVisible: visible(document.querySelector('[data-testid="perps-home-page"]')
+          ?? document.querySelector('[data-testid="perps-view"]')),
         loading: visibleCount('[data-testid$="-skeleton"], [data-testid*="loading"]') > 0,
         marketCount: visibleCount('[data-testid="perps-explore-markets-row"]'),
         positionCount: visibleCount('[data-testid^="position-card-"]:not([data-testid^="position-card-roe-"])'),