@broccolo1d/wallet-browser 0.1.0

package/dist/onboarding.d.ts

@@ -0,0 +1,95 @@
+import type { BrowserContext, Page } from 'playwright';
+import type { WalletBrowserEnv } from './config.js';
+export type MetaMaskOnboardingState = 'needs-import' | 'locked' | 'unlocked' | 'unknown';
+export type MetaMaskOnboardingStatus = 'pending' | 'verified';
+export interface MetaMaskOnboardingEnv extends WalletBrowserEnv {
+    SEPOLIA_WALLET_ADDRESS?: string;
+    SEPOLIA_WALLET_PRIVATE_KEY?: string;
+    METAMASK_PASSWORD?: string;
+    METAMASK_ONBOARDING_TIMEOUT_MS?: string;
+    METAMASK_ONBOARDING_DEBUG?: string;
+}
+export interface ResolveMetaMaskOnboardingConfigOptions {
+    env?: MetaMaskOnboardingEnv;
+    expectedAddress?: string;
+    privateKey?: string;
+    password?: string;
+    timeoutMs?: number;
+    debug?: boolean;
+}
+export interface MetaMaskOnboardingConfig {
+    expectedAddress: string;
+    privateKey: string;
+    password: string;
+    timeoutMs: number;
+    debug: boolean;
+}
+export interface RedactedMetaMaskOnboardingPlan {
+    status: 'pending';
+    expectedAddress: string;
+    privateKey: string;
+    password: string;
+    timeoutMs: number;
+    debug: boolean;
+    selectors: typeof METAMASK_ONBOARDING_SELECTORS;
+    run(driver: MetaMaskOnboardingDriver): Promise<MetaMaskOnboardingResult>;
+}
+export interface MetaMaskOnboardingResult {
+    status: MetaMaskOnboardingStatus;
+    expectedAddress: string;
+    activeAddress: string;
+}
+export interface MetaMaskImportPrivateKeyInput {
+    expectedAddress: string;
+    privateKey: string;
+    password: string;
+    timeoutMs: number;
+}
+export interface MetaMaskUnlockInput {
+    expectedAddress: string;
+    password: string;
+    timeoutMs: number;
+}
+export interface MetaMaskOnboardingDriver {
+    getState(): Promise<MetaMaskOnboardingState>;
+    importPrivateKey(input: MetaMaskImportPrivateKeyInput): Promise<void>;
+    unlock(input: MetaMaskUnlockInput): Promise<void>;
+    getActiveAddress(): Promise<string>;
+}
+export interface MetaMaskPageDriverOptions {
+    context: BrowserContext;
+    page?: Page;
+    extensionId?: string;
+    timeoutMs?: number;
+}
+export interface MetaMaskExtensionPageDiscoveryOptions {
+    context: BrowserContext;
+    extensionId?: string;
+}
+export declare const DEFAULT_METAMASK_ONBOARDING_TIMEOUT_MS = 60000;
+export declare const METAMASK_ONBOARDING_SELECTORS: {
+    readonly termsCheckbox: "[data-testid=\"onboarding-terms-checkbox\"]";
+    readonly importWalletButton: "[data-testid=\"onboarding-import-wallet\"]";
+    readonly noThanksMetricsButton: "[data-testid=\"metametrics-no-thanks\"]";
+    readonly privateKeyInput: "[data-testid=\"private-key-box\"]";
+    readonly passwordInput: "[data-testid=\"create-password-new\"]";
+    readonly confirmPasswordInput: "[data-testid=\"create-password-confirm\"]";
+    readonly importSubmitButton: "[data-testid=\"import-wallet-button\"]";
+    readonly unlockPasswordInput: "[data-testid=\"unlock-password\"]";
+    readonly unlockSubmitButton: "[data-testid=\"unlock-submit\"]";
+    readonly accountAddressButton: "[data-testid=\"account-menu-icon\"]";
+};
+export declare function resolveMetaMaskOnboardingConfig(options?: ResolveMetaMaskOnboardingConfigOptions): MetaMaskOnboardingConfig;
+export declare function validateEthereumAddress(value: string | undefined): string;
+export declare function validatePrivateKey(value: string | undefined): string;
+export declare function validateMetaMaskPassword(value: string | undefined): string;
+export declare function maskSecret(value: string): string;
+export declare function createMetaMaskOnboardingPlan(config: MetaMaskOnboardingConfig): RedactedMetaMaskOnboardingPlan;
+export declare function runMetaMaskOnboarding(config: MetaMaskOnboardingConfig, driver: MetaMaskOnboardingDriver): Promise<MetaMaskOnboardingResult>;
+export declare function importPrivateKeyIntoMetaMaskPage(_page: Page, _input: MetaMaskImportPrivateKeyInput): Promise<void>;
+export declare function unlockMetaMaskPage(page: Page, input: MetaMaskUnlockInput): Promise<void>;
+export declare function verifyMetaMaskActiveAddress(_page: Page, _expectedAddress: string): Promise<string>;
+export declare function isMetaMaskExtensionPageUrl(url: string, extensionId?: string): boolean;
+export declare function findMetaMaskExtensionPage(options: MetaMaskExtensionPageDiscoveryOptions): Page;
+export declare function createMetaMaskPageDriver(options: MetaMaskPageDriverOptions): Promise<MetaMaskOnboardingDriver>;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/onboarding.d.ts.map

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

