@marigoldlabs/web3-tester 0.1.2 → 0.4.1

package/dist/erc20.d.ts

@@ -0,0 +1,38 @@
+import { type Address } from 'viem';
+import type { RpcClient } from './types.js';
+export { TEST_ERC20_ABI, TEST_ERC20_BYTECODE, TEST_ERC20_SOLC_VERSION, TEST_ERC20_SOURCE_SHA256, } from './contracts/test-erc20.js';
+export type Erc20StorageLayout = 'solidity' | 'vyper';
+export type Erc20SlotInfo = {
+    layout: Erc20StorageLayout;
+    /** Mapping base slot: a small integer, or an ERC-7201 namespace root. */
+    balanceSlot: bigint;
+    /** Discovered lazily on first adjustTotalSupply use. */
+    totalSupplySlot?: bigint;
+};
+export type DealErc20Options = {
+    /** forge-std deal(token,to,give,adjust) parity: shift totalSupply by the balance delta. Default false. */
+    adjustTotalSupply?: boolean;
+    /** Highest integer mapping base slot probed per layout. Default 64. */
+    maxSlot?: number;
+    /** Skip discovery with a known mapping base slot. */
+    slot?: bigint | number;
+    /** Layout used with `slot`. Default 'solidity'. */
+    layout?: Erc20StorageLayout;
+    /** Contract whose storage holds balances when it differs from `token`. */
+    storageAddress?: Address;
+};
+export declare class Erc20DealError extends Error {
+    readonly token: Address;
+    /** Candidate slots tried across both layouts. */
+    readonly probedSlots: number;
+    constructor(message: string, token: Address, 
+    /** Candidate slots tried across both layouts. */
+    probedSlots: number);
+}
+export declare function discoverErc20BalanceSlot(client: RpcClient, token: Address, holder: Address, options?: {
+    maxSlot?: number;
+    storageAddress?: Address;
+}): Promise<Erc20SlotInfo>;
+export declare function getErc20Balance(client: RpcClient, token: Address, account: Address): Promise<bigint>;
+export declare function dealErc20(client: RpcClient, token: Address, account: Address, amount: bigint, options?: DealErc20Options, cache?: Map<string, Erc20SlotInfo>): Promise<void>;
+//# sourceMappingURL=erc20.d.ts.map

package/dist/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../src/erc20.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EAEb,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0GAA0G;IAC1G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAH5B,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO;IACvB,iDAAiD;IACxC,WAAW,EAAE,MAAM;CAK/B;AAsFD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,aAAa,CAAC,CAkDxB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,EAC9B,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAoFf"}

package/dist/erc20.js

