@marigoldlabs/web3-tester 0.1.0 → 0.1.2

package/README.md

@@ -1,8 +1,8 @@
 # Web3 Tester
 
-`@marigoldlabs/web3-tester` is a Playwright, Anvil, and Viem harness for deterministic Web3 end-to-end tests without a browser wallet extension.
+`@marigoldlabs/web3-tester` is a Playwright, Anvil, Viem, and MetaMask harness for Web3 end-to-end tests.
 
-The core rule is simple: test the dApp, not MetaMask's popup UI. The harness injects a standards-shaped EIP-1193 provider before application scripts run, bridges wallet RPC calls back to the Playwright process, and sends chain operations directly to Anvil or to an explicit live-chain signer.
+The injected fixtures test dApp behavior with a programmable EIP-1193 provider. The real-wallet adapter launches a persistent Chromium profile with MetaMask, imports or unlocks the profile when configured, and exposes wallet-side actions so consumer apps do not carry extension automation code.
 
 ## What It Provides
 
@@ -12,6 +12,7 @@ The core rule is simple: test the dApp, not MetaMask's popup UI. The harness inj
 - EIP-6963 provider announcements for wallet selector testing.
 - Viem-backed chain helpers for impersonation, balance setup, time travel, and block mining.
 - Optional live-chain fixtures for controlled Sepolia QA with a runtime-only private key.
+- Real MetaMask launch, profile resolution, unlock/import, dapp connection, signature confirmation, transaction confirmation, and token approval helpers.
 - Fjord v4 QA specs and reports that document the current state of `https://v4.fjordfoundry.com`.
 
 ## Install In A Consumer App
@@ -19,7 +20,7 @@ The core rule is simple: test the dApp, not MetaMask's popup UI. The harness inj
 From the Fjord v4 package, install this repo as a dev dependency:
 
 ```bash
-npm install --save-dev github:AndyMarigoldLabs/web3-tester
+npm install --save-dev @marigoldlabs/web3-tester
 ```
 
 Then import the local deterministic fixture:
@@ -52,6 +53,30 @@ test('signs in through SIWE on Sepolia', async ({ page, wallet }) => {
 });
 ```
 
+For fully in-UI real wallet tests, launch MetaMask through the package:
+
+```ts
+import { launchRealWallet } from '@marigoldlabs/web3-tester/real-wallet';
+
+const wallet = await launchRealWallet({
+  baseURL: 'https://v4.fjordfoundry.com',
+  expectedAddress: process.env.FJORD_REAL_WALLET_ADDRESS,
+  extensionPath: process.env.FJORD_REAL_WALLET_EXTENSION_PATH as string,
+  profileDir: process.env.FJORD_REAL_WALLET_PROFILE_DIR as string,
+  setup: process.env.FJORD_REAL_WALLET_PASSWORD || process.env.FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE
+    ? {
+        password: process.env.FJORD_REAL_WALLET_PASSWORD,
+        seedPhrase: process.env.FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE,
+      }
+    : undefined,
+});
+
+await wallet.connectToDapp();
+await wallet.confirmSignature();
+await wallet.confirmTransaction();
+await wallet.close();
+```
+
 ## Local Development
 
 ```bash
@@ -107,6 +132,11 @@ Copy `.env.example` for local reference. Do not commit real private keys.
 | `FJORD_MUTATE_STATE` | unset | Must be `true` to deploy QA tokens or create sale drafts. |
 | `FJORD_PUBLISH_SALES` | unset | Must be `true` to attempt live sale publishing. |
 | `FJORD_ADMIN_MUTATE` | unset | Must be `true` to attempt admin mutation tests. |
+| `FJORD_REAL_WALLET_EXTENSION_PATH` | unset | Path to the unpacked MetaMask extension for real-wallet tests. |
+| `FJORD_REAL_WALLET_PROFILE_DIR` | unset | Persistent Chromium user-data directory, or a Chrome profile directory such as `Profile 1`. |
+| `FJORD_REAL_WALLET_ADDRESS` | unset | Optional expected account address checked after unlock/import. |
+| `FJORD_REAL_WALLET_PASSWORD` | unset | Optional MetaMask password used to unlock the profile. When importing from a seed without a password, web3-tester uses a deterministic test profile password. |
+| `FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE` | unset | Optional seed phrase used when MetaMask opens on onboarding. |
 
 ## Package Surface
 
@@ -115,6 +145,7 @@ The installable package exports:
 - `@marigoldlabs/web3-tester`
 - `@marigoldlabs/web3-tester/fixtures`
 - `@marigoldlabs/web3-tester/live-fixtures`
+- `@marigoldlabs/web3-tester/real-wallet`
 - `@marigoldlabs/web3-tester/anvil`
 - `@marigoldlabs/web3-tester/mock-wallet-controller`
 - `@marigoldlabs/web3-tester/private-key-rpc-client`