package/dist/onboarding.js

@@ -0,0 +1,197 @@
+import { discoverMetaMaskExtensionPage, isMetaMaskExtensionPageUrl as isKnownMetaMaskExtensionPageUrl } from './extension-pages.js';
+export const DEFAULT_METAMASK_ONBOARDING_TIMEOUT_MS = 60_000;
+export const METAMASK_ONBOARDING_SELECTORS = {
+    termsCheckbox: '[data-testid="onboarding-terms-checkbox"]',
+    importWalletButton: '[data-testid="onboarding-import-wallet"]',
+    noThanksMetricsButton: '[data-testid="metametrics-no-thanks"]',
+    privateKeyInput: '[data-testid="private-key-box"]',
+    passwordInput: '[data-testid="create-password-new"]',
+    confirmPasswordInput: '[data-testid="create-password-confirm"]',
+    importSubmitButton: '[data-testid="import-wallet-button"]',
+    unlockPasswordInput: '[data-testid="unlock-password"]',
+    unlockSubmitButton: '[data-testid="unlock-submit"]',
+    accountAddressButton: '[data-testid="account-menu-icon"]'
+};
+export function resolveMetaMaskOnboardingConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const expectedAddress = validateEthereumAddress(options.expectedAddress ?? env.SEPOLIA_WALLET_ADDRESS);
+    const privateKey = validatePrivateKey(options.privateKey ?? env.SEPOLIA_WALLET_PRIVATE_KEY);
+    const password = validateMetaMaskPassword(options.password ?? env.METAMASK_PASSWORD);
+    return {
+        expectedAddress,
+        privateKey,
+        password,
+        timeoutMs: resolveTimeoutMs(options.timeoutMs, env.METAMASK_ONBOARDING_TIMEOUT_MS),
+        debug: options.debug ?? parseBoolean(env.METAMASK_ONBOARDING_DEBUG)
+    };
+}
+export function validateEthereumAddress(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || !/^0x[a-fA-F0-9]{40}$/i.test(trimmed)) {
+        throw new Error('SEPOLIA_WALLET_ADDRESS must be a 0x-prefixed 20-byte Ethereum address.');
+    }
+    return trimmed.toLowerCase();
+}
+export function validatePrivateKey(value) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        throw new Error('SEPOLIA_WALLET_PRIVATE_KEY is required for MetaMask onboarding.');
+    }
+    const normalized = trimmed.startsWith('0x') ? trimmed : `0x${trimmed}`;
+    if (!/^0x[a-fA-F0-9]{64}$/.test(normalized)) {
+        throw new Error('SEPOLIA_WALLET_PRIVATE_KEY must be a 32-byte hex private key.');
+    }
+    return normalized;
+}
+export function validateMetaMaskPassword(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || trimmed.length < 8) {
+        throw new Error('METAMASK_PASSWORD must be at least 8 characters long.');
+    }
+    return trimmed;
+}
+export function maskSecret(value) {
+    if (/^0x[a-fA-F0-9]{64}$/.test(value)) {
+        return `${value.slice(0, 4)}…${value.slice(-4)}`;
+    }
+    return `[redacted:${value.length} chars]`;
+}
+export function createMetaMaskOnboardingPlan(config) {
+    return {
+        status: 'pending',
+        expectedAddress: config.expectedAddress,
+        privateKey: maskSecret(config.privateKey),
+        password: maskSecret(config.password),
+        timeoutMs: config.timeoutMs,
+        debug: config.debug,
+        selectors: METAMASK_ONBOARDING_SELECTORS,
+        run: (driver) => runMetaMaskOnboarding(config, driver)
+    };
+}
+export async function runMetaMaskOnboarding(config, driver) {
+    const state = await runRedactedOnboardingStep(config, 'read MetaMask onboarding state', () => driver.getState());
+    switch (state) {
+        case 'needs-import':
+            await runRedactedOnboardingStep(config, 'import private key into MetaMask', () => driver.importPrivateKey({
+                expectedAddress: config.expectedAddress,
+                privateKey: config.privateKey,
+                password: config.password,
+                timeoutMs: config.timeoutMs
+            }));
+            await runRedactedOnboardingStep(config, 'unlock MetaMask', () => driver.unlock({ expectedAddress: config.expectedAddress, password: config.password, timeoutMs: config.timeoutMs }));
+            break;
+        case 'locked':
+            await runRedactedOnboardingStep(config, 'unlock MetaMask', () => driver.unlock({ expectedAddress: config.expectedAddress, password: config.password, timeoutMs: config.timeoutMs }));
+            break;
+        case 'unlocked':
+            break;
+        case 'unknown':
+            throw new Error('Unknown MetaMask onboarding state; refusing to continue without leaking onboarding secrets.');
+    }
+    const activeAddress = validateEthereumAddress(await runRedactedOnboardingStep(config, 'read active MetaMask address', () => driver.getActiveAddress()));
+    if (activeAddress !== config.expectedAddress) {
+        throw new Error(`MetaMask active address ${activeAddress} does not match expected ${config.expectedAddress}.`);
+    }
+    return { status: 'verified', expectedAddress: config.expectedAddress, activeAddress };
+}
+export async function importPrivateKeyIntoMetaMaskPage(_page, _input) {
+    throw new Error('MetaMask page import automation is not implemented yet; selector contract is exported for the pinned onboarding flow.');
+}
+export async function unlockMetaMaskPage(page, input) {
+    await page.locator(METAMASK_ONBOARDING_SELECTORS.unlockPasswordInput).fill(input.password);
+    await page.locator(METAMASK_ONBOARDING_SELECTORS.unlockSubmitButton).click();
+}
+export async function verifyMetaMaskActiveAddress(_page, _expectedAddress) {
+    throw new Error('MetaMask active-address verification is not implemented yet; use a MetaMaskOnboardingDriver mock until real extension page selectors are wired.');
+}
+export function isMetaMaskExtensionPageUrl(url, extensionId) {
+    return isKnownMetaMaskExtensionPageUrl(url, { extensionId });
+}
+export function findMetaMaskExtensionPage(options) {
+    try {
+        return discoverMetaMaskExtensionPage(options.context.pages(), { extensionId: options.extensionId });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.startsWith('No MetaMask extension page found')) {
+            throw new Error('Unknown MetaMask extension UI state: no MetaMask extension page is open in the provided BrowserContext.');
+        }
+        if (message.startsWith('Multiple MetaMask extension page candidates found')) {
+            throw new Error('Unknown MetaMask extension UI state: multiple MetaMask extension pages are open; pass an explicit Page to avoid ambiguity.');
+        }
+        throw error;
+    }
+}
+export async function createMetaMaskPageDriver(options) {
+    const page = options.page ?? findMetaMaskExtensionPage(options);
+    return {
+        async getState() {
+            if (await hasAnyVisibleSelector(page, [METAMASK_ONBOARDING_SELECTORS.unlockPasswordInput])) {
+                return 'locked';
+            }
+            if (await hasAnyVisibleSelector(page, [
+                METAMASK_ONBOARDING_SELECTORS.termsCheckbox,
+                METAMASK_ONBOARDING_SELECTORS.importWalletButton,
+                METAMASK_ONBOARDING_SELECTORS.privateKeyInput
+            ])) {
+                return 'needs-import';
+            }
+            if (await hasAnyVisibleSelector(page, [METAMASK_ONBOARDING_SELECTORS.accountAddressButton])) {
+                return 'unlocked';
+            }
+            return 'unknown';
+        },
+        async importPrivateKey(input) {
+            await importPrivateKeyIntoMetaMaskPage(page, input);
+        },
+        async unlock(input) {
+            await unlockMetaMaskPage(page, input);
+        },
+        async getActiveAddress() {
+            return verifyMetaMaskActiveAddress(page, '');
+        }
+    };
+}
+async function hasAnyVisibleSelector(page, selectors) {
+    for (const selector of selectors) {
+        try {
+            if ((await page.locator(selector).count()) > 0) {
+                return true;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+function resolveTimeoutMs(explicit, envValue) {
+    const value = explicit ?? (envValue?.trim() ? Number(envValue) : DEFAULT_METAMASK_ONBOARDING_TIMEOUT_MS);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error('METAMASK_ONBOARDING_TIMEOUT_MS must be a positive integer number of milliseconds.');
+    }
+    return value;
+}
+async function runRedactedOnboardingStep(config, step, action) {
+    try {
+        return await action();
+    }
+    catch (error) {
+        const rawMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to ${step}: ${redactOnboardingSecrets(rawMessage, config)}`);
+    }
+}
+function redactOnboardingSecrets(message, config) {
+    return [config.privateKey, config.privateKey.slice(2), config.password]
+        .filter((value) => value.length > 0)
+        .reduce((redacted, secret) => redacted.split(secret).join(maskSecret(secret)), message)
+        .replace(/0x[a-fA-F0-9]{64}/g, '[redacted:private-key]')
+        .replace(/\b[a-fA-F0-9]{64}\b/g, '[redacted:private-key]');
+}
+function parseBoolean(value) {
+    if (value === undefined || value.trim() === '') {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/onboarding.js.map

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

package/dist/profile-bootstrap.d.ts

@@ -0,0 +1,33 @@
+import { type WalletBrowserConfig, type WalletBrowserEnv } from './config.js';
+import { type MetaMaskOnboardingConfig, type MetaMaskOnboardingEnv } from './onboarding.js';
+export interface ProfileBootstrapImportEnv extends WalletBrowserEnv, MetaMaskOnboardingEnv {
+}
+export interface ResolveProfileBootstrapImportOptions {
+    cwd?: string;
+    env?: ProfileBootstrapImportEnv;
+    now?: Date;
+}
+export interface ProfileBootstrapImportManifest {
+    artifactType: 'wallet-profile-bootstrap-import';
+    status: 'dry-run';
+    walletAddress: string;
+    profileName: string;
+    metamaskExtension: {
+        version: string;
+        identity: WalletBrowserConfig['metamaskExtensionIdentity'];
+    };
+    secrets: {
+        privateKeyConfigured: boolean;
+        passwordConfigured: boolean;
+    };
+    safetyNotes: string[];
+}
+export interface ProfileBootstrapImportDryRunResult {
+    status: 'dry-run';
+    manifestPath: string;
+    manifest: ProfileBootstrapImportManifest;
+}
+export declare function maskEthereumAddress(address: string): string;
+export declare function createProfileBootstrapImportManifest(walletConfig: WalletBrowserConfig, onboardingConfig: MetaMaskOnboardingConfig): ProfileBootstrapImportManifest;
+export declare function createProfileBootstrapImportDryRun(options?: ResolveProfileBootstrapImportOptions): ProfileBootstrapImportDryRunResult;
+//# sourceMappingURL=profile-bootstrap.d.ts.map

package/dist/profile-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-bootstrap.d.ts","sourceRoot":"","sources":["../src/profile-bootstrap.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8B,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAmC,KAAK,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7H,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB,EAAE,qBAAqB;CAAG;AAE7F,MAAM,WAAW,oCAAoC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,yBAAyB,CAAC;IAChC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,iCAAiC,CAAC;IAChD,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;KAC5D,CAAC;IACF,OAAO,EAAE;QACP,oBAAoB,EAAE,OAAO,CAAC;QAC9B,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,8BAA8B,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,wBAAgB,oCAAoC,CAClD,YAAY,EAAE,mBAAmB,EACjC,gBAAgB,EAAE,wBAAwB,GACzC,8BAA8B,CAoBhC;AAED,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,oCAAyC,GACjD,kCAAkC,CAcpC"}

package/dist/profile-bootstrap.js

@@ -0,0 +1,46 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveWalletBrowserConfig } from './config.js';
+import { resolveMetaMaskOnboardingConfig } from './onboarding.js';
+export function maskEthereumAddress(address) {
+    const normalized = address.toLowerCase();
+    return `${normalized.slice(0, 6)}…${normalized.slice(-4)}`;
+}
+export function createProfileBootstrapImportManifest(walletConfig, onboardingConfig) {
+    return {
+        artifactType: 'wallet-profile-bootstrap-import',
+        status: 'dry-run',
+        walletAddress: maskEthereumAddress(onboardingConfig.expectedAddress),
+        profileName: walletConfig.profileName,
+        metamaskExtension: {
+            version: walletConfig.metamaskExtensionVersion,
+            identity: walletConfig.metamaskExtensionIdentity
+        },
+        secrets: {
+            privateKeyConfigured: onboardingConfig.privateKey.length > 0,
+            passwordConfigured: onboardingConfig.password.length > 0
+        },
+        safetyNotes: [
+            'No browser was launched and no private key or password was entered during this dry run.',
+            'Generated artifacts are local-only under .wallet-artifacts and must remain ignored.',
+            'Use only burner/testnet wallets and inspect artifacts before sharing any evidence.'
+        ]
+    };
+}
+export function createProfileBootstrapImportDryRun(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const onboardingConfig = resolveMetaMaskOnboardingConfig({ env });
+    const walletConfig = resolveWalletBrowserConfig({ cwd, env });
+    const manifest = createProfileBootstrapImportManifest(walletConfig, onboardingConfig);
+    const runId = formatRunId(options.now ?? new Date());
+    const artifactDir = join(cwd, '.wallet-artifacts', 'profile-bootstrap-import', runId);
+    const manifestPath = join(artifactDir, 'BOOTSTRAP-MANIFEST.json');
+    mkdirSync(artifactDir, { recursive: true });
+    writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
+    return { status: 'dry-run', manifestPath, manifest };
+}
+function formatRunId(now) {
+    return now.toISOString().replace(/[:.]/g, '-');
+}
+//# sourceMappingURL=profile-bootstrap.js.map

package/dist/profile-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-bootstrap.js","sourceRoot":"","sources":["../src/profile-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,0BAA0B,EAAmD,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,+BAA+B,EAA6D,MAAM,iBAAiB,CAAC;AAgC7H,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,YAAiC,EACjC,gBAA0C;IAE1C,OAAO;QACL,YAAY,EAAE,iCAAiC;QAC/C,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,eAAe,CAAC;QACpE,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,iBAAiB,EAAE;YACjB,OAAO,EAAE,YAAY,CAAC,wBAAwB;YAC9C,QAAQ,EAAE,YAAY,CAAC,yBAAyB;SACjD;QACD,OAAO,EAAE;YACP,oBAAoB,EAAE,gBAAgB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC5D,kBAAkB,EAAE,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;SACzD;QACD,WAAW,EAAE;YACX,yFAAyF;YACzF,qFAAqF;YACrF,oFAAoF;SACrF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,UAAgD,EAAE;IAElD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,0BAA0B,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,oCAAoC,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACtF,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IAElE,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,aAAa,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,GAAS;IAC5B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}

package/dist/wallet-control.d.ts

@@ -0,0 +1,137 @@
+import { type MetaMaskNetworkDriver, type SepoliaNetworkAssertionResult } from './network.js';
+export type WalletControlAction = 'connectWallet' | 'approveSignature' | 'approveTransaction' | 'switchNetwork' | 'assertWalletState' | 'resetProfile';
+export type WalletControlLogStatus = 'started' | 'prompt-approved' | 'verified' | 'deleted' | 'skipped' | 'failed';
+export interface WalletControlLogEvent {
+    action: WalletControlAction;
+    status: WalletControlLogStatus;
+    origin?: string;
+    chainId?: number;
+    chainIdHex?: string;
+    account?: string;
+    target?: string;
+    valueWei?: string;
+    decision?: 'pending' | 'approved' | 'rejected';
+    promptType?: 'connect' | 'signature' | 'transaction';
+    metadata?: unknown;
+}
+export type WalletControlLogger = (event: WalletControlLogEvent) => void;
+export interface WalletDappDriver {
+    requestConnect(): Promise<void>;
+    getConnectedAccount(): Promise<string | undefined>;
+    requestSignature?(input: WalletSignatureRequestInput): Promise<void>;
+    requestTransaction?(input: WalletTransactionRequestInput): Promise<void>;
+}
+export interface WalletDappPageLocator {
+    click(): Promise<void>;
+    textContent(): Promise<string | null>;
+}
+export interface WalletDappPageLike {
+    locator(selector: string): WalletDappPageLocator;
+}
+export interface WalletDappPageDriverSelectors {
+    connectButton: string;
+    connectedAccount: string;
+    signMessageButton: string;
+    sendTransactionButton: string;
+}
+export interface WalletDappPageDriverOptions {
+    page: WalletDappPageLike;
+    selectors: WalletDappPageDriverSelectors;
+}
+export interface WalletSignatureRequestInput {
+    origin?: string;
+    expectedAccount: string;
+    message?: string;
+}
+export interface WalletTransactionRequestInput {
+    origin?: string;
+    expectedAccount: string;
+    to?: string;
+    value?: string;
+}
+export interface WalletConnectionPromptInput {
+    origin?: string;
+    expectedAccount: string;
+    expectedChainIdHex: string;
+}
+export interface WalletSignaturePromptInput {
+    origin?: string;
+    expectedAccount: string;
+    message?: string;
+}
+export interface WalletTransactionPromptInput {
+    origin?: string;
+    expectedAccount: string;
+    to?: string;
+    value?: string;
+}
+export interface WalletGuardrailConfig {
+    maxTransactionValueWei?: string | number | bigint;
+    allowedOrigins?: readonly string[];
+    allowedTargets?: readonly string[];
+}
+export interface WalletPromptDriver {
+    approveConnection?(input: WalletConnectionPromptInput): Promise<void>;
+    approveSignature?(input: WalletSignaturePromptInput): Promise<void>;
+    approveTransaction?(input: WalletTransactionPromptInput): Promise<void>;
+}
+export interface WalletStateOptions {
+    network: MetaMaskNetworkDriver;
+    expectedAccount: string;
+    expectedChainId: string | number;
+    logger?: WalletControlLogger;
+    metadata?: unknown;
+}
+export interface ConnectWalletOptions extends WalletStateOptions {
+    dapp: WalletDappDriver;
+    prompt: WalletPromptDriver;
+    origin?: string;
+    guardrails?: WalletGuardrailConfig;
+}
+export type ConnectWalletResult = Omit<SepoliaNetworkAssertionResult, 'status'> & {
+    status: 'connected';
+};
+export interface ApproveSignatureOptions {
+    prompt: WalletPromptDriver;
+    dapp?: Pick<WalletDappDriver, 'requestSignature'>;
+    origin?: string;
+    expectedAccount: string;
+    expectedChainId?: string | number;
+    network?: MetaMaskNetworkDriver;
+    message?: string;
+    guardrails?: WalletGuardrailConfig;
+    logger?: WalletControlLogger;
+    metadata?: unknown;
+}
+export interface ApproveTransactionOptions {
+    prompt: WalletPromptDriver;
+    dapp?: Pick<WalletDappDriver, 'requestTransaction'>;
+    origin?: string;
+    expectedAccount: string;
+    expectedChainId?: string | number;
+    network?: MetaMaskNetworkDriver;
+    to?: string;
+    value?: string;
+    guardrails?: WalletGuardrailConfig;
+    logger?: WalletControlLogger;
+    metadata?: unknown;
+}
+export interface ResetProfileOptions {
+    profileDir: string;
+    allowedProfileRoot?: string;
+    logger?: WalletControlLogger;
+    metadata?: unknown;
+}
+export interface ResetProfileResult {
+    status: 'deleted' | 'skipped';
+    profileDir: string;
+    allowedProfileRoot: string;
+}
+export declare function createWalletDappPageDriver(options: WalletDappPageDriverOptions): WalletDappDriver;
+export declare function connectWallet(options: ConnectWalletOptions): Promise<ConnectWalletResult>;
+export declare function approveSignature(options: ApproveSignatureOptions): Promise<void>;
+export declare function approveTransaction(options: ApproveTransactionOptions): Promise<void>;
+export declare function switchNetwork(options: WalletStateOptions): Promise<SepoliaNetworkAssertionResult>;
+export declare function assertWalletState(options: WalletStateOptions): Promise<SepoliaNetworkAssertionResult>;
+export declare function resetProfile(options: ResetProfileOptions): Promise<ResetProfileResult>;
+//# sourceMappingURL=wallet-control.d.ts.map

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

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