---

name: adding-an-anchor description: Use when adding a new anchor integration to this project — creating an anchor client, its server singleton, API wrappers, proxy routes, and flow pages, or deciding whether a new anchor belongs in ANCHORS vs HONORABLE_MENTIONS.

Adding a new curated anchor

Each curated anchor owns its own client, server-side instance singleton, client-side API wrapper, API routes, and bespoke flow pages. Nothing is shared — see the per-provider isolation decision in CLAUDE.md.

1. src/lib/anchors/<name>/{client,types,index}.ts — shaped however the anchor's API actually works. No interface to satisfy. Define your own error class. Include the debug?: boolean flag described in CLAUDE.md and cover both logging behaviors with tests.
2. src/lib/server/<name>Instance.ts — singleton getter reading env vars, passing debug: dev from $app/environment.
3. src/lib/api/<name>.ts — client-side fetch wrappers per route. Mirror the per-provider shape in etherfuse.ts / testanchor.ts.
4. src/routes/api/anchor/<name>/<operation>/+server.ts — one route per operation.
5. src/routes/anchors/<name>/+page.svelte (landing) and <name>/<flow>/+page.svelte per flow. Compose primitives from src/lib/components/. Use AnchorRegionSelector for the region section. Don't try to share flow logic with another anchor in this PR — let it duplicate.
6. Add the provider to src/lib/constants.ts (PROVIDER).
7. Add to src/lib/config/anchors.ts (ANCHORS).
8. Add to src/lib/config/regions.ts if the anchor serves a region.
9. Add tests under tests/anchors/<name>/.
10. Document in src/lib/anchors/<name>/README.md.

If it doesn't clear the bar

Add it to HONORABLE_MENTIONS in src/lib/config/anchors.ts instead — no client code needed. Give it a scorecard (via makeCriteria) so its gaps render. For a candidate you're still researching rather than rejecting, use the assessing-an-anchor skill.

Adding SEP support

If the anchor needs a SEP this project doesn't implement yet: create src/lib/anchors/sep/sep<N>.ts modeled on the existing modules (pure functions, optional fetchFn), add types to sep/types.ts, export from sep/index.ts, and cover it under tests/anchors/sep/.