@@ -0,0 +1,229 @@
+import { encodeAbiParameters, encodeFunctionData, erc20Abi, keccak256, toHex, } from 'viem';
+export { TEST_ERC20_ABI, TEST_ERC20_BYTECODE, TEST_ERC20_SOLC_VERSION, TEST_ERC20_SOURCE_SHA256, } from './contracts/test-erc20.js';
+export class Erc20DealError extends Error {
+    token;
+    probedSlots;
+    constructor(message, token, 
+    /** Candidate slots tried across both layouts. */
+    probedSlots) {
+        super(message);
+        this.token = token;
+        this.probedSlots = probedSlots;
+        this.name = 'Erc20DealError';
+    }
+}
+const MAX_UINT256 = 2n ** 256n - 1n;
+// An improbable balance used as the discovery probe. Discovery never writes:
+// candidates are tested with eth_call state overrides (stateDiff), so a
+// crash mid-discovery cannot leave the chain dirty and probing is
+// batch-parallel safe.
+const PROBE_SENTINEL = 0xdea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1dea1n;
+// OZ v5 upgradeable ERC-20 (ERC-7201): _balances is the first struct member,
+// so the mapping base IS the namespace root; _totalSupply sits at root+2.
+const OZ_V5_ERC20_NAMESPACE_ROOT = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00n;
+const pad32 = (value) => toHex(value, { size: 32 });
+const mappingSlot = (layout, holder, base) => layout === 'solidity'
+    ? keccak256(encodeAbiParameters([{ type: 'address' }, { type: 'uint256' }], [holder, base]))
+    : keccak256(encodeAbiParameters([{ type: 'uint256' }, { type: 'address' }], [base, holder]));
+const balanceOfData = (holder) => encodeFunctionData({ abi: erc20Abi, functionName: 'balanceOf', args: [holder] });
+const totalSupplyData = () => encodeFunctionData({ abi: erc20Abi, functionName: 'totalSupply' });
+// eth_call returning the first uint256 word, optionally under a stateDiff
+// override; undefined on revert/empty (treated as "no signal").
+const callUint = async (client, to, data, override) => {
+    const params = [{ to, data }, 'latest'];
+    if (override) {
+        params.push({ [override.address]: { stateDiff: { [override.slot]: override.value } } });
+    }
+    try {
+        const result = await client.request({ method: 'eth_call', params });
+        if (typeof result !== 'string' || result.length < 66) {
+            return undefined;
+        }
+        return BigInt(result.slice(0, 66));
+    }
+    catch {
+        return undefined;
+    }
+};
+const getStorage = async (client, address, slot) => {
+    const result = await client.request({
+        method: 'eth_getStorageAt',
+        params: [address, slot, 'latest'],
+    });
+    return pad32(BigInt(String(result ?? '0x0')));
+};
+const setStorage = async (client, token, address, slot, value) => {
+    try {
+        await client.request({ method: 'anvil_setStorageAt', params: [address, slot, value] });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (/not found|not supported|not available|does not exist|unknown method|unsupported/i.test(message)) {
+            throw new Erc20DealError('dealErc20 requires an anvil-backed client (the RPC rejected anvil_setStorageAt) — live chains cannot be dealt.', token, 0);
+        }
+        throw error;
+    }
+};
+const probeSentinelFor = (current) => current === PROBE_SENTINEL ? PROBE_SENTINEL - 1n : PROBE_SENTINEL;
+export async function discoverErc20BalanceSlot(client, token, holder, options = {}) {
+    const storageAddress = options.storageAddress ?? token;
+    const maxSlot = options.maxSlot ?? 64;
+    const data = balanceOfData(holder);
+    const current = await callUint(client, token, data);
+    if (current === undefined) {
+        throw new Erc20DealError(`${token} does not implement balanceOf — not an ERC-20?`, token, 0);
+    }
+    const sentinel = probeSentinelFor(current);
+    const candidates = [];
+    for (let base = 0n; base <= BigInt(maxSlot); base += 1n) {
+        candidates.push({ layout: 'solidity', base });
+        candidates.push({ layout: 'vyper', base });
+    }
+    candidates.push({ layout: 'solidity', base: OZ_V5_ERC20_NAMESPACE_ROOT });
+    const BATCH = 8;
+    for (let start = 0; start < candidates.length; start += BATCH) {
+        const hits = await Promise.all(candidates.slice(start, start + BATCH).map(async (candidate) => {
+            const slot = mappingSlot(candidate.layout, holder, candidate.base);
+            const observed = await callUint(client, token, data, {
+                address: storageAddress,
+                slot,
+                value: pad32(sentinel),
+            });
+            return observed === sentinel ? candidate : undefined;
+        }));
+        const hit = hits.find(Boolean);
+        if (hit) {
+            return { layout: hit.layout, balanceSlot: hit.base };
+        }
+    }
+    throw new Erc20DealError(`Could not find ${token}'s balance slot after probing ${candidates.length} candidates. ` +
+        'Rebasing/shares tokens (stETH, aTokens) compute balanceOf and cannot be dealt this way; ' +
+        'solady-style seeded layouts need chain.setStorageAt with a hand-computed slot; ' +
+        'external-storage proxies need { storageAddress }; deep layouts may need a higher { maxSlot }.', token, candidates.length);
+}
+export async function getErc20Balance(client, token, account) {
+    const balance = await callUint(client, token, balanceOfData(account));
+    if (balance === undefined) {
+        throw new Erc20DealError(`${token} does not implement balanceOf — not an ERC-20?`, token, 0);
+    }
+    return balance;
+}
+export async function dealErc20(client, token, account, amount, options = {}, cache) {
+    if (typeof amount !== 'bigint') {
+        throw new RangeError('dealErc20 amount must be a bigint.');
+    }
+    if (amount < 0n || amount > MAX_UINT256) {
+        throw new RangeError('dealErc20 amount must be in [0, 2^256).');
+    }
+    const storageAddress = options.storageAddress ?? token;
+    const cacheKey = storageAddress.toLowerCase();
+    const explicit = options.slot !== undefined
+        ? { layout: options.layout ?? 'solidity', balanceSlot: BigInt(options.slot) }
+        : undefined;
+    let info = explicit ?? cache?.get(cacheKey);
+    let freshlyDiscovered = false;
+    if (!info) {
+        info = await discoverErc20BalanceSlot(client, token, account, options);
+        freshlyDiscovered = true;
+    }
+    const previousBalance = options.adjustTotalSupply
+        ? ((await callUint(client, token, balanceOfData(account))) ?? 0n)
+        : 0n;
+    // The one real write, always verified; a non-verifying write is restored so
+    // the worker chain is never left dirty (it outlives this call when used
+    // outside the wallet fixture's snapshot/revert).
+    const writeAndVerify = async (slotInfo) => {
+        const slot = mappingSlot(slotInfo.layout, account, slotInfo.balanceSlot);
+        const previous = await getStorage(client, storageAddress, slot);
+        await setStorage(client, token, storageAddress, slot, pad32(amount));
+        if ((await callUint(client, token, balanceOfData(account))) === amount) {
+            return true;
+        }
+        await setStorage(client, token, storageAddress, slot, previous);
+        return false;
+    };
+    if (await writeAndVerify(info)) {
+        if (freshlyDiscovered) {
+            cache?.set(cacheKey, info);
+        }
+    }
+    else {
+        if (explicit) {
+            throw new Erc20DealError(`balanceOf does not reflect a write at the explicit slot — wrong { slot }/{ layout }, or ${token} computes balanceOf.`, token, 0);
+        }
+        if (freshlyDiscovered) {
+            throw new Erc20DealError(`Discovery matched a slot but the final write did not verify — ${token} likely computes balanceOf (shares/rebasing).`, token, 0);
+        }
+        // Stale cache: snapshot reverts reset deployer nonces, so a different
+        // contract can reuse a previously-cached address. Evict and rediscover
+        // once.
+        cache?.delete(cacheKey);
+        const rediscovered = await discoverErc20BalanceSlot(client, token, account, options);
+        if (!(await writeAndVerify(rediscovered))) {
+            throw new Erc20DealError(`Verification failed even after rediscovery — ${token} likely computes balanceOf (shares/rebasing).`, token, 0);
+        }
+        cache?.set(cacheKey, rediscovered);
+        info = rediscovered;
+    }
+    if (options.adjustTotalSupply) {
+        await adjustTotalSupply(client, token, storageAddress, info, amount - previousBalance, {
+            maxSlot: options.maxSlot ?? 64,
+            cache: explicit ? undefined : cache,
+            cacheKey,
+        });
+    }
+}
+const adjustTotalSupply = async (client, token, storageAddress, info, delta, context) => {
+    if (delta === 0n) {
+        return;
+    }
+    const data = totalSupplyData();
+    const currentSupply = await callUint(client, token, data);
+    if (currentSupply === undefined) {
+        throw new Erc20DealError(`${token} does not implement totalSupply.`, token, 0);
+    }
+    const newSupply = currentSupply + delta;
+    if (newSupply < 0n) {
+        throw new Erc20DealError(`adjustTotalSupply would underflow: totalSupply ${currentSupply} with delta ${delta} (forge-std deal reverts here too).`, token, 0);
+    }
+    if (newSupply > MAX_UINT256) {
+        throw new Erc20DealError(`adjustTotalSupply would overflow uint256: totalSupply ${currentSupply} with delta ${delta}.`, token, 0);
+    }
+    let supplySlot = info.totalSupplySlot;
+    if (supplySlot === undefined) {
+        supplySlot = await discoverPlainSlot(client, token, storageAddress, data, currentSupply, info, context.maxSlot);
+        info.totalSupplySlot = supplySlot;
+        context.cache?.set(context.cacheKey, info);
+    }
+    const slot = pad32(supplySlot);
+    const previous = await getStorage(client, storageAddress, slot);
+    await setStorage(client, token, storageAddress, slot, pad32(newSupply));
+    if ((await callUint(client, token, data)) !== newSupply) {
+        await setStorage(client, token, storageAddress, slot, previous);
+        info.totalSupplySlot = undefined;
+        throw new Erc20DealError(`${token}'s totalSupply did not reflect the adjustment — it is likely computed.`, token, 0);
+    }
+};
+// Plain (unkeyed) slot discovery for totalSupply, also via state overrides.
+const discoverPlainSlot = async (client, token, storageAddress, data, current, info, maxSlot) => {
+    const sentinel = probeSentinelFor(current);
+    const candidates = [];
+    if (info.balanceSlot === OZ_V5_ERC20_NAMESPACE_ROOT) {
+        candidates.push(info.balanceSlot + 1n, info.balanceSlot + 2n, info.balanceSlot + 3n);
+    }
+    for (let base = 0n; base <= BigInt(maxSlot); base += 1n) {
+        candidates.push(base);
+    }
+    for (const base of candidates) {
+        const observed = await callUint(client, token, data, {
+            address: storageAddress,
+            slot: pad32(base),
+            value: pad32(sentinel),
+        });
+        if (observed === sentinel) {
+            return base;
+        }
+    }
+    throw new Erc20DealError(`Could not find ${token}'s totalSupply slot after probing ${candidates.length} candidates.`, token, candidates.length);
+};
+//# sourceMappingURL=erc20.js.map

