Link a Wallet
Using Your UI
If the user is not already logged in, it will trigger login with that wallet rather than linking. The difference between login and linking is that login will create a new user if one doesn’t exist, whereas linking will add the wallet to the existing user.
useWalletOptions provides a method called
selectWalletOption
that allows you to prompt the user to link using a specific wallet (by passing in the key).This method takes a wallet key, you can see how to find the available wallet keys in Find a Wallet Key.React
Using Dynamic Modals
You can allow the user to link a new wallet by using the useDynamicModals hook and the
setShowLinkNewWalletModal
method.You will need to also use the DynamicMultiWalletPromptsWidget component
Linking will fail if user is not fully logged in i.e. if they are missing info. See Check for Missing User Info for more information.
React
Headless per-wallet linking by key is currently a React-only pattern via useWalletOptions. For React Native and Flutter, use the SDK UI to let users link wallets from the profile modal.
Unlink a Wallet
You can unlink a wallet by using the useDynamicContext hook, specifically the
handleUnlinkWallet
method.React