Summary

The useSelectWalletOption hook allows you to start the process of connecting to a specific wallet. It provides a function to select a wallet by wallet key.

Once this function is called, the connection process begins with the caveat that:

  • If you pass in a walletKey that supports multiple chains, such as magiceden, a user will first be asked to select which chain they want to connect with. Once a chain is selected, then the user will be prompted to connect.
  • If you pass in a walletKey that includes a chain, such as magicedenbtc, then the user will skip to the connection step.
  • If a wallet does not support multiple chains, such as xverse, then the user will simply go to the connection step.

Usage

Available function and states

MethodTypeDescription
selectWalletOption(walletKey: string) => Promise<void>Function to select a specific wallet to connect with

Example

import { useSelectWalletOption } from "@dynamic-labs/sdk-react-core";

const WalletList = () => {
  const { selectWalletOption } = useSelectWalletOption();

  const wallets = [
    { key:'metamask', name: 'MetaMask' }, 
    { key: 'magiceden', name: 'Magic Eden' }
  ];

  return (
    <div>
      {wallets.map((wallet) => (
        <button key={wallet.key} onClick={() => selectWalletOption(wallet.key)}>
          {wallet.name}
        </button>
      ))}
    </div>
  );
};

Hook Details

Function: selectWalletOption

The selectWalletOption function select a wallet to connect with. It takes a single argument, walletKey, which is the key of the wallet to connect with.

You can find the available wallet keys either from wallet-book (object keys in groups or wallets) or in the chains pages in the dashboard.