canConnectWithHardwareWallet - Dynamic

Checks whether a specific wallet provider supports connecting via a hardware wallet vendor (e.g., Ledger). Use this before presenting hardware wallet options to the user, or to filter the list of available providers to only those compatible with a hardware device.

Usage

import {
  getAvailableWalletProvidersData,
  canConnectWithHardwareWallet,
} from '@dynamic-labs-sdk/client';

const ledgerProvider = getAvailableWalletProvidersData().find((provider) =>
  canConnectWithHardwareWallet({
    walletProviderKey: provider.key,
    hardwareWalletVendor: 'ledger',
  })
);

if (ledgerProvider) {
  console.log(`${ledgerProvider.metadata.displayName} supports Ledger`);
}

Parameters

Parameter	Type	Description
`walletProviderKey`	`string`	The key identifying the wallet provider. Use `getAvailableWalletProvidersData()` to get available providers and their keys
`hardwareWalletVendor`	`HardwareWalletVendor`	The hardware wallet vendor to check for. Currently `'ledger'`
`client`	`DynamicClient` (optional)	The Dynamic client instance. Only required when using multiple clients.

Returns

boolean — true if the wallet provider declares support for the given hardware wallet vendor, false otherwise.

Examples

Filter providers to Ledger-compatible ones

import {
  canConnectWithHardwareWallet,
  getAvailableWalletProvidersData,
} from '@dynamic-labs-sdk/client';

const allProviders = getAvailableWalletProvidersData();

const ledgerProviders = allProviders.filter((provider) =>
  canConnectWithHardwareWallet({
    walletProviderKey: provider.key,
    hardwareWalletVendor: 'ledger',
  })
);

Connect with the first available Ledger provider

import {
  getAvailableWalletProvidersData,
  canConnectWithHardwareWallet,
  connectWithWalletProvider,
} from '@dynamic-labs-sdk/client';

const ledgerProvider = getAvailableWalletProvidersData().find((provider) =>
  canConnectWithHardwareWallet({
    walletProviderKey: provider.key,
    hardwareWalletVendor: 'ledger',
  })
);

if (ledgerProvider) {
  const walletAccount = await connectWithWalletProvider({
    walletProviderKey: ledgerProvider.key,
    hardwareWalletVendor: 'ledger',
  });
}

React

canConnectWithHardwareWallet is synchronous — filter the list from useGetAvailableWalletProvidersData in @dynamic-labs-sdk/react-hooks, which updates when providers change. See Getting available wallets to connect for the same pattern.

import { canConnectWithHardwareWallet } from '@dynamic-labs-sdk/client';
import {
  useGetAvailableWalletProvidersData,
  useConnectWithWalletProvider,
} from '@dynamic-labs-sdk/react-hooks';

function LedgerProviderList() {
  const { data: providers = [] } = useGetAvailableWalletProvidersData();
  const { mutate: connectWithWalletProvider } = useConnectWithWalletProvider();
  const ledgerProviders = providers.filter((p) =>
    canConnectWithHardwareWallet({
      walletProviderKey: p.key,
      hardwareWalletVendor: 'ledger',
    }),
  );

  return (
    <ul>
      {ledgerProviders.map((p) => (
        <li key={p.key}>
          <button
            onClick={() =>
              connectWithWalletProvider({
                walletProviderKey: p.key,
                hardwareWalletVendor: 'ledger',
              })
            }
          >
            Connect via {p.metadata.displayName}
          </button>
        </li>
      ))}
    </ul>
  );
}

isHardwareWalletAccount - Check if a connected account came from a hardware wallet
connectWithWalletProvider - Connect a wallet (supports hardwareWalletVendor)
Hardware Wallet Support - Overview of hardware wallet support

Last modified on September 21, 2026