@taufinancexyz/test

Viem-based package that exports utilities to build Vitest & Playwright fixtures that spawn anvil forks as child processes.

Heavily inspired by prool, but lighter & faster.

Installation

npm install @taufinancexyz/test

yarn add @taufinancexyz/test

Getting Started

Vitest (viem)

Export an extended vitest test:

import { createViemTest } from "@taufinancexyz/test/vitest";
import { mainnet } from "viem/chains";

export const test = createViemTest(mainnet, {
  forkUrl: process.env.MAINNET_RPC_URL,
  forkBlockNumber: 19_530_000,
});

See more on its internal usage for viem-based E2E tests here.

Playwright

Export an extended Playwright test:

import { createViemTest } from "@taufinancexyz/test/playwright";
import { mainnet } from "viem/chains";

export const test = createViemTest(mainnet, {
  forkUrl: process.env.MAINNET_RPC_URL,
  forkBlockNumber: 19_530_000,
});

Spawn anvil instances

import { mainnet } from "viem/chains";
import { spawnAnvil } from "@taufinancexyz/test";

spawnAnvil(mainnet, { forkBlockNumber: 19_750_000n });