Upgrade from V2 to V3

V3 is still under development more breaking changes are going to be added here until we cut the first stable version [3.0.0]

Changes in 3.0.0-alpha.53 -> latest

See here for changes from 2.x.x to 3.0.0-alpha.52

Wallet and WalletConnectors

No undesired prompting

No more undesired prompting to reconnect or switch wallets when not required!

Now a wallet can be made primary at any time without extra prompting, even if the wallet is not connected or unlocked.

Users will only be prompted to connect/unlock when sending/signing a transaction if the wallet is not connected or unlocked already.

Wallet object has changed

• wallet.authenticated changed to wallet.isAuthenticated
• wallet.connected is now an async method wallet.isConnected()
• wallet.network is now an async method wallet.getNetwork()
• wallet.chain valid values have changed

We used to use values like ‘eip155’ for wallet.chain. This is no longer the case. The new valid values for wallet.chain are the following:

'ALGO' | 'BTC' | 'COSMOS' | 'EVM' | 'FLOW' | 'SOL' | 'STARK'

The Wallet object has changed and now contains some methods that were previously on the WalletConnector object. Each chain specific wallet has its own methods. The methods specific to the main chains on the wallet object are:

• EthereumWallet

  • getPublicClient
  • getWalletClient

• SolanaWallet

  • getConnection
  • getSigner

• BitcoinWallet

  • sendBitcoin
  • sendRawTransaction
  • signMessageWithAddress
  • signPsbt
  • signPsbts

• CosmosWallet

  • getOfflineSigner
  • getProvider

• StarknetWallet

  • getProvider
  • getWalletAccount

• AlgorandWallet

  • getSigner

Wallet type checking

You should always use our utilities to check that you’re dealing with the correct wallet type before calling the wallet specific methods.

import { isEthereumWallet } from '@dynamic-labs/ethereum';
import { isSolanaWallet } from '@dynamic-labs/solana';
import { isBitcoinWallet } from '@dynamic-labs/bitcoin';

const { primaryWallet } = useDynamicContext();

if (isEthereumWallet(primaryWallet)) {
  console.log('call any ethereum wallet method')
}

if (isSolanaWallet(primaryWallet)) {
  console.log('call any solana wallet method')
}

if (isBitcoinWallet(primaryWallet)) {
  console.log('call any bitcoin wallet method')
}

Learn more in the Wallet Interactions section.

Wallet connector object has changed

Since we have moved some methods from the connector to the wallet object, the wallet connector object is now slimmed down, you can find the methods and props available on both the connector and the wallet object in the Wallet Interactions section.

As with the wallet object, each chain specific wallet connector has its own methods so we recommend checking out the appropriate section for the chain you are working with.

• Before
• After

import { useDynamicContext } from '@dynamic-labs/sdk-react-core'
const { primaryWallet } = useDynamicContext()

const fetchBalance = async () => {
  const balance = await primaryWallet?.connector.getBalance()
}

Return value type changes

In V2, you needed to type method return values on specific wallet methods like fetching the Viem public client, Viem wallet client, Solana connection etc. In V3, you no longer need to do this.

All you have to do is check for the wallet type (as shown in the previous section), and all the methods will come typed for you.

• Before
• After

import { WalletClient, Transport, Chain, Account } from 'viem'

import { useDynamicContext } from '@dynamic-labs/sdk-react-core'
const { primaryWallet } = useDynamicContext()

const walletClient = await primaryWallet.connector.getWalletClient<
    WalletClient<Transport, Chain, Account>
  >();

Smart Wallet connector updates

• getEOAConnector has been removed

The getEOAConnector method is no longer available, you can use the useSmartWallets hook to get the EOA wallet.

Ethers support refactored

Instead of using the EthersExtension on the Context Provider, you now need to use the ethers-v6 package directly, which exports all of the Ethers specific methods.

• Before
• After

// App.tsx
import { EthersExtension } from '@dynamic-labs/ethers-v6'

<DynamicContextProvider
  settings={{
    environmentId: 'XXXXX',
    walletConnectorExtensions: [EthersExtension],
  }}
>
</DynamicContextProvider>

// Main.tsx
import { useDynamicContext } from '@dynamic-labs/sdk-react-core'

