@deeeed/metamask-harness 0.17.5 → 0.19.0

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

@@ -0,0 +1,41 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+
+runAdapter((input) => withExtensionPage(input, async (page) => {
+  const scope = input.node?.scope == null ? 'named' : String(input.node.scope);
+  if (scope !== 'selected' && scope !== 'named' && scope !== 'evm' && scope !== 'all') {
+    throw new Error('metamask.wallet.list_accounts scope must be selected, named, evm, or all.');
+  }
+  const result = await page.evaluate(`(() => {
+    const store = globalThis.stateHooks?.store;
+    if (!store || typeof store.getState !== 'function') {
+      throw new Error('stateHooks.store.getState is unavailable.');
+    }
+    const internal = store.getState()?.metamask?.internalAccounts || {};
+    const selectedId = internal.selectedAccount || null;
+    const scope = ${JSON.stringify(scope)};
+    const accounts = Object.entries(internal.accounts || {})
+      .map(([id, account]) => ({
+        id,
+        address: account?.address || null,
+        name: account?.metadata?.name || null,
+        type: account?.type || null,
+        selected: id === selectedId
+      }))
+      .filter((account) => {
+        if (scope === 'selected') return account.selected;
+        if (scope === 'all') return true;
+        if (scope === 'evm') return /^0x[0-9a-f]{40}$/iu.test(account.address || '');
+        return account.selected || Boolean(String(account.name || '').trim());
+      });
+    return { accounts };
+  })()`);
+  return {
+    action: input.action,
+    source: 'extension-stateHooks-store',
+    scope,
+    ...result,
+    count: result.accounts.length,
+    redacted: true,
+    proofPath: 'extension-wallet-accounts',
+  };
+}));

package/library/actions/mobile/perps/assert_orders.mjs

