@deeeed/metamask-harness 0.34.1 → 0.34.3

package/dist/live-adapter-contract.js

@@ -352,15 +352,15 @@ function liveAdapterProcessTimeoutMs(node) {
   }
   const settleMs = Number(node.settle_ms);
   const settleAllowance = Number.isFinite(settleMs) && settleMs > 0 ? settleMs : 0;
-  if (node.timeout_ms != null) {
-    const timeoutMs = Number(node.timeout_ms);
-    return Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs + settleAllowance + 5e3 : 6e4;
-  }
-  const actionTimeouts = [node.target_timeout_ms, node.unlock_timeout_ms].map(Number).filter((value) => Number.isFinite(value) && value > 0);
+  const actionTimeouts = [
+    node.target_timeout_ms,
+    node.unlock_timeout_ms,
+    node.timeout_ms
+  ].map(Number).filter((value) => Number.isFinite(value) && value > 0);
   if (actionTimeouts.length > 0) {
     return Math.max(
       6e4,
-      actionTimeouts.reduce((total, value) => total + value, 0) + 5e3
+      actionTimeouts.reduce((total, value) => total + value, 0) + settleAllowance + 5e3
     );
   }
   return 6e4 + settleAllowance;

package/dist/recipe-security.js

@@ -9,6 +9,7 @@ const READ_ONLY_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.read_positions",
   "metamask.perps.read_orders",
   "metamask.perps.read_account",
+  "metamask.perps.read_snapshot",
   "metamask.perps.assert_positions",
   "metamask.perps.assert_orders",
   // Collector reads are host-only; starting capture remains arbitrary-code
@@ -29,6 +30,8 @@ const APP_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.ensure_positions",
   "metamask.perps.ensure_orders",
   "metamask.perps.clear_performance_caches",
+  "metamask.perps.measure_homepage_visible",
+  "metamask.perps.prepare_local_snapshot_endpoint",
   "metamask.perps.start_state",
   "metamask.perps.teardown_state",
   // Consent changes wallet state and is therefore an app mutation.

package/dist/runner.js

@@ -1,4 +1,4 @@
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { createMetaMaskAdapters, createMetaMaskUiTransport } from "./adapters.js";
 import { bridgeCommand } from "../library/actions/mobile/platform/bridge.mjs";
