Swap (dapp-kit granular skill)

Granular skill for the swap hooks of @sodax/dapp-kit v2. React-only — backend/Node swaps use @sodax/sdk directly. 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 workflow.
   • Port v1 → § Migration workflow.
2. Which hooks? Quote/preview (useQuote), execute (useSwap), allowance gate (useSwapAllowance + useSwapApprove), status polling (useStatus), or limit orders (useCreateLimitOrder / useCancelLimitOrder).
3. Market order or limit order? Limit orders use useCreateLimitOrder (no deadline; cancel manually via useCancelLimitOrder).
4. Imperative flow or render-driven? Sequenced flows → mutateAsyncSafe (returns Result<T>, never rejects). Fire-and-forget → mutate.

Integration workflow (new v2 code)