Adding EVM Extensions

What you need to know: Add the EVM extension from the Chains table on Adding extensions. You need at least one EVM extension to support Ethereum-compatible chains. There are only two kinds of wallet: embedded and external. Each extension below lets you support one or both for EVM.

To interact with EVM wallets, add one or more EVM extensions to your client. Each extension enables a different way to discover and connect EVM wallets (e.g. EIP-6963, window.ethereum, or Dynamic embedded wallets). Enable the EVM chain in the Dynamic dashboard as well.

Installation

npm install @dynamic-labs-sdk/evm

Default EVM extension

If you wish to support the standard EVM wallets and Dynamic embedded wallets, you can add the default EVM extension to your client using the addEvmExtension method.

import { createDynamicClient } from '@dynamic-labs-sdk/client';
import { addEvmExtension } from '@dynamic-labs-sdk/evm';

const dynamicClient = createDynamicClient({
  ...
});

addEvmExtension();

Standalone EVM extensions

If you want to be more granular, you can add the standalone EVM extensions individually to your client.

EIP-6963 extension

import { addEIP6963Extension } from '@dynamic-labs-sdk/evm/eip6963';

const dynamicClient = createDynamicClient({
  ...
});

// this will add support for wallets that implement EIP-6963, which are most of the EVM external wallets
addEIP6963Extension();

Window-injected extension

When users open your app inside a wallet’s built-in browser (e.g. MetaMask Mobile, Trust Wallet, Coinbase Wallet), the wallet injects its provider into window.ethereum rather than announcing via EIP-6963. Use this extension as a fallback to support those environments:

import { addEvmWindowInjectedExtension } from '@dynamic-labs-sdk/evm/window-injected';

const dynamicClient = createDynamicClient({
  ...
});

// this will add support for wallets injected into window.ethereum (built-in browser or legacy extensions)
addEvmWindowInjectedExtension();

When used alongside addEIP6963Extension, EIP-6963 providers take priority automatically — so if a wallet supports both, the EIP-6963 version is used.

WAAS EVM extension

import { addWaasEvmExtension } from '@dynamic-labs-sdk/evm/waas';

const dynamicClient = createDynamicClient({
  ...
});

// this will add support for Dynamic embedded EVM wallets
addWaasEvmExtension();

Base Account extension

Adds support for Base Account — Coinbase’s popup / QR flow that surfaces both Coinbase Smart Wallet (passkey-backed ERC-4337 contract wallet at keys.coinbase.com) and Coinbase Wallet (EOA). It complements, rather than replaces, the EIP-6963 and window-injected paths, which continue to handle the Coinbase Wallet browser extension.

import { addBaseAccountEvmExtension } from '@dynamic-labs-sdk/evm/base-account';

const dynamicClient = createDynamicClient({
  ...
});

// this will add Base Account (Coinbase Smart Wallet + EOA via popup/QR)
addBaseAccountEvmExtension();

Pass preference.options to control which Base Account flavor(s) appear in the popup:

Value	Behavior
`'all'` (default)	Show both Smart Wallet and EOA options. Use this when in doubt.
`'smartWalletOnly'`	Only Coinbase Smart Wallet — a passkey-backed ERC-4337 contract wallet onboarded via Face ID / fingerprint / Yubikey, with no seed phrase. Best for first-time onchain users.
`'eoaOnly'`	Only Coinbase Wallet (EOA) — the standard private-key Coinbase Wallet. Best when the user already has Coinbase Wallet installed.

addBaseAccountEvmExtension({
  preference: { options: 'smartWalletOnly' },
});

Combining extensions

You can combine as many extensions as you want to support all the wallets you want to support.

import { addEIP6963Extension } from '@dynamic-labs-sdk/evm/eip6963';
import { addWaasEvmExtension } from '@dynamic-labs-sdk/evm/waas';

const dynamicClient = createDynamicClient({
  ...
});

addEIP6963Extension();
addWaasEvmExtension();

React

In React, register extensions at module level in the same file where you create the client — not inside components. This runs once when the module is first imported.

// dynamicClient.ts
import { createDynamicClient } from '@dynamic-labs-sdk/client';
import { addEIP6963Extension } from '@dynamic-labs-sdk/evm/eip6963';
import { addWaasEvmExtension } from '@dynamic-labs-sdk/evm/waas';

export const dynamicClient = createDynamicClient({
  environmentId: 'YOUR_ENVIRONMENT_ID',
});

addEIP6963Extension();
addWaasEvmExtension();

Then in your app entry point, import the client to trigger the module:

// main.tsx
import './dynamicClient';
import { initializeClient } from '@dynamic-labs-sdk/client';

void initializeClient();

Installation & Configuration

Chains & Networks

Authenticate

User & Session Management

Wallets

Flow

Swaps

Funding & Onramp

Events

Building UI

Migrating from React

Adding EVM Extensions

Installation

Default EVM extension

Standalone EVM extensions

EIP-6963 extension

Window-injected extension

WAAS EVM extension

Base Account extension

Combining extensions

React

​Installation

​Default EVM extension

​Standalone EVM extensions

​EIP-6963 extension

​Window-injected extension

​WAAS EVM extension

​Base Account extension

​Combining extensions

​React

Installation

Default EVM extension

Standalone EVM extensions

EIP-6963 extension

Window-injected extension

WAAS EVM extension

Base Account extension

Combining extensions

React