// Use when changing package management, workspace config, build scripts, generated outputs, Turborepo/Lerna config, or local validation in aa-sdk.
| name | tooling |
| description | Use when changing package management, workspace config, build scripts, generated outputs, Turborepo/Lerna config, or local validation in aa-sdk. |
| last_verified | "2026-05-21T00:00:00.000Z" |
aa-sdk is a pnpm workspace on main (v5 SDK; graduated from v5.x.x) with
Turborepo for build/test graphs and Lerna for package versioning/publish. The
legacy v4 SDK lives on v4.x.x and only receives backports.
| Rule | When to read |
|---|---|
| Package manager and build | Before changing scripts, dependencies, workspace config, or build commands. |
| Tracked tree only | Before auditing or generating guidance from repository contents. |
| Generated output policy | Before editing generated outputs or files produced by build/doc scripts. |
package.json declares packageManager: pnpm@9.15.4 and root scripts.pnpm-workspace.yaml lists templates/*, .vitest, halp, and packages/*.turbo.json defines build and test task graph behavior.lerna.json lists the four published packages and the current stable v5 version.Use when changing GitHub workflows, Lerna versioning, package publish, or post-merge docs hooks (revalidate + SDK indexer).
Use when writing or modifying Vitest tests, `.vitest` setup, Anvil/Foundry or Rundler fixtures, per-package test config, or CI affected-test behavior.
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.