Skip to main content

Web3Auth v10 Wallet Services Migration Guide

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

Overview​

In v7, 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 v7 to v10 migration guide to continue with other migration aspects.

On this page