package/dist/erc20.js.map

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

package/dist/fixtures.d.ts

@@ -1,15 +1,57 @@
+import { type Browser, type BrowserContext, type Page } from '@playwright/test';
 import { AnvilInstance, ChainController, type AnvilOptions } from './anvil.js';
 import { MockWalletController, type MockWalletControllerOptions } from './mock-wallet-controller.js';
+/** A second (third, …) user: its own browser context, page, and wallet. */
+export type UserSession = {
+    context: BrowserContext;
+    page: Page;
+    wallet: MockWalletController;
+    /** Idempotent mid-test disposal ("user leaves"); also runs at teardown. */
+    close(): Promise<void>;
+};
+export type CreateUserOptions = MockWalletFixtureOptions & {
+    /**
+     * Passed to browser.newContext(); baseURL is forwarded by default. Other
+     * test.use context options (viewport, locale, storageState…) are NOT
+     * inherited — pass them here when a user needs them.
+     */
+    contextOptions?: Parameters<Browser['newContext']>[0];
+};
+export type CreateUser = (options?: CreateUserOptions) => Promise<UserSession>;
 export type Web3Fixtures = {
     wallet: MockWalletController;
     walletOptions: MockWalletFixtureOptions;
+    /** Factory: fresh context + page + wallet on the shared worker chain(s). */
+    createUser: CreateUser;
+    /**
+     * Internal plumbing: the single per-test snapshot/revert owner spanning
+     * every running chain; wallet and createUser both depend on it.
+     */
+    _chainIsolation: void;
+};
+/**
+ * Spec for one extra per-worker Anvil chain. Port and host are
+ * fixture-managed; everything else defaults to the worker's anvilOptions
+ * (so docker runtime / custom executables apply to extras too).
+ */
+export type AnvilChainSpec = Omit<AnvilOptions, 'port' | 'host' | 'allowNonLoopbackHost'> & {
+    chainId: number;
 };
 export type Web3WorkerFixtures = {
     anvil: AnvilInstance;
     chain: ChainController;
     anvilOptions: AnvilOptions;
+    /** Worker option, default []. One extra AnvilInstance is started per entry. */
+    extraChains: readonly AnvilChainSpec[];
+    /** Worker-scoped: extra chainId -> running AnvilInstance. */
+    extraAnvils: ReadonlyMap<number, AnvilInstance>;
+    /** Worker-scoped: chainId -> ChainController, INCLUDING the primary chain. */
+    chains: ReadonlyMap<number, ChainController>;
+};
+export type MockWalletFixtureOptions = Omit<Partial<MockWalletControllerOptions>, 'chainId'> & {
+    /** Indexes into chain.accounts(); mutually exclusive with `accounts`. */
+    accountIndexes?: readonly number[];
 };
