For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

useWalletConnectScanner

Hook to show the WalletConnect QR scanner using the Wallet Services plugin.

info

Please note that this hook doesn't work for external wallet logins. It only works for social login embedded wallets.

Import​

import { useWalletConnectScanner } from '@web3auth/modal/react'

Usage​

import { useWalletConnectScanner } from '@web3auth/modal/react'

function WalletConnectScannerButton() {
const { showWalletConnectScanner, loading, error } = useWalletConnectScanner()

return (
<div>
<button onClick={() => showWalletConnectScanner()} disabled={loading}>
{loading ? 'Opening Scanner...' : 'Show WalletConnect Scanner'}
</button>
{error && <div>{error.message}</div>}
</div>
)
}

Return type​

import { type IUseWalletConnectScanner } from '@web3auth/modal/react'

loading​

boolean

Whether the scanner opening process is in progress.

error​

Web3AuthError | null

Error that occurred during the scanner opening process.

showWalletConnectScanner​

(showWalletConnectScannerParams?: BaseEmbedControllerState["showWalletConnect"]) => Promise<void>

Function to show the WalletConnect QR scanner. Accepts optional parameters for customizing the scanner behavior.