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.
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.
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:
