npm - @broccolo1d/wallet-browser - Versions diffs - 0.1.0 - Mend

@broccolo1d/wallet-browser 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/dist/cli.d.ts +14 -0
package/dist/cli.d.ts.map +1 -0
package/dist/cli.js +197 -0
package/dist/cli.js.map +1 -0
package/dist/config.d.ts +45 -0
package/dist/config.d.ts.map +1 -0
package/dist/config.js +149 -0
package/dist/config.js.map +1 -0
package/dist/extension-pages.d.ts +26 -0
package/dist/extension-pages.d.ts.map +1 -0
package/dist/extension-pages.js +140 -0
package/dist/extension-pages.js.map +1 -0
package/dist/fixture-harness.d.ts +22 -0
package/dist/fixture-harness.d.ts.map +1 -0
package/dist/fixture-harness.js +69 -0
package/dist/fixture-harness.js.map +1 -0
package/dist/fixture-proof.d.ts +23 -0
package/dist/fixture-proof.d.ts.map +1 -0
package/dist/fixture-proof.js +90 -0
package/dist/fixture-proof.js.map +1 -0
package/dist/index.d.ts +13 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +13 -0
package/dist/index.js.map +1 -0
package/dist/launcher.d.ts +15 -0
package/dist/launcher.d.ts.map +1 -0
package/dist/launcher.js +26 -0
package/dist/launcher.js.map +1 -0
package/dist/metamask-prompts.d.ts +27 -0
package/dist/metamask-prompts.d.ts.map +1 -0
package/dist/metamask-prompts.js +116 -0
package/dist/metamask-prompts.js.map +1 -0
package/dist/metamask-smoke.d.ts +54 -0
package/dist/metamask-smoke.d.ts.map +1 -0
package/dist/metamask-smoke.js +261 -0
package/dist/metamask-smoke.js.map +1 -0
package/dist/network.d.ts +79 -0
package/dist/network.d.ts.map +1 -0
package/dist/network.js +243 -0
package/dist/network.js.map +1 -0
package/dist/onboarding.d.ts +95 -0
package/dist/onboarding.d.ts.map +1 -0
package/dist/onboarding.js +197 -0
package/dist/onboarding.js.map +1 -0
package/dist/profile-bootstrap.d.ts +33 -0
package/dist/profile-bootstrap.d.ts.map +1 -0
package/dist/profile-bootstrap.js +46 -0
package/dist/profile-bootstrap.js.map +1 -0
package/dist/wallet-control.d.ts +137 -0
package/dist/wallet-control.d.ts.map +1 -0
package/dist/wallet-control.js +453 -0
package/dist/wallet-control.js.map +1 -0
package/package.json +35 -0

package/dist/metamask-smoke.js ADDED Viewed

