Embedded wallets: setup & creation

In the React SDK, embedded (WaaS) wallets were created for you: the widget’s onboarding flow (useSyncEmbeddedWalletFlow) ran after login and, when the project had automatic creation enabled, provisioned a wallet without any code on your side. The JavaScript SDK removes that implicit step — you call createWaasWalletAccounts yourself, after checking whether the user still needs a wallet.

What maps to what

React SDK	JavaScript SDK
automatic creation via `useSyncEmbeddedWalletFlow`	you call `createWaasWalletAccounts({ chains })` after login
`useDynamicWaas().createWalletAccount(requirements)`	`createWaasWalletAccounts()` / `useCreateWaasWalletAccounts()`
`useEmbeddedWallet().userHasEmbeddedWallet()`	`getChainsMissingWaasWalletAccounts()` (empty → nothing to create)
project setting “automatic embedded wallet creation”	`shouldAutoCreateWalletForChain({ chain })`
widget checked WaaS availability internally	`isDynamicWaasEnabled()`

What’s missing for this user?

Before creating anything, confirm WaaS is enabled and find the chains the user doesn’t have a wallet for yet. getChainsMissingWaasWalletAccounts() returns exactly the chains you should create — an empty array means the user is already set up.

import {
  isDynamicWaasEnabled,
  getChainsMissingWaasWalletAccounts,
} from '@dynamic-labs-sdk/client/waas';

if (isDynamicWaasEnabled()) {
  const missingChains = getChainsMissingWaasWalletAccounts();
  // missingChains is e.g. ['EVM', 'SOL'] — empty when nothing to create.
}

Reproducing the auto-create behavior

The one thing that changes for migrating apps is that nothing creates the wallet for you anymore. To keep the React SDK’s “create on login automatically” behavior, run the check-and-create step yourself once the user is authenticated. shouldAutoCreateWalletForChain({ chain }) mirrors the project setting the widget used to read.

TypeScript
React

import {
  shouldAutoCreateWalletForChain,
  createWaasWalletAccounts,
  getChainsMissingWaasWalletAccounts,
} from '@dynamic-labs-sdk/client/waas';

// Call this after login resolves.
async function autoCreateWallets() {
  const chains = getChainsMissingWaasWalletAccounts().filter((chain) =>
    shouldAutoCreateWalletForChain({ chain }),
  );
  if (chains.length > 0) await createWaasWalletAccounts({ chains });
}

import {
  shouldAutoCreateWalletForChain,
  getChainsMissingWaasWalletAccounts,
} from '@dynamic-labs-sdk/client/waas';
import { useCreateWaasWalletAccounts } from '@dynamic-labs-sdk/react-hooks';
import { useEffect } from 'react';

function useAutoCreateWallets(isAuthenticated: boolean) {
  const { mutate: createWallets } = useCreateWaasWalletAccounts();

  useEffect(() => {
    if (!isAuthenticated) return;
    const chains = getChainsMissingWaasWalletAccounts().filter((chain) =>
      shouldAutoCreateWalletForChain({ chain }),
    );
    if (chains.length > 0) createWallets({ chains });
  }, [isAuthenticated, createWallets]);
}

When your project protects WaaS wallets with a password, collect it first (isPasswordRequiredForWaasWallets()) and pass it to createWaasWalletAccounts({ chains, password }) — the same password protects every WaaS wallet the user has. See Embedded wallets: password & security.

Building it

Wallet creation is one step of the wider post-login setup, so the full build — the on-demand “Create wallet” button, password handling, and error cases — lives in the Building UI guide: Post-login user setup → Embedded wallet step (Building UI).

Installation & Configuration

React Native

Building UI

Migrating from React

Chains & Networks

Authenticate

User & Session Management

Wallets

Flow

Swaps

Funding & Onramp

Events

Embedded wallets: setup & creation

What maps to what

What’s missing for this user?

Reproducing the auto-create behavior

Building it

See also

​What maps to what

​What’s missing for this user?

​Reproducing the auto-create behavior

​Building it

​See also

What maps to what

What’s missing for this user?

Reproducing the auto-create behavior

Building it

See also