@morpho-org/test

Overview

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 @morpho-org/test

yarn add @morpho-org/test

Usage

Vitest (viem)

Export an extended vitest test:

import { createViemTest } from "@morpho-org/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 "@morpho-org/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 "@morpho-org/test";

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

Development

Contribute from the monorepo root. See CONTRIBUTING.md for setup, checks, and package workflow. Report vulnerabilities through SECURITY.md.

License

MIT. See LICENSE.