Wallet authentication

Connecting an external wallet becomes an explicit choice between connecting and connecting + verifying, and the multi-wallet prompts the React SDK rendered are now yours to build. This page maps the APIs and links to the implementation guides.

Wallet discovery

The catalogue of available wallet providers moves from useWalletOptions to a single function.

React SDK	JavaScript SDK
`useWalletOptions()`	`getWalletOptionsCatalogue()` / `useGetWalletOptionsCatalogue()`

Each entry carries the provider key, display name, icon, and installationUrls so you can render install links for wallets the user doesn’t have. For the full wallet picker (search, install links, deeplinks), see Connecting external wallets.

Connect vs. connect-and-verify

The React SDK decided when to prompt for a signature. Now you choose explicitly:

connectWithWalletProvider({ walletProviderKey }) — connect only (read the address, no signature).
connectAndVerifyWithWalletProvider({ walletProviderKey }) — connect and prompt for a sign-in signature, proving ownership and linking the wallet to the user.

React SDK	JavaScript SDK
`primaryWallet.connector.connect()`	`connectWithWalletProvider()` / `useConnectWithWalletProvider()`
authenticate connected wallet	`connectAndVerifyWithWalletProvider()` / `useConnectAndVerifyWithWalletProvider()`
`isAuthenticatedWithAWallet`	`isWalletAccountVerified({ walletAccount })`

TypeScript
React

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

const walletAccount = await connectAndVerifyWithWalletProvider({
  walletProviderKey,
});

import { useConnectAndVerifyWithWalletProvider } from '@dynamic-labs-sdk/react-hooks';

const { mutate: connectAndVerify } = useConnectAndVerifyWithWalletProvider();

connectAndVerify(
  { walletProviderKey },
  {
    onSuccess: (walletAccount) => {
      // The wallet is connected and verified.
    },
    onError: (error) => {
      // Render your own error UI.
    },
  },
);

Hardware wallets

The dedicated hardware-wallet selection view is gone; check support and account type with functions.

React SDK	JavaScript SDK
hardware wallet selection view	`canConnectWithHardwareWallet()`
—	`isHardwareWalletAccount({ walletAccount })`

Multi-wallet

Automatic multi-wallet prompts (a new wallet detected, switching the active wallet) are gone, and the SDK doesn’t track a selected wallet for you. Read the full set with getWalletAccounts() and build your own selection UI — see Connected wallets management.

Errors you now own

The React SDK rendered built-in screens for these cases; in the JavaScript SDK you catch the typed error and render your own UI.

Case	JavaScript SDK	Build it in
Wallet already linked to another user	catch `WalletAlreadyLinkedToAnotherUserError`	Account conflict resolution
Sanctioned / screened wallet blocked	catch `WalletScreeningBlockedError`	Handling blocked wallets

import {
  connectAndVerifyWithWalletProvider,
  WalletAlreadyLinkedToAnotherUserError,
  WalletScreeningBlockedError,
} from '@dynamic-labs-sdk/client';

try {
  await connectAndVerifyWithWalletProvider({ walletProviderKey });
} catch (error) {
  if (error instanceof WalletScreeningBlockedError) {
    // showAccessDenied is your implementation.
    showAccessDenied();
  } else if (error instanceof WalletAlreadyLinkedToAnotherUserError) {
    // showWalletAlreadyLinked is your implementation.
    showWalletAlreadyLinked();
  } else {
    throw error;
  }
}

Wallet screening (Chainalysis sanctions checks) still runs server-side during verification and is configured per environment in the dashboard — nothing changes there. What changes is that you handle the blocked result and render the UI. The token-gating (gate_blocked) and allowlist (missing_from_list) cases are still surfaced via their raw API error codes.

Installation & Configuration

React Native

Building UI

Migrating from React

Chains & Networks

Authenticate

User & Session Management

Wallets

Flow

Swaps

Funding & Onramp

Events

Wallet authentication

Wallet discovery

Connect vs. connect-and-verify

Hardware wallets

Multi-wallet

Errors you now own

See also

​Wallet discovery

​Connect vs. connect-and-verify

​Hardware wallets

​Multi-wallet

​Errors you now own

​See also

Wallet discovery

Connect vs. connect-and-verify

Hardware wallets

Multi-wallet

Errors you now own

See also