When to use this skill

AGENTS.md routes you here when you're working with @sodax/sdk v2 — either writing new code or porting from v1.

Pick your mode:

• Writing NEW v2 code (greenfield, no v1 fingerprints, no React)? → § Integration mode below.
• Porting EXISTING v1 code to v2 (grep finds useSpokeProvider, *_MAINNET_CHAIN_ID, xChainId, SpokeChainId, module-specific error classes)? → § Migration mode below.
• Both? → do migration first, then integration. Stale v1 patterns leak into new code if you skip it.

For React dapps using hooks → use sodax-dapp-kit instead (this skill is still relevant for any unwrapped SDK call).

Prefer a granular skill if the feature is known

If the user has already picked a single feature, load the matching granular skill instead of this broad one — it loads ~3 KB of focused workflow vs this file's ~13 KB and links directly into the right knowledge files. The granular skills sit in the same family (sdk) and cover both integration and migration via internal cross-links.