@deeeed/metamask-harness 0.80.0 → 0.82.0

package/library/actions/{terminal → web-dapp}/app/launch.mjs

@@ -1,14 +1,15 @@
-// Explicit lifecycle step: start (or reuse) the terminal slot browser with the
+// Explicit lifecycle step: start (or reuse) the web-dapp slot browser with the
 // requested signer (MetaMask extension or injected strict wallet) and fixture
 // account, and the wallet host that records wallet requests. A fresh_profile
 // start forgets the app's stored agent key and the extension's dapp permission.
 
-import { appPort, cdpPort, isDirectRun, resolveSigner, runAdapter } from '../platform/runtime.mjs';
-import { launchTerminalBrowser } from '../../../../adapters/terminal/launch.mjs';
+import { appPort, cdpPort, isDirectRun, resolveSigner, runAdapter, webDappPolicy } from '../platform/runtime.mjs';
+import { launchWebDappBrowser } from '../../../../adapters/web-dapp/launch.mjs';
 
 export async function launch(input) {
   const node = input.node ?? {};
-  const state = await launchTerminalBrowser({
+  const policy = webDappPolicy();
+  const state = await launchWebDappBrowser({
     target: input.context?.projectRoot,
     'cdp-port': cdpPort(input),
     'app-port': appPort(input),
@@ -22,8 +23,8 @@ export async function launch(input) {
     'slow-mo': node.slow_mo_ms,
     network: node.network,
     'mainnet-confirmation': node.mainnet_confirmation,
-    'start-chain': node.start_chain ?? 42161,
-  });
+    'start-chain': node.start_chain ?? policy.startChain,
+  }, process.env);
   return {
     action: input.action,
     status: 'ready',
@@ -38,7 +39,7 @@ export async function launch(input) {
     slowMoMs: state.slowMoMs ?? 0,
     extension: state.extension ? { id: state.extension.id, version: state.extension.version } : null,
     freshProfile: state.freshProfile,
-    proofPath: 'terminal-browser-launch',
+    proofPath: `${policy.adapterId}-browser-launch`,
   };
 }
 

package/library/actions/{terminal → web-dapp}/platform/hud.mjs

@@ -1,11 +1,12 @@
-// app.hud for the terminal: fold the runner's progress update into
+// app.hud for web-dapp: fold the runner's progress update into
 // <runtime>/hud.json and draw it on the app tab now. The wallet host redraws
 // the same state after every navigation. The HUD is advisory: a missing
 // browser or a busy tab skips the update instead of failing the recipe.
 
-import { clearHudState, hudRenderExpression, nextHudState, readHudState, writeHudState } from '../../../../adapters/terminal/lib/hud.mjs';
-import { isAppUrl } from '../../../../adapters/terminal/lib/origin.mjs';
-import { appOrigin, cdpPort, readBrowserState, terminalRuntimeDir } from './runtime.mjs';
+import { isAppUrl } from '@farmslot/adapter-web/origin';
+
+import { clearHudState, hudRenderExpression, nextHudState, readHudState, writeHudState } from '../../../../adapters/web-dapp/lib/hud.mjs';
+import { appOrigin, cdpPort, readBrowserState, webDappRuntimeDir } from './runtime.mjs';
 import { importRecipeHarnessRuntimeCdp } from '../../harness-exports.mjs';
 
 // --hud show draws in any mode; --hud auto (the default) only for a visible
@@ -46,14 +47,14 @@ async function drawOnAppTabs(input, expression, timeoutMs = 3000) {
   return results;
 }
 
-export async function showTerminalHud(input, { hudPolicy = 'auto' } = {}) {
+export async function showAppHud(input, { hudPolicy = 'auto' } = {}) {
   const node = input.node ?? {};
   const projectRoot = input.context?.projectRoot;
   const nodeId = input.context?.nodeId ?? '';
   const browserState = projectRoot ? await readBrowserState(projectRoot) : null;
   if (!browserState) return { hud: false, skipped: true, reason: 'no slot browser yet' };
   if (!hudVisible(hudPolicy, browserState)) return { hud: false, skipped: true, reason: 'headless browser (--hud show draws anyway)' };
-  const runtimeDir = terminalRuntimeDir(projectRoot);
+  const runtimeDir = webDappRuntimeDir(projectRoot);
   let state = null;
   if (node.clear === true) {
     clearHudState(runtimeDir);

package/library/actions/{terminal → web-dapp}/platform/page.mjs

@@ -1,4 +1,4 @@
-// Select the CDP page a terminal UI action drives: the app tab (default) or the
+// Select the CDP page a web-dapp UI action drives: the app tab (default) or the
 // MetaMask wallet surface (side panel / notification / popup) that shows the
 // pending dapp request. Pages are never brought to front unless
 // FARMSLOT_FOCUS_BROWSER=1, as in the Extension adapter: Page.bringToFront
@@ -6,10 +6,11 @@
 // app tab is the only tab of its window (the wallet host closes the others),
 // so it stays the window's active tab and keeps painting without it.
 
-import { resolveSlowMo } from '../../../../adapters/terminal/lib/display.mjs';
-import { HUD_ELEMENT } from '../../../../adapters/terminal/lib/hud.mjs';
-import { isAppUrl } from '../../../../adapters/terminal/lib/origin.mjs';
-import { cdpListenerPids } from '../../../../adapters/terminal/lib/processes.mjs';
+import { isAppUrl } from '@farmslot/adapter-web/origin';
+
+import { resolveSlowMo } from '../../../../adapters/web-dapp/lib/display.mjs';
+import { HUD_ELEMENT } from '../../../../adapters/web-dapp/lib/hud.mjs';
+import { cdpListenerPids } from '../../../../adapters/web-dapp/lib/processes.mjs';
 import { appOrigin, cdpPort, readBrowserState } from './runtime.mjs';
 import { importRecipeHarnessRuntimeCdp } from '../../harness-exports.mjs';
 
@@ -40,7 +41,7 @@ export function pickAppTarget(targets, origin) {
   return pages.find((target) => isAppUrl(target.url, origin)) ?? pages.find((target) => target.url === 'about:blank') ?? null;
 }
 
-export async function selectTerminalTarget(input) {
+export async function selectAppTarget(input) {
   const node = input.node ?? {};
   const port = cdpPort(input);
   const surface = resolveSurface(node);
@@ -74,7 +75,7 @@ export async function selectTerminalTarget(input) {
 // the DOM instead.
 class WalletSurfacePage extends CdpWebPage {
   evaluate(expression) {
-    return this.evaluateInIsolatedWorld(expression, 'mm-terminal-wallet-surface');
+    return this.evaluateInIsolatedWorld(expression, 'web-dapp-wallet-surface');
   }
 }
 
@@ -88,7 +89,7 @@ export function hudVisibilityExpression(visible) {
   return `(() => { const host = document.documentElement.querySelector(':scope > ${HUD_ELEMENT}'); if (!host) return false; host.style.visibility = ${JSON.stringify(visible ? '' : 'hidden')}; return true; })()`;
 }
 
-class TerminalAppPage extends CdpWebPage {
+class AppPage extends CdpWebPage {
   async screenshot(context, relPath, metadata = {}) {
     const hidden = await this.evaluate(hudVisibilityExpression(false)).catch(() => false);
     try {
@@ -143,7 +144,7 @@ class TerminalAppPage extends CdpWebPage {
       }
       const top = document.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2);
       return { error: 'Target is fully covered by ' + (top ? top.tagName.toLowerCase() : 'nothing') + ': ' + ${JSON.stringify(selector)} };
-    })()`, 'mm-terminal-click');
+    })()`, 'web-dapp-click');
   }
 
   async setInput(selector, value) {
@@ -216,14 +217,14 @@ export function assertAppListenersUnchanged(state, current) {
 
 const PAGE_DEPS = Object.freeze({
   listeners: (port) => cdpListenerPids(port),
-  select: (input) => selectTerminalTarget(input),
+  select: (input) => selectAppTarget(input),
   connect: (url) => CdpSession.connect(url),
   browserState: (projectRoot) => readBrowserState(projectRoot),
   sleep: (ms) => sleep(ms),
   env: process.env,
 });
 
-export async function withTerminalPage(input, callback, deps = PAGE_DEPS) {
+export async function withAppPage(input, callback, deps = PAGE_DEPS) {
   const state = input.context?.projectRoot ? await deps.browserState(input.context.projectRoot) : null;
   const delay = slowMoFor(state, deps.env);
   if (delay > 0) await deps.sleep(delay);
@@ -236,7 +237,7 @@ export async function withTerminalPage(input, callback, deps = PAGE_DEPS) {
     await session.call('Page.enable');
     await session.call('Runtime.enable');
     if (focusBrowserRequested(deps.env)) await session.call('Page.bringToFront');
-    const page = surface === 'wallet' ? new WalletSurfacePage(session) : new TerminalAppPage(session);
+    const page = surface === 'wallet' ? new WalletSurfacePage(session) : new AppPage(session);
     const result = await callback(page);
     return result && typeof result === 'object' && !Array.isArray(result)
       ? { ...result, surface, cdpPort: port, targetUrl: target.url.replace(/0x[0-9a-fA-F]{40}/gu, '<address>') }

package/library/actions/{terminal → web-dapp}/platform/runtime.mjs

@@ -1,6 +1,6 @@
-// Resolve the Web Terminal slot runtime: ports, runtime paths, browser state and
-// wallet-fixture accounts. Key material is only ever returned as a viem account
-// object; callers must never log or persist it.
+// Resolve the web-dapp slot runtime: the venue policy, ports, runtime paths,
+// browser state and wallet-fixture accounts. Key material is only ever
+// returned as a viem account object; callers must never log or persist it.
 
 import { realpathSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
@@ -11,6 +11,9 @@ import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
 
 import { recipeRuntimeDir } from '@farmslot/recipe-cli/harness';
 import { walletFixturePath } from '../../harness-exports.mjs';
+import { POLICY_ENV, webDappAdapterId, webDappPolicy } from '../../../../adapters/web-dapp/lib/policy.mjs';
+
+export { POLICY_ENV, webDappAdapterId, webDappPolicy };
 
 export const SIGNER_MODES = Object.freeze(['extension', 'injected']);
 export const DEFAULT_ACCOUNT = 'dev1';
@@ -26,12 +29,13 @@ export function canonicalPath(target) {
   }
 }
 
-export function terminalRuntimeDir(projectRoot) {
-  return path.join(canonicalPath(projectRoot), recipeRuntimeDir(), 'terminal');
+// <checkout>/<runtime>/<adapter id>, e.g. temp/recipe/runtime/terminal.
+export function webDappRuntimeDir(projectRoot) {
+  return path.join(canonicalPath(projectRoot), recipeRuntimeDir(), webDappPolicy().adapterId);
 }
 
-export function terminalRuntimePath(projectRoot, ...segments) {
-  return path.join(terminalRuntimeDir(projectRoot), ...segments);
+export function webDappRuntimePath(projectRoot, ...segments) {
+  return path.join(webDappRuntimeDir(projectRoot), ...segments);
 }
 
 function portFrom(raw, label) {
@@ -53,7 +57,7 @@ export function appPort(input = {}, env = process.env) {
     portFrom(env.WATCHER_PORT, 'WATCHER_PORT');
   if (!port) {
     throw new Error(
-      'terminal adapter requires the slot dev-server port.\n' +
+      `${webDappPolicy().adapterId} adapter requires the slot dev-server port.\n` +
       'Next: pass --watcher-port <port> (Farmslot: {{port}}) or set TERMINAL_APP_PORT.',
     );
   }
@@ -71,7 +75,7 @@ export function cdpPort(input = {}, env = process.env) {
     portFrom(env.CDP_PORT, 'CDP_PORT');
   if (!port) {
     throw new Error(
-      'terminal adapter requires a per-slot browser CDP port.\n' +
+      `${webDappPolicy().adapterId} adapter requires a per-slot browser CDP port.\n` +
       'Next: pass --cdp-port <port> (Farmslot: {{cdp_port}}).',
     );
   }
@@ -92,7 +96,7 @@ export async function writePrivateJson(file, value) {
 }
 
 export async function readBrowserState(projectRoot) {
-  return readJsonFile(terminalRuntimePath(projectRoot, 'browser.json'));
+  return readJsonFile(webDappRuntimePath(projectRoot, 'browser.json'));
 }
 
 export function resolveSigner(raw) {
@@ -123,7 +127,7 @@ export async function loadWalletFixture(projectRoot, env = process.env) {
   if (!fixture) {
     throw new Error(
       `wallet fixture not found at ${file}.\n` +
-      'Next: mm-harness install --adapter terminal --target <checkout> with RECIPE_WALLET_FIXTURE set, or copy the fixture there (0600).',
+      `Next: mm-harness install --adapter ${webDappPolicy().adapterId} --target <checkout> with RECIPE_WALLET_FIXTURE set, or copy the fixture there (0600).`,
     );
   }
   if (!Array.isArray(fixture.accounts) || fixture.accounts.length === 0) {
@@ -195,7 +199,7 @@ export async function runAdapter(callback) {
     const output = await callback(input);
     await writeFile(input.outputPath, `${JSON.stringify(output, null, 2)}\n`);
   } catch (error) {
-    process.stderr.write(`[terminal] ${input.action} failed: ${error?.stack ?? error}\n`);
+    process.stderr.write(`[${webDappAdapterId()}] ${input.action} failed: ${error?.stack ?? error}\n`);
     process.exitCode = 1;
   }
 }

package/library/actions/web-dapp/ui/navigate.mjs

@@ -0,0 +1,24 @@
+// Navigate the app tab to an explicit app path, or a product page the venue
+// policy names (the Terminal's order/<MARKET>, portfolio, home), and wait for
+// the document to be ready.
+
+import { appOrigin, isDirectRun, runAdapter, webDappPolicy } from '../platform/runtime.mjs';
+import { withAppPage } from '../platform/page.mjs';
+
+export function pathFor(node = {}, policy = webDappPolicy()) {
+  if (typeof node.path === 'string' && node.path.startsWith('/')) return node.path;
+  return policy.pagePath(node);
+}
+
+export async function navigate(input) {
+  const node = input.node ?? {};
+  const url = `${appOrigin(input)}${pathFor(node)}`;
+  return withAppPage({ ...input, node: { ...node, surface: 'app' } }, async (page) => {
+    await page.navigate(url, Number(node.timeout_ms ?? 120000));
+    await page.waitForDocumentReady({ expectedUrl: url, timeoutMs: Number(node.timeout_ms ?? 120000) });
+    if (node.settle_ms) await new Promise((resolve) => setTimeout(resolve, Number(node.settle_ms)));
+    return { action: input.action, url, page: node.page ?? 'order', market: node.market ?? null };
+  });
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => navigate(input));

package/library/actions/web-dapp/wallet/_signature-log.mjs

@@ -0,0 +1,32 @@
+// The wallet request log: where the wallet host writes it, and what the venue
+// forbids in it. Reading, windowing and asserting the log are
+// @farmslot/adapter-web/dapp's; the venue's rules come from its policy
+// (`signatureLog`, the Terminal's L1 and mainnet rules).
+
+import { webDappPolicy, webDappRuntimePath } from '../platform/runtime.mjs';
+
+export function signatureLog(projectRoot) {
+  return {
+    logFile: webDappRuntimePath(projectRoot, 'wallet-requests.jsonl'),
+    cursorFile: webDappRuntimePath(projectRoot, 'wallet-requests.cursor.json'),
+  };
+}
+
+// What the venue forbids in the log (a SignaturePolicy), e.g. the Terminal's L1 and mainnet rules.
+export function signaturePolicy() {
+  return webDappPolicy().signatureLog ?? {};
+}
+
+// The id the actions report their evidence under, e.g. terminal-wallet-request-log.
+export function evidenceId(suffix) {
+  return `${webDappPolicy().adapterId}-${suffix}`;
+}
+
+// Evidence goes to <artifacts>/<adapter id>-wallet/<node>-signature-log.json.
+export function logArtifactTarget(input) {
+  return {
+    artifactsDir: input.context?.artifactsDir,
+    nodeId: input.context?.nodeId ?? input.action,
+    folder: evidenceId('wallet'),
+  };
+}

package/library/actions/{terminal → web-dapp}/wallet/assert_signatures.mjs

@@ -3,22 +3,16 @@
 // payloads, active-chain matching and, in extension mode, confirmations shown.
 // The full window is retained as evidence whether or not the assertion holds.
 
+import { awaitSignatureLog, writeLogArtifact } from '@farmslot/adapter-web/dapp';
+
 import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
-import { evaluateSignatureLog, windowSinceCursor, writeLogArtifact } from './_signature-log.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
 
 export async function assertSignatures(input) {
   const node = input.node ?? {};
-  const projectRoot = input.context?.projectRoot;
-  const deadline = Date.now() + Math.max(0, Number(node.timeout_ms ?? 0));
-  let window = await windowSinceCursor(projectRoot);
-  let result = evaluateSignatureLog(window.entries, node);
-  // Entries arrive asynchronously from the wallet host; allow a short settle.
-  while (!result.ok && Date.now() < deadline) {
-    await new Promise((resolve) => setTimeout(resolve, 500));
-    window = await windowSinceCursor(projectRoot);
-    result = evaluateSignatureLog(window.entries, node);
-  }
-  const artifacts = await writeLogArtifact(input, {
+  // Entries arrive asynchronously from the wallet host; timeout_ms allows a short settle.
+  const { window, result } = await awaitSignatureLog(signatureLog(input.context?.projectRoot), node, signaturePolicy());
+  const artifacts = await writeLogArtifact(logArtifactTarget(input), {
     cursor: window.cursor,
     total: window.total,
     expectations: node,
@@ -30,13 +24,13 @@ export async function assertSignatures(input) {
   }
   return {
     action: input.action,
-    source: 'terminal-wallet-request-log',
+    source: evidenceId('wallet-request-log'),
     cursor: window.cursor,
     count: window.entries.length,
     summary: result.summary,
     entries: window.entries,
     artifacts,
-    proofPath: 'terminal-wallet-request-log',
+    proofPath: evidenceId('wallet-request-log'),
   };
 }
 

package/library/actions/{terminal → web-dapp}/wallet/list_accounts.mjs

@@ -1,7 +1,7 @@
 // List the wallet-fixture account names and addresses available to the slot
 // browser, marking the one the running browser uses. Addresses only.
 
-import { isDirectRun, loadWalletFixture, readBrowserState, runAdapter, viemAccountFromEntry } from '../platform/runtime.mjs';
+import { isDirectRun, loadWalletFixture, readBrowserState, runAdapter, viemAccountFromEntry, webDappPolicy } from '../platform/runtime.mjs';
 
 export async function listAccounts(input) {
   const projectRoot = input.context?.projectRoot;
@@ -20,7 +20,7 @@ export async function listAccounts(input) {
     accounts,
     count: accounts.length,
     redacted: true,
-    proofPath: 'terminal-wallet-accounts',
+    proofPath: `${webDappPolicy().adapterId}-wallet-accounts`,
   };
 }
 

package/library/actions/web-dapp/wallet/read_signatures.mjs

@@ -0,0 +1,38 @@
+// Return the wallet request log since the last reset and retain it as run
+// evidence. reset=true moves the window start to the end of the log so the next
+// read covers only what follows (an explicit setup step, recorded in the trace).
+
+import { resetWindow, summarize, windowSinceCursor, writeLogArtifact } from '@farmslot/adapter-web/dapp';
+
+import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
+
+export async function readSignatures(input) {
+  const log = signatureLog(input.context?.projectRoot);
+  if (input.node?.reset === true) {
+    const { cursor, previousEntries } = await resetWindow(log);
+    return {
+      action: input.action,
+      source: evidenceId('wallet-request-log'),
+      reset: true,
+      cursor,
+      previousEntries,
+      proofPath: evidenceId('wallet-request-log'),
+    };
+  }
+  const { cursor, entries, total } = await windowSinceCursor(log);
+  const summary = summarize(entries, signaturePolicy());
+  const artifacts = await writeLogArtifact(logArtifactTarget(input), { cursor, total, summary, entries });
+  return {
+    action: input.action,
+    source: evidenceId('wallet-request-log'),
+    cursor,
+    count: entries.length,
+    summary,
+    entries,
+    artifacts,
+    proofPath: evidenceId('wallet-request-log'),
+  };
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => readSignatures(input));

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

@@ -819,7 +819,7 @@
       "execution_capabilities": []
     },
     "metamask.perps.quote_fees": {
-      "description": "core Quote an order's fees through the perps controller's calculateFees (HyperLiquid, testnet by default, read-only): protocol and MetaMask fee rates and amounts (plus the winning fee source on a core that reports it), with an optional rewards discount supplied as RewardsController:getPerpsDiscountForAccount.",
+      "description": "core Quote an order's fees through the perps controller's calculateFees (HyperLiquid, testnet by default, read-only): protocol and MetaMask fee rates and amounts (plus the winning fee source on a core that reports it), with the rewards discount the headless RewardsController answers: the rewards API's answer for the selected wallet fixture account, the calls Mobile makes (UAT by default, like Mobile dev builds; CORE_PERPS_REWARDS_API_URL selects another).",
       "schema": {
         "type": "object",
         "properties": {
@@ -852,7 +852,7 @@
           },
           "rewards_discount_bips": {
             "type": "integer",
-            "description": "Rewards discount the headless RewardsController answers with, an integer in basis points from 0 through 10000 (6500 = 65%). Omitted: no rewards source, the controller's 'not known yet'."
+            "description": "Rewards discount the headless RewardsController answers with, an integer in basis points from 0 through 10000 (6500 = 65%). Replaces the rewards API's answer, to prove a discount the fixture accounts do not hold."
           },
           "account": {
             "type": "string",
@@ -1093,6 +1093,10 @@
             "type": "number",
             "default": 3
           },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
+          },
           "account": {
             "type": "string",
             "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."

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

@@ -4371,6 +4371,10 @@
             "type": "number",
             "default": 1
           },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
+          },
           "provider": {
             "type": "string",
             "description": "Exact Perps provider required before background dispatch."

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

@@ -2775,6 +2775,18 @@
           "leverage": {
             "type": "number",
             "default": 3
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ],
+            "description": "Perps network the order must run on; checked against the live app. A mainnet order must declare mainnet."
+          },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
           }
         },
         "additionalProperties": false