Wallet modal (wallet-sdk-react granular skill)

Granular skill for the headless multi-chain modal + connection-flow + batch hooks of @sodax/wallet-sdk-react v2 — render-agnostic, wallet-agnostic building blocks. Source-of-truth reference lives in the parent broad skill's knowledge tree; this file is the focused workflow only.

Step 1 — Clarify with user before coding

1. New code or v1 → v2 port? New → § Integration. Port v1 → § Migration.
2. Which primitive? Full modal state machine (useWalletModal), modal-less inline flow (useConnectionFlow), chain/connection lists (useChainGroups / useConnectedChains), or bulk ops (useBatchConnect / useBatchDisconnect).
3. Need a render? These hooks are render-agnostic — you own the JSX (the hooks supply state + actions; you map them to your components).

Integration workflow (new v2 code)

1. ../integration/knowledge/ai-rules.md — DO / DON'T (read first).
2. ../integration/knowledge/recipes/setup.md — prerequisite: mount SodaxWalletProvider, declare chain-type slots, wire React Query.
3. ../integration/knowledge/architecture.md — frozen config, EVM single-connection model, persist hydration gate.
4. ../integration/knowledge/recipes/multi-chain-modal.md and ../integration/knowledge/recipes/batch-operations.md.
5. Lookups → ../integration/knowledge/reference/hooks.md (modal / multi-chain section), connectors.md, wallet-brands.md.

Modal-specific anti-patterns