@@ -239,6 +239,8 @@ function isAutomaticHudProgress(action, node, nodeId) {
 function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe = probeMobileLifecycleRuntime, sourceFreshness = {
   fingerprint: mobileSourceFingerprint,
   record: recordMobileSourceBaseline
+}, processIdentity = {
+  readIosPid: readIosAppPid
 }) {
   if (adapter !== "mobile") return lifecycle;
   return lifecycle.map((entry) => ({
@@ -246,6 +248,8 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
     async execute(node, context) {
       const command = node.command ?? node.event ?? node.state;
       const reloadsSource = command === "launch" || command === "foreground" || command === "restart";
+      const checksIosContinuity = command === "foreground" && !isAndroidLifecycle(node, context.env ?? {});
+      const processBefore = checksIosContinuity ? processIdentity.readIosPid(node, context) : void 0;
       const fingerprint = reloadsSource ? sourceFreshness.fingerprint(context.projectRoot) : void 0;
       const androidRestart = command === "restart" && isAndroidLifecycle(node, context.env ?? {});
       const initialNode = androidRestart ? { ...node, settle_ms: 0 } : node;
@@ -261,6 +265,25 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
       if (reloadsSource) {
         await readinessProbe(node, context);
       }
+      if (checksIosContinuity) {
+        const processAfter = processIdentity.readIosPid(node, context);
+        const actualTransition = processBefore !== null && processBefore === processAfter ? "foreground_resume" : processAfter !== null ? "cold_relaunch" : "unknown";
+        const resultRecord = asRecord(result);
+        result = {
+          ...resultRecord,
+          output: {
+            ...asRecord(resultRecord.output),
+            actualTransition,
+            processBefore,
+            processAfter
+          }
+        };
+        if (node.require_process_continuity === true && actualTransition !== "foreground_resume") {
+          throw new Error(
+            `iOS foreground did not preserve the app process (actualTransition=${actualTransition}, before=${String(processBefore)}, after=${String(processAfter)}); this lifecycle sample is a cold relaunch, not a reconnect.`
+          );
+        }
+      }
       if (fingerprint !== void 0 && !sourceFreshness.record(context.projectRoot, fingerprint)) {
         throw new Error(
           "Mobile source changed while the app was reloading; the loaded-source baseline was not recorded. Next: retry app.lifecycle restart."
@@ -270,6 +293,26 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
     }
   }));
 }
+function readIosAppPid(node, context) {
+  const env = context.env ?? {};
+  const device = node.simulator ?? node.ios_simulator ?? env.SIM_UDID ?? env.IOS_SIMULATOR ?? process.env.SIM_UDID ?? process.env.IOS_SIMULATOR;
+  const bundleId = node.bundle_id ?? node.bundleId ?? env.IOS_BUNDLE_ID ?? process.env.IOS_BUNDLE_ID ?? "io.metamask.MetaMask";
+  if (typeof device !== "string" || typeof bundleId !== "string") return null;
+  try {
+    const output = execFileSync(
+      "xcrun",
+      ["simctl", "spawn", device, "launchctl", "list"],
+      { encoding: "utf8", timeout: 5e3 }
+    );
+    const labelPrefix = `UIKitApplication:${bundleId}[`;
+    const line = output.split("\n").find((candidate) => candidate.includes(labelPrefix));
+    if (!line) return null;
+    const pid = Number.parseInt(line.trim().split(/\s+/u)[0] ?? "", 10);
+    return Number.isInteger(pid) && pid > 0 ? pid : null;
+  } catch {
+    return null;
+  }
+}
 function isAndroidLifecycle(node, env) {
   const platform = node.platform ?? env.PLATFORM ?? process.env.PLATFORM;
   if (platform === "android") return true;
@@ -299,10 +342,9 @@ function mergeAndroidRestartResults(initialResult, foregroundResult) {
 }
 async function probeMobileLifecycleRuntime(node, context) {
   const command = node.command ?? node.event ?? node.state;
-  const defaultTimeoutMs = command === "restart" || command === "launch" ? 6e4 : 3e4;
-  const timeoutMs = lifecycleReadinessTimeout(
-    node.runtime_ready_timeout_ms,
-    defaultTimeoutMs
+  const timeoutMs = resolveMobileLifecycleReadinessTimeout(
+    command,
+    node.runtime_ready_timeout_ms
   );
   const deadline = Date.now() + timeoutMs;
   let lastError;
@@ -328,8 +370,10 @@ async function probeMobileLifecycleRuntime(node, context) {
     `Mobile lifecycle ${String(command)} did not expose a usable pinned __AGENTIC__ runtime within ${timeoutMs}ms: ${lastError instanceof Error ? lastError.message : String(lastError)}`
   );
 }
-function lifecycleReadinessTimeout(value, fallback) {
-  if (value === void 0) return fallback;
+function resolveMobileLifecycleReadinessTimeout(command, value) {
+  if (value === void 0) {
+    return command === "launch" || command === "restart" || command === "foreground" ? 6e4 : 3e4;
+  }
   const timeout = Number(value);
   if (!Number.isInteger(timeout) || timeout < 1e3 || timeout > 12e4) {
     throw new Error(
@@ -364,5 +408,6 @@ export {
   createMetaMaskMobileRunner,
   createMetaMaskRunner,
   isAutomaticHudProgress,
-  mobileSourceAwareLifecycleAdapters
+  mobileSourceAwareLifecycleAdapters,
+  resolveMobileLifecycleReadinessTimeout
 };

package/dist/runtime-context.js

@@ -244,6 +244,7 @@ function persistExplicitDevicePin(target, device) {
     return;
   }
   const next = { ...existing };
+  next.platform = device.platform;
   if (device.platform === "ios") {
     const simulatorName = device.name ? device.name.replace(/_/gu, " ").trim() : device.id;
     next.simulator = simulatorName;

package/library/actions/core/perps/_controller.mjs

@@ -39,8 +39,9 @@ function messengerEntry(projectRoot) {
 // a persistent auto-reconnecting HyperLiquid WebSocket (HyperLiquidClientService
 // .initialize → wsTransport.ready()); these logs proved the order returns over
 // HTTP while that open socket kept the event loop alive — see disconnectAndExit.
-function buildInfrastructure(stubbed) {
+function buildInfrastructure(stubbed, input) {
   const noop = () => undefined;
+  const terminalApi = resolveTerminalApi(input);
   return {
     logger: {
       error: (error, meta) =>
@@ -79,6 +80,7 @@ function buildInfrastructure(stubbed) {
       setItem: async () => undefined,
       removeItem: async () => undefined,
     },
+    ...(terminalApi ? { terminalApi } : {}),
     rewards: { getPerpsDiscountForAccount: async () => null },
   };
 }
@@ -246,6 +248,25 @@ export function resolveNetwork(input) {
   return raw;
 }
 
+export function resolveTerminalApi(input) {
+  const marketDataUrl = String(
+    input.node?.terminal_market_data_url ??
+      process.env.CORE_PERPS_TERMINAL_MARKET_DATA_URL ??
+      '',
+  ).trim();
+  const globalSnapshotUrl = String(
+    input.node?.terminal_global_snapshot_url ??
+      process.env.CORE_PERPS_TERMINAL_GLOBAL_SNAPSHOT_URL ??
+      '',
+  ).trim();
+
+  if (!marketDataUrl && !globalSnapshotUrl) return undefined;
+  return {
+    ...(marketDataUrl ? { marketDataUrl } : {}),
+    ...(globalSnapshotUrl ? { globalSnapshotUrl } : {}),
+  };
+}
+
 export function requireRuntimeExport(moduleNamespace, exportName, sourceLabel) {
   const value = moduleNamespace?.[exportName] ?? moduleNamespace?.default?.[exportName];
   if (value === undefined) {
@@ -264,8 +285,16 @@ export async function getCoreController(input) {
   if (!projectRoot) throw new Error('core adapter requires context.projectRoot.');
   const accountAddress = await requireAccountAddress(input);
   const network = resolveNetwork(input);
+  const terminalApi = resolveTerminalApi(input);
+  const terminalApiKey = JSON.stringify(terminalApi ?? null);
 
-  if (cached && cached.projectRoot === projectRoot && cached.network === network) {
+  if (
+    cached &&
+    cached.projectRoot === projectRoot &&
+    cached.network === network &&
+    cached.accountAddress.toLowerCase() === accountAddress.toLowerCase() &&
+    cached.terminalApiKey === terminalApiKey
+  ) {
     return { ...cached, accountAddress };
   }
 
@@ -290,7 +319,7 @@ export async function getCoreController(input) {
   );
 
   const stubbed = new Set();
-  const infrastructure = buildInfrastructure(stubbed);
+  const infrastructure = buildInfrastructure(stubbed, input);
 
   // Root + child messenger pair, mirroring the real app wiring (and the core
   // repo's own test harness in
@@ -305,6 +334,7 @@ export async function getCoreController(input) {
     namespace: 'PerpsController',
     parent: rootMessenger,
   });
+  registerSelectedAccountHandler(rootMessenger, messenger, accountAddress);
 
   // Default testnet. Mainnet only on explicit node.network: "mainnet" — mainnet
   // reads are safe; mainnet mutations use real funds (gated in getCoreControllerWithSigner).
@@ -339,7 +369,15 @@ export async function getCoreController(input) {
       );
     }
   }
-  cached = { controller, messenger, rootMessenger, projectRoot, network };
+  cached = {
+    controller,
+    messenger,
+    rootMessenger,
+    projectRoot,
+    network,
+    accountAddress,
+    terminalApiKey,
+  };
   return { ...cached, accountAddress };
 }
 
@@ -366,11 +404,30 @@ export async function getCoreController(input) {
 // getSelectedEvmAccountFromMessenger). These get registered on the root and
 // delegated into the PerpsController child messenger.
 const SIGNER_ACTIONS = [
-  'AccountsController:getSelectedAccount',
   'KeyringController:getState',
   'KeyringController:signTypedMessage',
 ];
 
+function registerSelectedAccountHandler(
+  rootMessenger,
+  childMessenger,
+  address,
+) {
+  rootMessenger.registerActionHandler(
+    'AccountsController:getSelectedAccount',
+    () => ({
+      id: 'core-headless-account',
+      address,
+      type: 'eip155:eoa',
+      metadata: { keyring: { type: 'HD Key Tree' } },
+    }),
+  );
+  rootMessenger.delegate({
+    actions: ['AccountsController:getSelectedAccount'],
+    messenger: childMessenger,
+  });
+}
+
 /**
  * Register the signer-backed external handlers on the root messenger and
  * delegate them into the PerpsController child, mirroring the real app's
@@ -379,26 +436,10 @@ const SIGNER_ACTIONS = [
  * @param rootMessenger - The permissive (MOCK_ANY_NAMESPACE) root messenger.
  * @param childMessenger - The PerpsController-namespaced messenger.
  * @param account - The viem signer account.
- * @param address - The selected EVM account address (0x).
  */
-function registerSignerHandlers(rootMessenger, childMessenger, account, address) {
+function registerSignerHandlers(rootMessenger, childMessenger, account) {
   if (rootMessenger.__coreSignerRegistered) return;
 
-  // AccountsController:getSelectedAccount — getSelectedEvmAccountFromMessenger()
-  // calls this first and uses it when the returned object looks like an account
-  // with an EVM `type`. Minimal InternalAccount shape: address + EVM type, plus
-  // metadata.keyring.type so isSelectedHardwareWallet() sees a software (non-
-  // hardware) keyring and allows user signing.
-  rootMessenger.registerActionHandler(
-    'AccountsController:getSelectedAccount',
-    () => ({
-      id: 'core-headless-signer',
-      address,
-      type: 'eip155:eoa',
-      metadata: { keyring: { type: 'HD Key Tree' } },
-    }),
-  );
-
   // KeyringController:getState — isKeyringUnlocked() reads `.isUnlocked`. The
   // headless keyring is always unlocked (we hold the private key).
   rootMessenger.registerActionHandler('KeyringController:getState', () => ({
@@ -479,7 +520,7 @@ export async function getCoreControllerWithSigner(input) {
   }
 
   const { account, address: signerAddress } = await resolveSignerFromFixture(input);
-  registerSignerHandlers(rootMessenger, childMessenger, account, signerAddress);
+  registerSignerHandlers(rootMessenger, childMessenger, account);
 
   // Bring up the active provider. placeOrder/closePosition call
   // getActiveProvider(), which throws CLIENT_NOT_INITIALIZED until init()
@@ -618,6 +659,17 @@ export function redactPosition(position) {
   };
 }
 
+export function redactAccount(account) {
+  return {
+    totalBalance: account?.totalBalance ?? null,
+    spendableBalance: account?.spendableBalance ?? null,
+    withdrawableBalance: account?.withdrawableBalance ?? null,
+    marginUsed: account?.marginUsed ?? null,
+    unrealizedPnl: account?.unrealizedPnl ?? null,
+    returnOnEquity: account?.returnOnEquity ?? null,
+  };
+}
+
 /**
  * Wrap a controller rejection so its typed code survives as data.
  *

package/library/actions/core/perps/read_account.mjs

@@ -1,15 +1,9 @@
-import { getCoreController, isDirectRun, runAdapter } from './_controller.mjs';
-
-function redactAccount(account) {
-  return {
-    totalBalance: account?.totalBalance ?? null,
-    spendableBalance: account?.spendableBalance ?? null,
-    withdrawableBalance: account?.withdrawableBalance ?? null,
-    marginUsed: account?.marginUsed ?? null,
-    unrealizedPnl: account?.unrealizedPnl ?? null,
-    returnOnEquity: account?.returnOnEquity ?? null,
-  };
-}
+import {
+  getCoreController,
+  isDirectRun,
+  redactAccount,
+  runAdapter,
+} from './_controller.mjs';
 
 export async function readAccount(input) {
   const { controller, accountAddress, network } = await getCoreController(input);

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

@@ -0,0 +1,66 @@
+import {
+  getCoreController,
+  isDirectRun,
+  redactAccount,
+  redactOrder,
+  redactPosition,
+  runAdapter,
+} from './_controller.mjs';
+
+export async function readSnapshotFromController(controller, scope) {
+  const output = {};
+
+  if (scope === 'markets' || scope === 'all') {
+    const markets = await controller.getMarketDataWithPrices({
+      standalone: true,
+    });
+    output.markets = {
+      count: markets.length,
+      dataSources: Array.from(
+        new Set(markets.map((market) => market.dataSource ?? 'provider')),
+      ),
+      marketsWithTrend: markets.filter(
+        (market) => Array.isArray(market.trend) && market.trend.length > 0,
+      ).length,
+      sampleSymbols: markets.slice(0, 10).map((market) => market.symbol),
+    };
+  }
+
+  if (scope === 'account' || scope === 'all') {
+    const snapshot = await controller.getUserDataSnapshot();
+    output.user = {
+      identity: snapshot.identity,
+      positions: snapshot.positions.map(redactPosition),
+      orders: snapshot.orders.map(redactOrder),
+      accountState: redactAccount(snapshot.accountState),
+    };
+  }
+
+  return output;
+}
+
+export async function readSnapshot(input) {
+  const scope = String(input.node?.scope ?? 'all');
+  if (!['markets', 'account', 'all'].includes(scope)) {
+    throw new Error(
+      `metamask.perps.read_snapshot scope must be markets, account, or all; got ${scope}.`,
+    );
+  }
+
+  const { controller, accountAddress, network } =
+    await getCoreController(input);
+  const snapshot = await readSnapshotFromController(controller, scope);
+
+  return {
+    action: input.action,
+    source: 'perps-controller-public-api',
+    network,
+    account: accountAddress,
+    scope,
+    ...snapshot,
+    proofPath:
+      'PerpsController.getMarketDataWithPrices/getUserDataSnapshot',
+  };
+}
+
+if (isDirectRun(import.meta.url)) runAdapter(readSnapshot);