@ethernauta/testing

Vitest-first testing utility for @ethernauta/* consumers. Spawns a local anvil node per worker, exposes its endpoint as a URL that both http(...) (path 2) and create_provider(...) (path 1) accept, and runs default-on snapshot/revert isolation around each test.

Install

pnpm add -D @ethernauta/testing
curl -L https://foundry.paradigm.xyz | bash && foundryup

Two-files-total usage

// vitest.config.ts
import { defineConfig } from "vitest/config"
import { ethernauta_anvil } from "@ethernauta/testing"

export default defineConfig({ plugins: [ethernauta_anvil()] })

// some.test.ts
import {
  create_provider,
  create_reader,
  http,
} from "@ethernauta/transport"
import {
  anvil,
  anvil_account,
  create_testing_provider,
} from "@ethernauta/testing"

// path 2 (no wallet)
const reader = create_reader([
  { chainId: "eip155:31337", transports: [http(anvil())] },
])

// path 1 (wallet-shape) — same shape as production's
// `create_provider(window.ethereum)`; only the provider source differs.
const resolver = create_provider(create_testing_provider(anvil()))
const account = anvil_account(0)

Full docs land in Phase 8.

Exports

Everything ships from the package root — anvil(), account helpers, lifecycle types, the ethernauta_anvil() vitest plugin, without_isolation(), and the anvil RPC method bindings (evm_*, anvil_*).