@walletwright/core 0.2.0 → 0.3.0

package/dist/cache-CHP-6eU0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-CHP-6eU0.mjs","names":["add","rename","NAVIGATION_TIMEOUT_MS","importWallet","unlockScreen","importWallet"],"sources":["../src/internal/download.ts","../src/wallets/metamask/actions/accounts.ts","../src/wallets/metamask/actions/network.ts","../src/internal/wait.ts","../src/internal/unlock-screen.ts","../src/wallets/metamask/onboarding.ts","../src/wallets/metamask/actions/settings.ts","../src/wallets/metamask/approve.ts","../src/internal/utils.ts","../src/wallets/metamask/onboarding-patch.ts","../src/wallets/metamask.ts","../src/wallets/phantom.ts","../src/wallets/rabby.ts","../src/wallets/slush.ts","../src/wallets/solflare.ts","../src/wallets/index.ts","../src/internal/chromium.ts","../src/internal/cache.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync } from \"node:fs\";\nimport { mkdir, mkdtemp, rename, rm } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport AdmZip from \"adm-zip\";\n\nconst ZIP_SIGNATURE = Buffer.from([80, 75, 3, 4]);\n\n/**\n * Prefix for in-progress extractions. It has to live inside `cacheDir` so publishing is a `rename`\n * on one filesystem (a cross-device rename fails with EXDEV), and it starts with a dot so it can\n * never collide with a wallet's `name`.\n */\nconst STAGING_PREFIX = \".staging-\";\n\n/** Download and validate an extension archive, then publish its extraction atomically from staging. */\nexport const downloadAndExtractExtension = async (options: {\n  cacheDir: string;\n  kind: \"zip\" | \"crx\";\n  name: string;\n  /**\n   * Expected sha256 of the downloaded bytes. Required, and `undefined` only where the bytes genuinely\n   * cannot be pinned, so adding a download site forces a decision instead of quietly trusting it.\n   */\n  sha256: string | undefined;\n  url: string;\n}): Promise<string> => {\n  const { cacheDir, kind, name, sha256, url } = options;\n  const cacheRoot = path.resolve(cacheDir);\n  const outDir = path.resolve(cacheDir, name);\n  if (outDir === cacheRoot || !outDir.startsWith(cacheRoot + path.sep)) {\n    throw new Error(`[walletwright] invalid extension name: ${name}`);\n  }\n  if (existsSync(path.join(outDir, \"manifest.json\"))) {\n    return outDir;\n  }\n\n  await mkdir(cacheDir, { recursive: true });\n\n  const response = await fetch(url, { redirect: \"follow\" });\n  if (!response.ok) {\n    throw new Error(\n      `[walletwright] failed to download ${url}: ${response.status} ${response.statusText}`,\n    );\n  }\n  const bytes = Buffer.from(await response.arrayBuffer());\n\n  if (sha256 !== undefined) {\n    const actual = createHash(\"sha256\").update(bytes).digest(\"hex\");\n    if (actual !== sha256.toLowerCase()) {\n      throw new Error(\n        `[walletwright] ${name} failed integrity check: expected ${sha256}, got ${actual}`,\n      );\n    }\n  }\n\n  let zipBytes = bytes;\n  if (kind === \"crx\") {\n    const start = bytes.indexOf(ZIP_SIGNATURE);\n    if (start === -1) {\n      throw new Error(`[walletwright] ${url} is not a valid CRX (no ZIP header found)`);\n    }\n    zipBytes = bytes.subarray(start);\n  }\n\n  const staging = await mkdtemp(path.join(cacheRoot, STAGING_PREFIX));\n  try {\n    const zip = new AdmZip(zipBytes);\n    for (const entry of zip.getEntries()) {\n      const target = path.resolve(staging, entry.entryName);\n      if (target !== staging && !target.startsWith(staging + path.sep)) {\n        throw new Error(`[walletwright] refusing to extract ${entry.entryName}: escapes ${outDir}`);\n      }\n    }\n    zip.extractAllTo(staging, /* overwrite */ true);\n\n    if (!existsSync(path.join(staging, \"manifest.json\"))) {\n      throw new Error(`[walletwright] extracted ${name} but no manifest.json found in ${outDir}`);\n    }\n\n    if (existsSync(path.join(outDir, \"manifest.json\"))) {\n      return outDir; // another worker published while we were downloading\n    }\n    await rm(outDir, { force: true, recursive: true });\n    await rename(staging, outDir);\n    return outDir;\n  } finally {\n    await rm(staging, { force: true, recursive: true }).catch(() => {});\n  }\n};\n\n/** Build the Chrome Web Store CRX download URL for an extension id. */\nexport const chromeWebStoreCrxUrl = (extensionId: string): string =>\n  `https://clients2.google.com/service/update2/crx?response=redirect&prodversion=130.0&acceptformat=crx2,crx3&x=id%3D${extensionId}%26uc`;\n\n/** Download and extract a Chrome Web Store extension (latest) into `<cacheDir>/<name>`. */\nexport const prepareWebStoreExtension = (options: {\n  cacheDir: string;\n  extensionId: string;\n  name: string;\n}): Promise<string> =>\n  downloadAndExtractExtension({\n    cacheDir: options.cacheDir,\n    kind: \"crx\",\n    name: options.name,\n    sha256: undefined,\n    url: chromeWebStoreCrxUrl(options.extensionId),\n  });\n","import type { Page } from \"@playwright/test\";\n\nimport type { AccountActions, WalletActionContext } from \"../../../types\";\n\nconst openAccountMenu = async (home: Page): Promise<void> => {\n  await home.getByTestId(\"account-menu-icon\").click();\n  await home.getByTestId(\"add-multichain-account-button\").waitFor({ state: \"visible\" });\n};\n\n/** The menu is a popover with no close affordance; going home is the reliable way out. */\nconst closeAccountMenu = async (home: Page): Promise<void> => {\n  await home.goto(`${home.url().split(\"#\")[0]}#/`);\n  await home.getByTestId(\"account-menu-icon\").waitFor({ state: \"visible\" });\n};\n\nconst add = async ({ home }: WalletActionContext): Promise<void> => {\n  await openAccountMenu(home);\n  const cells = home.getByTestId(\"account-cell-avatar\");\n  const before = await cells.count();\n  await home.getByTestId(\"add-multichain-account-button\").click();\n  await cells.nth(before).waitFor({ state: \"visible\", timeout: 15_000 });\n  await closeAccountMenu(home);\n};\n\nconst importPrivateKey = async (\n  { home }: WalletActionContext,\n  privateKey: string,\n): Promise<void> => {\n  await openAccountMenu(home);\n  await home.getByTestId(\"account-list-add-wallet-button\").click();\n  const chooseImport = home.getByTestId(\"choose-wallet-type-import-account\");\n  await chooseImport.waitFor({ state: \"visible\" });\n  await chooseImport.click();\n  const confirm = home.getByTestId(\"import-account-confirm-button\");\n  await confirm.waitFor({ state: \"visible\" });\n  await home.locator(\"input\").first().fill(privateKey);\n  await confirm.click();\n  await confirm.waitFor({ state: \"hidden\", timeout: 15_000 });\n  await closeAccountMenu(home);\n};\n\nconst rename = async (\n  { home }: WalletActionContext,\n  options: { index: number; name: string },\n): Promise<void> => {\n  await openAccountMenu(home);\n  await home.getByTestId(\"multichain-account-cell-end-accessory\").nth(options.index).click();\n  await home.getByTestId(\"multichain-account-menu-item-rename\").click();\n  await home.getByTestId(\"account-name-input\").locator(\"input\").fill(options.name);\n  await home.getByRole(\"button\", { name: \"Confirm\" }).click();\n  await closeAccountMenu(home);\n};\n\nconst switchTo = async ({ home }: WalletActionContext, index: number): Promise<void> => {\n  await openAccountMenu(home);\n  await home.getByTestId(\"account-cell-avatar\").nth(index).click();\n  const menuClosed = await home\n    .getByTestId(\"add-multichain-account-button\")\n    .waitFor({ state: \"hidden\", timeout: 10_000 })\n    .then(() => true)\n    .catch(() => false);\n  if (!menuClosed) {\n    throw new Error(`[walletwright] accounts.switch(${index}) did not switch (menu stayed open)`);\n  }\n};\n\nexport const accounts: AccountActions = {\n  add,\n  importPrivateKey,\n  rename,\n  switch: switchTo,\n};\n","import type { Page } from \"@playwright/test\";\n\nimport type { NetworkActions, NetworkConfig, WalletActionContext } from \"../../../types\";\n\nconst closeButton = (home: Page) =>\n  home.getByTestId(\"modal-header-close-button\").filter({ visible: true }).first();\n\nconst openNetworkManager = async (home: Page): Promise<void> => {\n  await home.getByTestId(\"sort-by-networks\").click();\n  await closeButton(home).waitFor({ state: \"visible\" });\n};\n\nconst add = async ({ home }: WalletActionContext, config: NetworkConfig): Promise<void> => {\n  await openNetworkManager(home);\n\n  await home.getByText(\"Custom\", { exact: true }).first().click();\n  await home.getByRole(\"button\", { name: \"Add custom network\" }).first().click();\n\n  await home.getByTestId(\"network-form-network-name\").fill(config.name);\n  await home.getByTestId(\"network-form-chain-id\").fill(String(config.chainId));\n  await home.getByTestId(\"network-form-ticker-input\").fill(config.symbol);\n\n  await home.getByTestId(\"test-add-rpc-drop-down\").click();\n  await home.getByText(\"Add RPC URL\", { exact: true }).first().click();\n  await home.getByTestId(\"rpc-url-input-test\").fill(config.rpcUrl);\n  await home.getByTestId(\"page-container-footer-next\").click();\n\n  await home.getByTestId(\"network-form-network-name\").waitFor();\n  await home.getByTestId(\"page-container-footer-next\").click();\n\n  await closeButton(home).click();\n  await closeButton(home).waitFor({ state: \"hidden\" });\n};\n\nexport const network: NetworkActions = {\n  add,\n};\n","import type { Page } from \"@playwright/test\";\n\nconst DEFAULT_INTERVAL_MS = 200;\nconst DEFAULT_NAVIGATION_INTERVAL_MS = 1000;\n\nexport type WaitOptions = {\n  /** Gap between checks. */\n  intervalMs?: number;\n  /** Total budget. `check` runs at least once, and never again once the budget has elapsed. */\n  timeoutMs: number;\n};\n\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n\n/** Render a timeout for an error message, so what a failure claims matches what it waited. */\nexport const formatTimeout = (ms: number): string => `${Math.round(ms / 100) / 10}s`;\n\n/** Poll until `check` returns a value, or `undefined` when the timeout expires. */\nexport const waitUntil = async <T>(\n  check: () => Promise<T | false | undefined> | T | false | undefined,\n  { intervalMs = DEFAULT_INTERVAL_MS, timeoutMs }: WaitOptions,\n): Promise<T | undefined> => {\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    const result = await check();\n    if (result !== undefined && result !== false) {\n      return result;\n    }\n    if (Date.now() >= deadline) {\n      return undefined;\n    }\n    await sleep(intervalMs);\n  }\n};\n\nexport const waitUntilOrThrow = async <T>(\n  check: () => Promise<T | false | undefined> | T | false | undefined,\n  options: WaitOptions & { message: string },\n): Promise<T> => {\n  const result = await waitUntil(check, options);\n  if (result === undefined) {\n    throw new Error(\n      `[walletwright] ${options.message} (gave up after ${formatTimeout(options.timeoutMs)})`,\n    );\n  }\n  return result;\n};\n\n/**\n * A `chrome-extension://` URL fails with `ERR_BLOCKED_BY_CLIENT` until the extension registers,\n * which takes seconds after launch, so reaching an extension page is a poll rather than a one-shot.\n */\nexport const gotoWithRetry = async (\n  page: Page,\n  url: string,\n  {\n    intervalMs = DEFAULT_NAVIGATION_INTERVAL_MS,\n    label,\n    timeoutMs,\n  }: WaitOptions & { label: string },\n): Promise<void> => {\n  await waitUntilOrThrow(\n    () =>\n      page\n        .goto(url, { waitUntil: \"domcontentloaded\" })\n        .then(() => true)\n        .catch(() => undefined),\n    { intervalMs, message: `${label} never loaded (${url})`, timeoutMs },\n  );\n};\n","import type { BrowserContext, Locator, Page } from \"@playwright/test\";\n\nimport { formatTimeout, gotoWithRetry, waitUntil } from \"./wait\";\n\nconst PASSWORD_FIELD = 'input[type=\"password\"]';\n\nconst NAVIGATION_TIMEOUT_MS = 15_000;\nconst FIRST_SETTLE_TIMEOUT_MS = 20_000;\nconst RELOAD_ATTEMPTS = 5;\nconst RELOAD_SETTLE_TIMEOUT_MS = 5000;\nconst PROBE_INTERVAL_MS = 500;\nconst PASSWORD_CLEARED_TIMEOUT_MS = 15_000;\n/**\n * Short on purpose. `unlock` is normally handed a page `reachUnlockScreen` already settled, so this\n * budget only matters when it is called on its own (the `settings.unlock` path), where a wallet with a\n * late-mounting UI needs a poll rather than a single read but a dead page should still fail fast.\n */\nconst UNLOCK_SETTLE_TIMEOUT_MS = 5000;\n\ntype UnlockScreenOptions = {\n  /** Extension-relative page that renders the unlock screen (e.g. `home.html`). */\n  entry: string;\n  /** Detect a warm launch that is already unlocked. */\n  isUnlocked?: (page: Page) => Promise<boolean>;\n  /** Submit the filled password. Defaults to pressing Enter in the field. */\n  submit?: (page: Page, field: Locator) => Promise<void>;\n  wallet: string;\n};\n\ntype UnlockScreen = {\n  reachUnlockScreen: (context: BrowserContext, extensionId: string) => Promise<Page>;\n  unlock: (page: Page, password: string) => Promise<void>;\n};\n\n/**\n * The shared unlock flow: open the wallet's own page, wait for it to settle into a state we can\n * name, and type the password. Every wallet differs only in its entry page, how it submits, and\n * whether it can come back already unlocked.\n */\nexport const createUnlockScreen = ({\n  entry,\n  isUnlocked,\n  submit,\n  wallet,\n}: UnlockScreenOptions): UnlockScreen => {\n  const settled = async (page: Page): Promise<\"locked\" | \"unlocked\" | undefined> => {\n    const locked = await page\n      .locator(PASSWORD_FIELD)\n      .isVisible()\n      .catch(() => false);\n    if (locked) {\n      return \"locked\";\n    }\n    const unlocked = await isUnlocked?.(page).catch(() => false);\n    return unlocked === true ? \"unlocked\" : undefined;\n  };\n\n  const settleWithin = (page: Page, timeoutMs: number) =>\n    waitUntil(() => settled(page), { intervalMs: PROBE_INTERVAL_MS, timeoutMs });\n\n  const reachUnlockScreen = async (context: BrowserContext, extensionId: string): Promise<Page> => {\n    const page = await context.newPage();\n    await gotoWithRetry(page, `chrome-extension://${extensionId}/${entry}`, {\n      label: `${wallet} ${entry}`,\n      timeoutMs: NAVIGATION_TIMEOUT_MS,\n    });\n\n    let state = await settleWithin(page, FIRST_SETTLE_TIMEOUT_MS);\n    for (let attempt = 0; attempt < RELOAD_ATTEMPTS && state === undefined; attempt++) {\n      await page.reload().catch(() => {});\n      state = await settleWithin(page, RELOAD_SETTLE_TIMEOUT_MS);\n    }\n    if (state === undefined) {\n      throw new Error(\n        `[walletwright] ${wallet} never reached its unlock screen (gave up after ${formatTimeout(\n          FIRST_SETTLE_TIMEOUT_MS + RELOAD_ATTEMPTS * RELOAD_SETTLE_TIMEOUT_MS,\n        )})`,\n      );\n    }\n    return page;\n  };\n\n  const unlock = async (page: Page, password: string): Promise<void> => {\n    // Through `settleWithin`, so there is one answer to \"what state is this page in\" and it waits.\n    const state = await settleWithin(page, UNLOCK_SETTLE_TIMEOUT_MS);\n    if (state === \"unlocked\") {\n      return;\n    }\n    if (state === undefined) {\n      throw new Error(\n        `[walletwright] ${wallet} showed neither an unlock screen nor an unlocked wallet`,\n      );\n    }\n\n    const field = page.locator(PASSWORD_FIELD);\n    await field.fill(password);\n    await (submit === undefined ? field.press(\"Enter\") : submit(page, field));\n    const cleared = await field\n      .waitFor({ state: \"hidden\", timeout: PASSWORD_CLEARED_TIMEOUT_MS })\n      .then(() => true)\n      .catch(() => false);\n    if (!cleared) {\n      throw new Error(\n        `[walletwright] ${wallet} unlock failed (password screen still visible after ${formatTimeout(\n          PASSWORD_CLEARED_TIMEOUT_MS,\n        )})`,\n      );\n    }\n  };\n\n  return { reachUnlockScreen, unlock };\n};\n","import type { Page } from \"@playwright/test\";\n\nimport { createUnlockScreen } from \"../../internal/unlock-screen\";\nimport { waitUntil } from \"../../internal/wait\";\n\nconst SRP_RETYPE_TIMEOUT_MS = 40_000;\nconst SRP_CONFIRM_TIMEOUT_MS = 5000;\n\nconst { reachUnlockScreen, unlock } = createUnlockScreen({\n  entry: \"home.html\",\n  wallet: \"MetaMask\",\n});\n\nexport const importWallet = async (\n  page: Page,\n  seedPhrase: string,\n  password: string,\n): Promise<void> => {\n  await page.getByTestId(\"onboarding-import-wallet\").click();\n  await page.getByTestId(\"onboarding-import-with-srp-button\").click();\n\n  const srpField = page.getByTestId(\"srp-input-import__srp-note\");\n  const confirmEnabled = page.locator('[data-testid=\"import-srp-confirm\"]:not([disabled])');\n  const accepted = await waitUntil(\n    async () => {\n      await srpField.click();\n      await srpField.fill(\"\");\n      await srpField.pressSequentially(seedPhrase, { delay: 50 });\n      return confirmEnabled\n        .waitFor({ state: \"visible\", timeout: SRP_CONFIRM_TIMEOUT_MS })\n        .then(() => true)\n        .catch(() => undefined);\n    },\n    { intervalMs: 0, timeoutMs: SRP_RETYPE_TIMEOUT_MS },\n  );\n  if (accepted === undefined) {\n    throw new Error(\"[walletwright] MetaMask rejected the seed phrase (confirm stayed disabled)\");\n  }\n  await confirmEnabled.click();\n\n  await page.getByTestId(\"create-password-new-input\").fill(password);\n  await page.getByTestId(\"create-password-confirm-input\").fill(password);\n  await page.getByTestId(\"create-password-terms\").click();\n  await page.locator('[data-testid=\"create-password-submit\"]:not([disabled])').click();\n\n  await page\n    .getByTestId(\"passkey-maybe-later-button\")\n    .click({ timeout: 10_000 })\n    .catch(() => {});\n  await page\n    .getByTestId(\"metametrics-i-agree\")\n    .click({ timeout: 10_000 })\n    .catch(() => {});\n};\n\nexport { reachUnlockScreen, unlock };\n","import type { SettingsActions } from \"../../../types\";\nimport { unlock as unlockScreen } from \"../onboarding\";\n\nexport const settings: SettingsActions = {\n  lock: async ({ home }) => {\n    await home.getByTestId(\"account-options-menu-button\").click();\n    await home.getByTestId(\"global-menu-lock\").filter({ visible: true }).first().click();\n    await home.locator('input[type=\"password\"]').waitFor({ state: \"visible\", timeout: 15_000 });\n  },\n\n  unlock: async ({ home, password }) => {\n    await unlockScreen(home, password);\n  },\n};\n","import type { Locator, Page } from \"@playwright/test\";\n\n/**\n * How long a confirm or cancel button gets to become clickable, once the page is already showing\n * one. Generous because a loaded CI runner renders MetaMask's footer slowly.\n */\nconst BUTTON_TIMEOUT_MS = 45_000;\n/** The retry only covers a notice that rendered late, so it does not need the full budget again. */\nconst RETRY_TIMEOUT_MS = 10_000;\n\n/** Snap notices intercept footer clicks and disable Accept until their content is scrolled. */\nconst acceptThirdPartyNotice = async (popup: Page): Promise<void> => {\n  const modal = popup.locator(\".snap-install-warning\");\n  if ((await modal.count().catch(() => 0)) === 0) {\n    return;\n  }\n  await modal\n    .locator(\"p\")\n    .last()\n    .scrollIntoViewIfNeeded()\n    .catch(() => {});\n  await modal\n    .getByRole(\"button\", { name: \"Accept\" })\n    .click({ timeout: 3000 })\n    .catch(() => {});\n};\n\n/** Resolve the confirm test id used by standard, legacy, and Snap request footers. */\nconst confirmButton = (popup: Page): Locator =>\n  popup\n    .getByTestId(\"confirm-btn\")\n    .or(popup.getByTestId(\"confirm-footer-button\"))\n    .or(popup.locator('[data-testid=\"page-container-footer-next\"]'))\n    .or(popup.locator('[data-testid$=\"-confirm-snap-footer-button\"]'))\n    .first();\n\nconst cancelButton = (popup: Page): Locator =>\n  popup\n    .getByTestId(\"cancel-btn\")\n    .or(popup.getByTestId(\"confirm-footer-cancel-button\"))\n    .or(popup.locator('[data-testid=\"page-container-footer-cancel\"]'))\n    .or(popup.locator('[data-testid$=\"-cancel-snap-footer-button\"]'))\n    .first();\n\n/** Distinguishes a pending request from MetaMask's requestless notification home screen. */\nexport const approvalControls = (popup: Page): Locator =>\n  confirmButton(popup).or(cancelButton(popup));\n\n/**\n * Click one of the popup's footer buttons. The third-party notice covers that whole footer, so both\n * confirm and cancel are intercepted while it is up, and both need the dismiss-then-retry: without it\n * a click times out against a button that is rendered and enabled, which reads as a stale selector.\n */\nconst clickFooterButton = async (popup: Page, button: Locator): Promise<void> => {\n  await acceptThirdPartyNotice(popup);\n  try {\n    await button.click({ timeout: BUTTON_TIMEOUT_MS });\n  } catch (error) {\n    await acceptThirdPartyNotice(popup);\n    await button.click({ timeout: RETRY_TIMEOUT_MS }).catch(() => {\n      throw error;\n    });\n  }\n};\n\nexport const approve = (popup: Page): Promise<void> =>\n  clickFooterButton(popup, confirmButton(popup));\n\n/** The cancel counterpart of `approve`; same union-by-DOM-order resolution, not written order. */\nexport const reject = (popup: Page): Promise<void> => clickFooterButton(popup, cancelButton(popup));\n","import { createHash } from \"node:crypto\";\nimport { readFileSync, realpathSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { BrowserContext, Locator, Page } from \"@playwright/test\";\n\nimport type { WalletSetup } from \"../types\";\n\nimport { waitUntil } from \"./wait\";\n\nexport const DEFAULT_CACHE_DIR = \".walletwright\";\n\n/** MetaMask/Phantom approval-popup URL token; Slush overrides it with `notificationMatch: \"isPopup=1\"`. */\nexport const DEFAULT_NOTIFICATION_MATCH = \"notification.html\";\n\n/** Stable per-setup profile directory name, so the same wallet+seed+password reuses one cache. */\nexport const profileKey = (setup: WalletSetup): string =>\n  createHash(\"sha256\")\n    .update(`${setup.wallet}:${setup.version ?? \"default\"}:${setup.seedPhrase}:${setup.password}`)\n    .digest(\"hex\")\n    .slice(0, 20);\n\n/** Mirror Chrome's extension-id derivation; resolve symlinks because Chrome hashes the real path. */\nexport const extensionIdFromPath = (extensionPath: string): string => {\n  const resolved = path.resolve(extensionPath);\n  const abs = (() => {\n    try {\n      return realpathSync(resolved);\n    } catch {\n      return resolved; // path doesn't exist yet, fall back to the literal resolved path\n    }\n  })();\n  let key: string | undefined;\n  try {\n    const manifest: unknown = JSON.parse(readFileSync(path.join(abs, \"manifest.json\"), \"utf8\"));\n    if (typeof manifest === \"object\" && manifest !== null && \"key\" in manifest) {\n      key = typeof manifest.key === \"string\" ? manifest.key : undefined;\n    }\n  } catch {\n    // manifest not present yet, fall back to the path\n  }\n  const source =\n    key === undefined || key === \"\" ? Buffer.from(abs, \"utf8\") : Buffer.from(key, \"base64\");\n  const hex = createHash(\"sha256\").update(source).digest(\"hex\").slice(0, 32);\n  return Array.from(hex, (nibble) => String.fromCodePoint(97 + Number.parseInt(nibble, 16))).join(\n    \"\",\n  );\n};\n\n/**\n * Approval popups open as `about:blank` and then navigate, so `waitForEvent('page', { predicate })`\n * misses them, poll the open pages instead. `match` is the URL token identifying the popup\n * (`notification.html` for MetaMask/Phantom; `isPopup=1` for Slush's single-page `index.html`).\n */\nexport const isApprovalPopup = (page: Page, extensionId: string, match: string): boolean =>\n  page.url().startsWith(`chrome-extension://${extensionId}`) &&\n  page.url().includes(match) &&\n  !page.isClosed();\n\nconst isVisible = async (locator: Locator): Promise<boolean> => {\n  try {\n    return await locator.isVisible();\n  } catch {\n    return false; // the page can go while we ask\n  }\n};\n\nconst hasVisibleButton = (page: Page): Promise<boolean> =>\n  isVisible(page.locator(\"button\").first());\n\nexport const findNotificationPopup = ({\n  approvalControls,\n  context,\n  extensionId,\n  match = DEFAULT_NOTIFICATION_MATCH,\n  timeoutMs = 10_000,\n}: {\n  /** From `WalletDefinition.approvalControls`, for a wallet that can render its popup requestless. */\n  approvalControls?: (page: Page) => Locator;\n  context: BrowserContext;\n  extensionId: string;\n  match?: string;\n  timeoutMs?: number;\n}): Promise<Page | undefined> =>\n  waitUntil(\n    async () => {\n      const popup = context.pages().find((page) => isApprovalPopup(page, extensionId, match));\n      if (!popup) {\n        return undefined;\n      }\n      await popup.waitForLoadState(\"domcontentloaded\").catch(() => {});\n      const ready =\n        approvalControls === undefined\n          ? await hasVisibleButton(popup)\n          : await isVisible(approvalControls(popup).first());\n      return ready ? popup : undefined;\n    },\n    { timeoutMs },\n  );\n\n/** MetaMask's own popup dimensions, which its layout is built for. */\nconst APPROVAL_WINDOW = { height: 592, width: 360 };\n/** Far enough from the edge that a popup this size lands fully on any usable display. */\nconst APPROVAL_WINDOW_OFFSET = 50;\n\n/** Move approval popups on-screen; headless and unsupported CDP targets are ignored. */\nexport const placeApprovalWindow = async (page: Page): Promise<void> => {\n  await page.setViewportSize(APPROVAL_WINDOW).catch(() => {});\n  try {\n    const session = await page.context().newCDPSession(page);\n    const { targetInfo } = await session.send(\"Target.getTargetInfo\");\n    const { windowId } = await session.send(\"Browser.getWindowForTarget\", {\n      targetId: targetInfo.targetId,\n    });\n    await session.send(\"Browser.setWindowBounds\", {\n      bounds: { left: APPROVAL_WINDOW_OFFSET, top: APPROVAL_WINDOW_OFFSET },\n      windowId,\n    });\n    await session.detach();\n  } catch {\n    // no window to place (headless), or the page refused a CDP session\n  }\n};\n\n/** Where Chrome persists an extension's `chrome.storage.local` inside a browser profile. */\nexport const extensionStateDir = (profileDir: string, extensionId: string): string =>\n  path.join(profileDir, \"Default\", \"Local Extension Settings\", extensionId);\n","import { existsSync } from \"node:fs\";\n\nimport { ClassicLevel } from \"classic-level\";\n\nimport { extensionStateDir } from \"../../internal/utils\";\n\ntype OnboardingState = Record<string, unknown>;\n\nconst asState = (value: unknown): OnboardingState | undefined =>\n  typeof value === \"object\" && value !== null ? { ...value } : undefined;\n\nconst markOnboarded = (onboarding: OnboardingState): OnboardingState => ({\n  ...onboarding,\n  completedOnboarding: true,\n  firstTimeFlowType:\n    typeof onboarding.firstTimeFlowType === \"string\" ? onboarding.firstTimeFlowType : \"import\",\n  onboardingTabs: {},\n});\n\n/** Patch both MetaMask 13.x onboarding layouts while the browser has released LevelDB. */\nexport const markMetaMaskOnboarded = async (\n  profileDir: string,\n  extensionId: string,\n): Promise<void> => {\n  const dbDir = extensionStateDir(profileDir, extensionId);\n  if (!existsSync(dbDir)) {\n    throw new Error(`[walletwright] MetaMask wrote no extension state to ${dbDir}`);\n  }\n\n  const db = new ClassicLevel(dbDir, {\n    createIfMissing: false,\n    keyEncoding: \"utf8\",\n    valueEncoding: \"utf8\",\n  });\n  try {\n    await db.open();\n\n    const perController = await db.get(\"OnboardingController\");\n    if (perController !== undefined && perController !== \"\") {\n      const onboarding = asState(JSON.parse(perController));\n      if (onboarding === undefined) {\n        throw new Error(`[walletwright] MetaMask's OnboardingController state is not an object`);\n      }\n      if (onboarding.completedOnboarding !== true) {\n        await db.put(\"OnboardingController\", JSON.stringify(markOnboarded(onboarding)));\n      }\n      return;\n    }\n\n    const raw = await db.get(\"data\");\n    if (raw === undefined || raw === \"\") {\n      throw new Error(\n        `[walletwright] MetaMask persisted no onboarding state in ${dbDir} (neither an OnboardingController key nor a data key)`,\n      );\n    }\n    const state = asState(JSON.parse(raw));\n    if (state === undefined) {\n      throw new Error(`[walletwright] MetaMask's \"data\" state is not an object`);\n    }\n    const nested = asState(state.data);\n    const controller = asState((nested ?? state).OnboardingController);\n    if (controller === undefined) {\n      throw new Error(`[walletwright] MetaMask's \"data\" state holds no OnboardingController`);\n    }\n    const patched = markOnboarded(controller);\n    await db.put(\n      \"data\",\n      JSON.stringify(\n        nested === undefined\n          ? { ...state, OnboardingController: patched }\n          : { ...state, data: { ...nested, OnboardingController: patched } },\n      ),\n    );\n  } finally {\n    await db.close();\n  }\n};\n","import { downloadAndExtractExtension } from \"../internal/download\";\nimport type { WalletDefinition } from \"../types\";\n\nimport { accounts } from \"./metamask/actions/accounts\";\nimport { network } from \"./metamask/actions/network\";\nimport { settings } from \"./metamask/actions/settings\";\nimport { approvalControls, approve, reject } from \"./metamask/approve\";\nimport { importWallet, reachUnlockScreen, unlock } from \"./metamask/onboarding\";\nimport { markMetaMaskOnboarded } from \"./metamask/onboarding-patch\";\n\n/** Release hashes for the pinned default. Add an entry before changing `DEFAULT_VERSION`. */\nconst RELEASE_SHA256 = {\n  \"13.35.1\": \"4e0f8626df0ae9fb15f5f3ad6784a0b518f3ede067b2b0d4f539f9f457c5049c\",\n} as const satisfies Readonly<Record<string, string>>;\n\n/**\n * Typed as a key of `RELEASE_SHA256`, so bumping the default without adding its hash above is a\n * compile error. `download.ts` skips verification for an unpinned `sha256`, so the same bump would\n * otherwise silently downgrade every default MetaMask download to unverified.\n */\nexport const DEFAULT_VERSION: keyof typeof RELEASE_SHA256 = \"13.35.1\";\n\nconst releaseSha256 = (version: string): string | undefined =>\n  Object.entries(RELEASE_SHA256).find(([pinned]) => pinned === version)?.[1];\n\n/** Download inputs for a MetaMask release, split out so the integrity wiring is unit-testable. */\nexport const metamaskDownload = (cacheDir: string, version: string) => ({\n  cacheDir,\n  kind: \"zip\" as const,\n  name: `metamask-chrome-${version}`,\n  sha256: releaseSha256(version),\n  url: `https://github.com/MetaMask/metamask-extension/releases/download/v${version}/metamask-chrome-${version}.zip`,\n});\n\n/** MetaMask's account-name sync mutates shared test-seed profiles, so its own e2e suite blocks this host. */\nconst ACCOUNT_SYNC_HOST = \"user-storage.api.cx.metamask.io\";\n\nexport const metamask: WalletDefinition = {\n  actions: { accounts, network, settings },\n  approvalControls,\n  approve,\n  ecosystems: [\"evm\", \"svm\"],\n  extensionName: \"MetaMask\",\n\n  finalizeCache: markMetaMaskOnboarded,\n\n  importWallet,\n\n  onboardingPage: \"home.html\",\n\n  prepareContext: async (context) => {\n    await context.route(`**://${ACCOUNT_SYNC_HOST}/**`, (route) => route.abort());\n  },\n  prepareExtension: (cacheDir, version = DEFAULT_VERSION) =>\n    downloadAndExtractExtension(metamaskDownload(cacheDir, version)),\n  reachUnlockScreen,\n  reject,\n  unlock,\n};\n","import { prepareWebStoreExtension } from \"../internal/download\";\nimport { createUnlockScreen } from \"../internal/unlock-screen\";\nimport { sleep } from \"../internal/wait\";\nimport type { WalletDefinition } from \"../types\";\n\nconst PHANTOM_EXTENSION_ID = \"bfnaelmomeimhlpmgjnjophhpkkoljpa\";\n\nconst { reachUnlockScreen, unlock } = createUnlockScreen({\n  entry: \"popup.html\",\n  isUnlocked: async (page) => {\n    const rendered = await page\n      .locator(\"button\")\n      .first()\n      .isVisible()\n      .catch(() => false);\n    return rendered;\n  },\n  submit: async (page, field) => {\n    const unlockButton = page.getByRole(\"button\", { name: /unlock/iv });\n    await ((await unlockButton.isVisible().catch(() => false))\n      ? unlockButton.click()\n      : field.press(\"Enter\"));\n  },\n  wallet: \"Phantom\",\n});\n\nexport const phantom: WalletDefinition = {\n  approve: async (popup) => {\n    await popup.getByTestId(\"primary-button\").click({ timeout: 15_000 });\n  },\n  ecosystems: [\"evm\", \"svm\"],\n\n  extensionName: \"Phantom\",\n\n  headlessApprovals: true,\n\n  importWallet: async (page, seedPhrase, password) => {\n    const testId = (id: string) => page.locator(`[data-testid=\"${id}\"]`);\n\n    await page.locator(\"text=I already have a wallet\").click();\n    await sleep(1000);\n    await page.locator(\"text=Import Recovery Phrase\").click();\n    await sleep(1500);\n\n    const words = seedPhrase.trim().split(/\\s+/v);\n    for (let i = 0; i < words.length; i++) {\n      await testId(`secret-recovery-phrase-word-input-${i}`).fill(words[i] ?? \"\");\n    }\n    await testId(\"onboarding-form-submit-button\").click();\n\n    await testId(\"onboarding-form-secondary-button\").waitFor({ state: \"visible\", timeout: 60_000 });\n    await testId(\"onboarding-form-submit-button\").click();\n\n    await testId(\"onboarding-form-password-input\").fill(password);\n    await testId(\"onboarding-form-confirm-password-input\").fill(password);\n    await testId(\"onboarding-form-terms-of-service-checkbox\").click();\n    await testId(\"onboarding-form-submit-button\").click();\n    await sleep(2500);\n\n    const getStarted = page.locator(\"text=Get Started\");\n    if (await getStarted.isVisible().catch(() => false)) {\n      await getStarted.click();\n    }\n    await sleep(1500);\n  },\n\n  onboardingPage: \"onboarding.html\",\n\n  prepareExtension: (cacheDir) =>\n    prepareWebStoreExtension({\n      cacheDir,\n      extensionId: PHANTOM_EXTENSION_ID,\n      name: \"phantom-chrome-latest\",\n    }),\n\n  reachUnlockScreen,\n\n  reject: async (popup) => {\n    await popup.getByTestId(\"secondary-button\").click({ timeout: 15_000 });\n  },\n\n  unlock,\n};\n","import type { Page } from \"@playwright/test\";\n\nimport { prepareWebStoreExtension } from \"../internal/download\";\nimport { createUnlockScreen } from \"../internal/unlock-screen\";\nimport { sleep, waitUntil, waitUntilOrThrow } from \"../internal/wait\";\nimport type { WalletDefinition } from \"../types\";\n\nconst ROUTE_TIMEOUT_MS = 30_000;\nconst SEED_PASTE_TIMEOUT_MS = 3000;\nconst APPROVAL_TIMEOUT_MS = 30_000;\n\nconst RABBY_EXTENSION_ID = \"acmacodkjbdgmoleebolmdjonilkdbch\";\n\nconst ONBOARDING_ROUTE = \"index.html#/new-user/guide\";\n\nconst { reachUnlockScreen, unlock } = createUnlockScreen({ entry: \"index.html\", wallet: \"Rabby\" });\n\nconst clickText = async (page: Page, text: string, timeoutMs = 30_000): Promise<void> => {\n  const target = page.getByText(text, { exact: true }).first();\n  await target.waitFor({ state: \"visible\", timeout: timeoutMs });\n  await target.click();\n};\n\n/**\n * Rabby routes with a hash router, so `waitForURL` never settles (a hash change fires no navigation\n * event). Poll the URL instead. Anchoring each onboarding step on its route matters because several\n * screens share the same `input[type=\"password\"]` selector.\n */\nconst waitForRoute = async (\n  page: Page,\n  fragment: string,\n  timeoutMs = ROUTE_TIMEOUT_MS,\n): Promise<void> => {\n  await waitUntilOrThrow(() => page.url().includes(fragment), {\n    message: `Rabby never reached ${fragment}`,\n    timeoutMs,\n  });\n};\n\nconst importWallet = async (page: Page, seedPhrase: string, password: string): Promise<void> => {\n  await clickText(page, \"I already have an address\");\n  await clickText(page, \"Seed Phrase or Private Key\");\n  await waitForRoute(page, \"seed-or-key\");\n\n  const words = page.locator('input[type=\"password\"]');\n  await words.first().waitFor({ state: \"visible\", timeout: 30_000 });\n  await page\n    .context()\n    .grantPermissions([\"clipboard-read\", \"clipboard-write\"])\n    .catch(() => {});\n  const list = seedPhrase.trim().split(/\\s+/v);\n  const lastFilled = async (): Promise<boolean> => {\n    const value = await words\n      .nth(list.length - 1)\n      .inputValue()\n      .catch(() => \"\");\n    return value.trim().length > 0;\n  };\n\n  await words.first().click();\n  await page.evaluate((phrase) => navigator.clipboard.writeText(phrase), seedPhrase.trim());\n  await page.keyboard.press(\"ControlOrMeta+v\");\n  const pasted = await waitUntil(lastFilled, { timeoutMs: SEED_PASTE_TIMEOUT_MS });\n  if (pasted === undefined) {\n    for (let index = 0; index < list.length; index++) {\n      const box = words.nth(index);\n      await box.click();\n      await box.fill(list[index] ?? \"\");\n    }\n  }\n  await page.getByRole(\"button\", { exact: true, name: \"Next\" }).first().click();\n\n  await waitForRoute(page, \"set-password\");\n  const passwords = page.locator('input[type=\"password\"]');\n  await passwords.nth(1).waitFor({ state: \"visible\", timeout: 30_000 });\n  await passwords.nth(0).fill(password);\n  await passwords.nth(1).fill(password);\n  await page.getByRole(\"button\", { exact: true, name: \"Confirm\" }).first().click();\n\n  await page\n    .getByText(\"Address Imported\", { exact: false })\n    .first()\n    .waitFor({ state: \"visible\", timeout: 30_000 });\n  await sleep(1000);\n};\n\nconst CONFIRM_LABELS = [\"Connect\", \"Sign\", \"Confirm\"];\nconst CANCEL_LABELS = [\"Cancel\", \"Reject\"];\n\n/** Rabby's focus-fragile popup requires in-page clicks; signing then requires a second Confirm click. */\nconst clickApprovalButton = async (\n  popup: Page,\n  labels: ReadonlyArray<string>,\n): Promise<boolean> => {\n  // Every label already clicked, not just the most recent one: after Sign then Confirm, a one-slot\n  // memory makes \"Sign\" eligible again, and re-clicking it re-issues the request.\n  const clickedLabels = new Set<string>();\n  const answered = await waitUntil(\n    async () => {\n      if (popup.isClosed()) {\n        return true;\n      }\n      const clicked = await popup\n        .evaluate(\n          (arg) => {\n            const target = [...document.querySelectorAll(\"button\")].find((button) => {\n              const text = (button.textContent ?? \"\").trim();\n              return arg.names.includes(text) && !button.disabled && !arg.skip.includes(text);\n            });\n            target?.click();\n            return target ? (target.textContent ?? \"\").trim() : \"\";\n          },\n          { names: [...labels], skip: [...clickedLabels] },\n        )\n        .catch(() => \"\");\n      if (clicked) {\n        clickedLabels.add(clicked);\n      }\n      return undefined;\n    },\n    { intervalMs: 300, timeoutMs: APPROVAL_TIMEOUT_MS },\n  );\n  return answered === true || popup.isClosed();\n};\n\nexport const rabby: WalletDefinition = {\n  approve: async (popup) => {\n    if (!(await clickApprovalButton(popup, CONFIRM_LABELS))) {\n      throw new Error(\"[walletwright] Rabby approval: no confirm button became actionable\");\n    }\n  },\n\n  ecosystems: [\"evm\"],\n\n  extensionName: \"Rabby\",\n\n  headlessApprovals: true,\n\n  importWallet,\n\n  onboardingPage: ONBOARDING_ROUTE,\n\n  prepareExtension: (cacheDir) =>\n    prepareWebStoreExtension({\n      cacheDir,\n      extensionId: RABBY_EXTENSION_ID,\n      name: \"rabby-chrome-latest\",\n    }),\n\n  reachUnlockScreen,\n\n  reject: async (popup) => {\n    if (!(await clickApprovalButton(popup, CANCEL_LABELS))) {\n      throw new Error(\"[walletwright] Rabby reject: no cancel button became actionable\");\n    }\n  },\n\n  unlock,\n};\n","import type { Page } from \"@playwright/test\";\n\nimport { prepareWebStoreExtension } from \"../internal/download\";\nimport { createUnlockScreen } from \"../internal/unlock-screen\";\nimport { sleep, waitUntilOrThrow } from \"../internal/wait\";\nimport type { WalletDefinition } from \"../types\";\n\nconst SLUSH_EXTENSION_ID = \"opcgpfmipidbgpenhmajoajpbobppdil\";\n\nconst HOME_ROUTE = \"#/tokens\";\n\nconst IMPORT_HOME_TIMEOUT_MS = 30_000;\n\nconst atHome = async (page: Page): Promise<boolean> =>\n  (await page.evaluate(() => globalThis.location.hash).catch(() => \"\")) === HOME_ROUTE;\n\nconst fclick = async (page: Page, text: string, timeoutMs = 15_000): Promise<boolean> => {\n  const target = page.getByText(text, { exact: true }).first();\n  const visible = await target\n    .waitFor({ state: \"visible\", timeout: timeoutMs })\n    .then(() => true)\n    .catch(() => false);\n  if (!visible) {\n    return false;\n  }\n  await target.scrollIntoViewIfNeeded().catch(() => {});\n  await target.click({ force: true, timeout: timeoutMs });\n  return true;\n};\n\nconst { reachUnlockScreen, unlock } = createUnlockScreen({\n  entry: \"index.html\",\n  isUnlocked: atHome,\n  submit: async (page) => {\n    await fclick(page, \"Unlock\");\n  },\n  wallet: \"Slush\",\n});\n\nexport const slush: WalletDefinition = {\n  approve: async (popup, password) => {\n    await sleep(2000);\n    const confirmed = (await fclick(popup, \"Approve\", 4000)) || (await fclick(popup, \"Sign\"));\n    if (!confirmed) {\n      throw new Error(\"[walletwright] Slush approval: neither Approve nor Sign was actionable\");\n    }\n    await sleep(1500);\n    const input = popup.locator('input[type=\"password\"]');\n    if (await input.isVisible().catch(() => false)) {\n      await input.fill(password);\n      await fclick(popup, \"Unlock\");\n    }\n  },\n\n  ecosystems: [\"sui\"],\n\n  extensionName: \"Slush\",\n\n  importWallet: async (page, seedPhrase, password) => {\n    await fclick(page, \"More options\");\n    await sleep(1000);\n    await fclick(page, \"Import existing from passphrase\");\n    await sleep(1500);\n\n    const words = seedPhrase.trim().split(/\\s+/v);\n    for (let i = 0; i < words.length; i++) {\n      await page.getByLabel(`Word ${i + 1}`, { exact: true }).fill(words[i] ?? \"\");\n    }\n    await page.getByRole(\"button\", { name: \"Next\" }).click();\n    await sleep(2000);\n\n    await page.locator('input[placeholder=\"Password\"]').fill(password);\n    await page.locator('input[placeholder=\"Confirm Password\"]').fill(password);\n    await page.getByRole(\"button\", { name: \"Next\" }).click();\n    await sleep(2000);\n\n    await page\n      .getByRole(\"button\", { name: \"Next\" })\n      .click()\n      .catch(() => {});\n    await waitUntilOrThrow(() => atHome(page), {\n      intervalMs: 1000,\n      message: `Slush import never reached the wallet home (${HOME_ROUTE})`,\n      timeoutMs: IMPORT_HOME_TIMEOUT_MS,\n    });\n  },\n\n  notificationMatch: \"isPopup=1\",\n\n  onboardingPage: \"index.html\",\n\n  prepareContext: async (context) => {\n    await context.route(\"**://*.slush.app/**\", (route) =>\n      route.fulfill({\n        body: JSON.stringify({ data: {} }),\n        contentType: \"application/json\",\n        status: 200,\n      }),\n    );\n  },\n\n  prepareExtension: (cacheDir) =>\n    prepareWebStoreExtension({\n      cacheDir,\n      extensionId: SLUSH_EXTENSION_ID,\n      name: \"slush-chrome-latest\",\n    }),\n\n  reachUnlockScreen,\n\n  reject: async (popup) => {\n    await sleep(2000);\n    if (!(await fclick(popup, \"Reject\"))) {\n      throw new Error(\"[walletwright] Slush reject: no Reject control was actionable\");\n    }\n  },\n\n  unlock,\n};\n","import type { Page } from \"@playwright/test\";\n\nimport { prepareWebStoreExtension } from \"../internal/download\";\nimport { createUnlockScreen } from \"../internal/unlock-screen\";\nimport type { WalletDefinition } from \"../types\";\n\nconst SOLFLARE_EXTENSION_ID = \"bhhhlbepdkbapadjdnnojkbgioiodbic\";\n\nconst { reachUnlockScreen, unlock } = createUnlockScreen({\n  entry: \"wallet.html\",\n  wallet: \"Solflare\",\n});\n\nconst importWallet = async (page: Page, seedPhrase: string, password: string): Promise<void> => {\n  await page.getByTestId(\"btn-import-existing-wallet\").click({ timeout: 30_000 });\n  await page.getByText(\"Recovery phrase\", { exact: true }).first().click({ timeout: 30_000 });\n\n  const words = seedPhrase.trim().split(/\\s+/v);\n  await page.getByTestId(\"input-recovery-phrase-1\").waitFor({ state: \"visible\", timeout: 30_000 });\n  for (let index = 0; index < words.length; index++) {\n    await page.getByTestId(`input-recovery-phrase-${index + 1}`).fill(words[index] ?? \"\");\n  }\n  await page.getByTestId(\"btn-continue\").click({ timeout: 30_000 });\n\n  await page.getByTestId(\"input-new-password\").waitFor({ state: \"visible\", timeout: 30_000 });\n  await page.getByTestId(\"input-new-password\").fill(password);\n  await page.getByTestId(\"input-repeat-password\").fill(password);\n  await page.getByTestId(\"btn-continue\").click({ timeout: 30_000 });\n\n  await page.getByTestId(\"btn-quick-setup\").click({ timeout: 60_000 });\n\n  await page.getByTestId(\"btn-explore\").click({ timeout: 60_000 });\n};\n\nexport const solflare: WalletDefinition = {\n  approve: async (popup) => {\n    await popup\n      .getByTestId(\"btn-connect\")\n      .or(popup.getByTestId(\"btn-approve\"))\n      .first()\n      .click({ timeout: 30_000 });\n  },\n\n  ecosystems: [\"svm\"],\n\n  extensionName: \"Solflare\",\n\n  importWallet,\n\n  notificationMatch: \"confirm_popup.html\",\n\n  onboardingPage: \"wallet.html\",\n\n  prepareExtension: (cacheDir) =>\n    prepareWebStoreExtension({\n      cacheDir,\n      extensionId: SOLFLARE_EXTENSION_ID,\n      name: \"solflare-chrome-latest\",\n    }),\n\n  reachUnlockScreen,\n\n  reject: async (popup) => {\n    await popup\n      .getByTestId(\"btn-cancel\")\n      .or(popup.getByTestId(\"btn-reject\"))\n      .first()\n      .click({ timeout: 30_000 });\n  },\n\n  unlock,\n};\n","import type { Ecosystem, WalletDefinition, WalletKind } from \"../types\";\n\nimport { metamask } from \"./metamask\";\nimport { phantom } from \"./phantom\";\nimport { rabby } from \"./rabby\";\nimport { slush } from \"./slush\";\nimport { solflare } from \"./solflare\";\n\nexport const wallets: Record<WalletKind, WalletDefinition> = {\n  metamask,\n  phantom,\n  rabby,\n  slush,\n  solflare,\n};\n\n/** Narrow an arbitrary string (CLI flag, setup file field) to a supported wallet. */\nexport const isWalletKind = (value: string): value is WalletKind => Object.hasOwn(wallets, value);\n\nconst walletKinds = Object.keys(wallets).filter(isWalletKind);\n\n/** Wallet kinds that can drive the given ecosystem (e.g. `\"evm\"` → MetaMask, Phantom). */\nexport const walletKindsByEcosystem = (ecosystem: Ecosystem): Array<WalletKind> =>\n  walletKinds.filter((kind) => wallets[kind].ecosystems.includes(ecosystem));\n","/**\n * How walletwright launches Chromium with a wallet extension loaded. Shared by the cache build and\n * the test run so the two cannot drift: an extension that loads for onboarding but not for the\n * tests (or the reverse) fails far from its cause.\n */\nexport const extensionContextOptions = (\n  extensionPath: string,\n  headless: boolean,\n): { args: Array<string>; channel: string; headless: boolean } => ({\n  args: [`--disable-extensions-except=${extensionPath}`, `--load-extension=${extensionPath}`],\n  channel: \"chromium\",\n  headless,\n});\n","import { mkdir, mkdtemp, readdir, rename, rm, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport { chromium } from \"@playwright/test\";\n\nimport type { WalletSetup } from \"../types\";\nimport { wallets } from \"../wallets/index\";\n\nimport { extensionContextOptions } from \"./chromium\";\nimport { DEFAULT_CACHE_DIR, extensionIdFromPath, extensionStateDir, profileKey } from \"./utils\";\nimport { gotoWithRetry, sleep, waitUntilOrThrow } from \"./wait\";\n\nconst NAVIGATION_TIMEOUT_MS = 15_000;\nconst FLUSH_SETTLE_MS = 3000;\nconst STATE_WRITE_TIMEOUT_MS = 10_000;\n\n/** Wallet state may live in `chrome.storage.local` or extension IndexedDB. */\nconst hasPersistedState = async (profileDir: string, extensionId: string): Promise<boolean> => {\n  const stores = [\n    extensionStateDir(profileDir, extensionId),\n    path.join(\n      profileDir,\n      \"Default\",\n      \"IndexedDB\",\n      `chrome-extension_${extensionId}_0.indexeddb.leveldb`,\n    ),\n  ];\n  const listings = await Promise.allSettled(stores.map((dir) => readdir(dir)));\n  return listings.some((listing) => listing.status === \"fulfilled\" && listing.value.length > 0);\n};\n\n/**\n * Prefix for an in-progress build. Inside `cacheDir` so publishing is a `rename` on one filesystem,\n * dot-prefixed so it can never be mistaken for a 20-hex-character `profileKey`.\n */\nconst BUILD_PREFIX = \".building-\";\nconst PREVIOUS_SUFFIX = \".previous\";\n\nconst isErrorCode = (error: unknown, code: string): boolean =>\n  error instanceof Error && \"code\" in error && error.code === code;\n\nconst pathExists = async (target: string): Promise<boolean> => {\n  try {\n    await stat(target);\n    return true;\n  } catch (error) {\n    if (isErrorCode(error, \"ENOENT\")) {\n      return false;\n    }\n    throw error;\n  }\n};\n\nconst previousProfileDir = (profileDir: string): string => `${profileDir}${PREVIOUS_SUFFIX}`;\n\nconst restorePreviousProfile = async (profileDir: string): Promise<void> => {\n  const previous = previousProfileDir(profileDir);\n  if (await pathExists(profileDir)) {\n    await rm(previous, { force: true, recursive: true });\n    return;\n  }\n  try {\n    await rename(previous, profileDir);\n  } catch (error) {\n    if (!isErrorCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n};\n\nconst publishProfile = async (staging: string, profileDir: string): Promise<void> => {\n  await restorePreviousProfile(profileDir);\n  const previous = previousProfileDir(profileDir);\n  let movedPrevious = false;\n  try {\n    await rename(profileDir, previous);\n    movedPrevious = true;\n  } catch (error) {\n    if (!isErrorCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n\n  try {\n    await rename(staging, profileDir);\n  } catch (error) {\n    if (movedPrevious) {\n      try {\n        await rename(previous, profileDir);\n      } catch (rollbackError) {\n        const publishMessage = error instanceof Error ? error.message : String(error);\n        const rollbackMessage =\n          rollbackError instanceof Error ? rollbackError.message : String(rollbackError);\n        throw new Error(\n          `[walletwright] failed to publish cache at ${profileDir}: ${publishMessage}; rollback failed: ${rollbackMessage}`,\n          { cause: rollbackError },\n        );\n      }\n    }\n    throw error;\n  }\n\n  if (movedPrevious) {\n    await rm(previous, { force: true, recursive: true });\n  }\n};\n\n/** Build in staging and retain the prior cache until the new profile publishes successfully. */\nconst buildCache = async (\n  setup: WalletSetup,\n  options: { headless?: boolean } = {},\n): Promise<string> => {\n  const definition = wallets[setup.wallet];\n  const cacheDir = path.resolve(setup.cacheDir ?? DEFAULT_CACHE_DIR);\n  const extensionPath = await definition.prepareExtension(cacheDir, setup.version);\n\n  const profileDir = path.join(cacheDir, profileKey(setup));\n  await restorePreviousProfile(profileDir);\n  await mkdir(cacheDir, { recursive: true });\n  const staging = await mkdtemp(path.join(cacheDir, BUILD_PREFIX));\n\n  let context;\n  try {\n    context = await chromium.launchPersistentContext(\n      staging,\n      extensionContextOptions(extensionPath, options.headless === true),\n    );\n    await definition.prepareContext?.(context);\n    const extensionId = extensionIdFromPath(extensionPath);\n\n    const page =\n      context.pages().find((candidate) => candidate.url() === \"about:blank\") ??\n      (await context.newPage());\n    await gotoWithRetry(page, `chrome-extension://${extensionId}/${definition.onboardingPage}`, {\n      label: `${definition.extensionName} onboarding page`,\n      timeoutMs: NAVIGATION_TIMEOUT_MS,\n    });\n    await sleep(2000);\n\n    await definition.importWallet(page, setup.seedPhrase, setup.password);\n    await sleep(FLUSH_SETTLE_MS); // let the wallet flush state to disk before we close\n    await waitUntilOrThrow(() => hasPersistedState(staging, extensionId), {\n      intervalMs: 500,\n      message: `${definition.extensionName} onboarding wrote no wallet state into ${staging}`,\n      timeoutMs: STATE_WRITE_TIMEOUT_MS,\n    });\n    await context.close();\n    await definition.finalizeCache?.(staging, extensionId);\n\n    await publishProfile(staging, profileDir);\n    return profileDir;\n  } catch (error) {\n    await context?.close().catch(() => {});\n    throw error;\n  } finally {\n    await rm(staging, { force: true, recursive: true });\n  }\n};\n\nexport { buildCache, publishProfile, restorePreviousProfile };\n"],"mappings":"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"}