-export type MockWalletFixtureOptions = Omit<Partial<MockWalletControllerOptions>, 'accounts' | 'chainId'>;
 export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & Web3Fixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & Web3WorkerFixtures>;
-export { expect } from '@playwright/test';
+export { expect } from './matchers.js';
 //# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAErG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,wBAAwB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,OAAO,CAAC,2BAA2B,CAAC,EACpC,UAAU,GAAG,SAAS,CACvB,CAAC;AAkBF,eAAO,MAAM,IAAI,iRA2Ef,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAK9F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,YAAY,EAAwB,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAErG,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG;IACzD;;;;OAIG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE/E,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,wBAAwB,CAAC;IACxC,4EAA4E;IAC5E,UAAU,EAAE,UAAU,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,sBAAsB,CAAC,GAAG;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,+EAA+E;IAC/E,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IACvC,6DAA6D;IAC7D,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,8EAA8E;IAC9E,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C,CAAC;AAGF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,EAAE,SAAS,CAAC,GAAG;IAC7F,yEAAyE;IACzE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAiEF,eAAO,MAAM,IAAI,iRA4Mf,CAAC;AA2BH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/fixtures.js

@@ -4,7 +4,41 @@ import { join } from 'node:path';
 import { foundry } from 'viem/chains';
 import { AnvilInstance, ChainController } from './anvil.js';
 import { MockWalletController } from './mock-wallet-controller.js';
