Skip to main content

Web3Auth v10 external wallet adapters migration guide

This guide focuses specifically on migrating external wallet adapter configurations from Web3Auth v8 to v10. This is a supplementary guide to the main v8 to v10 migration guide.

Overview​

In v8, external wallets required manual adapter configuration. V10 simplifies this by using MIPD (Multiple Injected provider Discovery) to automatically detect and provide access to external wallets without manual setup.

Migration steps​

External wallet adapter migration​

// Individual wallet adapters
import { MetamaskAdapter } from '@web3auth/metamask-adapter'
import { PhantomAdapter } from '@web3auth/phantom-adapter'
import { SolflareAdapter } from '@web3auth/solflare-adapter'

// Default adapter functions
import { getDefaultExternalAdapters, getInjectedAdapters } from '@web3auth/default-evm-adapter'

// Manual adapter configuration
const metamaskAdapter = new MetamaskAdapter()
const phantomAdapter = new PhantomAdapter()
web3auth.configureAdapter(metamaskAdapter)
web3auth.configureAdapter(phantomAdapter)

// Or using helper functions
const adapters = await getDefaultExternalAdapters({ options: web3AuthOptions })
adapters.forEach(adapter => {
  web3auth.configureAdapter(adapter)
})

await web3auth.initModal()

// All external wallets are automatically detected via MIPD
// No manual adapter configuration needed
await web3auth.init()

Key changes​

  • Package Removal: Remove all external wallet adapter packages
  • MIPD Integration: External wallets are automatically detected using MIPD (Multiple Injected provider Discovery)
  • No Configuration: No need to manually configure or register external adapters
  • WalletConnect Support: WalletConnect-compatible wallets are automatically available

Package removal​

Remove these deprecated packages from your project:

# Remove all external wallet adapter packages
npm uninstall @web3auth/metamask-adapter @web3auth/phantom-adapter @web3auth/solflare-adapter @web3auth/slope-adapter @web3auth/default-evm-adapter @web3auth/default-solana-adapter

How it works in v10​

V10 uses MIPD (Multiple Injected provider Discovery) to automatically detect injected wallets in the browser. When users attempt to connect, they'll see:

  1. Installed wallets: Any injected wallets found in the browser
  2. WalletConnect options: Popular wallets available via WalletConnect
  3. Install prompts: Options to install wallets if none are found

This provides a better user experience with no configuration required from developers.

Next steps​

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

On this page