@marigoldlabs/web3-tester 0.1.2 → 0.4.1

package/dist/index.js

@@ -1,6 +1,12 @@
 export { AnvilInstance, ChainController } from './anvil.js';
+export { Erc20DealError, dealErc20, discoverErc20BalanceSlot, getErc20Balance, TEST_ERC20_ABI, TEST_ERC20_BYTECODE, } from './erc20.js';
+export { anyValue, web3Matchers } from './matchers.js';
+export { extractRevertInfo, waitForDecodedTransaction, web3Equals, web3Stringify, } 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 { 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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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"}
+{"version":3,"file":"index.js","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;AAEpB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAU3B,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"}

package/dist/injected-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injected-provider.d.ts","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,eAAO,MAAM,aAAa,+BAAc,CAAC;AACzC,eAAO,MAAM,WAAW,0BAAe,CAAC;AAExC,eAAO,MAAM,2BAA2B,GAAI,QAAQ,gBAAgB,KAAG,MAuItE,CAAC"}
+{"version":3,"file":"injected-provider.d.ts","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,eAAO,MAAM,aAAa,+BAAc,CAAC;AACzC,eAAO,MAAM,WAAW,0BAAe,CAAC;AAExC,eAAO,MAAM,2BAA2B,GAAI,QAAQ,gBAAgB,KAAG,MAsMtE,CAAC"}

package/dist/injected-provider.js

@@ -5,34 +5,22 @@ export const emitterName = EMITTER_NAME;
 export const buildInjectedProviderScript = (config) => `
 (() => {
   const config = ${JSON.stringify(config)};
-  const listeners = new Map();
 
-  const getListeners = (event) => {
-    if (!listeners.has(event)) {
-      listeners.set(event, new Set());
-    }
-    return listeners.get(event);
-  };
+  // Origin-scoped wallets never install in out-of-scope frames, so blocked
+  // pages cannot even read the account address or chain off the provider.
+  // window.origin (unlike location.origin or the frame URL) is the security
+  // origin, which about:blank/srcdoc children inherit from their parent —
+  // matching the bridge-side ancestor walk.
+  if (config.allowedOrigins && !config.allowedOrigins.includes(window.origin || location.origin)) {
+    return;
+  }
 
-  const emit = (event, payload) => {
-    if (event === 'accountsChanged') {
-      provider.selectedAddress = Array.isArray(payload) && payload.length > 0 ? payload[0] : null;
-    }
+  const toNetworkVersion = (chainId) => String(Number(BigInt(chainId)));
 
-    if (event === 'chainChanged') {
-      provider.chainId = payload;
-      provider.networkVersion = String(Number(BigInt(payload)));
-    }
-
-    const callbacks = listeners.get(event);
-    if (!callbacks) {
-      return;
-    }
-
-    for (const callback of [...callbacks]) {
-      callback(payload);
-    }
-  };
+  // EIP-1193 connectivity means "can the provider reach the chain", which is
+  // independent of account authorization. The controller's disconnect()
+  // simulates losing the chain via the 'disconnect' event.
+  let chainDisconnected = false;
 
   const request = async (args) => {
     if (!args || typeof args.method !== 'string') {
@@ -56,74 +44,123 @@ export const buildInjectedProviderScript = (config) => `
     return response.result;
   };
 
