Announcements

System Status

Changelog

Dynamic

SDK Reference

API Reference

Live Support

Start Free

Explore Dynamic

PhoneData

Welcome to Dynamic! We're so excited that you're here!

Welcome

Let's get you up and running with a React based signup/login UI! Just [sign up](https://app.dynamic.xyz) and follow the guide below!

Quickstart

Example apps

Go Live Checklist

Adding the SDK

DynamicContextProvider props

Using Wagmi with Dynamic

Using Ethers instead of Viem

Enabling Chains

Embedded Wallet Chains

Account Abstraction Chains

Using RPC Providers

Custom EVM networks (EvmNetwork)

Switching Networks

Sign Up with Email/Social/SMS

Sign Up with Branded Wallets

Adding Captcha Protection

Accessing Users

Verified Credentials

Collecting Extra Information (Information Capture)

Email and Phone Verification

Social Linking

Banxa

UI Customization Options

Adapt UI With Views

Login Views Tutorial

Wallet List Views Tutorial

Adapt Copy With Translations

Inject Extra Content in Widget

Skip Signing Confirmation UI

Headless Overview

Headless Email Signup

Headless SMS signup

Headless Embedded Wallets With OTP

Headless Embedded Wallets With Passkeys

Headless Embedded Wallet Export

Headless User Profile

The `DynamicBridgeWidget` component allows you to handle multi chain bridging

Dynamic Bridge Widget

bridgeChains

This page hosts the keys that you'll need to setup the SDK, validate the JWT, and generate tokens for API usage.

SDK and API Keys

Every project you create in Dynamic comes with a Sandbox and a Live environment. Both these environments behave similarly but we've customized the Sandbox environment to make it ideal for testing and exploring features.

Sandbox vs Live

Analytics

Users

Visitors

One of the first things you'll want to do as you create a new project is update some of the basic metadata associated with the SDK such as your app name, logo url, and support url.

General Settings

Privacy Settings

We take security seriously at Dynamic and most of the work we do is behind the scenes so you don't have to worry about it. We will surface some security features that can be configured. 

Security Settings

Invite Members

If you would like to create a new organization, you can do so.

Organizations

Projects

Webhook Event types

General

Social Providers Overview

Sign in with Farcaster

Enable Write Access to Farcaster

Generate an multi-chain embedded wallet from a Farcaster frame

Phantom Redirect

NextAuth & Dynamic

Wagmi v2 & Dynamic

Wagmi & Dynamic

Create-web3-dapp & Dynamic

Co:Create & Dynamic Integration

Shield3 & Dynamic Integration

XMTP & Dynamic Integration

Add new users to your CRM

Webhooks using a serverless function

Post in a slack channel when you have a new signup

Slack notifications of new signups

Send new users an XMTP message

Migrating to Dynamic

Migrating Users

Migration from RainbowKit

The SDK allows you to build authentication and authorization into your application in a few lines of code.

Introduction to the SDK

Upgrade guides

Examples

Components Introduction

DynamicBridgeWidget

DynamicConnectButton

DynamicContextProvider

DynamicEmbeddedWidget

DynamicMultiWalletPromptsWidget

The `DynamicWagmiConnector` component integrates your Dynamic project settings with Wagmi

DynamicWagmiConnector

DynamicWidget

DynamicUserProfile

DynamicNav

Hooks Introduction

useAuthenticateConnectedUser

Allow for headless email or sms OTP authentication

useConnectWithOtp

Dynamic's React Context which is set via DynamicContextProvider

useDynamicContext

useDynamicModals

useDynamicScopes

useEmbeddedReveal

useEmbeddedWallet

useFunding

useIsLoggedIn

useOtpVerificationRequest

usePasskeyRecovery

useSendBalance

useTokenBalances

useSocialAccounts

useUserUpdateRequest

Get access to the current user/session wallets

useUserWallets

useWalletConnectorEvent

useWalletItemActions

Utilities Introduction

This utility can be used to get a JWT token generated by Dynamic which is stored inside of localStorage.

getAuthToken

getNetwork

isZeroDevConnector

createWalletClientFromWallet

Events Introduction

onAuthFlowCancel

onAuthFlowClose

onAuthFlowOpen

onAuthFailure

onAuthInit

onAuthSuccess

onEmbeddedWalletCreated

onLogout

onOtpVerificationResult

onSignedMessage

onUserProfileUpdate

onWalletAdded

onWalletRemoved

Handlers Introduction

handleConnectedWallet

handleVerifiedUser

Object References Introduction

AccessDeniedCustomButton

This is Dynamic's Bitcoin connector over the basic wallet interface. This can be used to interact with the users Bitcoin wallets.

BitcoinWalletConnector

EvmNetwork

LocaleResource

JWT Payload

An object containing attributes about the user such as the wallet address, email, first name, etc.

UserProfile

JwtVerifiedCredential

SdkViews

WalletOption

An object containing the attributes about the connected wallet. This object would be available immediately after a wallet has been connected.

Wallet

This is Dynamic's WalletConnect connector over the basic wallet interface. This can be used to interact with the users WalletConnect wallets. It has all methods available in the [WalletConnector](https://docs.dynamic.xyz/react-sdk/references/walletconnector) and some additional method specific to WalletConnect wallets.

WalletConnectConnector

This is Dynamic's abstraction over the wallet interface. This can be used to interact with the users wallet.

WalletConnector

WalletsByChain

Dynamic Doctor

Cannot convert a BigInt value to a number

Failed to parse source map warnings

Jest Error: SyntaxError: Cannot use import statement outside a module

NextJS with React 17 With Dynamic React SDK >=0.14.0

Modal pop up isn't visible

Vite.js polyfills necessary for Dynamic SDK

Module not found: Can't resolve 'encoding'

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed

Hydration failed because initial UI does not match what was rendered on the server

Wallet is redirecting to the App Store

WalletConnect Unsupported Chain

Module not found Error (Framer-motion/browser.js)

React Static Flag Error

Solved Issues

TypeScript Compilation Errors

V2: Viem and Wagmi upgrades, SMS login, headless support, smaller bundle sizes and more!

Attribute	Type	Description
dialCode	`string`	Country dial code (e.g: ‘1’)
iso2	`string`	Country iso code (e.g: ‘US’)
phone	`string`	Phone number, numbers only, without dial code (e.g: 5555555555)