Skip to main content

Web3Auth v10 Wallet Services Migration Guide

This guide focuses specifically on migrating Wallet Services functionality from Web3Auth v8 to v10. This is a supplementary guide to the main v8 to v10 migration guide.

Overview​

In v8, Wallet Services (Checkout, Swap, WalletConnect Scanner, Embedded Wallet UI) required installing and configuring a separate @web3auth/wallet-services-plugin package. V10 integrates these services directly into the main SDK.

Migration Steps​

Plugin Access Migration​

import { WalletServicesPlugin } from "@web3auth/wallet-services-plugin";

const walletServicesPlugin = new WalletServicesPlugin({
  // plugin configuration options
});

web3auth.addPlugin(walletServicesPlugin);
await web3auth.initModal();

// Usage
await walletServicesPlugin.showWalletUi();
await walletServicesPlugin.showCheckout();
await walletServicesPlugin.showWalletConnectScanner();

import { EVM_PLUGINS } from "@web3auth/modal";

await web3auth.init();

// Get the built-in wallet services plugin
const walletServicesPlugin = web3auth.getPlugin(EVM_PLUGINS.WALLET_SERVICES);

// Usage (methods now require { show: true } parameter)
await walletServicesPlugin.showWalletUi({ show: true });
await walletServicesPlugin.showCheckout({ show: true });
await walletServicesPlugin.showSwap({ show: true });
await walletServicesPlugin.showWalletConnectScanner({ show: true });

Key Changes​

  • Package Removal: Remove @web3auth/wallet-services-plugin package
  • Built-in Integration: Wallet Services are now automatically included in the main SDK
  • Plugin Access: Use web3auth.getPlugin(EVM_PLUGINS.WALLET_SERVICES) to access functionality
  • Parameter Updates: Methods now require a { show: true } parameter

Package Removal​

Remove the deprecated package from your project:

npm uninstall @web3auth/wallet-services-plugin

Next Steps​

Return to the main v8 to v10 migration guide to continue with other migration aspects.