EVM Wallets

There are methods in the Ethereum wallet specific to EVM which we list below, but in general all the methods you need are present on the generic Wallet described here.

Check if a wallet is an Ethereum wallet

You can use the isEthereumWallet helper method to check if a wallet is a Ethereum wallet. That way, TypeScript will know which methods are available to you.

import { isEthereumWallet } from '@dynamic-labs/ethereum';

if (!isEthereumWallet(wallet)) {
  throw new Error('This wallet is not a Ethereum wallet');
}

const client = await primaryWallet.getWalletClient();

Ethereum Wallet Methods

Method	Description
getPublicClient(): Promise<PublicClient<Transport, Chain>>	Retrieves the public client.
getWalletClient(chainId?: string): Promise<WalletClient<Transport, Chain, Account>>	Retrieves the wallet client.
isAtomicSupported(chainId?: number): Promise<boolean>	If the wallet supports atomic actions (EIP-5792).
isPaymasterServiceSupported(chainId?: number): Promise<boolean>	If the wallet supports paymaster services (EIP-5792).
sendCalls(callParams: Omit<SendCallsParameters, ‘account’>, options?: { paymasterURL?: string }): Promise<SendCallsReturnType>	Sends multiple transactions atomically. Requires EIP-5792 support.

Read only actions

If you want to read data from the blockchain, you will want either a “Public Client” (Viem terminology), or a “Provider” (Ethers terminology). Both allow you read only access to the blockchain.

Viem

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const { primaryWallet } = useDynamicContext();

const getEnsName = async () => {
  const publicClient = await primaryWallet?.getPublicClient()

  // Now you can use the public client to read data from the blockchain
  const ens = await publicClient?.getEnsName({ address: primaryWallet.address })
  return ens
}

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const { primaryWallet } = useDynamicContext();

const getEnsName = async () => {
  const publicClient = await primaryWallet?.getPublicClient()

  // Now you can use the public client to read data from the blockchain
  const ens = await publicClient?.getEnsName({ address: primaryWallet.address })
  return ens
}

import { getWeb3Provider } from '@dynamic-labs/ethers-v6';
import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const { primaryWallet } = useDynamicContext();

const getBalance = async () => {
  const provider = await getWeb3Provider(primaryWallet);

  // Now you can use the provider to read data from the blockchain
  const balance = await provider?.getBalance(primaryWallet.address);
  return balance
}

Write actions

If you want to write data to the blockchain, you will need a “Wallet Client” (Viem terminology), or a “Signer” (Ethers terminology). Both allow you to sign transactions with the private key.

Viem

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

const sendTransaction = async () => {
  if(!primaryWallet || !isEthereumWallet(primaryWallet)) {
    return;
  }

  const walletClient = await primaryWallet.getWalletClient();

  // Now you can use the wallet client to write data to the blockchain
  const tx = await walletClient?.sendTransaction({
    to: '0x1234567890abcdef',
    value: '1000000000000000000'
  });
  return tx
}

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

const sendTransaction = async () => {
  if(!primaryWallet || !isEthereumWallet(primaryWallet)) {
    return;
  }

  const walletClient = await primaryWallet.getWalletClient();

  // Now you can use the wallet client to write data to the blockchain
  const tx = await walletClient?.sendTransaction({
    to: '0x1234567890abcdef',
    value: '1000000000000000000'
  });
  return tx
}

import { getSigner } from '@dynamic-labs/ethers-v6';
import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const { primaryWallet } = useDynamicContext();

const sendTransaction = async () => {
  const signer = await getSigner(primaryWallet);

  // Now you can use the signer to write data to the blockchain
  const tx = await signer?.sendTransaction({
    to: '0x1234567890abcdef',
    value: '1000000000000000000'
  });
  return tx
}

Send multiple transactions atomically

If you want to send multiple transactions atomically, you can use the sendCalls method. This requires the wallet to support EIP-5792.

    import { parseEther } from 'viem';
    import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
    import { isEthereumWallet } from '@dynamic-labs/ethereum';

    const { primaryWallet } = useDynamicContext();

    const sendTransactions = async () => {
      if(!primaryWallet || !isEthereumWallet(primaryWallet) || !primaryWallet.isAtomicSupported()) {
        return;
      }

      // Now you can use the wallet client to write data to the blockchain
      const { id } = await primaryWallet.sendCalls({
        calls: [
          {
            to: '0x1111111111111111111111111111111111111111',
            value: parseEther('0.001'),
          },
          {
            to: '0x2222222222222222222222222222222222222222',
            value: parseEther('0.001'),
          },
        ],
        version: '2.0.0',
      });

      return id
    }

Examples

We’ve included a few examples of how to use the EVM wallet connector in this section:

• Get balance for all connected wallets
• Get balance for a single wallet
• Send a transaction
• Send a transaction with Wagmi
• Send balance using embedded wallet
• Sign a message