package/dist/chain.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chain.mjs","names":[],"sources":["../src/chain.ts"],"sourcesContent":["import { Instance } from \"prool\";\n\n/**\n * A running local EVM node for transaction and network tests. `@walletwright/core/chain` is a\n * separate entry point: it needs `prool` and Foundry's `anvil` binary, which the core connect/sign\n * flow does not, so it stays out of the default install.\n */\nexport type LocalChain = {\n  chainId: number;\n  /** JSON-RPC endpoint to hand to the wallet (via `addNetwork` or `wallet_addEthereumChain`). */\n  rpcUrl: string;\n  stop: () => Promise<void>;\n};\n\nexport type LocalChainOptions = {\n  /** `anvil` binary to run. Defaults to `anvil` on `PATH` (Foundry's standard install location). */\n  binary?: string;\n  chainId?: number;\n  /** Seed for the pre-funded accounts. Defaults to the public Hardhat/Anvil test mnemonic. */\n  mnemonic?: string;\n  port?: number;\n};\n\n// Anvil and Hardhat both default to this mnemonic and pre-fund account #0 as\n// 0xf39F…92266 with 10000 ETH, the account walletwright's MetaMask setup already imports.\nconst TEST_MNEMONIC = \"test test test test test test test test test test test junk\";\n\nconst createLocalChain = async (options: LocalChainOptions = {}): Promise<LocalChain> => {\n  const { binary = \"anvil\", chainId = 31_337, mnemonic = TEST_MNEMONIC, port = 8545 } = options;\n  const instance = Instance.anvil({ binary, chainId, mnemonic, port });\n  await instance.start();\n\n  return {\n    chainId,\n    rpcUrl: `http://127.0.0.1:${port}`,\n    stop: async () => {\n      await instance.stop();\n    },\n  };\n};\n\nexport { createLocalChain };\n"],"mappings":";;;AAyBA,MAAM,gBAAgB;AAEtB,MAAM,mBAAmB,OAAO,UAA6B,CAAC,MAA2B;CACvF,MAAM,EAAE,SAAS,SAAS,UAAU,OAAQ,WAAW,eAAe,OAAO,SAAS;CACtF,MAAM,WAAW,SAAS,MAAM;EAAE;EAAQ;EAAS;EAAU;CAAK,CAAC;CACnE,MAAM,SAAS,MAAM;CAErB,OAAO;EACL;EACA,QAAQ,oBAAoB;EAC5B,MAAM,YAAY;GAChB,MAAM,SAAS,KAAK;EACtB;CACF;AACF"}
+{"version":3,"file":"chain.mjs","names":[],"sources":["../src/chain.ts"],"sourcesContent":["import { Instance } from \"prool\";\n\n/**\n * A running local EVM node for transaction and network tests. `@walletwright/core/chain` is a\n * separate entry point: it needs `prool` and Foundry's `anvil` binary, which the core connect/sign\n * flow does not, so it stays out of the default install.\n */\nexport type LocalChain = {\n  chainId: number;\n  /** JSON-RPC endpoint to hand to the wallet (via `addNetwork` or `wallet_addEthereumChain`). */\n  rpcUrl: string;\n  stop: () => Promise<void>;\n};\n\nexport type LocalChainOptions = {\n  /** `anvil` binary to run. Defaults to `anvil` on `PATH` (Foundry's standard install location). */\n  binary?: string;\n  chainId?: number;\n  /** Seed for the pre-funded accounts. Defaults to the public Hardhat/Anvil test mnemonic. */\n  mnemonic?: string;\n  port?: number;\n};\n\nconst TEST_MNEMONIC = \"test test test test test test test test test test test junk\";\n\nconst createLocalChain = async (options: LocalChainOptions = {}): Promise<LocalChain> => {\n  const { binary = \"anvil\", chainId = 31_337, mnemonic = TEST_MNEMONIC, port = 8545 } = options;\n  const instance = Instance.anvil({ binary, chainId, mnemonic, port });\n  await instance.start();\n\n  return {\n    chainId,\n    rpcUrl: `http://127.0.0.1:${port}`,\n    stop: async () => {\n      await instance.stop();\n    },\n  };\n};\n\nexport { createLocalChain };\n"],"mappings":";;;AAuBA,MAAM,gBAAgB;AAEtB,MAAM,mBAAmB,OAAO,UAA6B,CAAC,MAA2B;CACvF,MAAM,EAAE,SAAS,SAAS,UAAU,OAAQ,WAAW,eAAe,OAAO,SAAS;CACtF,MAAM,WAAW,SAAS,MAAM;EAAE;EAAQ;EAAS;EAAU;CAAK,CAAC;CACnE,MAAM,SAAS,MAAM;CAErB,OAAO;EACL;EACA,QAAQ,oBAAoB;EAC5B,MAAM,YAAY;GAChB,MAAM,SAAS,KAAK;EACtB;CACF;AACF"}