@@ -0,0 +1,261 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { discoverMetaMaskExtensionPage } from './extension-pages.js';
+import { launchWalletBrowser } from './launcher.js';
+export async function captureMetaMaskSmokeScreenshots(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const artifactDir = resolve(cwd, options.artifactDir ?? join('.wallet-artifacts', 'metamask-smoke', safeTimestamp()));
+    const extensionScreenshotLabel = options.extensionScreenshotLabel ?? 'metamask-extension';
+    mkdirSync(artifactDir, { recursive: true });
+    const { context } = await launchWalletBrowser({ cwd, env: options.env });
+    try {
+        const extensionPage = await openOrDiscoverMetaMaskPage(context);
+        await waitForMetaMaskUiReady(extensionPage);
+        await extensionPage.waitForTimeout(10000);
+        const browserPage = await openBrowserSmokePage(context, cwd);
+        const screenshots = [
+            { label: 'browser-page', path: join(artifactDir, 'browser-page.png') },
+            { label: extensionScreenshotLabel, path: join(artifactDir, `${extensionScreenshotLabel}.png`) }
+        ];
+        await browserPage.screenshot({ path: screenshots[0].path, fullPage: true });
+        await extensionPage.bringToFront();
+        await extensionPage.screenshot({ path: screenshots[1].path });
+        const notes = [
+            ...(options.notes ?? []),
+            'No wallet was imported, unlocked, connected, used to sign, or used to transact.',
+            'Treat generated screenshots as local-only until visually inspected for sensitive content.'
+        ];
+        const inspectionGuidePath = writeSmokeInspectionGuide({ artifactDir, screenshots, notes });
+        const manifestPath = writeSmokeArtifactManifest({ artifactDir, screenshots, inspectionGuidePath, notes });
+        return {
+            status: 'captured',
+            artifactDir,
+            screenshots,
+            inspectionGuidePath,
+            manifestPath,
+            notes
+        };
+    }
+    finally {
+        await context.close();
+    }
+}
+export async function captureFixtureExtensionSmokeScreenshots(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const artifactDir = resolve(cwd, options.artifactDir ?? join('.wallet-artifacts', 'fixture-extension-smoke', safeTimestamp()));
+    const extensionPath = join(artifactDir, 'fixture-extension');
+    createFixtureExtension(extensionPath);
+    const result = await captureMetaMaskSmokeScreenshots({
+        cwd,
+        artifactDir,
+        env: {
+            ...options.env,
+            METAMASK_EXTENSION_PATH: extensionPath,
+            WALLET_PROFILE_DIR: join(artifactDir, 'profile')
+        },
+        extensionScreenshotLabel: 'fixture-extension',
+        notes: [
+            'Fixture extension smoke proves Chromium extension-loading mechanics only; it is not MetaMask UI.',
+            'The generated fixture manifest identifies as MetaMask only to exercise the same launcher validation path without downloading the real bundle.'
+        ]
+    });
+    return result;
+}
+async function openBrowserSmokePage(context, cwd) {
+    const page = await context.newPage();
+    const fixtureDappUrl = resolveDefaultFixtureDappSmokeUrl(cwd);
+    if (fixtureDappUrl) {
+        await page.goto(fixtureDappUrl, { waitUntil: 'domcontentloaded' });
+        return page;
+    }
+    await page.setContent(`<!doctype html>
+<title>brocolli-test MetaMask Smoke</title>
+<main style="font-family: system-ui, sans-serif; padding: 2rem; max-width: 52rem;">
+  <h1>brocolli-test MetaMask smoke</h1>
+  <p>Chromium launched with an unpacked MetaMask extension in a persistent context.</p>
+  <p>This milestone does not import, unlock, connect, sign, or transact.</p>
+</main>`);
+    return page;
+}
+async function openOrDiscoverMetaMaskPage(context) {
+    const extensionId = await discoverSingleExtensionId(context);
+    const page = await context.newPage();
+    await page.goto(`chrome-extension://${extensionId}/home.html`, { waitUntil: 'domcontentloaded' });
+    return page;
+}
+async function waitForMetaMaskUiReady(page) {
+    await page.waitForLoadState('domcontentloaded').catch(() => undefined);
+    await page
+        .getByText(/Create a new wallet|I have an existing wallet|Import an existing wallet|MetaMask encountered an error/i)
+        .first()
+        .waitFor({ state: 'visible', timeout: 15000 });
+    const bodyText = await page.locator('body').innerText({ timeout: 1000 }).catch(() => '');
+    if (/MetaMask encountered an error/i.test(bodyText)) {
+        throw new Error('MetaMask extension UI reached an error screen before smoke screenshot capture.');
+    }
+}
+export function resolveDefaultFixtureDappSmokeUrl(cwd) {
+    const fixtureDappIndex = resolve(cwd, 'apps', 'fixture-dapp', 'index.html');
+    return existsSync(fixtureDappIndex) ? pathToFileURL(fixtureDappIndex).toString() : undefined;
+}
+export function writeSmokeInspectionGuide(options) {
+    const guidePath = join(options.artifactDir, 'INSPECTION.md');
+    const checklist = options.screenshots.map((screenshot) => {
+        const fileName = basename(screenshot.path);
+        return `- [ ] Confirm \`${fileName}\` contains no seed phrases, private keys, passwords, RPC tokens, full wallet addresses, or sensitive local paths.`;
+    });
+    const notes = options.notes.map((note) => `- ${note}`);
+    writeFileSync(guidePath, `# Wallet browser smoke screenshot inspection
+These screenshots are local-only evidence until reviewed. Do not commit or publish them by default.
+## Required visual checks
+${checklist.join('\n')}
+- [ ] Confirm the screenshots do not show wallet import, unlock, account connection, signature approval, or transaction approval state.
+## Smoke notes
+${notes.join('\n')}
+Keep this artifact directory ignored/local-only unless every screenshot above is reviewed and intentionally promoted.
+`);
+    return guidePath;
+}
+export function writeSmokeArtifactManifest(options) {
+    const manifestPath = join(options.artifactDir, 'SMOKE-MANIFEST.json');
+    const screenshots = options.screenshots.map((screenshot) => {
+        const bytes = readFileSync(screenshot.path);
+        return {
+            label: screenshot.label,
+            file: basename(screenshot.path),
+            sizeBytes: statSync(screenshot.path).size,
+            sha256: createHash('sha256').update(bytes).digest('hex')
+        };
+    });
+    writeFileSync(manifestPath, `${JSON.stringify({
+        artifactType: 'wallet-browser-smoke-screenshots',
+        inspectionGuide: basename(options.inspectionGuidePath),
+        screenshots,
+        notes: options.notes
+    }, null, 2)}\n`);
+    return manifestPath;
+}
+export function verifySmokeArtifactManifest(artifactDir) {
+    const manifestPath = join(artifactDir, 'SMOKE-MANIFEST.json');
+    const manifestText = readFileSync(manifestPath, 'utf8');
+    if (manifestText.includes(artifactDir)) {
+        throw new Error('Smoke artifact manifest must not contain the full artifact directory path.');
+    }
+    const manifest = JSON.parse(manifestText);
+    if (manifest.artifactType !== 'wallet-browser-smoke-screenshots') {
+        throw new Error('Smoke artifact manifest has an unexpected artifact type.');
+    }
+    if (!isSafeArtifactFileName(manifest.inspectionGuide)) {
+        throw new Error('Smoke artifact manifest inspection guide must be a safe basename.');
+    }
+    const inspectionGuidePath = join(artifactDir, manifest.inspectionGuide);
+    if (!existsSync(inspectionGuidePath)) {
+        throw new Error('Smoke artifact inspection guide is missing.');
+    }
+    if (!Array.isArray(manifest.screenshots) || manifest.screenshots.length === 0) {
+        throw new Error('Smoke artifact manifest must list at least one screenshot.');
+    }
+    const screenshots = manifest.screenshots.map((screenshot) => verifyManifestScreenshot(artifactDir, screenshot));
+    return {
+        status: 'verified',
+        artifactDir,
+        manifestPath,
+        inspectionGuidePath,
+        screenshots,
+        notes: Array.isArray(manifest.notes) ? manifest.notes : []
+    };
+}
+function verifyManifestScreenshot(artifactDir, screenshot) {
+    if (!isKnownScreenshotLabel(screenshot.label)) {
+        throw new Error(`Smoke artifact manifest contains an unexpected screenshot label: ${String(screenshot.label)}`);
+    }
+    if (!isSafeArtifactFileName(screenshot.file)) {
+        throw new Error(`Smoke artifact manifest screenshot file must be a safe basename: ${String(screenshot.file)}`);
+    }
+    const screenshotPath = join(artifactDir, screenshot.file);
+    const bytes = readFileSync(screenshotPath);
+    const sizeBytes = statSync(screenshotPath).size;
+    const sha256 = createHash('sha256').update(bytes).digest('hex');
+    if (screenshot.sizeBytes !== sizeBytes) {
+        throw new Error(`Smoke artifact screenshot size mismatch for ${screenshot.file}.`);
+    }
+    if (screenshot.sha256 !== sha256) {
+        throw new Error(`Smoke artifact screenshot hash mismatch for ${screenshot.file}.`);
+    }
+    return { ...screenshot, sizeBytes, sha256 };
+}
+function isKnownScreenshotLabel(label) {
+    return label === 'browser-page' || label === 'metamask-extension' || label === 'fixture-extension';
+}
+function isSafeArtifactFileName(fileName) {
+    return typeof fileName === 'string' && fileName.length > 0 && fileName === basename(fileName) && !fileName.includes('..');
+}
+function createFixtureExtension(extensionPath) {
+    mkdirSync(extensionPath, { recursive: true });
+    writeFileSync(join(extensionPath, 'manifest.json'), `${JSON.stringify({
+        manifest_version: 3,
+        name: 'MetaMask',
+        short_name: 'MetaMask',
+        version: '0.0.0',
+        background: { service_worker: 'service-worker.js' },
+        action: { default_title: 'Fixture extension' }
+    }, null, 2)}\n`);
+    writeFileSync(join(extensionPath, 'service-worker.js'), "chrome.runtime.onInstalled.addListener(() => undefined);\n");
+    writeFileSync(join(extensionPath, 'home.html'), `<!doctype html>
+<title>Fixture extension smoke</title>
+<main style="font-family: system-ui, sans-serif; padding: 2rem; max-width: 48rem;">
+  <h1>Fixture extension loading smoke</h1>
+  <p>This generated extension proves Chromium loaded an unpacked extension in a persistent context.</p>
+  <p><strong>This is not MetaMask UI.</strong> It does not import, unlock, connect, sign, or transact.</p>
+</main>`);
+}
+function tryDiscoverMetaMaskPage(pages) {
+    try {
+        return discoverMetaMaskExtensionPage(pages);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function discoverSingleExtensionId(context) {
+    let ids = collectExtensionIds(context);
+    if (ids.size === 0) {
+        await context.waitForEvent('serviceworker', { timeout: 5000 }).catch(() => undefined);
+        ids = collectExtensionIds(context);
+    }
+    if (ids.size !== 1) {
+        throw new Error('Unable to discover a single loaded MetaMask extension id from Chromium service workers.');
+    }
+    return [...ids][0];
+}
+function collectExtensionIds(context) {
+    const ids = new Set();
+    for (const worker of context.serviceWorkers()) {
+        const id = extensionIdFromChromeExtensionUrl(worker.url());
+        if (id) {
+            ids.add(id);
+        }
+    }
+    return ids;
+}
+function extensionIdFromChromeExtensionUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'chrome-extension:' ? parsed.hostname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeTimestamp(date = new Date()) {
+    return date.toISOString().replace(/[:.]/g, '-');
+}
+//# sourceMappingURL=metamask-smoke.js.map

package/dist/metamask-smoke.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/network.d.ts ADDED Viewed

@@ -0,0 +1,79 @@
+import type { Page } from 'playwright';
+import type { WalletBrowserEnv } from './config.js';
+export declare const DEFAULT_SEPOLIA_CHAIN_ID = 11155111;
+export declare const DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS = 30000;
+export declare const DEFAULT_ALLOWED_WALLET_CHAIN_IDS: readonly [11155111, 31337, 1337];
+export interface SepoliaNetworkEnv extends WalletBrowserEnv {
+    SEPOLIA_CHAIN_ID?: string;
+    SEPOLIA_RPC_URL?: string;
+    SEPOLIA_WALLET_ADDRESS?: string;
+    METAMASK_NETWORK_ASSERTION_TIMEOUT_MS?: string;
+    METAMASK_NETWORK_DEBUG?: string;
+}
+export interface ResolveSepoliaNetworkConfigOptions {
+    env?: SepoliaNetworkEnv;
+    chainId?: string | number;
+    rpcUrl?: string;
+    expectedAccount?: string;
+    timeoutMs?: number;
+    debug?: boolean;
+}
+export interface SepoliaNetworkConfig {
+    chainId: number;
+    chainIdHex: string;
+    expectedAccount: string;
+    rpcUrl?: string;
+    timeoutMs: number;
+    debug: boolean;
+}
+export interface RedactedSepoliaNetworkPlan {
+    status: 'pending';
+    chainId: number;
+    chainIdHex: string;
+    expectedAccount: string;
+    rpcUrlConfigured: boolean;
+    rpcUrl?: string;
+    timeoutMs: number;
+    debug: boolean;
+}
+export interface SepoliaNetworkAssertionResult {
+    status: 'verified';
+    chainId: number;
+    chainIdHex: string;
+    expectedAccount: string;
+    activeAccount: string;
+}
+export interface AddEthereumChainInput {
+    chainId: string;
+    chainName: string;
+    rpcUrls: string[];
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    blockExplorerUrls: string[];
+}
+export interface MetaMaskNetworkDriver {
+    getChainId(): Promise<string | number>;
+    getAccounts(): Promise<string[]>;
+    switchChain(chainIdHex: string): Promise<void>;
+    addEthereumChain(input: AddEthereumChainInput): Promise<void>;
+}
+export interface MetaMaskNetworkPageDriverOptions {
+    page: Page;
+    timeoutMs?: number;
+}
+export declare function normalizeChainId(value: string | number | undefined): number;
+export declare function chainIdToHex(chainId: number): string;
+export declare function normalizeExpectedAccount(value: string | undefined): string;
+export declare function isAllowedWalletChainId(value: string | number): boolean;
+export declare function resolveSepoliaNetworkConfig(options?: ResolveSepoliaNetworkConfigOptions): SepoliaNetworkConfig;
+export declare function validateOptionalRpcUrl(value: string | undefined): string | undefined;
+export declare function createSepoliaNetworkPlan(config: SepoliaNetworkConfig): RedactedSepoliaNetworkPlan;
+export declare function assertExpectedChainAndAccount(config: SepoliaNetworkConfig, driver: MetaMaskNetworkDriver): Promise<SepoliaNetworkAssertionResult>;
+export declare function provisionSepoliaNetwork(config: SepoliaNetworkConfig, driver: MetaMaskNetworkDriver): Promise<SepoliaNetworkAssertionResult>;
+export declare function createSepoliaAddChainInput(config: SepoliaNetworkConfig): AddEthereumChainInput;
+export declare function createMetaMaskNetworkPageDriver(options: MetaMaskNetworkPageDriverOptions): MetaMaskNetworkDriver;
+export declare function redactRpcUrl(value: string): string;
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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"}

package/dist/network.js ADDED Viewed

@@ -0,0 +1,243 @@
+import { validateEthereumAddress } from './onboarding.js';
+export const DEFAULT_SEPOLIA_CHAIN_ID = 11_155_111;
+export const DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS = 30_000;
+export const DEFAULT_ALLOWED_WALLET_CHAIN_IDS = [DEFAULT_SEPOLIA_CHAIN_ID, 31_337, 1_337];
+export function normalizeChainId(value) {
+    if (typeof value === 'number') {
+        if (!Number.isInteger(value) || value <= 0) {
+            throw new Error('Chain id must be a positive integer.');
+        }
+        return validateSafeChainId(value);
+    }
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        throw new Error('Chain id is required.');
+    }
+    if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {
+        return validateSafeChainId(Number.parseInt(trimmed, 16));
+    }
+    if (/^[0-9]+$/.test(trimmed)) {
+        return validateSafeChainId(Number.parseInt(trimmed, 10));
+    }
+    throw new Error('Chain id must be a decimal integer or 0x-prefixed hexadecimal value.');
+}
+export function chainIdToHex(chainId) {
+    return `0x${validatePositiveSafeChainId(chainId).toString(16)}`;
+}
+function validateSafeChainId(chainId) {
+    if (!Number.isSafeInteger(chainId)) {
+        throw new Error('Chain id must be within JavaScript safe integer range.');
+    }
+    return chainId;
+}
+function validatePositiveSafeChainId(chainId) {
+    if (!Number.isInteger(chainId) || chainId <= 0) {
+        throw new Error('Chain id must be a positive integer.');
+    }
+    return validateSafeChainId(chainId);
+}
+export function normalizeExpectedAccount(value) {
+    return validateEthereumAddress(value);
+}
+export function isAllowedWalletChainId(value) {
+    try {
+        const chainId = normalizeChainId(value);
+        return DEFAULT_ALLOWED_WALLET_CHAIN_IDS.includes(chainId);
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveSepoliaNetworkConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const chainId = normalizeChainId(options.chainId ?? env.SEPOLIA_CHAIN_ID ?? DEFAULT_SEPOLIA_CHAIN_ID);
+    if (chainId !== DEFAULT_SEPOLIA_CHAIN_ID) {
+        throw new Error(`SEPOLIA_CHAIN_ID must be ${DEFAULT_SEPOLIA_CHAIN_ID} for Sepolia provisioning.`);
+    }
+    return {
+        chainId,
+        chainIdHex: chainIdToHex(chainId),
+        expectedAccount: normalizeExpectedAccount(options.expectedAccount ?? env.SEPOLIA_WALLET_ADDRESS),
+        rpcUrl: validateOptionalRpcUrl(options.rpcUrl ?? env.SEPOLIA_RPC_URL),
+        timeoutMs: resolveNetworkTimeoutMs(options.timeoutMs, env.METAMASK_NETWORK_ASSERTION_TIMEOUT_MS),
+        debug: options.debug ?? parseBoolean(env.METAMASK_NETWORK_DEBUG)
+    };
+}
+export function validateOptionalRpcUrl(value) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new Error('SEPOLIA_RPC_URL must be a valid http(s) URL when provided.');
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        throw new Error('SEPOLIA_RPC_URL must use http or https when provided.');
+    }
+    return trimmed;
+}
+export function createSepoliaNetworkPlan(config) {
+    return {
+        status: 'pending',
+        chainId: config.chainId,
+        chainIdHex: config.chainIdHex,
+        expectedAccount: config.expectedAccount,
+        rpcUrlConfigured: config.rpcUrl !== undefined,
+        rpcUrl: config.rpcUrl ? redactRpcUrl(config.rpcUrl) : undefined,
+        timeoutMs: config.timeoutMs,
+        debug: config.debug
+    };
+}
+export async function assertExpectedChainAndAccount(config, driver) {
+    const activeChainId = await runRedactedNetworkStep(config, 'read active wallet chain', () => driver.getChainId());
+    const normalizedChainId = normalizeChainId(activeChainId);
+    if (!isAllowedWalletChainId(normalizedChainId)) {
+        throw new Error(`Wallet chain ${chainIdToHex(normalizedChainId)} is not allowed for this harness.`);
+    }
+    if (normalizedChainId !== config.chainId) {
+        throw new Error(`Wallet chain ${chainIdToHex(normalizedChainId)} does not match expected Sepolia chain ${config.chainIdHex}.`);
+    }
+    const accounts = await runRedactedNetworkStep(config, 'read active wallet accounts', () => driver.getAccounts());
+    const activeAccount = normalizeExpectedAccount(accounts[0]);
+    if (activeAccount !== config.expectedAccount) {
+        throw new Error(`Wallet active account ${activeAccount} does not match expected ${config.expectedAccount}.`);
+    }
+    return {
+        status: 'verified',
+        chainId: config.chainId,
+        chainIdHex: config.chainIdHex,
+        expectedAccount: config.expectedAccount,
+        activeAccount
+    };
+}
+export async function provisionSepoliaNetwork(config, driver) {
+    const activeChainId = normalizeChainId(await runRedactedNetworkStep(config, 'read active wallet chain', () => driver.getChainId()));
+    if (!isAllowedWalletChainId(activeChainId)) {
+        throw new Error(`Wallet chain ${chainIdToHex(activeChainId)} is not allowed for this harness.`);
+    }
+    if (activeChainId !== config.chainId) {
+        try {
+            await runRedactedNetworkStep(config, 'switch MetaMask to Sepolia', () => driver.switchChain(config.chainIdHex));
+        }
+        catch (error) {
+            if (!config.rpcUrl) {
+                throw new Error(`SEPOLIA_RPC_URL is required to add Sepolia after MetaMask switch failed: ${redactNetworkErrorMessage(config, error)}`);
+            }
+            await runRedactedNetworkStep(config, 'add Sepolia to MetaMask', () => driver.addEthereumChain(createSepoliaAddChainInput(config)));
+            await runRedactedNetworkStep(config, 'switch MetaMask to Sepolia after adding network', () => driver.switchChain(config.chainIdHex));
+        }
+    }
+    return assertExpectedChainAndAccount(config, driver);
+}
+export function createSepoliaAddChainInput(config) {
+    if (!config.rpcUrl) {
+        throw new Error('SEPOLIA_RPC_URL is required to add Sepolia to MetaMask.');
+    }
+    return {
+        chainId: config.chainIdHex,
+        chainName: 'Sepolia',
+        rpcUrls: [config.rpcUrl],
+        nativeCurrency: {
+            name: 'Sepolia Ether',
+            symbol: 'ETH',
+            decimals: 18
+        },
+        blockExplorerUrls: ['https://sepolia.etherscan.io']
+    };
+}
+export function createMetaMaskNetworkPageDriver(options) {
+    const timeoutMs = resolvePageDriverTimeoutMs(options.timeoutMs);
+    return {
+        async getChainId() {
+            const result = await requestEthereum(options.page, { method: 'eth_chainId' }, timeoutMs);
+            if (typeof result !== 'string' && typeof result !== 'number') {
+                throw new Error('MetaMask returned an invalid eth_chainId response.');
+            }
+            return result;
+        },
+        async getAccounts() {
+            const result = await requestEthereum(options.page, { method: 'eth_accounts' }, timeoutMs);
+            if (!Array.isArray(result) || !result.every((value) => typeof value === 'string')) {
+                throw new Error('MetaMask returned an invalid eth_accounts response.');
+            }
+            return result;
+        },
+        async switchChain(chainIdHex) {
+            await requestEthereum(options.page, { method: 'wallet_switchEthereumChain', params: [{ chainId: chainIdHex }] }, timeoutMs);
+        },
+        async addEthereumChain(input) {
+            await requestEthereum(options.page, { method: 'wallet_addEthereumChain', params: [input] }, timeoutMs);
+        }
+    };
+}
+async function requestEthereum(page, request, timeoutMs) {
+    let timeoutHandle;
+    try {
+        return await Promise.race([
+            page.evaluate(async (input) => {
+                const maybeProvider = globalThis.ethereum;
+                if (!maybeProvider?.request) {
+                    throw new Error('window.ethereum.request is not available on the selected MetaMask page.');
+                }
+                return maybeProvider.request(input);
+            }, request),
+            new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => {
+                    reject(new Error(`MetaMask EIP-1193 request ${request.method} timed out after ${timeoutMs}ms.`));
+                }, timeoutMs);
+            })
+        ]);
+    }
+    finally {
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+    }
+}
+function resolvePageDriverTimeoutMs(timeoutMs) {
+    const resolved = timeoutMs ?? DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS;
+    if (!Number.isInteger(resolved) || resolved <= 0) {
+        throw new Error('MetaMask page network driver timeoutMs must be a positive integer.');
+    }
+    return resolved;
+}
+function resolveNetworkTimeoutMs(explicit, envValue) {
+    const raw = explicit ?? (envValue ? Number(envValue) : DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS);
+    if (!Number.isInteger(raw) || raw <= 0) {
+        throw new Error('METAMASK_NETWORK_ASSERTION_TIMEOUT_MS must be a positive integer.');
+    }
+    return raw;
+}
+function parseBoolean(value) {
+    if (value === undefined || value.trim() === '') {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+async function runRedactedNetworkStep(config, label, step) {
+    try {
+        return await step();
+    }
+    catch (error) {
+        throw new Error(`${label} failed: ${redactNetworkErrorMessage(config, error)}`);
+    }
+}
+function redactNetworkErrorMessage(config, error) {
+    const raw = error instanceof Error ? error.message : String(error);
+    const withoutConfiguredRpc = config.rpcUrl ? raw.split(config.rpcUrl).join(redactRpcUrl(config.rpcUrl)) : raw;
+    return withoutConfiguredRpc.replace(/https?:\/\/[^\s)]+/gi, (match) => redactRpcUrl(match));
+}
+export function redactRpcUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return `${parsed.protocol}//${parsed.host}/[redacted-url]`;
+    }
+    catch {
+        return '[redacted-rpc-url]';
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map ADDED Viewed

@@ -0,0 +1 @@

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