Skip to main content
This function was introduced in SDK version 0.4.0.
Use addNetwork to add a network to a wallet provider. This function requests that the wallet provider add a network to its list of available networks.

Usage

import { addNetwork, NetworkAddingUnavailableError } from '@dynamic-labs-sdk/client';

const addNetworkToWallet = async () => {
  try {
    await addNetwork({ 
      walletAccount, 
      networkData: {
        chainId: 137,
        chainName: 'Polygon',
        nativeCurrency: {
          name: 'MATIC',
          symbol: 'MATIC',
          decimals: 18
        },
        rpcUrls: ['https://polygon-rpc.com'],
        blockExplorerUrls: ['https://polygonscan.com']
      }
    });
  } catch (error) {
    if (error instanceof NetworkAddingUnavailableError) {
      console.error('This wallet does not support adding networks');
    }
  }
}

Parameters

  • walletAccount - The wallet account to add the network for.
  • networkData - The network configuration data to add to the wallet.
  • client (optional) - The Dynamic client instance. Only required when using multiple Dynamic clients.

Error Handling

The addNetwork function can throw the following errors:

NetworkAddingUnavailableError

If the wallet provider does not support adding networks, the function will throw a NetworkAddingUnavailableError error. In this case, the user must manually add the network in their wallet.