@@ -169,6 +200,7 @@ test.use({
 
 - Local tests use deterministic Anvil accounts only.
 - Live tests require explicit environment variables and never store private keys in source.
+- Real-wallet tests use a persistent browser profile and keep extension-side automation inside this package.
 - Mutation tests are skipped unless their opt-in flag is set.
 - Published reports redact secrets and record transaction hashes only when useful for auditability.
 

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,aAAa,SAClB,MAAM,WACH,MAAM,SACR,OAAO,KACb,oBAOF,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAW,OAAO,KAAG,mBAiBlD,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,OAAO,OAAO,KACb,oBAOF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,mBAiBlD,CAAC"}

package/dist/index.d.ts

@@ -2,8 +2,10 @@ export { AnvilInstance, ChainController } from './anvil.js';
 export { test, expect } from './fixtures.js';
 export { MockWalletController } from './mock-wallet-controller.js';
 export { PrivateKeyRpcClient } from './private-key-rpc-client.js';
+export { launchRealWallet, resolveRealWalletProfile } from './real-wallet.js';
 export type { AnvilOptions, AnvilSnapshotId, AnvilViemClient, ChainControllerOptions, } from './anvil.js';
 export type { MockWalletControllerOptions, RejectionRule, } from './mock-wallet-controller.js';
 export type { JsonRpcRequest, MockWalletConfig, WalletProviderInfo, } from './types.js';
 export type { PrivateKeyRpcClientOptions } from './private-key-rpc-client.js';
+export type { RealWalletController, RealWalletGasSettings, RealWalletLaunchOptions, RealWalletProfile, RealWalletSession, RealWalletSetup, } from './real-wallet.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2BAA2B,EAC3B,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2BAA2B,EAC3B,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -2,4 +2,5 @@ export { AnvilInstance, ChainController } from './anvil.js';
 export { test, expect } from './fixtures.js';
 export { MockWalletController } from './mock-wallet-controller.js';
 export { PrivateKeyRpcClient } from './private-key-rpc-client.js';
+export { launchRealWallet, resolveRealWalletProfile } from './real-wallet.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/injected-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injected-provider.d.ts","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,eAAO,MAAM,aAAa,+BAAc,CAAC;AACzC,eAAO,MAAM,WAAW,0BAAe,CAAC;AAExC,eAAO,MAAM,2BAA2B,WAAY,gBAAgB,KAAG,MAuItE,CAAC"}
+{"version":3,"file":"injected-provider.d.ts","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,eAAO,MAAM,aAAa,+BAAc,CAAC;AACzC,eAAO,MAAM,WAAW,0BAAe,CAAC;AAExC,eAAO,MAAM,2BAA2B,GAAI,QAAQ,gBAAgB,KAAG,MAuItE,CAAC"}

package/dist/real-wallet-setup.d.ts

@@ -0,0 +1,4 @@
+import type { RealWalletSetup } from './real-wallet.js';
+export declare const DEFAULT_WALLET_PASSWORD = "web3-tester-wallet";
+export declare function passwordForSetup(setup: RealWalletSetup | undefined): string | undefined;
+//# sourceMappingURL=real-wallet-setup.d.ts.map

package/dist/real-wallet-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-wallet-setup.d.ts","sourceRoot":"","sources":["../src/real-wallet-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,sBAElE"}

package/dist/real-wallet-setup.js

@@ -0,0 +1,5 @@
+export const DEFAULT_WALLET_PASSWORD = 'web3-tester-wallet';
+export function passwordForSetup(setup) {
+    return setup?.password ?? (setup?.seedPhrase ? DEFAULT_WALLET_PASSWORD : undefined);
+}
+//# sourceMappingURL=real-wallet-setup.js.map

package/dist/real-wallet-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-wallet-setup.js","sourceRoot":"","sources":["../src/real-wallet-setup.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE5D,MAAM,UAAU,gBAAgB,CAAC,KAAkC;IACjE,OAAO,KAAK,EAAE,QAAQ,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACtF,CAAC"}

package/dist/real-wallet.d.ts

@@ -0,0 +1,59 @@
+import { type BrowserContext } from '@playwright/test';
+export type RealWalletProfile = {
+    profileDirectory?: string;
+    userDataDir: string;
+};
+export type RealWalletSetup = {
+    password?: string;
+    seedPhrase?: string;
+};
+export type RealWalletGasSettings = 'site' | 'low' | 'market' | 'aggressive' | {
+    gasLimit?: number;
+    maxBaseFee: number;
+    priorityFee: number;
+};
+export type RealWalletLaunchOptions = {
+    baseURL?: string;
+    expectedAddress?: string;
+    extensionName?: string;
+    extensionPath: string;
+    headless?: boolean;
+    profileDir: string;
+    setup?: RealWalletSetup;
+    slowMo?: number;
+};
+export type RealWalletController = {
+    approveTokenPermission(options?: {
+        gasSetting?: RealWalletGasSettings;
+        spendLimit?: 'max' | number;
+    }): Promise<void>;
+    confirmSignature(): Promise<void>;
+    confirmTransaction(options?: {
+        gasSetting?: RealWalletGasSettings;
+    }): Promise<void>;
+    connectToDapp(accounts?: string[]): Promise<void>;
+    getAccountAddress(): Promise<string>;
+    rejectSignature(): Promise<void>;
+    rejectTransaction(): Promise<void>;
+};
+export type RealWalletSession = {
+    approveTokenPermission(options?: {
+        gasSetting?: RealWalletGasSettings;
+        spendLimit?: 'max' | number;
+    }): Promise<void>;
+    close(): Promise<void>;
+    confirmSignature(): Promise<void>;
+    confirmTransaction(options?: {
+        gasSetting?: RealWalletGasSettings;
+    }): Promise<void>;
+    connectToDapp(accounts?: string[]): Promise<void>;
+    context: BrowserContext;
+    extensionId: string;
+    getAccountAddress(): Promise<string>;
+    rejectSignature(): Promise<void>;
+    rejectTransaction(): Promise<void>;
+    wallet: RealWalletController;
+};
+export declare function resolveRealWalletProfile(profileDir: string): RealWalletProfile;
+export declare function launchRealWallet(options: RealWalletLaunchOptions): Promise<RealWalletSession>;
+//# sourceMappingURL=real-wallet.d.ts.map

package/dist/real-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-wallet.d.ts","sourceRoot":"","sources":["../src/real-wallet.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAG1F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,YAAY,GACZ;IACE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,sBAAsB,CAAC,OAAO,CAAC,EAAE;QAC/B,UAAU,CAAC,EAAE,qBAAqB,CAAC;QACnC,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,qBAAqB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sBAAsB,CAAC,OAAO,CAAC,EAAE;QAC/B,UAAU,CAAC,EAAE,qBAAqB,CAAC;QACnC,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,qBAAqB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAgBF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAW9E;AAq4BD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgDnG"}

package/dist/real-wallet.js

@@ -0,0 +1,759 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { chromium } from '@playwright/test';
+import { passwordForSetup } from './real-wallet-setup.js';
+const DEFAULT_EXTENSION_NAME = 'MetaMask';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const SHORT_TIMEOUT_MS = 2_000;
+const LOCATOR_PROBE_MS = 250;
+const testId = (id) => `[data-testid="${id}"]`;
+function extensionUrl(extensionId, page = 'home.html') {
+    return `chrome-extension://${extensionId}/${page}`;
+}
+function extensionIdFromUrl(url) {
+    return /^chrome-extension:\/\/([^/]+)\//.exec(url)?.[1];
+}
+export function resolveRealWalletProfile(profileDir) {
+    const resolved = path.resolve(profileDir);
+    const profileDirectory = path.basename(resolved);
+    const userDataDir = path.dirname(resolved);
+    const looksLikeChromeProfile = /^(?:Default|Profile \d+)$/.test(profileDirectory);
+    if (looksLikeChromeProfile && fs.existsSync(path.join(userDataDir, 'Local State'))) {
+        return { profileDirectory, userDataDir };
+    }
+    return { userDataDir: resolved };
+}
+async function isVisible(locator, timeout = SHORT_TIMEOUT_MS) {
+    await locator.first().waitFor({ state: 'visible', timeout });
+    return true;
+}
+async function isHidden(locator, timeout = SHORT_TIMEOUT_MS) {
+    await locator.first().waitFor({ state: 'hidden', timeout });
+    return true;
+}
+function wait(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+async function findVisibleLocator(locators, timeout = SHORT_TIMEOUT_MS, options = {}) {
+    const deadline = Date.now() + timeout;
+    do {
+        const remaining = Math.max(deadline - Date.now(), 1);
+        for (const locator of locators) {
+            const target = locator.first();
+            const probeTimeout = Math.min(LOCATOR_PROBE_MS, remaining);
+            if (!(await isVisible(target, probeTimeout).catch(() => false)))
+                continue;
+            if (options.requireEnabled && !(await target.isEnabled({ timeout: 0 }).catch(() => false)))
+                continue;
+            return target;
+        }
+        const delay = Math.min(LOCATOR_PROBE_MS, Math.max(deadline - Date.now(), 0));
+        if (delay > 0)
+            await wait(delay);
+    } while (Date.now() < deadline);
+    return undefined;
+}
+async function clickFirstVisible(locators, timeout = SHORT_TIMEOUT_MS, options = { requireEnabled: true }) {
+    const target = await findVisibleLocator(locators, timeout, {
+        requireEnabled: options.requireEnabled ?? true,
+    });
+    if (!target)
+        return false;
+    await target.click({ force: options.force, timeout });
+    return true;
+}
+async function fillFirstVisible(locators, value, timeout = DEFAULT_TIMEOUT_MS) {
+    const target = await findVisibleLocator(locators, timeout);
+    if (!target)
+        return false;
+    await target.fill(value);
+    return true;
+}
+async function startSeedPhraseWordGrid(target, firstWord) {
+    await target.fill(firstWord);
+    await wait(250);
+    await target.press('Space');
+}
+function metaMaskOnboardingLocators(page) {
+    return [
+        page.locator(testId('onboarding-import-wallet')),
+        page.locator(testId('onboarding-import-with-srp-button')),
+        page.locator(testId('onboarding-create-wallet')),
+        page.locator(testId('onboarding-terms-checkbox')),
+        page.locator(testId('srp-input-import__srp-note')),
+        page.locator(testId('import-srp-confirm')),
+        page.locator(testId('create-password-new-input')),
+        page.locator(testId('create-password-confirm-input')),
+        page.getByRole('button', { name: 'I have an existing wallet' }),
+        page.getByRole('button', { name: 'Create a new wallet' }),
+        page.getByRole('button', { name: 'Import using Secret Recovery Phrase' }),
+        page.getByRole('heading', { name: 'Import a wallet' }),
+    ];
+}
+async function isMetaMaskOnboardingVisible(page) {
+    return page.url().includes('/home.html#/onboarding') || Boolean(await findVisibleLocator(metaMaskOnboardingLocators(page), SHORT_TIMEOUT_MS));
+}
+function metaMaskSeedPhraseInputLocators(page) {
+    return [
+        page.locator(testId('srp-input-import__srp-note')),
+        page.locator('#first-word-input-text-area'),
+        page.locator('textarea[name="seedPhrase"]'),
+        page.locator('textarea').first(),
+    ];
+}
+function metaMaskSeedPhraseImportLocators(page) {
+    return [
+        ...metaMaskSeedPhraseInputLocators(page),
+        page.getByRole('heading', { name: 'Import a wallet' }),
+    ];
+}
+function metaMaskSeedPhraseWordInputs(page) {
+    return page.locator('.srp-input-import__words-list input, input[id^="import-srp__srp-word-"], input[data-testid^="import-srp__srp-word-"], input[name^="srp-word-"]');
+}
+async function isSeedPhraseConfirmEnabled(page, timeout = SHORT_TIMEOUT_MS) {
+    return Boolean(await findVisibleLocator([page.locator(testId('import-srp-confirm'))], timeout, {
+        requireEnabled: true,
+    }));
+}
+async function fillMetaMaskSeedPhraseWordGrid(page, words, startIndex = 0) {
+    const wordInputs = metaMaskSeedPhraseWordInputs(page);
+    for (let index = startIndex; index < words.length; index += 1) {
+        const input = wordInputs.nth(index);
+        await input.waitFor({ state: 'visible', timeout: DEFAULT_TIMEOUT_MS });
+        await input.fill(words[index]);
+        if (index < words.length - 1) {
+            await input.press('Space');
+            await wait(100);
+        }
+    }
+}
+async function isMetaMaskSeedPhraseImportVisible(page) {
+    return (page.url().includes('/onboarding/import-with-recovery-phrase') ||
+        Boolean(await findVisibleLocator(metaMaskSeedPhraseImportLocators(page), SHORT_TIMEOUT_MS)));
+}
+async function isMetaMaskCreatePasswordVisible(page) {
+    return (page.url().includes('/onboarding/create-password') ||
+        Boolean(await findVisibleLocator([page.locator(testId('create-password-new-input')), page.locator('input[type="password"]').nth(0)], SHORT_TIMEOUT_MS)));
+}
+async function waitForMetaMaskReady(page) {
+    await page.waitForLoadState('domcontentloaded', { timeout: DEFAULT_TIMEOUT_MS }).catch(() => undefined);
+    await isHidden(page.locator('.spinner, .loading-overlay, [data-testid="loading-overlay"]'), DEFAULT_TIMEOUT_MS).catch(() => undefined);
+}
+function metaMaskUnlockPasswordLocators(page) {
+    return [page.locator(testId('unlock-password')), page.locator('input[type="password"]').first()];
+}
+function metaMaskUnlockSubmitLocators(page) {
+    return [page.locator(testId('unlock-submit')), page.getByRole('button', { name: 'Unlock' })];
+}
+async function isMetaMaskUnlockVisible(page) {
+    return Boolean(await findVisibleLocator(metaMaskUnlockPasswordLocators(page), SHORT_TIMEOUT_MS));
+}
+async function closeMetaMaskOverlay(page) {
+    await clickFirstVisible([
+        page.locator(testId('popover-close')),
+        page.locator('.mm-modal-content .mm-modal-header button').first(),
+    ], SHORT_TIMEOUT_MS).catch(() => false);
+}
+function metaMaskAccountMenuLocators(page) {
+    return [
+        page.locator(testId('account-options-menu-button')),
+        page.locator(testId('account-menu-icon')),
+        page.getByRole('button', { name: /Account options|Account menu/i }),
+    ];
+}
+function metaMaskPromptActions(page) {
+    return [
+        page.locator(testId('onboarding-complete-done')),
+        page.locator(testId('metametrics-no-thanks')),
+        page.getByRole('button', { name: 'No thanks' }),
+        page.getByRole('button', { name: 'Done' }),
+        page.getByRole('button', { name: 'Skip' }),
+        page.getByRole('button', { name: 'Continue' }),
+        page.getByRole('button', { name: 'Open wallet' }),
+        page.getByRole('button', { name: 'Maybe later' }),
+        page.getByRole('link', { name: 'Maybe later' }),
+    ];
+}
+function metaMaskTextPromptActions(page) {
+    return [
+        page.getByText('Maybe later', { exact: true }),
+        page.getByText('No thanks', { exact: true }),
+    ];
+}
+async function clickMetaMaskPromptAction(page, timeout = SHORT_TIMEOUT_MS) {
+    return ((await clickFirstVisible(metaMaskPromptActions(page), timeout)) ||
+        (await clickFirstVisible(metaMaskTextPromptActions(page), timeout, { requireEnabled: false })));
+}
+async function waitForMetaMaskHome(page, timeout = DEFAULT_TIMEOUT_MS) {
+    const deadline = Date.now() + timeout;
+    do {
+        await waitForMetaMaskReady(page);
+        if (await findVisibleLocator(metaMaskAccountMenuLocators(page), SHORT_TIMEOUT_MS))
+            return true;
+        if (await clickMetaMaskPromptAction(page, SHORT_TIMEOUT_MS))
+            continue;
+        const delay = Math.min(LOCATOR_PROBE_MS, Math.max(deadline - Date.now(), 0));
+        if (delay > 0)
+            await wait(delay);
+    } while (Date.now() < deadline);
+    return Boolean(await findVisibleLocator(metaMaskAccountMenuLocators(page), SHORT_TIMEOUT_MS));
+}
+async function discoverExtensionIdFromRuntime(context) {
+    const workerId = context.serviceWorkers().map((worker) => extensionIdFromUrl(worker.url())).find(Boolean);
+    if (workerId)
+        return workerId;
+    const pageId = context.pages().map((page) => extensionIdFromUrl(page.url())).find(Boolean);
+    if (pageId)
+        return pageId;
+    const worker = await context.waitForEvent('serviceworker', { timeout: 10_000 }).catch(() => undefined);
+    if (worker) {
+        const extensionId = extensionIdFromUrl(worker.url());
+        if (extensionId)
+            return extensionId;
+    }
+    return undefined;
+}
+async function discoverExtensionIdFromManagementApi(context, extensionName) {
+    const page = await context.newPage();
+    try {
+        await page.goto('chrome://extensions', { waitUntil: 'domcontentloaded' });
+        const extensions = await page.evaluate(() => {
+            const chromeApi = globalThis;
+            return new Promise((resolve, reject) => {
+                if (!chromeApi.chrome?.management?.getAll) {
+                    reject(new Error('chrome.management.getAll is not available on chrome://extensions.'));
+                    return;
+                }
+                chromeApi.chrome.management.getAll((items) => {
+                    const error = chromeApi.chrome?.runtime?.lastError;
+                    if (error)
+                        reject(new Error(error.message ?? 'Unable to enumerate Chrome extensions.'));
+                    else
+                        resolve(items);
+                });
+            });
+        });
+        const exact = extensions.find((extension) => extension.name.toLowerCase() === extensionName.toLowerCase());
+        if (exact)
+            return exact.id;
+        const available = extensions.map((extension) => extension.name).sort().join(', ');
+        throw new Error(`Unable to find extension "${extensionName}". Installed extensions: ${available || 'none'}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+async function getExtensionId(context, extensionName) {
+    return ((await discoverExtensionIdFromRuntime(context)) ??
+        (await discoverExtensionIdFromManagementApi(context, extensionName)));
+}
+async function openExtensionHome(context, extensionId) {
+    const homeUrl = extensionUrl(extensionId);
+    const existing = context.pages().find((page) => page.url().startsWith(homeUrl));
+    const page = existing ?? (await context.newPage());
+    if (page.url() !== homeUrl)
+        await page.goto(homeUrl);
+    await waitForMetaMaskReady(page);
+    return page;
+}
+function notificationUrlPrefix(extensionId) {
+    return extensionUrl(extensionId, 'notification.html');
+}
+function extensionPageUrlPrefix(extensionId) {
+    return `chrome-extension://${extensionId}/`;
+}
+function metaMaskActionContentLocators(page) {
+    return [
+        page.getByRole('heading', {
+            name: /Spending cap request|Transaction request|Signature request|Sign-in request|Permission request/i,
+        }),
+        page.getByText(/Spending cap request|Transaction request|Signature request|Sign-in request|Permission request|This site wants permission/i),
+    ];
+}
+function metaMaskActionControlLocators(page) {
+    return [
+        page.locator(testId('confirm-footer-button')),
+        page.locator(testId('confirmation-submit-button')),
+        page.locator(testId('page-container-footer-next')),
+        page.locator(testId('request-signature__sign')),
+        page.locator(testId('signature-sign-button')),
+        page.locator(testId('custom-spending-cap-input')),
+        page.locator('.set-approval-for-all-warning__footer__approve-button'),
+        page.getByRole('button', { name: /^(Confirm|Connect|Next|Approve|Sign)$/i }),
+    ];
+}
+function metaMaskActionLocators(page) {
+    return [...metaMaskActionContentLocators(page), ...metaMaskActionControlLocators(page)];
+}
+async function findMetaMaskActionPage(context, extensionId) {
+    const extensionPrefix = extensionPageUrlPrefix(extensionId);
+    let controlOnlyPage;
+    for (const page of [...context.pages()].reverse()) {
+        if (page.isClosed() || !page.url().startsWith(extensionPrefix))
+            continue;
+        await page.waitForLoadState('domcontentloaded', { timeout: LOCATOR_PROBE_MS }).catch(() => undefined);
+        if (await findVisibleLocator(metaMaskActionContentLocators(page), LOCATOR_PROBE_MS, { requireEnabled: false })) {
+            return page;
+        }
+        if (!controlOnlyPage &&
+            (await findVisibleLocator(metaMaskActionControlLocators(page), LOCATOR_PROBE_MS, { requireEnabled: false }))) {
+            controlOnlyPage = page;
+        }
+    }
+    return controlOnlyPage;
+}
+async function findMetaMaskLockedPage(context, extensionId) {
+    const extensionPrefix = extensionPageUrlPrefix(extensionId);
+    for (const page of [...context.pages()].reverse()) {
+        if (page.isClosed() || !page.url().startsWith(extensionPrefix))
+            continue;
+        await page.waitForLoadState('domcontentloaded', { timeout: LOCATOR_PROBE_MS }).catch(() => undefined);
+        if (await isMetaMaskUnlockVisible(page))
+            return page;
+    }
+    return undefined;
+}
+function findMetaMaskNotificationPage(context, extensionId) {
+    const notificationPrefix = notificationUrlPrefix(extensionId);
+    return [...context.pages()]
+        .reverse()
+        .find((page) => !page.isClosed() && page.url().startsWith(notificationPrefix));
+}
+async function getNotificationPage(context, extensionId, timeout = DEFAULT_TIMEOUT_MS) {
+    const prefix = notificationUrlPrefix(extensionId);
+    const extensionPrefix = extensionPageUrlPrefix(extensionId);
+    const startedAt = Date.now();
+    let page = await findMetaMaskActionPage(context, extensionId);
+    let notificationPage = findMetaMaskNotificationPage(context, extensionId);
+    while (!page && Date.now() - startedAt < timeout) {
+        const remaining = Math.max(timeout - (Date.now() - startedAt), 1_000);
+        const candidate = await context.waitForEvent('page', { timeout: Math.min(remaining, 1_000) }).catch(() => undefined);
+        if (candidate) {
+            await candidate
+                .waitForURL((url) => url.href.startsWith(prefix) || url.href.startsWith(extensionPrefix), {
+                timeout: Math.min(remaining, 5_000),
+            })
+                .catch(() => undefined);
+        }
+        page = await findMetaMaskActionPage(context, extensionId);
+        notificationPage = findMetaMaskNotificationPage(context, extensionId) ?? notificationPage;
+    }
+    page ??= notificationPage;
+    if (!page)
+        throw new Error('Timed out waiting for MetaMask notification window.');
+    await waitForMetaMaskReady(page);
+    await page.bringToFront().catch(() => undefined);
+    return page;
+}
+function shortAddress(address) {
+    return `${address.slice(0, 6)}...${address.slice(-4)}`.toLowerCase();
+}
+async function pageContainsAddress(page, address) {
+    const normalizedAddress = address.toLowerCase();
+    const text = ((await page.locator('body').textContent({ timeout: SHORT_TIMEOUT_MS }).catch(() => '')) ?? '')
+        .replace(/\s+/g, '')
+        .toLowerCase();
+    return (text.includes(normalizedAddress) ||
+        (text.includes(normalizedAddress.slice(0, 6)) && text.includes(normalizedAddress.slice(-4))) ||
+        (text.includes(normalizedAddress.slice(0, 7)) && text.includes(normalizedAddress.slice(-5))));
+}
+async function fillSeedPhrase(page, seedPhrase) {
+    const words = seedPhrase.trim().split(/\s+/);
+    if (words.length < 12) {
+        throw new Error('setup.seedPhrase must contain at least 12 words.');
+    }
+    const singleInput = await findVisibleLocator(metaMaskSeedPhraseInputLocators(page), DEFAULT_TIMEOUT_MS);
+    if (singleInput) {
+        await startSeedPhraseWordGrid(singleInput, words[0]);
+        await fillMetaMaskSeedPhraseWordGrid(page, words, 1);
+        if (await isSeedPhraseConfirmEnabled(page)) {
+            return;
+        }
+    }
+    const wordInputs = metaMaskSeedPhraseWordInputs(page);
+    if ((await wordInputs.count()) >= words.length) {
+        await fillMetaMaskSeedPhraseWordGrid(page, words);
+        if (await isSeedPhraseConfirmEnabled(page))
+            return;
+    }
+    const textboxes = page.getByRole('textbox');
+    if ((await textboxes.count()) >= words.length) {
+        for (const [index, word] of words.entries()) {
+            await textboxes.nth(index).fill(word);
+        }
+        return;
+    }
+    throw new Error('Unable to find MetaMask seed phrase input fields.');
+}
+async function importMetaMaskWallet(page, setup) {
+    const password = passwordForSetup(setup);
+    if (!password || !setup.seedPhrase) {
+        throw new Error('MetaMask is on onboarding. Provide setup.seedPhrase to import a wallet through web3-tester, or use a preconfigured persistent profile.');
+    }
+    await page.bringToFront().catch(() => undefined);
+    const terms = page.locator(testId('onboarding-terms-checkbox'));
+    if (await isVisible(terms, SHORT_TIMEOUT_MS).catch(() => false)) {
+        await terms.check();
+    }
+    if (!(await isMetaMaskSeedPhraseImportVisible(page)) && !(await isMetaMaskCreatePasswordVisible(page))) {
+        const importStarted = await clickFirstVisible([
+            page.locator(testId('onboarding-import-wallet')),
+            page.locator(testId('onboarding-import-with-srp-button')),
+            page.getByRole('button', { name: 'I have an existing wallet' }),
+            page.getByRole('button', { name: 'Import an existing wallet' }),
+            page.getByRole('button', { name: 'Import wallet' }),
+        ], DEFAULT_TIMEOUT_MS);
+        if (!importStarted)
+            throw new Error('Unable to start MetaMask wallet import flow.');
+        await waitForMetaMaskReady(page);
+        await clickFirstVisible([
+            page.locator(testId('onboarding-import-with-srp-button')),
+            page.getByRole('button', { name: 'Import using Secret Recovery Phrase' }),
+        ], 5_000);
+        await clickFirstVisible([
+            page.locator(testId('metametrics-no-thanks')),
+            page.locator(testId('metametrics-i-agree')),
+            page.getByRole('button', { name: 'No thanks' }),
+            page.getByRole('button', { name: 'I agree' }),
+        ], SHORT_TIMEOUT_MS);
+    }
+    if (!(await isMetaMaskCreatePasswordVisible(page))) {
+        await fillSeedPhrase(page, setup.seedPhrase);
+        const seedConfirmed = await clickFirstVisible([
+            page.locator(testId('import-srp-confirm')),
+            page.getByRole('button', { name: 'Confirm Secret Recovery Phrase' }),
+            page.getByRole('button', { name: 'Confirm' }),
+        ], DEFAULT_TIMEOUT_MS);
+        if (!seedConfirmed)
+            throw new Error('Unable to confirm MetaMask seed phrase import.');
+    }
+    const passwordFilled = await fillFirstVisible([page.locator(testId('create-password-new-input')), page.locator('input[type="password"]').nth(0)], password);
+    if (!passwordFilled)
+        throw new Error('Unable to find MetaMask password input.');
+    const confirmationPasswordFilled = await fillFirstVisible([page.locator(testId('create-password-confirm-input')), page.locator('input[type="password"]').nth(1)], password);
+    if (!confirmationPasswordFilled)
+        throw new Error('Unable to find MetaMask password confirmation input.');
+    const passwordTerms = page.locator(testId('create-password-terms'));
+    if (await isVisible(passwordTerms, SHORT_TIMEOUT_MS).catch(() => false)) {
+        await passwordTerms.check();
+    }
+    const passwordSubmitted = await clickFirstVisible([page.locator(testId('create-password-submit')), page.getByRole('button', { name: 'Import my wallet' })], DEFAULT_TIMEOUT_MS);
+    if (!passwordSubmitted)
+        throw new Error('Unable to submit MetaMask import password.');
+    await finishMetaMaskOnboarding(page);
+}
+async function unlockMetaMask(page, password) {
+    const passwordFilled = await fillFirstVisible(metaMaskUnlockPasswordLocators(page), password, DEFAULT_TIMEOUT_MS);
+    if (!passwordFilled)
+        throw new Error('Unable to find MetaMask unlock password input.');
+    const unlocked = await clickFirstVisible(metaMaskUnlockSubmitLocators(page), DEFAULT_TIMEOUT_MS);
+    if (!unlocked)
+        throw new Error('Unable to submit MetaMask unlock form.');
+    await waitForMetaMaskReady(page);
+}
+async function unlockMetaMaskIfNeeded(page, password) {
+    if (!(await isMetaMaskUnlockVisible(page)))
+        return false;
+    if (!password) {
+        throw new Error('MetaMask profile is locked. Provide setup.password to unlock through web3-tester, or unlock the persistent profile before running.');
+    }
+    await page.bringToFront().catch(() => undefined);
+    await unlockMetaMask(page, password);
+    return true;
+}
+async function finishMetaMaskOnboarding(page) {
+    for (let attempt = 0; attempt < 6; attempt += 1) {
+        await waitForMetaMaskReady(page);
+        const actions = [...metaMaskPromptActions(page), ...metaMaskTextPromptActions(page)];
+        const onSetupScreen = page.url().includes('/home.html#/onboarding') ||
+            Boolean(await findVisibleLocator(actions, SHORT_TIMEOUT_MS));
+        if (!onSetupScreen)
+            return;
+        const advanced = await clickMetaMaskPromptAction(page, 5_000);
+        if (!advanced)
+            break;
+    }
+    if (await waitForMetaMaskHome(page, 10_000))
+        return;
+    if (page.url().includes('/home.html#/onboarding') ||
+        (await findVisibleLocator([...metaMaskPromptActions(page), ...metaMaskTextPromptActions(page)], SHORT_TIMEOUT_MS))) {
+        throw new Error('MetaMask wallet import did not complete onboarding.');
+    }
+}
+class MetaMaskRealWallet {
+    context;
+    homePage;
+    extensionId;
+    expectedAddress;
+    walletPassword;
+    constructor(context, homePage, extensionId, expectedAddress, walletPassword) {
+        this.context = context;
+        this.homePage = homePage;
+        this.extensionId = extensionId;
+        this.expectedAddress = expectedAddress;
+        this.walletPassword = walletPassword;
+    }
+    async approveTokenPermission(options) {
+        const page = await this.notificationPage();
+        if (options?.spendLimit === 'max') {
+            await clickFirstVisible([page.locator(testId('custom-spending-cap-max-button'))], SHORT_TIMEOUT_MS);
+        }
+        else if (typeof options?.spendLimit === 'number') {
+            await fillFirstVisible([page.locator(testId('custom-spending-cap-input'))], String(options.spendLimit), SHORT_TIMEOUT_MS);
+        }
+        await this.confirmFooterAction(page);
+        if (!page.isClosed()) {
+            await waitForMetaMaskReady(page);
+            await this.applyGasSetting(page, options?.gasSetting);
+            await this.confirmFooterAction(page, SHORT_TIMEOUT_MS).catch(() => undefined);
+        }
+    }
+    async confirmSignature() {
+        const page = await this.notificationPage();
+        const structuredSignButton = page.locator(testId('signature-sign-button')).first();
+        const scrollButton = page.locator(testId('signature-request-scroll-button')).first();
+        for (let attempts = 0; attempts < 8; attempts += 1) {
+            if (!(await isVisible(scrollButton, SHORT_TIMEOUT_MS).catch(() => false)))
+                break;
+            if (await structuredSignButton.isEnabled().catch(() => false))
+                break;
+            await scrollButton.click();
+        }
+        const signed = await clickFirstVisible([
+            page.locator(testId('confirm-footer-button')),
+            page.locator(testId('confirmation-submit-button')),
+            page.locator(testId('request-signature__sign')),
+            structuredSignButton,
+            page.locator(testId('page-container-footer-next')),
+            page.getByRole('button', { name: 'Confirm' }),
+            page.getByRole('button', { name: 'Sign' }),
+        ], DEFAULT_TIMEOUT_MS);
+        if (!signed)
+            throw new Error('Unable to confirm MetaMask signature request.');
+        await clickFirstVisible([page.locator(testId('signature-warning-sign-button'))], SHORT_TIMEOUT_MS);
+    }
+    async confirmTransaction(options) {
+        let page = await this.notificationPage();
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            await this.applyGasSetting(page, options?.gasSetting);
+            await clickFirstVisible([page.locator('.set-approval-for-all-warning__footer__approve-button')], SHORT_TIMEOUT_MS);
+            await this.confirmFooterAction(page);
+            await wait(1_000);
+            const nextPage = await findMetaMaskActionPage(this.context, this.extensionId);
+            if (!nextPage)
+                return;
+            page = nextPage;
+            await waitForMetaMaskReady(page);
+            await page.bringToFront().catch(() => undefined);
+        }
+        throw new Error('MetaMask transaction confirmation did not settle after multiple confirmation steps.');
+    }
+    async connectToDapp(accounts) {
+        const page = await this.notificationPage();
+        await this.selectAccounts(page, accounts);
+        await this.confirmFooterAction(page);
+        if (!page.isClosed()) {
+            await waitForMetaMaskReady(page);
+            await this.confirmFooterAction(page, SHORT_TIMEOUT_MS).catch(() => undefined);
+        }
+    }
+    async getAccountAddress() {
+        const page = await this.home();
+        await waitForMetaMaskHome(page);
+        await closeMetaMaskOverlay(page);
+        if (this.expectedAddress && await pageContainsAddress(page, this.expectedAddress)) {
+            return this.expectedAddress;
+        }
+        const openedMenu = await clickFirstVisible(metaMaskAccountMenuLocators(page), DEFAULT_TIMEOUT_MS);
+        if (!openedMenu)
+            throw new Error('Unable to open MetaMask account options menu.');
+        const openedDetails = await clickFirstVisible([page.locator(testId('account-list-menu-details'))], DEFAULT_TIMEOUT_MS);
+        if (!openedDetails)
+            throw new Error('Unable to open MetaMask account details.');
+        const addressText = page.locator(testId('address-copy-button-text')).first();
+        await addressText.waitFor({ state: 'visible', timeout: DEFAULT_TIMEOUT_MS });
+        const address = (await addressText.textContent())?.trim();
+        await closeMetaMaskOverlay(page);
+        if (!address?.startsWith('0x'))
+            throw new Error('Unable to read selected MetaMask account address.');
+        return address;
+    }
+    async rejectSignature() {
+        const page = await this.notificationPage();
+        await this.rejectFooterAction(page, [
+            page.locator(testId('signature-cancel-button')),
+            page.locator('.request-signature__footer button.btn-secondary'),
+        ]);
+    }
+    async rejectTransaction() {
+        const page = await this.notificationPage();
+        await this.rejectFooterAction(page);
+    }
+    async home() {
+        const page = await openExtensionHome(this.context, this.extensionId);
+        await unlockMetaMaskIfNeeded(page, this.walletPassword);
+        return page;
+    }
+    async notificationPage() {
+        await this.unlockVisibleMetaMask();
+        let page = await getNotificationPage(this.context, this.extensionId).catch(async (error) => {
+            if (await this.unlockVisibleMetaMask()) {
+                return getNotificationPage(this.context, this.extensionId);
+            }
+            throw error;
+        });
+        if (await unlockMetaMaskIfNeeded(page, this.walletPassword)) {
+            page = await getNotificationPage(this.context, this.extensionId);
+        }
+        return page;
+    }
+    async unlockVisibleMetaMask() {
+        const page = await findMetaMaskLockedPage(this.context, this.extensionId);
+        if (!page)
+            return false;
+        return unlockMetaMaskIfNeeded(page, this.walletPassword);
+    }
+    async confirmFooterAction(page, timeout = DEFAULT_TIMEOUT_MS) {
+        const confirmed = await clickFirstVisible([
+            page.locator(testId('confirm-footer-button')),
+            page.locator(testId('confirmation-submit-button')),
+            page.locator(testId('page-container-footer-next')),
+            page.getByRole('button', { name: 'Confirm' }),
+            page.getByRole('button', { name: 'Connect' }),
+            page.getByRole('button', { name: 'Next' }),
+            page.getByRole('button', { name: 'Approve' }),
+        ], timeout);
+        if (!confirmed)
+            throw new Error('Unable to confirm MetaMask notification.');
+    }
+    async rejectFooterAction(page, extraLocators = []) {
+        const rejected = await clickFirstVisible([
+            ...extraLocators,
+            page.locator(testId('confirm-footer-cancel-button')),
+            page.locator(testId('page-container-footer-cancel')),
+            page.getByRole('button', { name: 'Reject' }),
+            page.getByRole('button', { name: 'Cancel' }),
+        ], DEFAULT_TIMEOUT_MS);
+        if (!rejected)
+            throw new Error('Unable to reject MetaMask notification.');
+    }
+    async selectAccounts(page, accounts) {
+        if (!accounts?.length)
+            return;
+        const rows = page.locator('.choose-account-list .choose-account-list__account');
+        const rowCount = await rows.count();
+        if (!rowCount)
+            return;
+        const expected = accounts.map((account) => account.toLowerCase());
+        const expectedShort = accounts.map(shortAddress);
+        for (let index = 0; index < rowCount; index += 1) {
+            const row = rows.nth(index);
+            const text = ((await row.textContent()) ?? '').toLowerCase();
+            const matches = expected.some((account) => text.includes(account)) || expectedShort.some((account) => text.includes(account));
+            if (!matches)
+                continue;
+            const checkbox = row.locator('input[type="checkbox"]').first();
+            if (await isVisible(checkbox, SHORT_TIMEOUT_MS).catch(() => false))
+                await checkbox.check();
+            else
+                await row.click();
+            return;
+        }
+        if (rowCount > 1) {
+            throw new Error(`Unable to find requested MetaMask account in connect prompt: ${accounts.join(', ')}.`);
+        }
+    }
+    async applyGasSetting(page, gasSetting) {
+        if (!gasSetting || gasSetting === 'site')
+            return;
+        const editOpened = await clickFirstVisible([page.locator(testId('edit-gas-fee-icon')), page.getByRole('button', { name: 'Edit gas fee' })], SHORT_TIMEOUT_MS);
+        if (!editOpened)
+            throw new Error('Unable to open MetaMask gas fee editor.');
+        if (typeof gasSetting === 'string') {
+            const testIdBySetting = {
+                aggressive: 'edit-gas-fee-item-high',
+                low: 'edit-gas-fee-item-low',
+                market: 'edit-gas-fee-item-medium',
+            };
+            const selected = await clickFirstVisible([page.locator(testId(testIdBySetting[gasSetting]))], DEFAULT_TIMEOUT_MS);
+            if (!selected)
+                throw new Error(`Unable to select MetaMask ${gasSetting} gas setting.`);
+        }
+        else {
+            const customOpened = await clickFirstVisible([page.locator(testId('edit-gas-fee-item-custom'))], DEFAULT_TIMEOUT_MS);
+            if (!customOpened)
+                throw new Error('Unable to open MetaMask custom gas editor.');
+            const baseFeeFilled = await fillFirstVisible([page.locator(testId('base-fee-input'))], String(gasSetting.maxBaseFee));
+            if (!baseFeeFilled)
+                throw new Error('Unable to fill MetaMask custom base fee.');
+            const priorityFeeFilled = await fillFirstVisible([page.locator(testId('priority-fee-input'))], String(gasSetting.priorityFee));
+            if (!priorityFeeFilled)
+                throw new Error('Unable to fill MetaMask custom priority fee.');
+            if (gasSetting.gasLimit !== undefined) {
+                const gasLimitFilled = await fillFirstVisible([page.locator(testId('gas-limit-input'))], String(gasSetting.gasLimit));
+                if (!gasLimitFilled)
+                    throw new Error('Unable to fill MetaMask custom gas limit.');
+            }
+        }
+        const saved = await clickFirstVisible([page.locator('.popover-footer button.btn-primary'), page.getByRole('button', { name: 'Save' })], DEFAULT_TIMEOUT_MS);
+        if (!saved)
+            throw new Error('Unable to save MetaMask gas setting.');
+    }
+}
+async function prepareMetaMask({ expectedAddress, page, setup, wallet, }) {
+    if (await isMetaMaskOnboardingVisible(page)) {
+        if (!setup?.seedPhrase) {
+            throw new Error('MetaMask is on onboarding. Provide setup.seedPhrase to import a wallet through web3-tester, or use a preconfigured persistent profile.');
+        }
+        await importMetaMaskWallet(page, setup);
+    }
+    await unlockMetaMaskIfNeeded(page, passwordForSetup(setup));
+    if (!expectedAddress)
+        return;
+    const address = await wallet.getAccountAddress();
+    if (address.toLowerCase() !== expectedAddress.toLowerCase()) {
+        throw new Error(`MetaMask account ${address} does not match expected address ${expectedAddress}.`);
+    }
+}
+export async function launchRealWallet(options) {
+    const extensionName = options.extensionName ?? DEFAULT_EXTENSION_NAME;
+    if (!fs.existsSync(options.extensionPath)) {
+        throw new Error(`MetaMask extension path does not exist: ${options.extensionPath}`);
+    }
+    const profile = resolveRealWalletProfile(options.profileDir);
+    const context = await chromium.launchPersistentContext(profile.userDataDir, {
+        args: [
+            ...(profile.profileDirectory ? [`--profile-directory=${profile.profileDirectory}`] : []),
+            `--disable-extensions-except=${options.extensionPath}`,
+            `--load-extension=${options.extensionPath}`,
+        ],
+        baseURL: options.baseURL,
+        headless: options.headless ?? false,
+        slowMo: options.slowMo,
+    });
+    const extensionId = await getExtensionId(context, extensionName);
+    const page = await openExtensionHome(context, extensionId);
+    const wallet = new MetaMaskRealWallet(context, page, extensionId, options.expectedAddress, passwordForSetup(options.setup));
+    await prepareMetaMask({
+        expectedAddress: options.expectedAddress,
+        page,
+        setup: options.setup,
+        wallet,
+    });
+    return {
+        approveTokenPermission: (approvalOptions) => wallet.approveTokenPermission(approvalOptions),
+        close: () => context.close(),
+        confirmSignature: () => wallet.confirmSignature(),
+        confirmTransaction: (confirmationOptions) => wallet.confirmTransaction(confirmationOptions),
+        connectToDapp: (accounts) => wallet.connectToDapp(accounts),
+        context,
+        extensionId,
+        getAccountAddress: () => wallet.getAccountAddress(),
+        rejectSignature: () => wallet.rejectSignature(),
+        rejectTransaction: () => wallet.rejectTransaction(),
+        wallet,
+    };
+}
+//# sourceMappingURL=real-wallet.js.map

package/dist/real-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-wallet.js","sourceRoot":"","sources":["../src/real-wallet.ts"],"names":[],"mappings":"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"}

package/docs/API.md

@@ -1,9 +1,10 @@
 # API Reference
 
-This package exposes two Playwright fixture families:
+This package exposes two Playwright fixture families and one real-wallet adapter:
 
 - `fixtures`: local deterministic Anvil tests.
 - `live-fixtures`: live Sepolia tests that sign with a runtime-only private key.
+- `real-wallet`: persistent Chromium and MetaMask automation for fully in-UI Web3 tests.
 
 ## Local Fixtures
 
@@ -48,6 +49,53 @@ Optional:
 SEPOLIA_RPC_URL=https://...
 ```
 
+## Real Wallet
+
+```ts
+import { launchRealWallet } from '@marigoldlabs/web3-tester/real-wallet';
+
+const session = await launchRealWallet({
+  extensionPath: process.env.FJORD_REAL_WALLET_EXTENSION_PATH as string,
+  profileDir: process.env.FJORD_REAL_WALLET_PROFILE_DIR as string,
+  expectedAddress: process.env.FJORD_REAL_WALLET_ADDRESS,
+  setup: process.env.FJORD_REAL_WALLET_PASSWORD || process.env.FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE
+    ? {
+        password: process.env.FJORD_REAL_WALLET_PASSWORD,
+        seedPhrase: process.env.FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE,
+      }
+    : undefined,
+});
+```
+
+`launchRealWallet` starts a persistent Chromium context with the configured unpacked MetaMask extension. `profileDir` can be either a dedicated Playwright user data directory or a Chrome profile directory such as `Default` or `Profile 1`; Chrome profile paths are mapped back to their user data root and launched with `--profile-directory`.
+
+Options:
+
+| Option | Description |
+| --- | --- |
+| `extensionPath` | Required path to the unpacked MetaMask extension. |
+| `profileDir` | Required persistent Chromium user data directory, or a Chrome profile directory. |
+| `baseURL` | Optional Playwright base URL for pages opened from the returned context. |
+| `expectedAddress` | Optional account address assertion after unlock/import. |
+| `extensionName` | Extension name used to resolve the extension ID. Defaults to `MetaMask`. |
+| `headless` | Chromium headless setting. Defaults to `false` because extensions require headed Chromium in normal use. |
+| `setup.password` | Optional password used to unlock MetaMask, or to import a seed phrase when onboarding is visible. |
+| `setup.seedPhrase` | Seed phrase used if MetaMask opens on onboarding. When no password is supplied, web3-tester imports with a deterministic test profile password. |
+| `slowMo` | Optional Playwright slow-motion delay. |
+
+Returned session methods:
+
+| Method | Description |
+| --- | --- |
+| `connectToDapp(accounts?)` | Approves a dapp connection request in MetaMask. |
+| `confirmSignature()` | Confirms a pending signature request. |
+| `confirmTransaction(options?)` | Confirms a pending transaction request. |
+| `approveTokenPermission(options?)` | Approves a pending ERC-20 spending permission request. |
+| `rejectSignature()` | Rejects a pending signature request. |
+| `rejectTransaction()` | Rejects a pending transaction request. |
+| `getAccountAddress()` | Returns the selected MetaMask account. |
+| `close()` | Closes the persistent browser context. |
+
 ## MockWalletController
 
 ```ts

package/docs/CONSUMING_FROM_FJORD.md

@@ -1,17 +1,17 @@
 # Consuming Web3 Tester From Fjord V4
 
-This guide covers adding this repo to Fjord v4 as a dependency.
+This guide covers adding the published package to Fjord v4 as a dependency.
 
 ## Install
 
 ```bash
-npm install --save-dev github:AndyMarigoldLabs/web3-tester
+npm install --save-dev @marigoldlabs/web3-tester
 ```
 
-For a pinned dependency, use a commit SHA:
+For a pinned dependency, use an exact package version:
 
 ```bash
-npm install --save-dev github:AndyMarigoldLabs/web3-tester#<commit-sha>
+npm install --save-dev @marigoldlabs/web3-tester@<version>
 ```
 
 ## Playwright Config
@@ -120,4 +120,4 @@ Keep destructive or expensive tests behind separate flags so normal CI remains r
 - Run live Sepolia read-only tests on a scheduled job or protected branch.
 - Run live mutation tests manually with approval.
 - Store `FJORD_PRIVATE_KEY` and `SEPOLIA_RPC_URL` only as CI secrets.
-- Pin this repo by commit SHA once Fjord depends on it.
+- Pin the npm dependency to an exact version once Fjord depends on it.

package/docs/RELEASE_CHECKLIST.md

@@ -1,6 +1,6 @@
 # Release Checklist
 
-Use this before pushing a new version or pinning it inside Fjord v4.
+Use this before publishing a new version or pinning it inside Fjord v4.
 
 ## Required
 
@@ -16,7 +16,7 @@ Use this before pushing a new version or pinning it inside Fjord v4.
 From a clean consumer repo:
 
 ```bash
-npm install --save-dev github:AndyMarigoldLabs/web3-tester#<commit-sha>
+npm install --save-dev @marigoldlabs/web3-tester@<version>
 ```
 
 Then import:
@@ -47,3 +47,9 @@ git add .
 git commit -m "Document and package Web3 tester"
 git push -u origin main
 ```
+
+## Publish
+
+```bash
+npm publish --access public
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marigoldlabs/web3-tester",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
   "description": "A Playwright, Anvil, and Viem based Web3 E2E harness with an injected programmable wallet provider.",
@@ -39,6 +39,10 @@
     "./private-key-rpc-client": {
       "types": "./dist/private-key-rpc-client.d.ts",
       "import": "./dist/private-key-rpc-client.js"
+    },
+    "./real-wallet": {
+      "types": "./dist/real-wallet.d.ts",
+      "import": "./dist/real-wallet.js"
     }
   },
   "files": [
@@ -56,15 +60,14 @@
     "typecheck": "tsc --noEmit",
     "verify": "npm run typecheck && npm run build && npm test"
   },
-  "dependencies": {
-    "viem": "^2.39.3"
-  },
   "peerDependencies": {
-    "@playwright/test": ">=1.56.0"
+    "@playwright/test": ">=1.56.0",
+    "viem": ">=2.39.3 <3"
   },
   "devDependencies": {
     "@playwright/test": "^1.56.1",
     "@types/node": "^24.10.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "viem": "^2.52.0"
   }
 }