package/dist/cli.d.mts

@@ -1,14 +1,26 @@
-import { a as WalletSetup } from "./types-CWxz_dJe.mjs";
+import { a as WalletSetup } from "./types-CFQpWZhv.mjs";
 //#region src/cli.d.ts
-declare const parseFlags: (argv: Array<string>) => Record<string, string | boolean>;
-declare const resolveSetup: (flags: Record<string, string | boolean>) => Promise<WalletSetup>;
-/**
- * Node resolves `import.meta.url` through symlinks but leaves `process.argv[1]` as the caller
- * typed it, so comparing the two directly is false whenever the CLI is reached through a symlink,
- * which is every pnpm install: `node_modules/.bin/walletwright` execs the package through an
- * `.pnpm` symlink. The command then exits 0 having printed and done nothing.
- */
+type Flags = {
+  "cache-dir"?: string;
+  headless?: boolean;
+  help?: boolean;
+  password?: string;
+  seed?: string;
+  setup?: string;
+  version?: string;
+  wallet?: string;
+};
+type Command = {
+  kind: "help";
+} | {
+  headless: boolean;
+  kind: "cache";
+  setup: WalletSetup;
+};
+declare const resolveSetup: (flags: Flags) => Promise<WalletSetup>;
+declare const parseArgv: (argv: Array<string>) => Promise<Command>;
+/** Resolve the CLI symlink before comparing `process.argv[1]` with `import.meta.url`. */
 declare const isEntryPoint: (moduleUrl: string, entryPath: string | undefined) => boolean;
 //#endregion
