القائمة
Use when you need to hit the running local stack (API, gateful, dashboard, indexer) to test or verify a change. Covers scripts/dev.sh, hot reload, and the ports each service listens on.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use for apps/api work: adding or changing REST controllers, services, repositories, mappers, clients, schema mapping, or API tests.
Use for apps/dashboard work: routes, features, shared components/hooks, styling, data-fetching wiring, and dashboard tests.
Use for apps/gateful work: REST aggregation of DAO APIs, Hono + zod-openapi routing, DAO source discovery (DAO_API_*), proxying, caching, circuit breaker, and gateway tests.
Use when preparing a PR — adding a changeset, choosing bump types, empty changesets, API-contract changes, or understanding the version/release flow.
Use when adding a new DAO to the Anticapture platform. Covers all five components — indexer, API, gateway, dashboard, and enum sync — with a step-by-step checklist.
Use when adding a new DAO to the Anticapture dashboard. Walks through enum registration, config creation, quorum label, icon setup, and wiring — with exact file paths and a worked example (FLUID).
| name | local-dev-stack |
| description | Use when you need to hit the running local stack (API, gateful, dashboard, indexer) to test or verify a change. Covers scripts/dev.sh, hot reload, and the ports each service listens on. |
The local stack is started with scripts/dev.sh (usually already running — check the
ports before starting your own). All services hot-reload on file save — after
editing source you do NOT need to restart; just re-hit the endpoint.
./scripts/dev.sh <dao> # e.g. tornado, uniswap, gitcoin, scroll, shutter, compound
./scripts/dev.sh <dao> --indexer # also run the indexer for that DAO
./scripts/dev.sh <dao> --debug-api # wait for API from IDE debugger instead of spawning it
./scripts/dev.sh # no DAO → API skipped, uses DAO_API_* from .env
By default all services run locally (env from .env). Opt into railway run -e dev
env injection per service:
| Flag | API | Gateful |
|---|---|---|
| (none) | local | local |
--rw-api | railway | local |
--rw-gateful | local | railway |
--rw | railway | railway |
--rw-api falls back to .env if the Railway service isn't found. Relayer and
Address Enrichment always use railway run when available.
On startup it kills anything already on the ports below, so a second run replaces the first.
| Service | Port | URL | Notes |
|---|---|---|---|
| API | 42069 | http://localhost:42069 | only when a <dao> is passed |
| Indexer | 42070 | http://localhost:42070 | only with --indexer |
| Gateful (gateway) | 4001 | http://localhost:4001 | always |
| Dashboard | 3000 | http://localhost:3000 | always |
| Address Enrichment | 3001 | http://localhost:3001 | optional, skipped if no Railway svc |
| Relayer (ENS) | 3002 | http://localhost:3002 | ENS only |
Client SDK codegen runs in watch mode (no port) and regenerates on API/gateful changes.
http://localhost:42069 — OpenAPI/REST.http://localhost:4001.DAO_API_<UPPER_ID> (e.g. DAO_API_TORN,
DAO_API_UNI). dev.sh exports these automatically.apps/gateful/src/_dev-reload.ts so gateful
reloads and re-points at the recovered API.Stop everything with Ctrl+C (dev.sh traps it and kills the whole process group).