helpers-checklist.mdc

---
description: Checklist when adding or removing std helpers
globs: modules/std/src/helpers/*.ts
alwaysApply: false
---

# Adding / removing a std helper

When you add, remove, or rename a helper in `modules/std/src/helpers/`, you must also update the helper lists in `packages/test-utils/src/constants.ts`:

- `STD_ALL_HELPERS` — every helper.
- `STD_ADDRESS_HELPERS` — helpers whose `returnType` includes `"address"` or `"any"`.
- `STD_NUMBER_HELPERS` — helpers whose `returnType` includes `"number"` or `"any"`.
- `STD_BYTES32_HELPERS` — helpers whose `returnType` includes `"bytes32"` or `"any"`.
- `STD_BOOL_HELPERS` — helpers whose `returnType` includes `"bool"` or `"any"`.
- `STD_BYTES_HELPERS` — helpers whose `returnType` includes `"bytes"` or `"any"`.

A `returnType` of `"any"` is compatible with **all** lists.

After updating, run codegen (`bun packages/sdk/scripts/codegen.ts` from the module directory) and verify tests pass (`bun test modules/std/test/unit/completions.test.ts`).