Skip to content

WalletModal

WalletModal(__namedParameters): Element

Wallet picker and WalletConnect pairing dialog.

The modal loads compatible wallets from WalletConnect Explorer and includes any local wallets from the pairing binding. On a desktop browser it starts pairing when the user asks for a QR code, and closing that view runs the teardown returned by pairing.start.

On a phone it instead pairs as soon as it opens, lists only wallets reachable by a mobile link, and leaves for the wallet inside the tap that chose it. Both are required: WebKit refuses to open a custom scheme once the gesture that asked for it has expired, so the URI cannot be fetched first. A pairing that is about to lapse is replaced with a fresh one.

The dialog traps keyboard focus, closes on Escape, restores previous focus, and labels its controls for assistive technology.

WalletModalProps

Element