-  const provider = {
-    isMetaMask: true,
-    isMock: true,
-    selectedAddress: config.connected && config.accounts.length > 0 ? config.accounts[0] : null,
-    chainId: config.chainId,
-    networkVersion: String(Number(BigInt(config.chainId))),
-    request,
-    enable: () => request({ method: 'eth_requestAccounts' }),
-    send: (methodOrPayload, paramsOrCallback) => {
-      if (typeof methodOrPayload === 'string') {
-        return request({ method: methodOrPayload, params: paramsOrCallback });
+  // One distinct provider object per announced wallet so selector tests can
+  // detect a dapp talking to the wrong provider. They share request handling
+  // and state, but each has its own identity and listener registry.
+  const createProviderEntry = (info) => {
+    const listeners = new Map();
+
+    const getListeners = (event) => {
+      if (!listeners.has(event)) {
+        listeners.set(event, new Set());
       }
+      return listeners.get(event);
+    };
+
+    const provider = {
+      isMetaMask: true,
+      isMock: true,
+      selectedAddress: config.connected && config.accounts.length > 0 ? config.accounts[0] : null,
+      chainId: config.chainId,
+      networkVersion: toNetworkVersion(config.chainId),
+      request,
+      isConnected: () => !chainDisconnected,
+      enable: () => request({ method: 'eth_requestAccounts' }),
+      send: (methodOrPayload, paramsOrCallback) => {
+        if (typeof methodOrPayload === 'string') {
+          return request({ method: methodOrPayload, params: paramsOrCallback });
+        }
+
+        const payload = methodOrPayload;
+        const callback = paramsOrCallback;
+        request(payload)
+          .then((result) => callback?.(null, { id: payload.id, jsonrpc: '2.0', result }))
+          .catch((error) => callback?.(error, null));
+      },
+      sendAsync: (payload, callback) => {
+        request(payload)
+          .then((result) => callback(null, { id: payload.id, jsonrpc: '2.0', result }))
+          .catch((error) => callback(error, null));
+      },
+      on: (event, handler) => {
+        getListeners(event).add(handler);
+        return provider;
+      },
+      once: (event, handler) => {
+        const wrapped = (payload) => {
+          provider.removeListener(event, wrapped);
+          handler(payload);
+        };
+        provider.on(event, wrapped);
+        return provider;
+      },
+      removeListener: (event, handler) => {
+        listeners.get(event)?.delete(handler);
+        return provider;
+      },
+      removeAllListeners: (event) => {
+        if (event) {
+          listeners.delete(event);
+        } else {
+          listeners.clear();
+        }
+        return provider;
+      },
+      _metamask: {
+        isUnlocked: async () => true,
+      },
+    };
 
-      const payload = methodOrPayload;
-      const callback = paramsOrCallback;
-      request(payload)
-        .then((result) => callback?.(null, { id: payload.id, jsonrpc: '2.0', result }))
-        .catch((error) => callback?.(error, null));
-    },
-    sendAsync: (payload, callback) => {
-      request(payload)
-        .then((result) => callback(null, { id: payload.id, jsonrpc: '2.0', result }))
-        .catch((error) => callback(error, null));
-    },
-    on: (event, handler) => {
-      getListeners(event).add(handler);
-      return provider;
-    },
-    once: (event, handler) => {
-      const wrapped = (payload) => {
-        provider.removeListener(event, wrapped);
-        handler(payload);
-      };
-      provider.on(event, wrapped);
-      return provider;
-    },
-    removeListener: (event, handler) => {
-      listeners.get(event)?.delete(handler);
-      return provider;
-    },
-    removeAllListeners: (event) => {
-      if (event) {
-        listeners.delete(event);
-      } else {
-        listeners.clear();
+    return { info, provider, listeners };
+  };
+
+  const entries = config.providers.map(createProviderEntry);
+
+  const emit = (event, payload) => {
+    if (event === 'connect') {
+      chainDisconnected = false;
+    }
+    if (event === 'disconnect') {
+      chainDisconnected = true;
+    }
+
+    for (const entry of entries) {
+      if (event === 'accountsChanged') {
+        entry.provider.selectedAddress =
+          Array.isArray(payload) && payload.length > 0 ? payload[0] : null;
+      }
+
+      if (event === 'chainChanged') {
+        entry.provider.chainId = payload;
+        entry.provider.networkVersion = toNetworkVersion(payload);
+      }
+
+      const callbacks = entry.listeners.get(event);
+      if (!callbacks) {
+        continue;
+      }
+
+      for (const callback of [...callbacks]) {
+        callback(payload);
       }
-      return provider;
-    },
-    _metamask: {
-      isUnlocked: async () => true,
-    },
+    }
   };
 
   const announceProviders = () => {
-    for (const info of config.providers) {
+    for (const entry of entries) {
       window.dispatchEvent(
         new CustomEvent('eip6963:announceProvider', {
-          detail: {
-            info,
-            provider,
-          },
+          detail: Object.freeze({
+            info: Object.freeze({ ...entry.info }),
+            provider: entry.provider,
+          }),
         }),
       );
     }
   };
 
   Object.defineProperty(window, 'ethereum', {
-    value: provider,
+    value: entries[0].provider,
     configurable: true,
     enumerable: true,
     writable: true,
@@ -136,6 +173,32 @@ export const buildInjectedProviderScript = (config) => `
 
   window.addEventListener('eip6963:requestProvider', announceProviders);
   queueMicrotask(announceProviders);
+
+  // The serialized config snapshot goes stale once the controller mutates
+  // accounts or chain and the page navigates; refresh the synchronous mirror
+  // properties from the wallet's current state as soon as the bridge is up.
+  const refresh = async () => {
+    try {
+      const response = await window.${BRIDGE_NAME}({
+        method: 'metamask_getProviderState',
+        params: [],
+      });
+      if (!response.ok) {
+        return;
+      }
+
+      const state = response.result;
+      for (const entry of entries) {
+        entry.provider.selectedAddress = state.accounts.length > 0 ? state.accounts[0] : null;
+        entry.provider.chainId = state.chainId;
+        entry.provider.networkVersion = toNetworkVersion(state.chainId);
+      }
+    } catch {
+      // Bridge not available yet (e.g. detached frame) — sync values fall
+      // back to the injected config snapshot.
+    }
+  };
+  refresh();
 })();
 `;
 //# sourceMappingURL=injected-provider.js.map

package/dist/injected-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"injected-provider.js","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAwB,EAAU,EAAE,CAAC;;mBAE9D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAqCL,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAwFZ,YAAY;;;;;;;;CAQ9C,CAAC"}
+{"version":3,"file":"injected-provider.js","sourceRoot":"","sources":["../src/injected-provider.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAwB,EAAU,EAAE,CAAC;;mBAE9D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;oCAyBL,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAyIZ,YAAY;;;;;;;;;;;;;sCAaT,WAAW;;;;;;;;;;;;;;;;;;;;;CAqBhD,CAAC"}

package/dist/live-fixtures.d.ts

@@ -1,9 +1,38 @@
-import { MockWalletController } from './mock-wallet-controller.js';
+import type { Chain } from 'viem';
+import { MockWalletController, type MockWalletControllerOptions } from './mock-wallet-controller.js';
 import { PrivateKeyRpcClient } from './private-key-rpc-client.js';
+export type LiveFixtureOptions = {
+    /** Target chain. Defaults to Sepolia. */
+    chain?: Chain;
+    /**
+     * Passed through to PrivateKeyRpcClient for chains that are neither
+     * `testnet: true` nor local dev chains. Without it such chains throw at
+     * fixture setup.
+     */
+    allowMainnet?: boolean;
+    /** Env var holding the signing key. Defaults to WEB3_TESTER_PRIVATE_KEY. */
+    privateKeyEnv?: string;
+    /** Env var holding the RPC URL. Defaults to WEB3_TESTER_RPC_URL. */
+    rpcUrlEnv?: string;
+    /**
+     * Per-test overrides for the injected wallet (provider identity,
+     * autoApprove, allowedOrigins, …). Live wallets default to
+     * autoApprove: false and origin-scope the provider to baseURL; override
+     * here only for keys you are comfortable auto-signing with.
+     */
+    walletOptions?: Omit<Partial<MockWalletControllerOptions>, 'accounts' | 'chainId'>;
+};
 export type LiveWeb3Fixtures = {
-    wallet: MockWalletController;
+    liveOptions: LiveFixtureOptions;
     liveClient: PrivateKeyRpcClient;
+    wallet: MockWalletController;
 };
+/**
+ * Builds a live-chain fixture family. The defaults read the signing key from
+ * WEB3_TESTER_PRIVATE_KEY (with the legacy FJORD_PRIVATE_KEY still honored)
+ * and target Sepolia; pass options to bind other chains or env var names.
+ */
+export declare function createLiveFixtures(defaults?: LiveFixtureOptions): import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & LiveWeb3Fixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
 export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & LiveWeb3Fixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
-export { expect } from '@playwright/test';
+export { expect } from './matchers.js';
 //# sourceMappingURL=live-fixtures.d.ts.map

package/dist/live-fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-fixtures.d.ts","sourceRoot":"","sources":["../src/live-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,IAAI,gQA+Bf,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"live-fixtures.d.ts","sourceRoot":"","sources":["../src/live-fixtures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yCAAyC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;CACpF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,kBAAuB,kQAuDnE;AAED,eAAO,MAAM,IAAI,gQAAuB,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/live-fixtures.js

@@ -1,33 +1,70 @@
 import { test as base } from '@playwright/test';
 import { sepolia } from 'viem/chains';
-import { MockWalletController } from './mock-wallet-controller.js';
+import { MockWalletController, } from './mock-wallet-controller.js';
 import { PrivateKeyRpcClient } from './private-key-rpc-client.js';
-export const test = base.extend({
-    liveClient: async ({}, use) => {
-        const privateKey = process.env.FJORD_PRIVATE_KEY;
-        if (!privateKey) {
-            throw new Error('FJORD_PRIVATE_KEY is required for live Sepolia Fjord tests.');
+const resolveEnv = (names) => {
+    for (const name of names) {
+        if (name && process.env[name]) {
+            return process.env[name];
         }
-        await use(new PrivateKeyRpcClient({
-            privateKey: privateKey,
-            chain: sepolia,
-            rpcUrl: process.env.SEPOLIA_RPC_URL,
-        }));
-    },
-    wallet: async ({ page, liveClient }, use) => {
-        const wallet = new MockWalletController(page, liveClient, {
-            accounts: [liveClient.account.address],
-            chainId: sepolia.id,
-            autoApprove: true,
-            connected: true,
-            providerInfo: {
-                name: 'MetaMask',
-                rdns: 'io.metamask',
+    }
+    return undefined;
+};
+/**
+ * Builds a live-chain fixture family. The defaults read the signing key from
+ * WEB3_TESTER_PRIVATE_KEY (with the legacy FJORD_PRIVATE_KEY still honored)
+ * and target Sepolia; pass options to bind other chains or env var names.
+ */
+export function createLiveFixtures(defaults = {}) {
+    return base.extend({
+        liveOptions: [
+            async ({}, use) => {
+                await use(defaults);
             },
-        });
-        await wallet.injectMockProvider();
-        await use(wallet);
-    },
-});
-export { expect } from '@playwright/test';
+            { option: true },
+        ],
+        liveClient: async ({ liveOptions }, use) => {
+            const options = { ...defaults, ...liveOptions };
+            const privateKeyEnv = options.privateKeyEnv ?? 'WEB3_TESTER_PRIVATE_KEY';
+            const privateKey = resolveEnv([privateKeyEnv, 'FJORD_PRIVATE_KEY']);
+            if (!privateKey) {
+                throw new Error(`${privateKeyEnv} is required for live-chain tests.`);
+            }
+            const rpcUrlEnv = options.rpcUrlEnv ?? 'WEB3_TESTER_RPC_URL';
+            await use(new PrivateKeyRpcClient({
+                privateKey: privateKey,
+                chain: options.chain ?? sepolia,
+                rpcUrl: resolveEnv([rpcUrlEnv, 'SEPOLIA_RPC_URL']),
+                allowMainnet: options.allowMainnet,
+            }));
+        },
+        wallet: async ({ page, liveClient, liveOptions, baseURL }, use) => {
+            const options = { ...defaults, ...liveOptions };
+            const wallet = new MockWalletController(page, liveClient, {
+                accounts: [liveClient.account.address],
+                chainId: liveClient.chain.id,
+                // A real key sits behind this provider, so nothing signs or connects
+                // until the test arms it (wallet.approveNext(...) for one request,
+                // wallet.autoApprove(true) or walletOptions for a whole test), and
+                // only frames on the dapp's own origin can reach the wallet at all.
+                autoApprove: false,
+                connected: true,
+                // EIP-5792 stays off over a real key: capability-probing dapps keep
+                // the eth_sendTransaction fallback with per-transaction arming,
+                // capping a bare approveNext() at one real transaction.
+                eip5792: false,
+                ...(baseURL ? { allowedOrigins: [baseURL] } : {}),
+                // Masquerade as MetaMask by default so production wallet selectors
+                // (wagmi / EIP-6963) detect the injected provider unmodified.
+                providerInfo: { name: 'MetaMask', rdns: 'io.metamask' },
+                ...options.walletOptions,
+            });
+            await wallet.injectMockProvider();
+            await use(wallet);
+        },
+    });
+}
+export const test = createLiveFixtures();
+// The web3-extended expect: every matcher from ./matchers.js, zero migration.
+export { expect } from './matchers.js';
 //# sourceMappingURL=live-fixtures.js.map

package/dist/live-fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"live-fixtures.js","sourceRoot":"","sources":["../src/live-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAOlE,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAmB;IAChD,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACjD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,GAAG,CACP,IAAI,mBAAmB,CAAC;YACtB,UAAU,EAAE,UAA2B;YACvC,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;SACpC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE;YACxD,QAAQ,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;YACtC,OAAO,EAAE,OAAO,CAAC,EAAE;YACnB,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE;gBACZ,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,aAAa;aACpB;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAClC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;CACF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"live-fixtures.js","sourceRoot":"","sources":["../src/live-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/matchers.d.ts

@@ -0,0 +1,90 @@
+import { type ExpectMatcherState } from '@playwright/test';
+import { type Abi, type Address } from 'viem';
+import { type ChainLike, type RevertTarget, type TransactionTarget } from './transactions.js';
+type MatcherResult = {
+    pass: boolean;
+    message: () => string;
+    expected?: unknown;
+    actual?: unknown;
+};
+/** Named or positional; positional `undefined` = wildcard; values may be predicates. */
+export type EventArgsExpectation = Record<string, unknown> | readonly unknown[];
+export type EventMatchOptions = {
+    args?: EventArgsExpectation;
+    /** Restrict to events emitted by this contract. */
+    address?: Address;
+    /** Exact number of matching events; default passes on >= 1 (and `.not` asserts zero). */
+    count?: number;
+    timeout?: number;
+};
+export type BalanceChange = {
+    address: Address;
+    delta: bigint | number | string;
+};
+/** hardhat-chai-matchers `anyValue` parity for arg wildcards. */
+export declare const anyValue: (_value: unknown) => boolean;
+export declare const web3Matchers: {
+    toEmitEvent(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, abi: Abi, eventName: string, options?: EventMatchOptions): Promise<MatcherResult>;
+    toChangeBalance(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, address: Address, delta: bigint | number | string, options?: {
+        includeFee?: boolean;
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeBalances(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, changes: readonly BalanceChange[], options?: {
+        includeFee?: boolean;
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeTokenBalance(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, token: Address, address: Address, delta: bigint | number | string, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeTokenBalances(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, token: Address, changes: readonly BalanceChange[], options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeReverted(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWith(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, reason: string | RegExp, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWithCustomError(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, abi: Abi, errorName: string, options?: {
+        args?: readonly unknown[];
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWithPanic(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, code?: bigint | number, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toHaveTokenBalance(this: ExpectMatcherState, holder: Address, chain: ChainLike, token: Address, expected: bigint | number | string | ((balance: bigint) => boolean)): Promise<MatcherResult>;
+};
+/** Pre-extended expect carrying every web3 matcher, fully typed. */
+export declare const expect: import("@playwright/test").Expect<{
+    toEmitEvent(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, abi: Abi, eventName: string, options?: EventMatchOptions): Promise<MatcherResult>;
+    toChangeBalance(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, address: Address, delta: bigint | number | string, options?: {
+        includeFee?: boolean;
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeBalances(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, changes: readonly BalanceChange[], options?: {
+        includeFee?: boolean;
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeTokenBalance(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, token: Address, address: Address, delta: bigint | number | string, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toChangeTokenBalances(this: ExpectMatcherState, target: TransactionTarget, chain: ChainLike, token: Address, changes: readonly BalanceChange[], options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeReverted(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWith(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, reason: string | RegExp, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWithCustomError(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, abi: Abi, errorName: string, options?: {
+        args?: readonly unknown[];
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toBeRevertedWithPanic(this: ExpectMatcherState, target: RevertTarget, chain: ChainLike, code?: bigint | number, options?: {
+        timeout?: number;
+    }): Promise<MatcherResult>;
+    toHaveTokenBalance(this: ExpectMatcherState, holder: Address, chain: ChainLike, token: Address, expected: bigint | number | string | ((balance: bigint) => boolean)): Promise<MatcherResult>;
+}>;
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

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