@marigoldlabs/web3-tester 0.1.0 → 0.1.1

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
+    ? {
+        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 or import the profile. |
+| `FJORD_REAL_WALLET_SECRET_RECOVERY_PHRASE` | unset | Optional seed phrase used only 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.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;AAE1F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,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;AAeF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAW9E;AAqkBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0CnG"}

package/dist/real-wallet.js

@@ -0,0 +1,494 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { chromium } from '@playwright/test';
+const DEFAULT_EXTENSION_NAME = 'MetaMask';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const SHORT_TIMEOUT_MS = 2_000;
+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;
+}
+async function clickFirstVisible(locators, timeout = SHORT_TIMEOUT_MS) {
+    for (const locator of locators) {
+        const target = locator.first();
+        if (!(await isVisible(target, timeout).catch(() => false)))
+            continue;
+        await target.click();
+        return true;
+    }
+    return false;
+}
+async function fillFirstVisible(locators, value, timeout = DEFAULT_TIMEOUT_MS) {
+    for (const locator of locators) {
+        const target = locator.first();
+        if (!(await isVisible(target, timeout).catch(() => false)))
+            continue;
+        await target.fill(value);
+        return true;
+    }
+    return false;
+}
+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);
+}
+async function closeMetaMaskOverlay(page) {
+    await clickFirstVisible([
+        page.locator(testId('popover-close')),
+        page.locator('.mm-modal-content .mm-modal-header button').first(),
+        page.getByRole('button', { name: 'Close' }),
+    ], 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().startsWith(homeUrl))
+        await page.goto(homeUrl);
+    await waitForMetaMaskReady(page);
+    return page;
+}
+function notificationUrlPrefix(extensionId) {
+    return extensionUrl(extensionId, 'notification.html');
+}
+async function getNotificationPage(context, extensionId, timeout = DEFAULT_TIMEOUT_MS) {
+    const prefix = notificationUrlPrefix(extensionId);
+    const startedAt = Date.now();
+    let page = context.pages().find((candidate) => candidate.url().startsWith(prefix));
+    while (!page && Date.now() - startedAt < timeout) {
+        const pendingPages = context.pages().filter((candidate) => !candidate.isClosed());
+        for (const pendingPage of pendingPages) {
+            await pendingPage
+                .waitForURL((url) => url.href.startsWith(prefix), { timeout: 250 })
+                .catch(() => undefined);
+            if (pendingPage.url().startsWith(prefix)) {
+                page = pendingPage;
+                break;
+            }
+        }
+        if (page)
+            break;
+        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) {
+            page = context.pages().find((openPage) => openPage.url().startsWith(prefix));
+            continue;
+        }
+        await candidate
+            .waitForURL((url) => url.href.startsWith(prefix), { timeout: Math.min(remaining, 5_000) })
+            .catch(() => undefined);
+        if (candidate.url().startsWith(prefix))
+            page = candidate;
+    }
+    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 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 singleInputFilled = await fillFirstVisible([
+        page.locator(testId('srp-input-import__srp-note')),
+        page.locator('textarea[name="seedPhrase"]'),
+        page.locator('textarea').first(),
+    ], words.join(' '), SHORT_TIMEOUT_MS);
+    if (singleInputFilled)
+        return;
+    const wordInputs = page.locator('input[id^="import-srp__srp-word-"], input[data-testid^="import-srp__srp-word-"]');
+    if ((await wordInputs.count()) >= words.length) {
+        for (const [index, word] of words.entries()) {
+            await wordInputs.nth(index).fill(word);
+        }
+        return;
+    }
+    throw new Error('Unable to find MetaMask seed phrase input fields.');
+}
+async function importMetaMaskWallet(page, setup) {
+    if (!setup.password || !setup.seedPhrase) {
+        throw new Error('MetaMask is on onboarding. Provide setup.password and 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();
+    }
+    const importStarted = await clickFirstVisible([
+        page.locator(testId('onboarding-import-wallet')),
+        page.locator(testId('onboarding-import-with-srp-button')),
+        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 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);
+    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)], setup.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)], setup.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 clickFirstVisible([
+        page.locator(testId('onboarding-complete-done')),
+        page.getByRole('button', { name: 'Done' }),
+        page.getByRole('button', { name: 'Skip' }),
+    ], DEFAULT_TIMEOUT_MS);
+    await waitForMetaMaskReady(page);
+}
+async function unlockMetaMask(page, password) {
+    const passwordFilled = await fillFirstVisible([page.locator(testId('unlock-password')), page.locator('input[type="password"]').first()], password, DEFAULT_TIMEOUT_MS);
+    if (!passwordFilled)
+        throw new Error('Unable to find MetaMask unlock password input.');
+    const unlocked = await clickFirstVisible([page.locator(testId('unlock-submit')), page.getByRole('button', { name: 'Unlock' })], DEFAULT_TIMEOUT_MS);
+    if (!unlocked)
+        throw new Error('Unable to submit MetaMask unlock form.');
+    await waitForMetaMaskReady(page);
+}
+class MetaMaskRealWallet {
+    context;
+    homePage;
+    extensionId;
+    constructor(context, homePage, extensionId) {
+        this.context = context;
+        this.homePage = homePage;
+        this.extensionId = extensionId;
+    }
+    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('request-signature__sign')),
+            structuredSignButton,
+            page.locator(testId('page-container-footer-next')),
+            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) {
+        const page = await this.notificationPage();
+        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);
+    }
+    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 closeMetaMaskOverlay(page);
+        const openedMenu = await clickFirstVisible([page.locator(testId('account-options-menu-button'))], 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() {
+        if (!this.homePage.isClosed()) {
+            await this.homePage.bringToFront().catch(() => undefined);
+            await waitForMetaMaskReady(this.homePage);
+            return this.homePage;
+        }
+        return openExtensionHome(this.context, this.extensionId);
+    }
+    async notificationPage() {
+        return getNotificationPage(this.context, this.extensionId);
+    }
+    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, }) {
+    const onboardingImport = page.locator(testId('onboarding-import-wallet'));
+    const onboardingCreate = page.locator(testId('onboarding-create-wallet'));
+    const onboardingTerms = page.locator(testId('onboarding-terms-checkbox'));
+    if ((await isVisible(onboardingImport, SHORT_TIMEOUT_MS).catch(() => false)) ||
+        (await isVisible(onboardingCreate, SHORT_TIMEOUT_MS).catch(() => false)) ||
+        (await isVisible(onboardingTerms, SHORT_TIMEOUT_MS).catch(() => false))) {
+        if (!setup?.password || !setup.seedPhrase) {
+            throw new Error('MetaMask is on onboarding. Provide setup.password and setup.seedPhrase to import a wallet through web3-tester, or use a preconfigured persistent profile.');
+        }
+        await importMetaMaskWallet(page, setup);
+    }
+    const unlockPassword = page.locator(testId('unlock-password'));
+    if (await isVisible(unlockPassword, SHORT_TIMEOUT_MS).catch(() => false)) {
+        if (!setup?.password) {
+            throw new Error('MetaMask profile is locked. Provide setup.password to unlock through web3-tester, or unlock the persistent profile before running.');
+        }
+        await unlockMetaMask(page, setup.password);
+    }
+    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);
+    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
+    ? {
+        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` | Password used to unlock MetaMask, or to import a seed phrase when onboarding is visible. |
+| `setup.seedPhrase` | Seed phrase used only if MetaMask opens on onboarding. |
+| `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/examples/live-sepolia.spec.ts

@@ -1,4 +1,4 @@
-import { expect, test } from '@marigoldlabs/web3-tester/live-fixtures';
+import { expect, test } from '@andy-marigold-labs/web3-tester/live-fixtures';
 
 test.skip(!process.env.FJORD_PRIVATE_KEY, 'FJORD_PRIVATE_KEY is required for live Sepolia tests.');
 

package/examples/local-wallet.spec.ts

@@ -1,4 +1,4 @@
-import { expect, test } from '@marigoldlabs/web3-tester/fixtures';
+import { expect, test } from '@andy-marigold-labs/web3-tester/fixtures';
 
 type EthereumProvider = {
   request: (args: { method: string; params?: unknown[] }) => Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marigoldlabs/web3-tester",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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"
   }
 }