-const workerPort = (workerIndex) => Number(process.env.ANVIL_PORT ?? 8545) + workerIndex;
+const resolveAccounts = async (chain, options, fallbackIndex) => {
+    if (options.accounts && options.accountIndexes) {
+        throw new Error('Pass either accounts or accountIndexes, not both.');
+    }
+    if (options.accounts) {
+        return [...options.accounts];
+    }
+    const available = await chain.accounts();
+    const pick = (index) => {
+        const account = available[index];
+        if (!account) {
+            throw new Error(`Account index ${index} is out of range: the node exposes ${available.length} accounts. ` +
+                'Raise anvilOptions: { accounts: n } to generate more.');
+        }
+        return account;
+    };
+    if (options.accountIndexes) {
+        return options.accountIndexes.map(pick);
+    }
+    return [pick(fallbackIndex)];
+};
+// Base defaults to 8645 rather than anvil's own 8545 so the fixture never
+// collides with a developer-run dev node on the conventional port.
+//
+// Port bands (ANVIL_PORT shifts everything wholesale):
+//   primary anvil:  base + workerIndex                       (8645, 8646, …)
+//   extraChains:    base + 1000 + workerIndex*20 + index     (9645+, 20/worker)
+// Spec-managed anvils use their own bands with distinct mod-20 sub-offsets:
+//   tests/anvil.spec.ts                  19100 + w*20 + {0..3}
+//   tests/private-key-rpc-client.spec.ts 19510 + w*20 + {0..2}  (≡ 10..12)
+//   tests/mock-wallet-multichain.spec.ts 19700 + w*20 + {13..19}
+//   tests/erc20.spec.ts                  19900 + w*20 + {4..5}
+// The extras band assumes workerIndex < 1000.
+const workerPort = (workerIndex) => Number(process.env.ANVIL_PORT ?? 8645) + workerIndex;
+const extraChainPort = (workerIndex, index) => Number(process.env.ANVIL_PORT ?? 8645) + 1000 + workerIndex * 20 + index;
 const resolveAnvilExecutable = () => {
     if (process.env.ANVIL_EXECUTABLE) {
         return process.env.ANVIL_EXECUTABLE;
@@ -29,6 +63,7 @@ export const test = base.extend({
                 executable: resolveAnvilExecutable(),
                 dockerImage: process.env.ANVIL_DOCKER_IMAGE,
                 host: process.env.ANVIL_HOST ?? '127.0.0.1',
+                allowNonLoopbackHost: process.env.ANVIL_ALLOW_NON_LOOPBACK === 'true',
                 chainId: Number(process.env.ANVIL_CHAIN_ID ?? foundry.id),
                 forkUrl: process.env.ANVIL_FORK_URL,
                 silent: process.env.ANVIL_SILENT !== 'false',
@@ -60,28 +95,138 @@ export const test = base.extend({
         },
         { scope: 'worker' },
     ],
-    wallet: async ({ page, chain, walletOptions: customWalletOptions }, use) => {
-        const snapshotId = await chain.snapshot();
-        const [defaultAccount] = await chain.accounts();
-        if (!defaultAccount) {
-            throw new Error('Anvil did not expose any default accounts.');
+    extraChains: [
+        async ({}, use) => {
+            await use([]);
+        },
+        { scope: 'worker', option: true },
+    ],
+    extraAnvils: [
+        async ({ anvil, anvilOptions, extraChains }, use, workerInfo) => {
+            const instances = new Map();
+            try {
+                const seenChainIds = new Set([anvil.chainId]);
+                for (const [index, spec] of extraChains.entries()) {
+                    if (seenChainIds.has(spec.chainId)) {
+                        throw new Error(`extraChains lists chain id ${spec.chainId} more than once (or it collides with the primary chain).`);
+                    }
+                    seenChainIds.add(spec.chainId);
+                    // Extras inherit the worker anvilOptions (runtime, executable,
+                    // docker image, host…) under the spec's own overrides; the port is
+                    // fixture-managed in a dedicated band.
+                    instances.set(spec.chainId, await AnvilInstance.start({
+                        ...anvilOptions,
+                        ...spec,
+                        port: extraChainPort(workerInfo.workerIndex, index),
+                    }));
+                }
+                await use(instances);
+            }
+            finally {
+                await Promise.all([...instances.values()].map((instance) => instance.stop()));
+            }
+        },
+        { scope: 'worker' },
+    ],
+    chains: [
+        async ({ anvil, chain, extraAnvils }, use) => {
+            const map = new Map();
+            map.set(anvil.chainId, chain);
+            for (const [chainId, instance] of extraAnvils) {
+                map.set(chainId, new ChainController({ rpcUrl: instance.rpcUrl, chainId }));
+            }
+            await use(map);
+        },
+        { scope: 'worker' },
+    ],
+    // The single per-test snapshot/revert owner. Playwright memoizes fixtures,
+    // so a test using both wallet and createUser takes exactly ONE snapshot
+    // per chain, and teardown runs dependents first — user contexts close
+    // before the single revert.
+    _chainIsolation: async ({ chains }, use) => {
+        const snapshots = new Map();
+        for (const controller of chains.values()) {
+            snapshots.set(controller, await controller.snapshot());
         }
-        const walletOptions = {
-            accounts: [defaultAccount],
-            chainId: chain.chainId,
-            autoApprove: true,
-            connected: true,
-            ...customWalletOptions,
-        };
-        const wallet = new MockWalletController(page, chain, walletOptions);
+        try {
+            await use(undefined);
+        }
+        finally {
+            for (const [controller, snapshotId] of snapshots) {
+                await controller.revert(snapshotId);
+            }
+        }
+    },
+    wallet: async ({ page, chain, chains, walletOptions: customWalletOptions, _chainIsolation }, use) => {
+        void _chainIsolation;
+        const { accounts, accountIndexes, ...controllerOverrides } = customWalletOptions;
+        const resolvedAccounts = await resolveAccounts(chain, { accounts, accountIndexes }, 0);
+        const wallet = new MockWalletController(page, chain, buildControllerOptions(chain, chains, resolvedAccounts, controllerOverrides));
         await wallet.injectMockProvider();
+        await use(wallet);
+    },
+    createUser: async ({ browser, chain, chains, baseURL, walletOptions: customWalletOptions, _chainIsolation }, use) => {
+        void _chainIsolation;
+        const sessions = [];
+        // Index 0 is the primary wallet fixture's default; users without
+        // explicit accounts take 1, 2, 3… in creation order.
+        let nextDefaultIndex = 1;
+        const factory = async (options = {}) => {
+            // The test's walletOptions are the base layer (so deny-mode or origin
+            // scoping applies to every user) under per-call overrides — except
+            // accounts/accountIndexes, which resolveAccounts owns per user.
+            const { accounts: _baseAccounts, accountIndexes: _baseIndexes, ...baseOptions } = customWalletOptions;
+            const merged = { ...baseOptions, ...options };
+            const { accounts, accountIndexes, contextOptions, ...controllerOverrides } = merged;
+            const resolvedAccounts = await resolveAccounts(chain, { accounts, accountIndexes }, nextDefaultIndex);
+            if (!accounts && !accountIndexes) {
+                nextDefaultIndex += 1;
+            }
+            const context = await browser.newContext({ baseURL, ...contextOptions });
+            const page = await context.newPage();
+            const wallet = new MockWalletController(page, chain, buildControllerOptions(chain, chains, resolvedAccounts, controllerOverrides));
+            await wallet.injectMockProvider();
+            let closed = false;
+            const session = {
+                context,
+                page,
+                wallet,
+                close: async () => {
+                    if (closed) {
+                        return;
+                    }
+                    closed = true;
+                    await context.close().catch(() => undefined);
+                },
+            };
+            sessions.push(session);
+            return session;
+        };
         try {
-            await use(wallet);
+            await use(factory);
         }
         finally {
-            await chain.revert(snapshotId);
+            for (const session of sessions) {
+                await session.close();
+            }
         }
     },
 });
-export { expect } from '@playwright/test';
+// The primary chain is the positional rpcClient; extras go in the chains
+// option. User-supplied chains entries win per key, but fixture extras are
+// never silently dropped (their Anvils keep running).
+const buildControllerOptions = (chain, chains, accounts, overrides) => {
+    const extraBackends = Object.fromEntries([...chains].filter(([chainId]) => chainId !== chain.chainId));
+    const mergedChains = { ...extraBackends, ...overrides.chains };
+    return {
+        accounts,
+        chainId: chain.chainId,
+        autoApprove: true,
+        connected: true,
+        ...overrides,
+        ...(Object.keys(mergedChains).length > 0 ? { chains: mergedChains } : {}),
+    };
+};
+// The web3-extended expect: every matcher from ./matchers.js, zero migration.
+export { expect } from './matchers.js';
 //# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

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

package/dist/index.d.ts

@@ -1,11 +1,23 @@
 export { AnvilInstance, ChainController } from './anvil.js';
+export { Erc20DealError, dealErc20, discoverErc20BalanceSlot, getErc20Balance, TEST_ERC20_ABI, TEST_ERC20_BYTECODE, } from './erc20.js';
+export type { DealErc20Options, Erc20SlotInfo, Erc20StorageLayout } from './erc20.js';
+export { anyValue, web3Matchers } from './matchers.js';
+export type { BalanceChange, EventArgsExpectation, EventMatchOptions } from './matchers.js';
+export { extractRevertInfo, waitForDecodedTransaction, web3Equals, web3Stringify, } from './transactions.js';
+export type { ChainLike, DecodedTransaction, ReadClient, RevertInfo, RevertTarget, TransactionRef, TransactionTarget, } from './transactions.js';
 export { test, expect } from './fixtures.js';
-export { MockWalletController } from './mock-wallet-controller.js';
+export { MockWalletController, httpRpcClient } from './mock-wallet-controller.js';
 export { PrivateKeyRpcClient } from './private-key-rpc-client.js';
 export { launchRealWallet, resolveRealWalletProfile } from './real-wallet.js';
-export type { AnvilOptions, AnvilSnapshotId, AnvilViemClient, ChainControllerOptions, } from './anvil.js';
-export type { MockWalletControllerOptions, RejectionRule, } from './mock-wallet-controller.js';
-export type { JsonRpcRequest, MockWalletConfig, WalletProviderInfo, } from './types.js';
+export { DEFAULT_METAMASK_VERSION, prepareMetaMaskExtension, extensionManifestVersion, } from './metamask-extension.js';
+export { buildWalletProfile, cloneWalletProfile, waitForExtensionStatePersisted, } from './real-wallet-cache.js';
+export { DEFAULT_WALLET_PASSWORD } from './real-wallet-setup.js';
+export type { AnvilOptions, AnvilSnapshotId, AnvilViemClient, ChainAuthorizationOptions, ChainControllerOptions, DelegateOptions, DeployContractOptions, DeployedContract, DeployedErc20, DeployErc20Options, } from './anvil.js';
+export type { AtomicCapabilityStatus, CallsBatchRecord, ChainBackend, Eip5792Options, HeldRequest, HttpRpcClientOptions, MockWalletControllerOptions, RejectionRule, SentTransactionRecord, } from './mock-wallet-controller.js';
+export type { JsonRpcRequest, MockWalletConfig, RpcClient, WalletProviderInfo, } from './types.js';
 export type { PrivateKeyRpcClientOptions } from './private-key-rpc-client.js';
-export type { RealWalletController, RealWalletGasSettings, RealWalletLaunchOptions, RealWalletProfile, RealWalletSession, RealWalletSetup, } from './real-wallet.js';
+export type { RealWalletController, RealWalletGasSettings, RealWalletLaunchOptions, RealWalletNetwork, RealWalletProfile, RealWalletSession, RealWalletSetup, RealWalletToken, WalletGeneration, } from './real-wallet.js';
+export type { PrepareMetaMaskExtensionOptions } from './metamask-extension.js';
+export type { BuildWalletProfileOptions } from './real-wallet-cache.js';
+export type { RealWalletFixtureOptions, RealWalletFixtures } from './real-wallet-fixtures.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2BAA2B,EAC3B,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,SAAS,EACT,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,2BAA2B,EAC3B,aAAa,EACb,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}