Bridge (dapp-kit granular skill)

Granular skill for the bridge hooks of @sodax/dapp-kit v2. queryKey/mutationKey first segment: bridge. React-only — backend uses @sodax/sdk directly.

Step 1 — Clarify with user before coding

1. New code or v1 → v2 port?
2. Need a bridgeable precheck? useGetBridgeableAmount (vault deposit/withdrawal cap, returns a BridgeLimit) and useGetBridgeableTokens (enumerate compatible destinations).
3. Allowance gating? useBridgeAllowance + useBridgeApprove before useBridge.
4. Source/destination chains + recipient format — confirm both are supported spokes and the recipient matches the destination chain encoding.

Integration workflow (new v2 code)

1. ../integration/knowledge/ai-rules.md — DO / DO NOT (read first).
2. ../integration/knowledge/architecture.md — hook shapes, mutateAsyncSafe, unwrapResult, queryKey conventions.
3. ../integration/knowledge/features/bridge.md — full hook surface, CreateBridgeIntentParams shape, useBridgeAllowance nesting, BridgeLimit return.
4. ../integration/knowledge/recipes/bridge.md — full worked example.
5. Call-shape choice → ../integration/knowledge/recipes/mutation-error-handling.md.