@deeeed/metamask-harness 0.81.0 → 0.82.0

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

@@ -6,12 +6,12 @@
 import { awaitSignatureLog, writeLogArtifact } from '@farmslot/adapter-web/dapp';
 
 import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
-import { TERMINAL_SIGNATURE_POLICY, logArtifactTarget, signatureLog } from './_signature-log.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
 
 export async function assertSignatures(input) {
   const node = input.node ?? {};
   // Entries arrive asynchronously from the wallet host; timeout_ms allows a short settle.
-  const { window, result } = await awaitSignatureLog(signatureLog(input.context?.projectRoot), node, TERMINAL_SIGNATURE_POLICY);
+  const { window, result } = await awaitSignatureLog(signatureLog(input.context?.projectRoot), node, signaturePolicy());
   const artifacts = await writeLogArtifact(logArtifactTarget(input), {
     cursor: window.cursor,
     total: window.total,
@@ -24,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/{terminal → web-dapp}/wallet/read_signatures.mjs

@@ -5,7 +5,7 @@
 import { resetWindow, summarize, windowSinceCursor, writeLogArtifact } from '@farmslot/adapter-web/dapp';
 
 import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
-import { TERMINAL_SIGNATURE_POLICY, logArtifactTarget, signatureLog } from './_signature-log.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
 
 export async function readSignatures(input) {
   const log = signatureLog(input.context?.projectRoot);
@@ -13,25 +13,25 @@ export async function readSignatures(input) {
     const { cursor, previousEntries } = await resetWindow(log);
     return {
       action: input.action,
-      source: 'terminal-wallet-request-log',
+      source: evidenceId('wallet-request-log'),
       reset: true,
       cursor,
       previousEntries,
-      proofPath: 'terminal-wallet-request-log',
+      proofPath: evidenceId('wallet-request-log'),
     };
   }
   const { cursor, entries, total } = await windowSinceCursor(log);
-  const summary = summarize(entries, TERMINAL_SIGNATURE_POLICY);
+  const summary = summarize(entries, signaturePolicy());
   const artifacts = await writeLogArtifact(logArtifactTarget(input), { cursor, total, summary, entries });
   return {
     action: input.action,
-    source: 'terminal-wallet-request-log',
+    source: evidenceId('wallet-request-log'),
     cursor,
     count: entries.length,
     summary,
     entries,
     artifacts,
-    proofPath: 'terminal-wallet-request-log',
+    proofPath: evidenceId('wallet-request-log'),
   };
 }