const { primaryWallet } = useDynamicContext()
const signer = primaryWallet?.connector.ethers?.getSigner();

Helper method removed

• createWalletClientFromWallet has been removed

The createWalletClientFromWallet function is no longer available, you can use the getWalletClient method on the wallet object instead.

SignWithEmailWalletName has been removed

Instead please use the available email login flows

2.X.X to 3.0.0-alpha.52

Packages restructuring

Solana Utils

@dynamic-labs/solana-utils has been renamed to @dynamic-labs/solana-core

Viem Utils

@dynamic-labs/viem-utils has been renamed to @dynamic-labs/ethereum-core

Ethereum RPC provider

@dynamic-labs/rpc-provider-ethereum has been removed. You can now use @dynamic-labs/ethereum-core to get the RPC provider.

Solana RPC provider

@dynamic-labs/rpc-provider-solana has been removed. You can now use @dynamic-labs/solana-core to get the RPC provider.

Starknet RPC provider

@dynamic-labs/rpc-provider-starknet has been removed. You can now use @dynamic-labs/starknet-core to get the RPC provider.

UserProfile

Removed props that should be retrieved from the primaryWallet: chain, ens, wallet Remove isAuthenticatedWithAWallet as a prop and added it as a helper method. See isAuthenticatedWithAWallet

Removed props from useDynamicContext

hideEmbeddedWalletTransactionUIs has been removed from useDynamicContext. This is now a toggle in the dashboard.

setPrimaryWallet has been removed. You should use useSwitchWallet instead.

isAuthenticated has been removed. Please refer to this page for other ways to check the login state.

walletConnector has been removed. You can get access to it by getting the primary wallet prop and doing primaryWallet?.connector.

walletConnectorOptions has been removed. You can get access to the available wallet options from the useWalletOptions hook.

Replaced props

• setDefaultTabIndex replaced with setSelectedTabIndex in useDynamicContext

This function is used to create wallet list views.

Package restructuring

• ethers-v5 no longer available

We no longer support ethers v5. If you are using ethers v5 and wish to keep using ethers with Dynamic, please upgrade to ethers v6 by following this guide, and then switch to using our ethers-v6 package. They have the same usability.

• rpcProviders no longer available in the sdk-react-core packages

The type DynamicRPCProviders that used to be exported from @dynamic-labs/sdk-react-core is no longer available and has been replaced with individual packages i.e. @dynamic-labs/ethereum-core & @dynamic-labs/solana-core:

• ITurnkeySolanaSigner renamed to IEmbeddedWalletSolanaSigner and import path changed

Events arguments

• onAuthSuccess doesn’t return an authToken anymore

• onEmbeddedWalletCreated returns the user instead of the authToken

You can call getAuthToken to access the authToken at any time!

Other

• Polyfill for Solana Embedded Wallet users

You may need to polyfill the ‘crypto’ module.

webpack.config.js:

config.resolve.fallback = {
  ...config.resolve.fallback,
  crypto: require.resolve('crypto-browserify'),
}

vite.config.ts

import { nodePolyfills } from 'vite-plugin-node-polyfills';

plugins: [
      nodePolyfills({
        globals: {
          global: true,
        },
        include: [],
      }),
    ],

Renamed Hooks

useSelectWalletOption has been renamed to useWalletOptions

New Hooks

• Re-initialize the SDK (useReinitialize)

import {
  DynamicContextProvider,
  useReinitialize,
} from '@dynamic-labs/sdk-react-core';

const ReInitButton = () => {
  const reinitialize = useReinitialize();

  return (
    <button onClick={reinitialize}>Reinitialize</button>
  );
}

const App = () => {
  return (
    <DynamicContextProvider>
      <ReInitButton />
    </DynamicContextProvider>
  )
}

• Trigger state refresh (useRefreshUser)

import {
  DynamicContextProvider,
  useRefreshUser,
} from '@dynamic-labs/sdk-react-core';

const RefreshButton = () => {
  const refresh = useRefreshUser();

  return (
    <button onClick={refresh}>Reinitialize</button>
  );
}

const App = () => {
  return (
    <DynamicContextProvider>
      <RefreshButton />
    </DynamicContextProvider>
  )
}