@deeeed/metamask-harness 0.70.1 → 0.72.0

package/library/actions/terminal/wallet/assert_signatures.mjs

@@ -0,0 +1,43 @@
+// Assert what the main wallet was asked to sign since the last reset: allowed
+// EIP-712 primary types, exact signed counts, zero L1 (Agent / chainId 1337)
+// payloads, active-chain matching and, in extension mode, confirmations shown.
+// The full window is retained as evidence whether or not the assertion holds.
+
+import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
+import { evaluateSignatureLog, windowSinceCursor, writeLogArtifact } 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, {
+    cursor: window.cursor,
+    total: window.total,
+    expectations: node,
+    ...result,
+    entries: window.entries,
+  });
+  if (!result.ok) {
+    throw new Error(`signature log assertion failed: ${result.failures.join('; ')}`);
+  }
+  return {
+    action: input.action,
+    source: 'terminal-wallet-request-log',
+    cursor: window.cursor,
+    count: window.entries.length,
+    summary: result.summary,
+    entries: window.entries,
+    artifacts,
+    proofPath: 'terminal-wallet-request-log',
+  };
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => assertSignatures(input));

package/library/actions/terminal/wallet/list_accounts.mjs

@@ -0,0 +1,27 @@
+// 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';
+
+export async function listAccounts(input) {
+  const projectRoot = input.context?.projectRoot;
+  const { fixture } = await loadWalletFixture(projectRoot);
+  const state = await readBrowserState(projectRoot);
+  const accounts = fixture.accounts
+    .filter((entry) => entry?.type === 'mnemonic' || entry?.type === 'privateKey')
+    .map((entry) => {
+      const address = viemAccountFromEntry(entry).address;
+      return { name: entry.name, address, selected: state?.account?.address?.toLowerCase() === address.toLowerCase() };
+    });
+  return {
+    action: input.action,
+    source: 'wallet-fixture',
+    signer: state?.signer ?? null,
+    accounts,
+    count: accounts.length,
+    redacted: true,
+    proofPath: 'terminal-wallet-accounts',
+  };
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => listAccounts(input));

package/library/actions/terminal/wallet/read_signatures.mjs

@@ -0,0 +1,37 @@
+// 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 { isDirectRun, runAdapter } from '../platform/runtime.mjs';
+import { readLog, summarize, windowSinceCursor, writeCursor, writeLogArtifact } from './_signature-log.mjs';
+
+export async function readSignatures(input) {
+  const projectRoot = input.context?.projectRoot;
+  if (input.node?.reset === true) {
+    const entries = await readLog(projectRoot);
+    await writeCursor(projectRoot, entries.length);
+    return {
+      action: input.action,
+      source: 'terminal-wallet-request-log',
+      reset: true,
+      cursor: entries.length,
+      previousEntries: entries.length,
+      proofPath: 'terminal-wallet-request-log',
+    };
+  }
+  const { cursor, entries, total } = await windowSinceCursor(projectRoot);
+  const summary = summarize(entries);
+  const artifacts = await writeLogArtifact(input, { cursor, total, summary, entries });
+  return {
+    action: input.action,
+    source: 'terminal-wallet-request-log',
+    cursor,
+    count: entries.length,
+    summary,
+    entries,
+    artifacts,
+    proofPath: 'terminal-wallet-request-log',
+  };
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => readSignatures(input));