-export { isEntryPoint, parseFlags, resolveSetup };
+export { isEntryPoint, parseArgv, resolveSetup };
 //# sourceMappingURL=cli.d.mts.map

package/dist/cli.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { a as wallets, r as isWalletKind, t as buildCache } from "./cache-Bqz3Mchl.mjs";
+import { i as isWalletKind, o as wallets, t as buildCache } from "./cache-CHP-6eU0.mjs";
 import path from "node:path";
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
+import { parseArgs } from "node:util";
 
 //#region src/cli.ts
 const KINDS = Object.keys(wallets);
@@ -22,23 +23,33 @@ Options:
   --headless         build the cache headless
   -h, --help         show this help
 
+--setup carries the whole setup, so it cannot be combined with --wallet/--seed/--password/--version;
+--cache-dir works with either form. A value that begins with "-" needs the --flag=value spelling.
+
 --seed and --password are visible in shell history and process lists when passed as flags; use
 test-only values, or prefer --setup <file> to keep them out of argv.
 `;
-const parseFlags = (argv) => {
-	const flags = {};
-	for (let i = 0; i < argv.length; i++) {
-		const token = argv[i];
-		if (!token?.startsWith("--") && token !== "-h") continue;
-		const key = token.replace(/* @__PURE__ */ new RegExp("^--?", "v"), "");
-		const next = argv[i + 1];
-		if (next && !next.startsWith("--")) {
-			flags[key] = next;
-			i++;
-		} else flags[key] = true;
-	}
-	return flags;
+/** `parseArgs` schema; strict mode rejects unknown, missing, or misplaced flag values. */
+const OPTIONS = {
+	"cache-dir": { type: "string" },
+	headless: { type: "boolean" },
+	help: {
+		short: "h",
+		type: "boolean"
+	},
+	password: { type: "string" },
+	seed: { type: "string" },
+	setup: { type: "string" },
+	version: { type: "string" },
+	wallet: { type: "string" }
 };
+/** The flags `--setup` makes redundant: accepting both silently discarded one of the two. */
+const SETUP_CONFLICTS = [
+	"password",
+	"seed",
+	"version",
+	"wallet"
+];
 const isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
 const isWalletSetup = (value) => typeof value === "object" && value !== null && "wallet" in value && typeof value.wallet === "string" && isWalletKind(value.wallet) && "seedPhrase" in value && isNonEmptyString(value.seedPhrase) && "password" in value && isNonEmptyString(value.password);
 const loadSetup = async (file) => {
@@ -48,54 +59,70 @@ const loadSetup = async (file) => {
 	return setup;
 };
 const resolveSetup = async (flags) => {
-	if (typeof flags.setup === "string") {
-		const loaded = await loadSetup(flags.setup);
-		return typeof flags["cache-dir"] === "string" ? {
-			...loaded,
-			cacheDir: flags["cache-dir"]
-		} : loaded;
+	const withCacheDir = (setup) => isNonEmptyString(flags["cache-dir"]) ? {
+		...setup,
+		cacheDir: flags["cache-dir"]
+	} : setup;
+	if (isNonEmptyString(flags.setup)) {
+		const redundant = SETUP_CONFLICTS.filter((name) => flags[name] !== void 0);
+		if (redundant.length > 0) throw new Error(`[walletwright] --setup carries the whole setup, so --${redundant.join(", --")} would be ignored. Pass one or the other.`);
+		return withCacheDir(await loadSetup(flags.setup));
 	}
 	const { password, seed, wallet } = flags;
-	if (isNonEmptyString(wallet) && isNonEmptyString(seed) && isNonEmptyString(password)) {
-		if (!isWalletKind(wallet)) throw new Error(`[walletwright] unknown --wallet "${wallet}". Expected one of: ${Object.keys(wallets).join(", ")}.`);
-		return {
-			password,
-			seedPhrase: seed,
-			wallet,
-			...typeof flags.version === "string" ? { version: flags.version } : {},
-			...typeof flags["cache-dir"] === "string" ? { cacheDir: flags["cache-dir"] } : {}
-		};
+	if (!isNonEmptyString(wallet) || !isNonEmptyString(seed) || !isNonEmptyString(password)) throw new Error("[walletwright] provide --setup <file> or --wallet/--seed/--password. See --help.");
+	if (!isWalletKind(wallet)) throw new Error(`[walletwright] unknown --wallet "${wallet}". Expected one of: ${KINDS.join(", ")}.`);
+	const base = {
+		password,
+		seedPhrase: seed,
+		wallet
+	};
+	return withCacheDir(isNonEmptyString(flags.version) ? {
+		...base,
+		version: flags.version
+	} : base);
+};
+const parseArgv = async (argv) => {
+	let parsed;
+	try {
+		parsed = parseArgs({
+			allowPositionals: true,
+			args: argv,
+			options: OPTIONS,
+			strict: true
+		});
+	} catch (error) {
+		throw new Error(`[walletwright] ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
-	throw new Error("[walletwright] provide --setup <file> or --wallet/--seed/--password. See --help.");
+	const flags = parsed.values;
+	const [command, ...extra] = parsed.positionals;
+	if (flags.help === true || command === void 0 || command === "help") return { kind: "help" };
+	if (command !== "cache") throw new Error(`[walletwright] unknown command "${command}". Run \`walletwright --help\`.`);
+	if (extra.length > 0) throw new Error(`[walletwright] unexpected argument "${extra[0]}". Run \`walletwright --help\`.`);
+	return {
+		headless: flags.headless === true,
+		kind: "cache",
+		setup: await resolveSetup(flags)
+	};
 };
 const main = async () => {
-	const argv = process.argv.slice(2);
-	const [command] = argv;
-	const flags = parseFlags(argv);
-	if (!command || command === "help" || flags.help !== void 0 || flags.h !== void 0) {
+	const command = await parseArgv(process.argv.slice(2));
+	if (command.kind === "help") {
 		process.stdout.write(HELP);
 		return;
 	}
-	if (command !== "cache") throw new Error(`[walletwright] unknown command "${command}". Run \`walletwright --help\`.`);
-	const setup = await resolveSetup(flags);
-	process.stdout.write(`[walletwright] building ${setup.wallet} cache…\n`);
-	const profileDir = await buildCache(setup, { headless: Boolean(flags.headless) });
+	process.stdout.write(`[walletwright] building ${command.setup.wallet} cache…\n`);
+	const profileDir = await buildCache(command.setup, { headless: command.headless });
 	process.stdout.write(`[walletwright] cache ready: ${profileDir}\n`);
 };
-/**
-* Node resolves `import.meta.url` through symlinks but leaves `process.argv[1]` as the caller
-* typed it, so comparing the two directly is false whenever the CLI is reached through a symlink,
-* which is every pnpm install: `node_modules/.bin/walletwright` execs the package through an
-* `.pnpm` symlink. The command then exits 0 having printed and done nothing.
-*/
+/** Resolve the CLI symlink before comparing `process.argv[1]` with `import.meta.url`. */
 const isEntryPoint = (moduleUrl, entryPath) => entryPath !== void 0 && moduleUrl === pathToFileURL(realpathSync(entryPath)).href;
 if (isEntryPoint(import.meta.url, process.argv[1])) try {
 	await main();
 } catch (error) {
 	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
-	process.exit(1);
+	process.exitCode = 1;
 }
 
 //#endregion
-export { isEntryPoint, parseFlags, resolveSetup };
+export { isEntryPoint, parseArgv, resolveSetup };
 //# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport { buildCache } from \"./internal/cache\";\nimport type { WalletSetup } from \"./types\";\nimport { isWalletKind, wallets } from \"./wallets/index\";\n\nconst KINDS = Object.keys(wallets);\n\nconst HELP = `walletwright: build the onboarded wallet cache for Playwright tests\n\nUsage:\n  walletwright cache --setup <file>            Build cache from a module's default-exported WalletSetup\n  walletwright cache --wallet <${KINDS.join(\"|\")}> --seed \"<phrase>\" --password \"<pw>\" [--version <v>]\n\nOptions:\n  --setup <file>     A module whose default export is a WalletSetup (.ts works on modern Node)\n  --wallet <kind>    ${KINDS.join(\" | \")}\n  --seed <phrase>    seed phrase to import\n  --password <pw>    wallet password\n  --version <v>      pin an extension version\n  --cache-dir <dir>  cache directory (default: .walletwright)\n  --headless         build the cache headless\n  -h, --help         show this help\n\n--seed and --password are visible in shell history and process lists when passed as flags; use\ntest-only values, or prefer --setup <file> to keep them out of argv.\n`;\n\nconst parseFlags = (argv: Array<string>): Record<string, string | boolean> => {\n  const flags: Record<string, string | boolean> = {};\n  for (let i = 0; i < argv.length; i++) {\n    const token = argv[i];\n    if (!token?.startsWith(\"--\") && token !== \"-h\") {\n      continue;\n    }\n    const key = token.replace(/^--?/v, \"\");\n    const next = argv[i + 1];\n    if (next && !next.startsWith(\"--\")) {\n      flags[key] = next;\n      i++;\n    } else {\n      flags[key] = true;\n    }\n  }\n  return flags;\n};\n\nconst isNonEmptyString = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0;\n\nconst isWalletSetup = (value: unknown): value is WalletSetup =>\n  typeof value === \"object\" &&\n  value !== null &&\n  \"wallet\" in value &&\n  typeof value.wallet === \"string\" &&\n  isWalletKind(value.wallet) &&\n  \"seedPhrase\" in value &&\n  isNonEmptyString(value.seedPhrase) &&\n  \"password\" in value &&\n  isNonEmptyString(value.password);\n\nconst loadSetup = async (file: string): Promise<WalletSetup> => {\n  const resolved = pathToFileURL(path.resolve(file)).href;\n  const mod: unknown = await import(resolved);\n  const setup =\n    typeof mod === \"object\" && mod !== null && \"default\" in mod ? mod.default : undefined;\n  if (!isWalletSetup(setup)) {\n    throw new Error(`[walletwright] ${file} must default-export a WalletSetup`);\n  }\n  return setup;\n};\n\nconst resolveSetup = async (flags: Record<string, string | boolean>): Promise<WalletSetup> => {\n  if (typeof flags.setup === \"string\") {\n    const loaded = await loadSetup(flags.setup);\n    return typeof flags[\"cache-dir\"] === \"string\"\n      ? { ...loaded, cacheDir: flags[\"cache-dir\"] }\n      : loaded;\n  }\n  const { password, seed, wallet } = flags;\n  if (isNonEmptyString(wallet) && isNonEmptyString(seed) && isNonEmptyString(password)) {\n    if (!isWalletKind(wallet)) {\n      throw new Error(\n        `[walletwright] unknown --wallet \"${wallet}\". Expected one of: ${Object.keys(wallets).join(\", \")}.`,\n      );\n    }\n    return {\n      password,\n      seedPhrase: seed,\n      wallet,\n      ...(typeof flags.version === \"string\" ? { version: flags.version } : {}),\n      ...(typeof flags[\"cache-dir\"] === \"string\" ? { cacheDir: flags[\"cache-dir\"] } : {}),\n    };\n  }\n  throw new Error(\n    \"[walletwright] provide --setup <file> or --wallet/--seed/--password. See --help.\",\n  );\n};\n\nconst main = async (): Promise<void> => {\n  const argv = process.argv.slice(2);\n  const [command] = argv;\n  const flags = parseFlags(argv);\n\n  if (!command || command === \"help\" || flags.help !== undefined || flags.h !== undefined) {\n    process.stdout.write(HELP);\n    return;\n  }\n  if (command !== \"cache\") {\n    throw new Error(`[walletwright] unknown command \"${command}\". Run \\`walletwright --help\\`.`);\n  }\n\n  const setup = await resolveSetup(flags);\n\n  process.stdout.write(`[walletwright] building ${setup.wallet} cache…\\n`);\n  const profileDir = await buildCache(setup, { headless: Boolean(flags.headless) });\n  process.stdout.write(`[walletwright] cache ready: ${profileDir}\\n`);\n};\n\n/**\n * Node resolves `import.meta.url` through symlinks but leaves `process.argv[1]` as the caller\n * typed it, so comparing the two directly is false whenever the CLI is reached through a symlink,\n * which is every pnpm install: `node_modules/.bin/walletwright` execs the package through an\n * `.pnpm` symlink. The command then exits 0 having printed and done nothing.\n */\nconst isEntryPoint = (moduleUrl: string, entryPath: string | undefined): boolean =>\n  entryPath !== undefined && moduleUrl === pathToFileURL(realpathSync(entryPath)).href;\n\nif (isEntryPoint(import.meta.url, process.argv[1])) {\n  try {\n    await main();\n  } catch (error: unknown) {\n    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n}\n\nexport { isEntryPoint, parseFlags, resolveSetup };\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { parseArgs } from \"node:util\";\n\nimport { buildCache } from \"./internal/cache\";\nimport type { WalletSetup } from \"./types\";\nimport { isWalletKind, wallets } from \"./wallets/index\";\n\nconst KINDS = Object.keys(wallets);\n\nconst HELP = `walletwright: build the onboarded wallet cache for Playwright tests\n\nUsage:\n  walletwright cache --setup <file>            Build cache from a module's default-exported WalletSetup\n  walletwright cache --wallet <${KINDS.join(\"|\")}> --seed \"<phrase>\" --password \"<pw>\" [--version <v>]\n\nOptions:\n  --setup <file>     A module whose default export is a WalletSetup (.ts works on modern Node)\n  --wallet <kind>    ${KINDS.join(\" | \")}\n  --seed <phrase>    seed phrase to import\n  --password <pw>    wallet password\n  --version <v>      pin an extension version\n  --cache-dir <dir>  cache directory (default: .walletwright)\n  --headless         build the cache headless\n  -h, --help         show this help\n\n--setup carries the whole setup, so it cannot be combined with --wallet/--seed/--password/--version;\n--cache-dir works with either form. A value that begins with \"-\" needs the --flag=value spelling.\n\n--seed and --password are visible in shell history and process lists when passed as flags; use\ntest-only values, or prefer --setup <file> to keep them out of argv.\n`;\n\n/** `parseArgs` schema; strict mode rejects unknown, missing, or misplaced flag values. */\nconst OPTIONS = {\n  \"cache-dir\": { type: \"string\" },\n  headless: { type: \"boolean\" },\n  help: { short: \"h\", type: \"boolean\" },\n  password: { type: \"string\" },\n  seed: { type: \"string\" },\n  setup: { type: \"string\" },\n  version: { type: \"string\" },\n  wallet: { type: \"string\" },\n} as const;\n\ntype Flags = {\n  \"cache-dir\"?: string;\n  headless?: boolean;\n  help?: boolean;\n  password?: string;\n  seed?: string;\n  setup?: string;\n  version?: string;\n  wallet?: string;\n};\n\n/** The flags `--setup` makes redundant: accepting both silently discarded one of the two. */\nconst SETUP_CONFLICTS = [\"password\", \"seed\", \"version\", \"wallet\"] as const;\n\ntype Command = { kind: \"help\" } | { headless: boolean; kind: \"cache\"; setup: WalletSetup };\n\nconst isNonEmptyString = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0;\n\nconst isWalletSetup = (value: unknown): value is WalletSetup =>\n  typeof value === \"object\" &&\n  value !== null &&\n  \"wallet\" in value &&\n  typeof value.wallet === \"string\" &&\n  isWalletKind(value.wallet) &&\n  \"seedPhrase\" in value &&\n  isNonEmptyString(value.seedPhrase) &&\n  \"password\" in value &&\n  isNonEmptyString(value.password);\n\nconst loadSetup = async (file: string): Promise<WalletSetup> => {\n  const resolved = pathToFileURL(path.resolve(file)).href;\n  const mod: unknown = await import(resolved);\n  const setup =\n    typeof mod === \"object\" && mod !== null && \"default\" in mod ? mod.default : undefined;\n  if (!isWalletSetup(setup)) {\n    throw new Error(`[walletwright] ${file} must default-export a WalletSetup`);\n  }\n  return setup;\n};\n\nconst resolveSetup = async (flags: Flags): Promise<WalletSetup> => {\n  const withCacheDir = (setup: WalletSetup): WalletSetup =>\n    isNonEmptyString(flags[\"cache-dir\"]) ? { ...setup, cacheDir: flags[\"cache-dir\"] } : setup;\n\n  if (isNonEmptyString(flags.setup)) {\n    const redundant = SETUP_CONFLICTS.filter((name) => flags[name] !== undefined);\n    if (redundant.length > 0) {\n      throw new Error(\n        `[walletwright] --setup carries the whole setup, so --${redundant.join(\", --\")} would be ignored. Pass one or the other.`,\n      );\n    }\n    return withCacheDir(await loadSetup(flags.setup));\n  }\n\n  const { password, seed, wallet } = flags;\n  if (!isNonEmptyString(wallet) || !isNonEmptyString(seed) || !isNonEmptyString(password)) {\n    throw new Error(\n      \"[walletwright] provide --setup <file> or --wallet/--seed/--password. See --help.\",\n    );\n  }\n  if (!isWalletKind(wallet)) {\n    throw new Error(\n      `[walletwright] unknown --wallet \"${wallet}\". Expected one of: ${KINDS.join(\", \")}.`,\n    );\n  }\n  const base: WalletSetup = { password, seedPhrase: seed, wallet };\n  return withCacheDir(isNonEmptyString(flags.version) ? { ...base, version: flags.version } : base);\n};\n\nconst parseArgv = async (argv: Array<string>): Promise<Command> => {\n  let parsed;\n  try {\n    parsed = parseArgs({ allowPositionals: true, args: argv, options: OPTIONS, strict: true });\n  } catch (error) {\n    // node's ERR_PARSE_ARGS_* messages are good; they just need the prefix everything else here has.\n    throw new Error(`[walletwright] ${error instanceof Error ? error.message : String(error)}`, {\n      cause: error,\n    });\n  }\n\n  const flags: Flags = parsed.values;\n  const [command, ...extra] = parsed.positionals;\n\n  if (flags.help === true || command === undefined || command === \"help\") {\n    return { kind: \"help\" };\n  }\n  if (command !== \"cache\") {\n    throw new Error(`[walletwright] unknown command \"${command}\". Run \\`walletwright --help\\`.`);\n  }\n  if (extra.length > 0) {\n    throw new Error(\n      `[walletwright] unexpected argument \"${extra[0]}\". Run \\`walletwright --help\\`.`,\n    );\n  }\n\n  return { headless: flags.headless === true, kind: \"cache\", setup: await resolveSetup(flags) };\n};\n\nconst main = async (): Promise<void> => {\n  const command = await parseArgv(process.argv.slice(2));\n  if (command.kind === \"help\") {\n    process.stdout.write(HELP);\n    return;\n  }\n\n  process.stdout.write(`[walletwright] building ${command.setup.wallet} cache…\\n`);\n  const profileDir = await buildCache(command.setup, { headless: command.headless });\n  process.stdout.write(`[walletwright] cache ready: ${profileDir}\\n`);\n};\n\n/** Resolve the CLI symlink before comparing `process.argv[1]` with `import.meta.url`. */\nconst isEntryPoint = (moduleUrl: string, entryPath: string | undefined): boolean =>\n  entryPath !== undefined && moduleUrl === pathToFileURL(realpathSync(entryPath)).href;\n\nif (isEntryPoint(import.meta.url, process.argv[1])) {\n  try {\n    await main();\n  } catch (error: unknown) {\n    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n    // Not process.exit(1): writes to a piped stderr are async and exit() does not flush them, so\n    // `walletwright cache … 2>&1 | tee build.log` could exit 1 with an empty diagnostic. Nothing runs\n    // after this block, so the process ends on its own once the write drains.\n    process.exitCode = 1;\n  }\n}\n\nexport { isEntryPoint, parseArgv, resolveSetup };\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,28 +1,23 @@
-import { a as WalletSetup, i as WalletKind, n as Wallet, r as WalletDefinition, t as Ecosystem } from "./types-CWxz_dJe.mjs";
+import { a as WalletSetup, i as WalletKind, n as Wallet, r as WalletDefinition, t as Ecosystem } from "./types-CFQpWZhv.mjs";
 import { BrowserContext } from "@playwright/test";
 //#region src/internal/cache.d.ts
-/**
- * Import the wallet once and persist an onboarded browser profile to disk (the "cache"), so tests
- * launch a ready-to-unlock wallet instead of re-running onboarding each time. Returns the profile
- * directory. Idempotent per (wallet, version, seed, password).
- *
- * `headless` only affects this build step; the tests choose their own mode via `launchWallet`.
- */
+/** Build in staging and retain the prior cache until the new profile publishes successfully. */
 declare const buildCache: (setup: WalletSetup, options?: {
   headless?: boolean;
 }) => Promise<string>;
 //#endregion
 //#region src/internal/launch.d.ts
 type LaunchedWallet = {
+  /**
+   * Close the browser and remove the throwaway profile copy, in that order. Prefer this over
+   * `context.close()`: the copy is a full onboarded profile (tens of MB), and awaiting its removal is
+   * the only way to know it is gone before the process exits.
+   */
+  close: () => Promise<void>;
   context: BrowserContext;
   wallet: Wallet;
 };
-/**
- * Launch a fresh persistent context from the onboarded cache and return an unlocked wallet
- * controller. Headed by default; `headless` needs the wallet to declare `headlessApprovals`, since
- * some wallets create an approval window headless that is never exposed as a page. Outside
- * Playwright fixtures, `context.close()` is yours.
- */
+/** Launch and unlock a disposable profile copy. Headless mode requires verified wallet support. */
 declare const launchWallet: (setup: WalletSetup, { headless }?: {
   headless?: boolean;
 }) => Promise<LaunchedWallet>;
@@ -35,25 +30,15 @@ type WalletFixtures = {
 type LaunchFixture = {
   walletLaunch: LaunchedWallet;
 };
-/**
- * Build a Playwright `test` whose `context`/`page` run inside a persistent Chromium with the wallet
- * loaded and unlocked, exposing a `wallet` fixture to approve connect/sign popups.
- *
- * ```ts
- * const test = createWalletFixtures(setup);
- * test("connect", async ({ page, wallet }) => {
- *   await page.goto("/");
- *   await page.getByRole("button", { name: "Connect" }).click();
- *   await wallet.connectToDapp();
- * });
- * ```
- */
+/** Create Playwright fixtures backed by one unlocked wallet launch per test. */
 declare const createWalletFixtures: (setup: WalletSetup) => import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & LaunchFixture & WalletFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
 //#endregion
 //#region src/wallets/index.d.ts
 declare const wallets: Record<WalletKind, WalletDefinition>;
+/** Narrow an arbitrary string (CLI flag, setup file field) to a supported wallet. */
+declare const isWalletKind: (value: string) => value is WalletKind;
 /** Wallet kinds that can drive the given ecosystem (e.g. `"evm"` → MetaMask, Phantom). */
 declare const walletKindsByEcosystem: (ecosystem: Ecosystem) => Array<WalletKind>;
 //#endregion
-export { type Ecosystem, type LaunchedWallet, type Wallet, type WalletDefinition, type WalletFixtures, type WalletKind, type WalletSetup, buildCache, createWalletFixtures, launchWallet, walletKindsByEcosystem, wallets };
+export { type Ecosystem, type LaunchedWallet, type Wallet, type WalletDefinition, type WalletFixtures, type WalletKind, type WalletSetup, buildCache, createWalletFixtures, isWalletKind, launchWallet, walletKindsByEcosystem, wallets };
 //# sourceMappingURL=index.d.mts.map