@@ -2,7 +2,8 @@ import { runAdapter } from '../platform/bridge.mjs';
 import { assertOrders } from './perps.mjs';
 
 function expectedOpen(input) {
-  const state = String(input.node?.state ?? input.node?.orders ?? 'open').toLowerCase();
+  if (input.node?.state == null) throw new Error('metamask.perps.assert_orders requires state=open or state=none.');
+  const state = String(input.node.state).toLowerCase();
   if (state === 'open' || state === 'present') return true;
   if (state === 'none' || state === 'closed' || state === 'absent') return false;
   throw new Error(`metamask.perps.assert_orders received unsupported state: ${state}`);

package/library/actions/mobile/perps/assert_positions.mjs

@@ -2,7 +2,8 @@ import { runAdapter } from '../platform/bridge.mjs';
 import { assertPositions } from './perps.mjs';
 
 function expectedOpen(input) {
-  const state = String(input.node?.state ?? input.node?.position ?? 'open').toLowerCase();
+  if (input.node?.state == null) throw new Error('metamask.perps.assert_positions requires state=open or state=none.');
+  const state = String(input.node.state).toLowerCase();
   if (state === 'open' || state === 'present') return true;
   if (state === 'none' || state === 'closed' || state === 'absent') return false;
   throw new Error(`metamask.perps.assert_positions received unsupported state: ${state}`);

package/library/actions/mobile/perps/perps.mjs

@@ -34,20 +34,39 @@ function configuredSymbols(input, items) {
   const explicit = input.node?.markets ?? input.node?.symbols ?? selector.markets ?? selector.symbols;
   if (Array.isArray(explicit) && explicit.length > 0) return uniqueSymbols(explicit.map(normalizeMarketSymbol));
   if (typeof explicit === 'string' && explicit.length > 0) return uniqueSymbols(explicit.split(',').map((part) => normalizeMarketSymbol(part.trim())).filter(Boolean));
-  return [marketSymbol(input)];
+  const single = input.node?.market ?? input.node?.symbol ?? selector.market ?? selector.symbol;
+  return single ? [normalizeMarketSymbol(single)] : [];
 }
 
-function selectedItems(input, items) {
-  const symbols = new Set(configuredSymbols(input, items));
+export function selectedItems(input, items) {
+  const requested = configuredSymbols(input, items);
+  const symbols = requested.length > 0 ? new Set(requested) : null;
   const selector = input.node?.selector && typeof input.node.selector === 'object' ? input.node.selector : {};
   const side = input.node?.side ?? selector.side;
   return items.filter((item) => {
-    if (!symbols.has(symbolForItem(item))) return false;
+    if (symbols && !symbols.has(symbolForItem(item))) return false;
     if (side && sideForItem(item) && sideForItem(item) !== String(side).toLowerCase()) return false;
     return true;
   });
 }
 
+function requireExplicitSelection(input) {
+  const node = input.node ?? {};
+  const selector = node.selector && typeof node.selector === 'object' ? node.selector : {};
+  const values = [node.market, node.symbol, node.markets, node.symbols, selector.market, selector.symbol, selector.markets, selector.symbols];
+  const selected = values.some((value) => Array.isArray(value) ? value.length > 0 : value != null && String(value).trim() !== '');
+  if (!selected && node.mode !== 'all' && selector.mode !== 'all') {
+    throw new Error(`${input.action} requires market=<symbol> or mode=all.`);
+  }
+}
+
+function requirePlaceOrderInputs(input) {
+  const node = input.node ?? {};
+  if (node.market == null && node.symbol == null) throw new Error(`${input.action} requires market=<symbol>.`);
+  if (node.side == null) throw new Error(`${input.action} requires side=long or side=short.`);
+  if (node.amount == null && node.notional == null) throw new Error(`${input.action} requires amount=<usd> or notional=<usd>.`);
+}
+
 function uniqueSymbols(symbols) {
   return Array.from(new Set(symbols.filter(Boolean)));
 }
@@ -250,20 +269,22 @@ export async function readOrders(input) {
 }
 
 export async function assertPositions(input, expectedOpen) {
+  requireExplicitSelection(input);
   const positions = await readPositions(input);
   const matching = selectedItems(input, positions);
   const hasPosition = matching.length > 0;
-  if (expectedOpen && !hasPosition) throw new Error(`Expected selected Perps position(s), but none matched ${JSON.stringify(input.node)}.`);
-  if (!expectedOpen && hasPosition) throw new Error(`Expected no selected Perps positions, but ${matching.length} matched ${JSON.stringify(input.node)}.`);
+  if (expectedOpen && !hasPosition) throw new Error('Expected at least one matching open Perps position, but found none.');
+  if (!expectedOpen && hasPosition) throw new Error(`Expected no matching open Perps positions, but found ${matching.length}.`);
   return { action: input.action, expectedOpen, matchingCount: matching.length, positions: matching.map(redactPosition), source: 'mobile-perps-controller' };
 }
 
 export async function assertOrders(input, expectedOpen) {
+  requireExplicitSelection(input);
   const orders = await readOpenOrders(input);
   const matching = selectedItems(input, orders);
   const hasOrders = matching.length > 0;
-  if (expectedOpen && !hasOrders) throw new Error(`Expected selected Perps order(s), but none matched ${JSON.stringify(input.node)}.`);
-  if (!expectedOpen && hasOrders) throw new Error(`Expected no selected Perps orders, but ${matching.length} matched ${JSON.stringify(input.node)}.`);
+  if (expectedOpen && !hasOrders) throw new Error('Expected at least one matching open Perps order, but found none.');
+  if (!expectedOpen && hasOrders) throw new Error(`Expected no matching open Perps orders, but found ${matching.length}.`);
   return { action: input.action, expectedOpen, matchingCount: matching.length, orders: matching.map(redactOrder), source: 'mobile-perps-controller-open-orders' };
 }
 
@@ -315,6 +336,7 @@ async function closePositionItem(input, position) {
 }
 
 export async function closePositions(input) {
+  requireExplicitSelection(input);
   const before = await readPositions(input);
   const matching = selectedItems(input, before);
   const symbols = uniqueSymbols(matching.map(symbolForItem));
@@ -336,6 +358,7 @@ export async function closePositions(input) {
 }
 
 export async function closeOrders(input) {
+  requireExplicitSelection(input);
   const before = await readOpenOrders(input);
   const matching = selectedItems(input, before);
   const symbols = uniqueSymbols(matching.map(symbolForItem));
@@ -380,9 +403,10 @@ export async function closeOrders(input) {
 }
 
 export async function placeOrder(input) {
+  requirePlaceOrderInputs(input);
   const symbol = marketSymbol(input);
-  const side = String(input.node?.side ?? 'long').toLowerCase();
-  const amount = String(input.node?.amount ?? input.node?.notional ?? '11');
+  const side = String(input.node.side).toLowerCase();
+  const amount = String(input.node.amount ?? input.node.notional);
   const size = String(input.node?.size ?? '0.0001');
   const leverage = Number(input.node?.leverage ?? 3);
   const maxSlippageBps = Number(input.node?.max_slippage_bps ?? input.node?.maxSlippageBps ?? 300);
@@ -401,7 +425,9 @@ export async function placeOrder(input) {
 }
 
 export async function ensurePositions(input) {
-  const state = String(input.node?.state ?? input.node?.position ?? 'none').toLowerCase();
+  if (input.node?.state == null) throw new Error('metamask.perps.ensure_positions requires state=open or state=none.');
+  requireExplicitSelection(input);
+  const state = String(input.node.state).toLowerCase();
   if (state === 'none' || state === 'closed' || state === 'absent') {
     const close = await closePositions(input);
     return { ...(await assertPositions(input, false)), close };
@@ -415,7 +441,9 @@ export async function ensurePositions(input) {
 }
 
 export async function ensureOrders(input) {
-  const state = String(input.node?.state ?? input.node?.orders ?? 'none').toLowerCase();
+  if (input.node?.state == null) throw new Error('metamask.perps.ensure_orders requires state=open or state=none.');
+  requireExplicitSelection(input);
+  const state = String(input.node.state).toLowerCase();
   if (state === 'none' || state === 'closed' || state === 'absent') {
     const close = await closeOrders(input);
     return { ...(await assertOrders(input, false)), close };

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

@@ -0,0 +1,37 @@
+import { bridgeCommand, runAdapter } from '../platform/bridge.mjs';
+
+runAdapter(async (input) => {
+  const scope = input.node?.scope == null ? 'named' : String(input.node.scope);
+  if (scope !== 'selected' && scope !== 'named' && scope !== 'evm' && scope !== 'all') {
+    throw new Error('metamask.wallet.list_accounts scope must be selected, named, evm, or all.');
+  }
+  const rawAccounts = await bridgeCommand(input, ['list-accounts']);
+  if (!Array.isArray(rawAccounts)) {
+    throw new Error(`metamask.wallet.list_accounts expected an array, got ${typeof rawAccounts}.`);
+  }
+  const selected = await bridgeCommand(input, ['get-selected-account']);
+  const selectedAddress = String(selected?.address ?? selected ?? '').toLowerCase();
+  const accounts = rawAccounts
+    .map((account) => ({
+      id: account?.id ?? null,
+      address: account?.address ?? null,
+      name: account?.name ?? null,
+      type: account?.type ?? null,
+      selected: Boolean(selectedAddress && String(account?.address ?? '').toLowerCase() === selectedAddress),
+    }))
+    .filter((account) => {
+      if (scope === 'selected') return account.selected;
+      if (scope === 'all') return true;
+      if (scope === 'evm') return /^0x[0-9a-f]{40}$/iu.test(String(account.address ?? ''));
+      return account.selected || Boolean(String(account.name ?? '').trim());
+    });
+  return {
+    action: input.action,
+    source: 'mobile-accounts-controller',
+    scope,
+    accounts,
+    count: accounts.length,
+    redacted: true,
+    proofPath: 'agentic-wallet-accounts',
+  };
+});

package/library/library.json

@@ -3,5 +3,5 @@
   "schema_version": 1,
   "name": "metamask",
   "owner": "mm-harness-runner",
-  "description": "Canonical MetaMask recipe library: minimal, stable flows every recipe can compose. Team and personal libraries layer on top and win resolution by default."
+  "description": "Canonical MetaMask library of reusable, parameterized recipes. Team and personal libraries layer on top and win resolution by default."
 }