Migration Guides
Version-by-version upgrade guides for the Nexus SDK and Avail Widgets.
Each guide covers one upgrade step — what changed, why, and the exact renames and rewrites to apply. New guides are added here as new major versions ship.
Current versions
| Surface | Package / registry | Current |
|---|---|---|
| Nexus SDK | @avail-project/nexus-core | 3.x |
| Avail Widgets | availproject/widgets/nexus (shadcn registry) | Nexus Widget |
Guides
Migrate to Nexus SDK v3
nexus-core 2.x to 3.x: address-based swaps replace bridge methods, one balance query, hooks under options.hooks, intent events.
Migrate to Nexus SDK v2
nexus-core 1.x to 2.x — factory client, param renames, per-operation hooks, plan-based events.
Migrate to Nexus Widget
Standalone SwapWidget/FastBridge/FastTransfer/Deposit components to the single unified Nexus Widget.
How is this guide?