6.0.4

Web SDK 6.0.0 Series

Breaking Changes

• Migrated to @0xsequence v3 SDK — All underlying dependencies (api, indexer, metadata) now target v3. Update any direct imports accordingly.
• ESM-first builds — Package outputs are now ESM-first; CJS build steps have been removed. Ensure your bundler or runtime supports ESM imports.
• Replaced @0xsequence/network with wallet-primitives networks — Chain/network utilities now come from wallet-primitives instead of the legacy @0xsequence/network package.
• Removed ethers.js dependency — The SDK no longer depends on ethers. Wordlists and utilities are sourced from viem instead.
• Removed old connectors — Legacy wallet connectors have been replaced with the new V3 connector architecture.
• Removed Immutable connector package — The unused @0xsequence/immutable-connector package has been removed.

New Features

• V3 Connector — New connector built on Sequence v3, supporting email, Apple, and passkey sign-in methods out of the box.
• Ecosystem branded connectors — Support for ecosystem-specific branded connector options via the V3 connector.
• Explicit Sessions & Permissions — New explicitSession configuration (renamed from permissions) enables fine-grained session permission management.
  • usePermissions hook for checking and managing session permissions.
  • useFeeOptions hook for handling fee option selection and balance checks.
  • useSequenceSessionInfo hook for reading session state.
  • includeFeeOptionPermissions flag for addExplicitSession with cumulative permission support.
  • modifySession support for updating sessions after creation.
• Remote wallet configuration — Wallet metadata and SDK configuration are now fetched from the Sequence wallet API, with built-in caching and TTL support.
• Dynamic chain configuration — setChains utility allows updating supported chains dynamically from remote config. Unsupported chain IDs are gracefully ignored.
• Session restore — Ability to restore previous sessions for V3 connectors.
• Wallet actions for sends — V3 wallet sends now use wallet actions for improved reliability.
• Updated wagmi — Upgraded to wagmi 2.19.5 and viem 2.44.4 with withCapabilities support.
• Design System v3 — Upgraded to @0xsequence/design-system v3 with refreshed UI components, improved theming, network selection with search, and updated branding.

Improvements

• ethAuth utility improvements — Enhanced ethAuth util with better caching and validation.
• Safari popup fix — Resolved popup-related issues on Safari.
• SSR-safe hooks — Hooks are now safe for server-side rendering (Next.js compatible).
• Improved connect UI — Fixed element jump issues, improved loading states (undismissable loading modal), better text truncation, and left-aligned vertical connect button contents.
• App name config is now optional — No longer required in the configuration.
• dappOrigin defaults to window.origin — Simplifies configuration for most use cases.

---

6.0.1

• Updated @0xsequence packages to latest v3 releases.

6.0.2

• fix(checkout): Pinned wallet and public clients to the checkout chain to prevent cross-chain issues during checkout flows.

6.0.3

• Updated @0xsequence v2 WaaS-related packages and removed unused code.
• Preserved native token pricing in hooks.
• Upgraded Design System to v3.2.9 with additional UI fixes (updated logos, improved connecting modal, spinner theming, icon colors).

6.0.4

• fix(connect): Normalized v3 Sequence node URLs to prevent connection issues from inconsistent URL formats.

5.2.0

• Completely reimplemented Wallet Widget modal, with support for displaying all tokens and NFTs in connected wallets, swap, buy, receive and send functionality, multi-accounts, wallet linking and multiple social auth for Embedded Wallet
• useCheckoutUI hook for programmatically integrating checkout flows
• Various fixes and improvements

5.1.0

• Immutable Passport support
• useListAccounts hook
• Improved docs
• Swap flow improvements

5.0.5

• Ecosystem wallet connector
• Sardine onramp support
• Various fixes to checkout

5.0.1

Web SDK v5 brings compatibility with Sequence Design System v2, streamlining ability to customize Web SDK integrations with Sequence infrastructure. We've also revamped our package structure for easier integration and added more programmatic hooks for direct integrations into all SDK features.

Read our migration guide to learn how to migrate from Sequence Kit v4 to Sequence Web SDK v5