Skip to main content

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

​
Summary

The useSwitchWallet hook is designed to facilitate the process of switching between wallets of an authenticated user. It provides a function to switch the primary wallet.

​
Usage

Available function and states
MethodTypeDescription
switchWallet(walletId: string) => Promise<void>Function to switch the primary wallet by wallet ID

​
Example

import React from "react";
import { useSwitchWallet, useUserWallets } from "@dynamic-labs/sdk-react-core";

const WalletSwitcher = () => {
  const switchWallet = useSwitchWallet();
  const userWallets = useUserWallets();

  return (
    <div>
      {userWallets.map((wallet) => (
        <button key={wallet.id} onClick={() => switchWallet(wallet.id)}>
          {wallet.address}
        </button>
      ))}
    </div>
  );
};

​
Hook Details

Function: switchWallet The switchWallet function switches the primary wallet of the authenticated user. It takes a single argument, walletId, which is the ID of the wallet to switch to.
Last modified on June 25, 2026