error-handling
Use when throwing, catching, wrapping, documenting, or testing runtime errors in aa-sdk packages.
Source facts
- Repository
- alchemyplatform/aa-sdk
- Last source activity
- May 21, 2026 at 23:38
- Detected SKILL.md language
- English
- Stars
- 321
- Forks
- 235
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
4 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- error-handling
- description
- Use when throwing, catching, wrapping, documenting, or testing runtime errors in aa-sdk packages.
- last_verified
- 2026-05-06T00:00:00.000Z
# Error Handling
Runtime package errors should use the SDK error hierarchy rooted at
`@alchemy/common` `BaseError`.
## Rules
| Rule | When to read |
| ----------------------------------------- | ----------------------------------------------- |
| [BaseError](rules/base-error.md) | Before adding package runtime errors. |
| [No plain Error](rules/no-plain-error.md) | Before writing throw statements in `packages/`. |
| [Raise footgun](rules/raise-footgun.md) | Before using or modifying `raise`. |
## Evidence
- `packages/common/src/errors/BaseError.ts` extends viem's `BaseError`.
- `.eslintrc` forbids `throw new Error(...)` in `packages/**/*` except tests.
- `.eslintrc` forbids `import { BaseError } from "viem"` to prevent accidentally
using viem's `BaseError` instead of `@alchemy/common`'s.
- `packages/wallet-apis/src/utils/schema.ts` wraps Zod validation failures in
`@alchemy/common` `BaseError`.
View on GitHub