// Use when writing or modifying Vitest tests, `.vitest` setup, Anvil/Foundry or Rundler fixtures, per-package test config, or CI affected-test behavior.
| name | testing |
| description | Use when writing or modifying Vitest tests, `.vitest` setup, Anvil/Foundry or Rundler fixtures, per-package test config, or CI affected-test behavior. |
| last_verified | "2026-05-06T00:00:00.000Z" |
aa-sdk uses Vitest workspace projects with shared .vitest setup. CI runs
affected package tests and a separate typecheck-only Vitest pass.
| Rule | When to read |
|---|---|
| Vitest workspace | Before changing tests or per-package Vitest config. |
| Anvil and Rundler | Before changing tests that depend on local chain fixtures. |
| Affected tests | Before choosing local verification for package changes. |
vitest.workspace.ts loads .vitest and packages/*..vitest/vitest.shared.ts sets ~test, global setup, timeouts, and thread pool.scripts/run-affected-tests.sh uses Turborepo dry-run output to select
Vitest projects.Use when changing GitHub workflows, Lerna versioning, package publish, or post-merge docs hooks (revalidate + SDK indexer).
Use when changing package management, workspace config, build scripts, generated outputs, Turborepo/Lerna config, or local validation in aa-sdk.
Use when editing `docs/**/*.mdx`, generated reference docs, TypeDoc comments, `typedoc.json`, `docs/docs.yml`, or documentation review instructions.
Use when throwing, catching, wrapping, documenting, or testing runtime errors in aa-sdk packages.
Use when changing package entry points, `exports` maps, public API barrels, import paths, or subpath exports in aa-sdk packages.
Use when changing `packages/smart-accounts`, account implementations, modules, permissions, nonces, deferred actions, or account address helpers.