Hello Web3Auth Developers,
We are incredibly excited to announce the arrival of Web3Auth PnP SDK v10! This landmark release represents a major leap forward, empowering you with a more intuitive, powerful, and developer-friendly experience through a single, unified SDK.
Web3Auth v10 evolves our platform to further streamline your workflow, significantly reducing code complexity and enhancing development speed. We’ve focused on what matters most: a clean, efficient, and flexible integration.
Web3Auth v10 at a Glance: Key Highlights & Advantages
-
One SDK for All Flows: A single
@web3auth/modal
SDK now supports both experiences: using our pre-built modal UI, and implementing your own custom user interface with direct connection capabilities. This dramatically simplifies your integration choices and reduces package management. -
Modernized React Experience: Enjoy a cleaner, more efficient React development with an exclusively hooks-based architecture (
@web3auth/modal/react
). -
Dashboard-Powered Configuration: Many settings (Connections, Chains, Smart Accounts, UI Customizations, Wallet Features) are now visually managed on the Web3Auth Developer Dashboard, reducing client-side code and offering better visibility.
-
Simplified Authentication and Logins: Authentication setup is now easier—just toggle it on or update key fields for custom authentication. The updated login modal offers better control and customization.
-
Native SSR Support: Ensures that you know your users are authenticated before your page even hits the browser.
-
Reduced Boilerplate & Faster Development: Get up and running with significantly less initial code, leading to faster development cycles.
-
Enhanced Readability & Maintainability: More declarative configurations and centralized dashboard settings make your integration easier to understand, manage, and update.
What’s New in the Unified Web3Auth v10 SDK? 
1. One Unified SDK for All Your Needs (Pre-built Modal & Custom UI Flows)
-
The Power of One: We’ve consolidated into a single, versatile
@web3auth/modal
SDK. Whether you need a beautiful, pre-built login modal for quick integration, or you want to craft a completely custom user interface by directly connecting to authentication providers, v10 has you covered. -
Ultimate Flexibility, Minimal Code: This unification means fewer packages to manage and significantly less boilerplate. Integrate sophisticated auth flows with just a few lines of code, without sacrificing flexibility.
2. Modernized React Experience: Hooks-First Simplicity
-
Effortless React Integration: For React developers, v10 mandates a hooks-based architecture using
@web3auth/modal/react
. Hooks likeuseWeb3AuthConnect
,useWeb3AuthDisconnect
, anduseWeb3AuthUser
dramatically simplify state management and component lifecycle. -
Less Code, More Power: This approach naturally leads to cleaner components and a more intuitive development flow.
// v10 @web3auth/modal SDK (React Hooks) - Example for Custom UI with Direct Connection import { useWeb3AuthConnect, WALLET_CONNECTORS, AUTH_CONNECTION } from "@web3auth/modal/react"; // In your React component, get the connect function: const { connectTo } = useWeb3AuthConnect(); // As per your example, connectTo is used // Later, in an async function to handle a custom connection: await connectTo(WALLET_CONNECTORS.AUTH, { authConnection: AUTH_CONNECTION.CUSTOM, // Or specific providers like AUTH_CONNECTION.GOOGLE authConnectionId: "your-connection-id-from-dashboard", // Connection ID from Dashboard // groupedAuthConnectionId: "optional-group-id" // For account linking });
-
Non-React Environments: For Angular, Vue, VanillaJS, etc., direct usage of the
Web3Auth
class from@web3auth/modal
remains the robust standard.
3. The Dashboard: Your Central Hub for Seamless Configuration & Visibility
Many configurations have moved to the Web3Auth Developer Dashboard, providing a clear visual interface and reducing client-side setup:
-
Connections & Social Logins: Define, customize, and manage your authentication connections (previously verifiers) directly on the dashboard. We’ve streamlined nomenclature to
authConnectionId
for simplicity, aligning with industry standards.
-
Blockchain & Chain Configurations: Set up your desired chains (standard or custom) effortlessly. For many standard EVM chains, there are predefined chains already present so that you don’t need to add them. Custom chains can also be added.
-
Smart Account (EIP-4337) Setup: Enable and configure Smart Accounts with a simple toggle. Set parameters for bundlers and paymasters directly through the dashboard.
-
Branding Customizations (for pre-built modal flow): Whitelabel the login modal and tweak its appearance to perfectly match your brand.
-
Modal Customizations (for pre-built modal flow): Tweak what gets displayed on the modal, in what order and more.
-
Wallet Configuration: Tailor the in-wallet experience for your users by configuring features like token display, NFT display, buy/send/swap buttons, and more, all from the dashboard.
4. Simplified Login & Connection Logic
-
No More Client-Side Adapter Configuration: The explicit need to import and manage adapter packages (like
@web3auth/auth-adapter
) or callweb3auth.configureAdapter()
is gone for standard setups. -
Using the Pre-built Modal UI: Customize which dashboard-configured connectors appear (and their order) using
modalConfig
in yourWeb3Auth
constructor (class-based) orWeb3AuthProvider
options (React).// v10 @web3auth/modal SDK (Class-based) - Example for Pre-built Modal UI import { Web3Auth, WEB3AUTH_NETWORK, WALLET_CONNECTORS } from "@web3auth/modal"; const web3auth = new Web3Auth({ clientId: "YOUR_CLIENT_ID", web3AuthNetwork: WEB3AUTH_NETWORK.SAPPHIRE_MAINNET, modalConfig: { [WALLET_CONNECTORS.AUTH]: { // For dashboard-configured social/custom connections loginMethods: { // Define which configured connections appear in the modal and their order google: { name: "Google", showOnModal: true }, // Assuming 'google' is a configured connection // ... other connections }, }, }, });
-
Building Your Own UI with Direct Connections: If you prefer to implement your own login flow without our pre-built modal, the
connectTo
method is your go-to, using theauthConnectionId
from your dashboard setup.
5. Simplified Multi-Factor Authentication (MFA)
- MFA configuration is now more direct. Define global
mfaSettings
in the SDK constructor/Web3AuthProvider
options, or specify a per-connectionmfaLevel
.
6. Native Server-Side Rendering (SSR) Support
- Web3Auth v10 now includes improved native SSR support, ensuring that you know your users are authenticated before your page even hits the browser. This enables better performance and SEO for your applications.
Migration Notes: Key Updates & Deprecations
To ensure a smooth transition to v10, please note these important changes:
-
Consolidated SDK: The
@web3auth/no-modal
SDK is an internal SDK for@web3auth/modal
SDK. -
Deprecated Packages:
@web3auth/base
,@web3auth/auth-adapter
,@web3auth/account-abstraction-provider
, and chain-specific providers (like@web3auth/ethereum-provider
for standard Web3Auth init) are deprecated as their functionalities are merged or dashboard-driven. -
Parameter Rename: The constructor option
useCoreKitKey
(v9) for SFA-compatible keys is nowuseSFAKey
(v10). -
Connection Nomenclature: “Verifiers” are now referred to as “Connections” with an
authConnectionId
configured on the dashboard.
Ready to Upgrade?
We’ve crafted a detailed migration guide to help you transition:
- Migrating to the Unified Web3Auth PnP Modal SDK v10: Migration Guide
We highly recommend reviewing the “Before You Start” section in the guide.
Join the v10 Journey!
We are incredibly proud of Web3Auth v10 and believe it marks a significant step forward.
-
Dive into the Docs:
- Web3Auth PnP Web SDK (v10)
- Explore Examples: Web3Auth PnP Examples on GitHub (updated to v10)
-
Share Your Feedback: Your insights are invaluable. Join the discussion in our Web3Auth Community.
Thank you for being a part of the Web3Auth community. We can’t wait to see what you build with v10!
Happy Coding!
The Web3Auth Team