@marigoldlabs/web3-tester 0.1.2 → 0.4.1

package/dist/matchers.js

@@ -0,0 +1,268 @@
+import { expect as baseExpect, } from '@playwright/test';
+import { erc20Abi, parseEventLogs } from 'viem';
+import { describePanic, extractRevertInfo, isWalletRejectionError, recoverRevertInfo, renderRevertInfo, resolveClient, resolveTxHash, web3Equals, web3Stringify, } from './transactions.js';
+/** hardhat-chai-matchers `anyValue` parity for arg wildcards. */
+export const anyValue = (_value) => true;
+const ADDRESS_PATTERN = /^0x[0-9a-fA-F]{40}$/;
+const toBigInt = (value) => typeof value === 'bigint' ? value : BigInt(value);
+const badReceiver = (state, name, received) => ({
+    pass: false,
+    message: () => `${state.utils.matcherHint(name, undefined, undefined, { isNot: state.isNot })}\n\n` +
+        `Received value is not a transaction hash (or { hash }): ${web3Stringify(received)}`,
+});
+const eventArgsMatch = (logArgs, expectation, abi, eventName) => {
+    if (Array.isArray(expectation)) {
+        const positional = Array.isArray(logArgs)
+            ? [...logArgs]
+            : (() => {
+                const event = abi.find((entry) => entry.type === 'event' && 'name' in entry && entry.name === eventName);
+                return (event?.inputs ?? []).map((input, index) => input.name
+                    ? logArgs[input.name]
+                    : logArgs[index]);
+            })();
+        return expectation.every((expected, index) => expected === undefined || web3Equals(expected, positional[index]));
+    }
+    const named = (logArgs ?? {});
+    return Object.entries(expectation).every(([key, expected]) => web3Equals(expected, named[key]));
+};
+// Resolves a revert-family receiver into a uniform shape; wallet approval
+// failures are rethrown with a hint instead of counting as reverts.
+const resolveRevertReceiver = async (target, client, timeout, abi) => {
+    let resolved;
+    try {
+        resolved = typeof target === 'function' ? await target() : await target;
+    }
+    catch (error) {
+        if (isWalletRejectionError(error)) {
+            throw new Error(`The wallet rejected the request — a wallet approval failure, not a chain revert: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        const info = extractRevertInfo(error, abi);
+        if (!info) {
+            throw new Error(`The call rejected with a non-revert error: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        return { outcome: 'reverted', info };
+    }
+    const hash = await resolveTxHash(resolved);
+    if (!hash) {
+        return {
+            outcome: 'succeeded',
+            detail: `the call succeeded and resolved to ${web3Stringify(resolved)}`,
+        };
+    }
+    const receipt = await client.waitForTransactionReceipt({ hash, timeout });
+    if (receipt.status === 'success') {
+        return {
+            outcome: 'succeeded',
+            detail: `transaction ${hash} succeeded (gasUsed ${receipt.gasUsed})`,
+        };
+    }
+    return {
+        outcome: 'reverted',
+        info: await recoverRevertInfo(client, hash, receipt, abi),
+        gasUsed: receipt.gasUsed,
+    };
+};
+const balanceChangeMatcher = async (state, name, target, chain, changes, options, readBalance, feeAdjustable) => {
+    const client = resolveClient(chain);
+    const hash = await resolveTxHash(target);
+    if (!hash) {
+        return badReceiver(state, name, await target);
+    }
+    const receipt = await client.waitForTransactionReceipt({
+        hash,
+        timeout: options.timeout ?? state.timeout,
+    });
+    const observed = [];
+    for (const change of changes) {
+        const after = await readBalance(client, change.address, receipt.blockNumber);
+        const before = await readBalance(client, change.address, receipt.blockNumber - 1n);
+        let delta = after - before;
+        // hardhat parity: the sender's gas fee is excluded unless includeFee.
+        if (feeAdjustable &&
+            !options.includeFee &&
+            change.address.toLowerCase() === receipt.from.toLowerCase()) {
+            delta += receipt.gasUsed * receipt.effectiveGasPrice;
+        }
+        observed.push({ address: change.address, expected: toBigInt(change.delta), actual: delta });
+    }
+    const pass = observed.every((entry) => entry.expected === entry.actual);
+    const message = async () => {
+        const lines = observed.map((entry) => `  ${entry.address}: expected ${entry.expected}, observed ${entry.actual}${entry.expected === entry.actual ? '' : '  ←'}`);
+        const block = await client.getBlock({ blockNumber: receipt.blockNumber }).catch(() => undefined);
+        const crowded = block && block.transactions.length > 1
+            ? `\n${block.transactions.length - 1} other transaction(s) share this block and may also have moved balances.`
+            : '';
+        return (`${state.utils.matcherHint(name, undefined, undefined, { isNot: state.isNot })}\n\n` +
+            `Transaction ${hash} (block ${receipt.blockNumber}):\n${lines.join('\n')}${crowded}`);
+    };
+    const rendered = await message();
+    return {
+        pass,
+        message: () => rendered,
+        expected: observed.map((entry) => `${entry.address}: ${entry.expected}`),
+        actual: observed.map((entry) => `${entry.address}: ${entry.actual}`),
+    };
+};
+const erc20Balance = (token) => async (client, address, blockNumber) => (await client.readContract({
+    address: token,
+    abi: erc20Abi,
+    functionName: 'balanceOf',
+    args: [address],
+    blockNumber,
+}));
+export const web3Matchers = {
+    async toEmitEvent(target, chain, abi, eventName, options = {}) {
+        const client = resolveClient(chain);
+        const hash = await resolveTxHash(target);
+        if (!hash) {
+            return badReceiver(this, 'toEmitEvent', await target);
+        }
+        const receipt = await client.waitForTransactionReceipt({
+            hash,
+            timeout: options.timeout ?? this.timeout,
+        });
+        const decoded = parseEventLogs({ abi, logs: receipt.logs, strict: false });
+        // parseEventLogs silently drops foreign-topic0 logs; surface them by diff.
+        const decodedIndexes = new Set(decoded.map((log) => log.logIndex));
+        const undecodable = receipt.logs.filter((log) => !decodedIndexes.has(log.logIndex));
+        let candidates = decoded.filter((log) => log.eventName === eventName);
+        if (options.address) {
+            candidates = candidates.filter((log) => log.address.toLowerCase() === options.address.toLowerCase());
+        }
+        const matching = options.args === undefined
+            ? candidates
+            : candidates.filter((log) => eventArgsMatch(log.args, options.args, abi, eventName));
+        const pass = options.count !== undefined ? matching.length === options.count : matching.length >= 1;
+        const emitted = decoded.map((log) => `  ${log.eventName}(${web3Stringify(log.args).replace(/\n\s*/g, ' ')}) @ ${log.address}`);
+        const extras = undecodable.map((log) => `  <undecodable> topic0=${log.topics[0]} @ ${log.address}`);
+        const revertedNote = receipt.status !== 'success'
+            ? '\nThe transaction REVERTED — reverted transactions emit no events.'
+            : '';
+        return {
+            pass,
+            message: () => `${this.utils.matcherHint('toEmitEvent', undefined, eventName, { isNot: this.isNot })}\n\n` +
+                `Expected ${options.count !== undefined ? `exactly ${options.count}` : 'at least one'} ` +
+                `"${eventName}" event${options.args ? ` with args ${web3Stringify(options.args)}` : ''}; ` +
+                `found ${matching.length}.${revertedNote}\n` +
+                `Events in receipt:\n${[...emitted, ...extras].join('\n') || '  (none)'}`,
+            expected: options.args,
+            actual: candidates.map((log) => log.args),
+        };
+    },
+    async toChangeBalance(target, chain, address, delta, options = {}) {
+        return balanceChangeMatcher(this, 'toChangeBalance', target, chain, [{ address, delta }], options, (client, holder, blockNumber) => client.getBalance({ address: holder, blockNumber }), true);
+    },
+    async toChangeBalances(target, chain, changes, options = {}) {
+        return balanceChangeMatcher(this, 'toChangeBalances', target, chain, changes, options, (client, holder, blockNumber) => client.getBalance({ address: holder, blockNumber }), true);
+    },
+    async toChangeTokenBalance(target, chain, token, address, delta, options = {}) {
+        return balanceChangeMatcher(this, 'toChangeTokenBalance', target, chain, [{ address, delta }], options, erc20Balance(token), false);
+    },
+    async toChangeTokenBalances(target, chain, token, changes, options = {}) {
+        return balanceChangeMatcher(this, 'toChangeTokenBalances', target, chain, changes, options, erc20Balance(token), false);
+    },
+    async toBeReverted(target, chain, options = {}) {
+        const result = await resolveRevertReceiver(target, resolveClient(chain), options.timeout ?? this.timeout, undefined);
+        return {
+            pass: result.outcome === 'reverted',
+            message: () => `${this.utils.matcherHint('toBeReverted', undefined, undefined, { isNot: this.isNot })}\n\n` +
+                (result.outcome === 'reverted'
+                    ? `Reverted with ${renderRevertInfo(result.info)}.`
+                    : `Expected a revert, but ${result.detail}.`),
+        };
+    },
+    async toBeRevertedWith(target, chain, reason, options = {}) {
+        const result = await resolveRevertReceiver(target, resolveClient(chain), options.timeout ?? this.timeout, undefined);
+        let pass = false;
+        let detail;
+        if (result.outcome === 'succeeded') {
+            detail = `Expected a revert, but ${result.detail}.`;
+        }
+        else if (result.info.kind === 'reason') {
+            pass =
+                typeof reason === 'string' ? result.info.reason === reason : reason.test(result.info.reason);
+            detail = `Reverted with Error("${result.info.reason}").`;
+        }
+        else {
+            detail = `Reverted, but not with an Error(string): ${renderRevertInfo(result.info)}.`;
+        }
+        return {
+            pass,
+            message: () => `${this.utils.matcherHint('toBeRevertedWith', undefined, String(reason), { isNot: this.isNot })}\n\n${detail}`,
+            expected: String(reason),
+            actual: result.outcome === 'reverted' ? renderRevertInfo(result.info) : 'success',
+        };
+    },
+    async toBeRevertedWithCustomError(target, chain, abi, errorName, options = {}) {
+        const result = await resolveRevertReceiver(target, resolveClient(chain), options.timeout ?? this.timeout, abi);
+        let pass = false;
+        let detail;
+        if (result.outcome === 'succeeded') {
+            detail = `Expected a revert, but ${result.detail}.`;
+        }
+        else if (result.info.kind === 'custom') {
+            pass =
+                result.info.errorName === errorName &&
+                    (options.args === undefined ||
+                        web3Equals([...options.args], [...(result.info.args ?? [])]));
+            detail = `Reverted with ${renderRevertInfo(result.info)}.`;
+        }
+        else {
+            detail = `Reverted, but not with a custom error: ${renderRevertInfo(result.info)}.`;
+        }
+        return {
+            pass,
+            message: () => `${this.utils.matcherHint('toBeRevertedWithCustomError', undefined, errorName, { isNot: this.isNot })}\n\n${detail}`,
+            expected: `${errorName}(${(options.args ?? []).map(String).join(', ')})`,
+            actual: result.outcome === 'reverted' ? renderRevertInfo(result.info) : 'success',
+        };
+    },
+    async toBeRevertedWithPanic(target, chain, code, options = {}) {
+        const result = await resolveRevertReceiver(target, resolveClient(chain), options.timeout ?? this.timeout, undefined);
+        let pass = false;
+        let detail;
+        if (result.outcome === 'succeeded') {
+            detail = `Expected a panic, but ${result.detail}.`;
+        }
+        else if (result.info.kind === 'panic') {
+            pass = code === undefined || BigInt(code) === result.info.code;
+            detail = `Reverted with ${renderRevertInfo(result.info)}.`;
+        }
+        else {
+            detail = `Reverted, but not with a Panic: ${renderRevertInfo(result.info)}.`;
+        }
+        return {
+            pass,
+            message: () => `${this.utils.matcherHint('toBeRevertedWithPanic', undefined, code === undefined ? '' : `0x${BigInt(code).toString(16)} (${describePanic(BigInt(code))})`, { isNot: this.isNot })}\n\n${detail}`,
+        };
+    },
+    async toHaveTokenBalance(holder, chain, token, expected) {
+        // Address and tx-hash are both `0x${string}` — catch 32-byte receivers.
+        if (typeof holder !== 'string' || !ADDRESS_PATTERN.test(holder)) {
+            return {
+                pass: false,
+                message: () => `${this.utils.matcherHint('toHaveTokenBalance', undefined, undefined, { isNot: this.isNot })}\n\n` +
+                    `Received value is not a 20-byte address: ${web3Stringify(holder)}`,
+            };
+        }
+        const client = resolveClient(chain);
+        const balance = (await client.readContract({
+            address: token,
+            abi: erc20Abi,
+            functionName: 'balanceOf',
+            args: [holder],
+        }));
+        const pass = typeof expected === 'function' ? Boolean(expected(balance)) : toBigInt(expected) === balance;
+        return {
+            pass,
+            message: () => `${this.utils.matcherHint('toHaveTokenBalance', undefined, undefined, { isNot: this.isNot })}\n\n` +
+                `Token ${token} balance of ${holder}: ${balance}` +
+                (typeof expected === 'function' ? ' (predicate)' : `, expected ${toBigInt(expected)}`),
+            expected: typeof expected === 'function' ? 'predicate' : toBigInt(expected).toString(),
+            actual: balance.toString(),
+        };
+    },
+};
+/** Pre-extended expect carrying every web3 matcher, fully typed. */
+export const expect = baseExpect.extend(web3Matchers);
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

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

package/dist/metamask-extension.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The MetaMask build the adapter's selectors are maintained against. Bump
+ * deliberately and re-run the real-wallet smoke suite when changing it
+ * (`npm run smoke:real-wallet`).
+ *
+ * The adapter drives one UI generation per launch as explicit configuration
+ * (derived from the extension manifest, overridable via the `generation`
+ * option): 13.x (the "multichain" UI) is validated end to end and gates
+ * releases; the last 12.x line stays supported on a best-effort cadence. Set
+ * WEB3_TESTER_METAMASK_VERSION=12.23.1 to drive the older generation.
+ */
+export declare const DEFAULT_METAMASK_VERSION = "13.34.1";
+export type PrepareMetaMaskExtensionOptions = {
+    /** Release version, e.g. "13.34.1". Defaults to WEB3_TESTER_METAMASK_VERSION or the pinned default. */
+    version?: string;
+    /** Directory unpacked extensions are cached in. Defaults to ~/.cache/web3-tester/metamask. */
+    cacheDir?: string;
+    /** Full download URL override (e.g. an internal mirror). */
+    downloadUrl?: string;
+    /** Optional sha256 (hex) of the zip for integrity verification. */
+    sha256?: string;
+    /** Re-download even if a cached copy exists. */
+    force?: boolean;
+};
+export declare const defaultExtensionCacheDir: () => string;
+/**
+ * Downloads and unpacks a pinned MetaMask release into a local cache and
+ * returns the unpacked extension directory, suitable for
+ * launchRealWallet({ extensionPath }). Subsequent calls hit the cache.
+ */
+export declare function prepareMetaMaskExtension(options?: PrepareMetaMaskExtensionOptions): Promise<string>;
+/** Reads the version field of an unpacked extension's manifest.json. */
+export declare function extensionManifestVersion(extensionPath: string): string;
+//# sourceMappingURL=metamask-extension.d.ts.map

package/dist/metamask-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamask-extension.d.ts","sourceRoot":"","sources":["../src/metamask-extension.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,uGAAuG;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAO,MACkB,CAAC;AA0B/D;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAuDjB;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOtE"}

package/dist/metamask-extension.js

@@ -0,0 +1,97 @@
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { once } from 'node:events';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * The MetaMask build the adapter's selectors are maintained against. Bump
+ * deliberately and re-run the real-wallet smoke suite when changing it
+ * (`npm run smoke:real-wallet`).
+ *
+ * The adapter drives one UI generation per launch as explicit configuration
+ * (derived from the extension manifest, overridable via the `generation`
+ * option): 13.x (the "multichain" UI) is validated end to end and gates
+ * releases; the last 12.x line stays supported on a best-effort cadence. Set
+ * WEB3_TESTER_METAMASK_VERSION=12.23.1 to drive the older generation.
+ */
+export const DEFAULT_METAMASK_VERSION = '13.34.1';
+export const defaultExtensionCacheDir = () => path.join(os.homedir(), '.cache', 'web3-tester', 'metamask');
+const releaseUrl = (version) => `https://github.com/MetaMask/metamask-extension/releases/download/v${version}/metamask-chrome-${version}.zip`;
+const unzip = async (zipPath, destination) => {
+    const [command, args] = process.platform === 'win32'
+        ? [
+            'powershell.exe',
+            ['-NoProfile', '-Command', `Expand-Archive -LiteralPath '${zipPath}' -DestinationPath '${destination}' -Force`],
+        ]
+        : ['unzip', ['-o', '-q', zipPath, '-d', destination]];
+    const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+    let stderr = '';
+    child.stderr.on('data', (chunk) => {
+        stderr += chunk.toString();
+    });
+    const [code] = (await once(child, 'exit'));
+    if (code !== 0) {
+        throw new Error(`Failed to unzip MetaMask extension (${command} exited with ${code}).\n${stderr}`);
+    }
+};
+/**
+ * Downloads and unpacks a pinned MetaMask release into a local cache and
+ * returns the unpacked extension directory, suitable for
+ * launchRealWallet({ extensionPath }). Subsequent calls hit the cache.
+ */
+export async function prepareMetaMaskExtension(options = {}) {
+    // `||` (not `??`): an empty env var (e.g. a workflow_dispatch input left
+    // blank) must fall through to the pinned default, not become version "".
+    const version = options.version || process.env.WEB3_TESTER_METAMASK_VERSION || DEFAULT_METAMASK_VERSION;
+    const cacheDir = options.cacheDir ?? defaultExtensionCacheDir();
+    const destination = path.join(cacheDir, `metamask-chrome-${version}`);
+    const manifestPath = path.join(destination, 'manifest.json');
+    if (!options.force && fs.existsSync(manifestPath)) {
+        return destination;
+    }
+    const url = options.downloadUrl ?? releaseUrl(version);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download MetaMask ${version} from ${url}: HTTP ${response.status}. ` +
+            `Check the version exists (https://github.com/MetaMask/metamask-extension/releases) ` +
+            `or set WEB3_TESTER_METAMASK_VERSION / options.version.`);
+    }
+    const zipBytes = Buffer.from(await response.arrayBuffer());
+    if (options.sha256) {
+        const actual = createHash('sha256').update(zipBytes).digest('hex');
+        if (actual !== options.sha256.toLowerCase()) {
+            throw new Error(`MetaMask ${version} download failed integrity check: expected sha256 ${options.sha256}, got ${actual}.`);
+        }
+    }
+    fs.mkdirSync(cacheDir, { recursive: true });
+    const zipPath = path.join(cacheDir, `metamask-chrome-${version}.zip`);
+    fs.writeFileSync(zipPath, zipBytes);
+    // Extract into a staging directory and rename so a partially extracted
+    // cache entry can never be mistaken for a complete one.
+    const staging = `${destination}.tmp-${process.pid}`;
+    fs.rmSync(staging, { recursive: true, force: true });
+    try {
+        await unzip(zipPath, staging);
+        if (!fs.existsSync(path.join(staging, 'manifest.json'))) {
+            throw new Error(`MetaMask zip for ${version} did not contain a manifest.json at its root.`);
+        }
+        fs.rmSync(destination, { recursive: true, force: true });
+        fs.renameSync(staging, destination);
+    }
+    finally {
+        fs.rmSync(staging, { recursive: true, force: true });
+        fs.rmSync(zipPath, { force: true });
+    }
+    return destination;
+}
+/** Reads the version field of an unpacked extension's manifest.json. */
+export function extensionManifestVersion(extensionPath) {
+    const manifestPath = path.join(extensionPath, 'manifest.json');
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    if (!manifest.version) {
+        throw new Error(`No version field in ${manifestPath}.`);
+    }
+    return manifest.version;
+}
+//# sourceMappingURL=metamask-extension.js.map

package/dist/metamask-extension.js.map

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