@marigoldlabs/web3-tester 0.1.2 → 0.4.2

package/dist/real-wallet-cache.js

@@ -0,0 +1,331 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { mnemonicToAccount } from 'viem/accounts';
+import { extensionManifestVersion } from './metamask-extension.js';
+import { launchRealWalletExtension, readExtensionManifest, } from './real-wallet-extension.js';
+import { passwordForSetup } from './real-wallet-setup.js';
+import { launchRealWallet, resolveRealWalletProfile, } from './real-wallet.js';
+const READY_MARKER = '.web3-tester-profile-ready';
+const METAMASK_PROFILE_CACHE_SCHEMA = 2;
+// Chromium singleton artifacts must never travel with a cloned profile.
+const SINGLETON_FILES = ['SingletonLock', 'SingletonCookie', 'SingletonSocket'];
+// Regenerable Chromium cache subtrees dominate a cached profile's size;
+// pruning them before the copy makes clones ~3x faster and ~75% smaller.
+// 'Local Extension Settings' (the MetaMask vault) and 'IndexedDB' (13.x
+// debounced extension state) must always travel — never list them here.
+const SKIP_CLONE_DIRS = new Set([
+    'Cache',
+    'Code Cache',
+    'DawnGraphiteCache',
+    'DawnWebGPUCache',
+    'GPUCache',
+    'GraphiteDawnCache',
+    'GrShaderCache',
+    'Service Worker',
+    'ShaderCache',
+    'component_crx_cache',
+    'extensions_crx_cache',
+]);
+/**
+ * Polls the profile's extension storage (IndexedDB leveldb + blob and Local
+ * Extension Settings) from Node until a write newer than `since` lands and
+ * the directories stay quiet for `quietMs` (default 1500ms — 500ms of margin
+ * above MetaMask 13.x's verified 1000ms OperationSafener debounce). Times
+ * out silently; the customize-persistence smoke test is the regression trap
+ * for a missed flush.
+ */
+export async function waitForExtensionStatePersisted(profileDir, extensionId, options = {}) {
+    const since = options.since ?? Date.now();
+    const quietMs = options.quietMs ?? 1_500;
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    // A consumer profileDir can itself be a Chrome "Default"/"Profile N"
+    // directory; resolve the actual profile root the same way launch does.
+    const profile = resolveRealWalletProfile(profileDir);
+    const root = profile.profileDirectory
+        ? path.join(profile.userDataDir, profile.profileDirectory)
+        : path.join(profile.userDataDir, 'Default');
+    const watched = [
+        path.join(root, 'IndexedDB', `chrome-extension_${extensionId}_0.indexeddb.leveldb`),
+        path.join(root, 'IndexedDB', `chrome-extension_${extensionId}_0.indexeddb.blob`),
+        path.join(root, 'Local Extension Settings', extensionId),
+    ];
+    const newestWrite = () => {
+        let newest = 0;
+        for (const dir of watched) {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                try {
+                    const mtime = fs.statSync(path.join(dir, entry)).mtimeMs;
+                    if (mtime > newest)
+                        newest = mtime;
+                }
+                catch {
+                    // File rotated away mid-scan.
+                }
+            }
+        }
+        return newest;
+    };
+    const deadline = Date.now() + timeoutMs;
+    let lastSeen = 0;
+    let quietSince = 0;
+    while (Date.now() < deadline) {
+        const newest = newestWrite();
+        if (newest > since) {
+            if (newest !== lastSeen) {
+                lastSeen = newest;
+                quietSince = Date.now();
+            }
+            else if (Date.now() - quietSince >= quietMs) {
+                return;
+            }
+        }
+        await sleep(250);
+    }
+}
+export const defaultProfileCacheDir = () => path.join(os.homedir(), '.cache', 'web3-tester', 'profiles');
+const cacheKey = (options) => createHash('sha256')
+    .update(JSON.stringify({
+    cacheSchema: METAMASK_PROFILE_CACHE_SCHEMA,
+    seedPhrase: options.setup.seedPhrase,
+    password: passwordForSetup(options.setup),
+    extensionVersion: extensionManifestVersion(options.extensionPath),
+    customizeKey: options.customize?.key,
+}))
+    .digest('hex')
+    .slice(0, 16);
+const extensionProfileCacheKey = (options) => {
+    const manifest = readExtensionManifest(options.extensionPath);
+    const userKey = options.cacheKey.trim();
+    if (!userKey) {
+        throw new Error('buildWalletExtensionProfile requires a non-empty cacheKey.');
+    }
+    return createHash('sha256')
+        .update(JSON.stringify({
+        kind: 'real-wallet-extension',
+        extensionPath: path.resolve(options.extensionPath),
+        extensionId: options.extensionId,
+        extensionName: options.extensionName,
+        manifestName: manifest.name,
+        manifestVersion: manifest.version,
+        initialPage: options.initialPage,
+        userKey,
+    }))
+        .digest('hex')
+        .slice(0, 16);
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const buildCachedProfile = async (options) => {
+    const cacheDir = options.cacheDir ?? defaultProfileCacheDir();
+    const profileDir = path.join(cacheDir, options.cacheKey);
+    const marker = path.join(profileDir, READY_MARKER);
+    if (options.force) {
+        fs.rmSync(profileDir, { recursive: true, force: true });
+    }
+    else if (fs.existsSync(marker)) {
+        return profileDir;
+    }
+    // mkdir is atomic: exactly one concurrent builder wins the lock; the rest
+    // wait for the ready marker. Locks left behind by killed builders are
+    // considered stale after 5 minutes and stolen.
+    const lockDir = `${profileDir}.lock`;
+    const lockIsStale = () => {
+        try {
+            return Date.now() - fs.statSync(lockDir).mtimeMs > 300_000;
+        }
+        catch {
+            return false;
+        }
+    };
+    fs.mkdirSync(cacheDir, { recursive: true });
+    try {
+        fs.mkdirSync(lockDir);
+    }
+    catch {
+        if (lockIsStale()) {
+            fs.rmSync(lockDir, { recursive: true, force: true });
+            return buildCachedProfile(options);
+        }
+        // Keep waiting as long as the builder's lock stays fresh — the builder
+        // heartbeats the lock every 60s precisely because setup/customize builds
+        // can run well past the 5-minute stale threshold. A fixed deadline
+        // shorter than that would abandon a healthy builder. The hard ceiling
+        // only backstops a hang that somehow keeps the lock fresh without
+        // finishing.
+        const deadline = Date.now() + 1_800_000;
+        while (Date.now() < deadline) {
+            if (fs.existsSync(marker)) {
+                return profileDir;
+            }
+            if (!fs.existsSync(lockDir) || lockIsStale()) {
+                fs.rmSync(lockDir, { recursive: true, force: true });
+                return buildCachedProfile(options);
+            }
+            await sleep(250);
+        }
+        throw new Error(`Timed out waiting for another process to finish building the ${options.label} at ${profileDir}.`);
+    }
+    const heartbeat = setInterval(() => {
+        try {
+            const now = new Date();
+            fs.utimesSync(lockDir, now, now);
+        }
+        catch {
+            // Lock already gone — the finally below is about to run anyway.
+        }
+    }, 60_000);
+    heartbeat.unref?.();
+    try {
+        fs.rmSync(profileDir, { recursive: true, force: true });
+        fs.mkdirSync(profileDir, { recursive: true });
+        await options.build(profileDir);
+        fs.writeFileSync(marker, JSON.stringify({ createdAt: new Date().toISOString() }));
+        return profileDir;
+    }
+    catch (error) {
+        fs.rmSync(profileDir, { recursive: true, force: true });
+        throw error;
+    }
+    finally {
+        clearInterval(heartbeat);
+        fs.rmSync(lockDir, { recursive: true, force: true });
+    }
+};
+/**
+ * Builds (once) and returns a cached, fully onboarded MetaMask profile
+ * directory keyed by (seed phrase, password, extension version). The first
+ * call walks MetaMask onboarding in a real browser; subsequent calls return
+ * instantly. Use cloneWalletProfile to obtain a disposable per-test copy —
+ * never launch the cached directory directly.
+ */
+export async function buildWalletProfile(options) {
+    const seedPhrase = options.setup.seedPhrase;
+    if (!seedPhrase) {
+        throw new Error('buildWalletProfile requires setup.seedPhrase.');
+    }
+    return buildCachedProfile({
+        cacheDir: options.cacheDir,
+        cacheKey: cacheKey(options),
+        force: options.force,
+        label: 'wallet profile',
+        build: async (profileDir) => {
+            const onboardStartedAt = Date.now();
+            const session = await launchRealWallet({
+                extensionPath: options.extensionPath,
+                profileDir,
+                setup: options.setup,
+                headless: options.headless,
+                generation: options.generation,
+                // Verifying against the seed-derived address guarantees the build
+                // actually imported a wallet — a silently skipped onboarding would
+                // otherwise produce a cached profile with no vault.
+                expectedAddress: mnemonicToAccount(seedPhrase).address,
+            });
+            try {
+                // 13.x flushes extension state through a debounced write (safe-reload's
+                // OperationSafener, a 1000ms trailing-edge debounce around
+                // persistenceManager.set()); wait for the post-onboarding (and, when
+                // customizing, post-mutation) write to land and stay quiet before
+                // closing — a missed flush silently replays onboarding or loses the
+                // customization.
+                if (options.customize) {
+                    const mutationsStartedAt = Date.now();
+                    await options.customize.run(session);
+                    await waitForExtensionStatePersisted(profileDir, session.extensionId, {
+                        since: mutationsStartedAt,
+                        timeoutMs: 20_000,
+                    });
+                }
+                else {
+                    await waitForExtensionStatePersisted(profileDir, session.extensionId, {
+                        since: onboardStartedAt,
+                        timeoutMs: 15_000,
+                    });
+                }
+            }
+            finally {
+                await session.close();
+            }
+        },
+    });
+}
+/**
+ * Builds (once) and returns a cached profile for any unpacked Chromium wallet
+ * extension. The caller owns wallet-specific onboarding/unlock selectors in
+ * `setup.run`; this helper only supplies the persistent profile, extension
+ * launch, cache locking, ready marker, and optional extension-state flush.
+ * Use cloneWalletProfile to obtain disposable per-test copies.
+ */
+export async function buildWalletExtensionProfile(options) {
+    return buildCachedProfile({
+        cacheDir: options.cacheDir,
+        cacheKey: extensionProfileCacheKey(options),
+        force: options.force,
+        label: 'wallet extension profile',
+        build: async (profileDir) => {
+            const session = await launchRealWalletExtension({
+                baseURL: options.baseURL,
+                extensionId: options.extensionId,
+                extensionName: options.extensionName,
+                extensionPath: options.extensionPath,
+                headless: options.headless,
+                initialPage: options.initialPage,
+                launchArgs: options.launchArgs,
+                locale: options.locale,
+                profileDir,
+                slowMo: options.slowMo,
+            });
+            try {
+                if (options.setup) {
+                    const setupStartedAt = Date.now();
+                    await options.setup.run(session);
+                    const waitForState = options.waitForState ?? true;
+                    if (waitForState) {
+                        await waitForExtensionStatePersisted(profileDir, session.extensionId, {
+                            since: setupStartedAt,
+                            ...(typeof waitForState === 'object' ? waitForState : {}),
+                        });
+                    }
+                }
+                else if (options.waitForState && typeof options.waitForState === 'object') {
+                    await waitForExtensionStatePersisted(profileDir, session.extensionId, options.waitForState);
+                }
+                else if (options.waitForState === true) {
+                    await waitForExtensionStatePersisted(profileDir, session.extensionId);
+                }
+            }
+            finally {
+                await session.close();
+            }
+        },
+    });
+}
+/**
+ * Copies a cached profile into a disposable directory (per test or per
+ * worker) so parallel runs never collide on Chromium's profile singleton
+ * lock and tests cannot dirty the cache.
+ */
+export async function cloneWalletProfile(cachedProfileDir, targetDir) {
+    if (!fs.existsSync(path.join(cachedProfileDir, READY_MARKER))) {
+        throw new Error(`${cachedProfileDir} is not a completed web3-tester profile cache (missing ${READY_MARKER}).`);
+    }
+    fs.rmSync(targetDir, { recursive: true, force: true });
+    fs.cpSync(cachedProfileDir, targetDir, {
+        recursive: true,
+        // Returning false for a directory prunes its whole subtree.
+        filter: (source) => !SKIP_CLONE_DIRS.has(path.basename(source)),
+    });
+    for (const file of [READY_MARKER, ...SINGLETON_FILES]) {
+        fs.rmSync(path.join(targetDir, file), { force: true });
+    }
+    return targetDir;
+}
+//# sourceMappingURL=real-wallet-cache.js.map

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

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

package/dist/real-wallet-extension-fixtures.d.ts

@@ -0,0 +1,35 @@
+import { type BuildWalletExtensionProfileOptions } from './real-wallet-cache.js';
+import { type RealWalletExtensionLaunchOptions, type RealWalletExtensionSession } from './real-wallet-extension.js';
+export type RealWalletExtensionFixtureOptions = Omit<RealWalletExtensionLaunchOptions, 'extensionPath' | 'profileDir'> & {
+    /** Unpacked Chromium extension directory. Defaults to WEB3_TESTER_REAL_WALLET_EXTENSION_PATH. */
+    extensionPath?: string;
+    /**
+     * Explicit persistent profile directory. Disables the profile cache; the
+     * test reuses (and mutates) this profile directly, so parallel tests must
+     * not share it.
+     */
+    profileDir?: string;
+    /** Cache identity for non-MetaMask setup. Required when profileDir is absent. */
+    profileCacheKey?: string;
+    /** Directory cached profiles live in. Defaults to ~/.cache/web3-tester/profiles. */
+    cacheDir?: string;
+    /** Rebuild the cached profile even if it already exists. */
+    forceProfile?: boolean;
+    /** One-time extension setup baked into the cached profile. */
+    profileSetup?: BuildWalletExtensionProfileOptions['setup'];
+    /** Wait policy after profileSetup. Defaults to buildWalletExtensionProfile's behavior. */
+    waitForState?: BuildWalletExtensionProfileOptions['waitForState'];
+};
+export type RealWalletExtensionFixtures = {
+    realWalletExtensionOptions: RealWalletExtensionFixtureOptions;
+    realWalletExtension: RealWalletExtensionSession;
+};
+/**
+ * Playwright fixtures for arbitrary Chromium wallet extensions. Each test
+ * gets either the explicit profileDir or a disposable clone of a cached
+ * profile prepared by profileSetup. `context` and `page` are rebound to the
+ * persistent extension context.
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & RealWalletExtensionFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from './matchers.js';
+//# sourceMappingURL=real-wallet-extension-fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"real-wallet-extension-fixtures.d.ts","sourceRoot":"","sources":["../src/real-wallet-extension-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kCAAkC,EACxC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEL,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,gCAAgC,EAChC,eAAe,GAAG,YAAY,CAC/B,GAAG;IACF,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,kCAAkC,CAAC,OAAO,CAAC,CAAC;IAC3D,0FAA0F;IAC1F,YAAY,CAAC,EAAE,kCAAkC,CAAC,cAAc,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,0BAA0B,EAAE,iCAAiC,CAAC;IAC9D,mBAAmB,EAAE,0BAA0B,CAAC;CACjD,CAAC;AAkBF;;;;;GAKG;AACH,eAAO,MAAM,IAAI,2QA+Ff,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/real-wallet-extension-fixtures.js

@@ -0,0 +1,96 @@
+import path from 'node:path';
+import { test as base } from '@playwright/test';
+import { buildWalletExtensionProfile, cloneWalletProfile, } from './real-wallet-cache.js';
+import { benchmarkForTest, benchmarkObjectMethods } from './benchmark.js';
+import { launchRealWalletExtension, } from './real-wallet-extension.js';
+const extensionPathFromEnv = () => process.env.WEB3_TESTER_REAL_WALLET_EXTENSION_PATH || undefined;
+const profileDirFromEnv = () => process.env.WEB3_TESTER_REAL_WALLET_PROFILE_DIR || undefined;
+const assertChromiumProject = (browserName) => {
+    if (browserName !== 'chromium') {
+        throw new Error('@marigoldlabs/web3-tester/real-wallet-extension-fixtures launch a Chromium extension context. ' +
+            `The current Playwright project uses "${browserName}". Exclude real-extension tests from non-Chromium ` +
+            'projects, or run them in a dedicated Chromium project.');
+    }
+};
+/**
+ * Playwright fixtures for arbitrary Chromium wallet extensions. Each test
+ * gets either the explicit profileDir or a disposable clone of a cached
+ * profile prepared by profileSetup. `context` and `page` are rebound to the
+ * persistent extension context.
+ */
+export const test = base.extend({
+    realWalletExtensionOptions: [
+        async ({}, use) => {
+            await use({});
+        },
+        { option: true },
+    ],
+    realWalletExtension: async ({ realWalletExtensionOptions, browserName }, use, testInfo) => {
+        assertChromiumProject(browserName);
+        const benchmark = benchmarkForTest(testInfo, { suite: 'real-wallet-extension' });
+        let session;
+        try {
+            const options = realWalletExtensionOptions;
+            const extensionPath = options.extensionPath ?? extensionPathFromEnv();
+            if (!extensionPath) {
+                throw new Error('Real-wallet extension fixtures need extensionPath or ' +
+                    'WEB3_TESTER_REAL_WALLET_EXTENSION_PATH pointing at an unpacked Chromium wallet extension.');
+            }
+            let profileDir = options.profileDir ?? profileDirFromEnv();
+            if (!profileDir) {
+                if (!options.profileCacheKey) {
+                    throw new Error('Real-wallet extension fixtures need profileCacheKey to build a cached profile, ' +
+                        'or an explicit profileDir pointing at a prepared wallet profile.');
+                }
+                const profileCacheKey = options.profileCacheKey;
+                const cachedProfile = await benchmark.measure('realWalletExtension.buildProfile', () => buildWalletExtensionProfile({
+                    baseURL: options.baseURL,
+                    cacheDir: options.cacheDir,
+                    cacheKey: profileCacheKey,
+                    extensionId: options.extensionId,
+                    extensionName: options.extensionName,
+                    extensionPath,
+                    force: options.forceProfile,
+                    headless: options.headless,
+                    initialPage: options.initialPage,
+                    launchArgs: options.launchArgs,
+                    locale: options.locale,
+                    setup: options.profileSetup,
+                    slowMo: options.slowMo,
+                    waitForState: options.waitForState,
+                }));
+                profileDir = await benchmark.measure('realWalletExtension.cloneProfile', () => cloneWalletProfile(cachedProfile, path.join(testInfo.outputDir, 'wallet-extension-profile')));
+            }
+            session = await benchmark.measure('realWalletExtension.launch', () => launchRealWalletExtension({
+                baseURL: options.baseURL,
+                extensionId: options.extensionId,
+                extensionName: options.extensionName,
+                extensionPath,
+                headless: options.headless,
+                initialPage: options.initialPage,
+                launchArgs: options.launchArgs,
+                locale: options.locale,
+                profileDir,
+                slowMo: options.slowMo,
+            }));
+            await use(benchmarkObjectMethods(session, benchmark, { prefix: 'realWalletExtension', exclude: ['close'] }));
+        }
+        finally {
+            if (session) {
+                const activeSession = session;
+                await benchmark.measure('realWalletExtension.close', () => activeSession.close().catch(() => undefined));
+            }
+            await benchmark.flush();
+        }
+    },
+    context: async ({ realWalletExtension }, use) => {
+        await use(realWalletExtension.context);
+    },
+    page: async ({ context }, use) => {
+        const page = await context.newPage();
+        await use(page);
+        await page.close().catch(() => undefined);
+    },
+});
+export { expect } from './matchers.js';
+//# sourceMappingURL=real-wallet-extension-fixtures.js.map

package/dist/real-wallet-extension-fixtures.js.map

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

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

@@ -0,0 +1,86 @@
+import { type BrowserContext, type Page } from '@playwright/test';
+export type RealWalletProfile = {
+    profileDirectory?: string;
+    userDataDir: string;
+};
+export type BrowserExtensionManifest = {
+    manifest_version?: number;
+    name?: string;
+    version?: string;
+    action?: {
+        default_popup?: string;
+    };
+    browser_action?: {
+        default_popup?: string;
+    };
+    options_ui?: {
+        page?: string;
+    };
+    side_panel?: {
+        default_path?: string;
+    };
+    [key: string]: unknown;
+};
+export type RealWalletExtensionLaunchOptions = {
+    baseURL?: string;
+    /**
+     * Exact Chrome extension display name used when runtime/service-worker
+     * discovery is inconclusive. For localized manifests (`__MSG_*__`), pass
+     * this explicitly or pass `extensionId`.
+     */
+    extensionName?: string;
+    /**
+     * Known extension ID. Useful for persistent profiles that already have a
+     * wallet installed or for extensions without a service worker.
+     */
+    extensionId?: string;
+    /** Path to an unpacked Chrome extension directory. */
+    extensionPath: string;
+    /**
+     * Run the browser headless. There is deliberately no default — choose
+     * explicitly here or via WEB3_TESTER_REAL_WALLET_HEADLESS=true|false.
+     */
+    headless?: boolean;
+    /**
+     * Extension page to open after launch. Defaults to the manifest action
+     * popup/options/side-panel page when present; pass false to leave all
+     * extension pages untouched.
+     */
+    initialPage?: string | false;
+    /** Additional Chromium launch args appended after extension args. */
+    launchArgs?: readonly string[];
+    locale?: string;
+    profileDir: string;
+    slowMo?: number;
+};
+export type RealWalletExtensionSession = {
+    close(): Promise<void>;
+    context: BrowserContext;
+    extensionId: string;
+    extensionPath: string;
+    manifest: BrowserExtensionManifest;
+    /** Page opened from `initialPage`, when configured/resolved. */
+    page?: Page;
+    profile: RealWalletProfile;
+    extensionUrl(page?: string): string;
+    openPage(page?: string): Promise<Page>;
+};
+export declare function resolveRealWalletProfile(profileDir: string): RealWalletProfile;
+/**
+ * Resolves the headed/headless choice for real-wallet extension launches.
+ * The explicit option wins over the environment.
+ */
+export declare function resolveRealWalletHeadless(explicit?: boolean): boolean;
+export declare function readExtensionManifest(extensionPath: string): BrowserExtensionManifest;
+export declare function extensionManifestName(extensionPath: string): string | undefined;
+export declare function extensionManifestDefaultPage(manifest: BrowserExtensionManifest): string | undefined;
+export declare function extensionPageUrl(extensionId: string, page?: string): string;
+export declare function resolveExtensionPageUrl(extensionId: string, page?: string): string;
+export declare function extensionIdFromUrl(url: string): string | undefined;
+export declare function discoverRealWalletExtensionId(context: BrowserContext, options?: {
+    extensionName?: string;
+    timeoutMs?: number;
+}): Promise<string>;
+export declare function openRealWalletExtensionPage(context: BrowserContext, extensionId: string, page?: string): Promise<Page>;
+export declare function launchRealWalletExtension(options: RealWalletExtensionLaunchOptions): Promise<RealWalletExtensionSession>;
+//# sourceMappingURL=real-wallet-extension.d.ts.map

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

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