Adding Custom EVM Networks - Dynamic

You can add any EVM network that Dynamic does not support out of the box by passing a list of GenericNetwork objects to the evmNetworks property in ClientProps when initializing the SDK.

The evmNetworks list replaces the EVM networks enabled in your Dynamic dashboard for this session. Pass the full list of networks you want the SDK to use.

Example

The following example sets Ethereum Mainnet and Polygon as supported networks.

import DynamicSDKSwift

let evmNetworks = [
    GenericNetwork(
        blockExplorerUrls: ["https://etherscan.io"],
        chainId: 1,
        iconUrls: ["https://app.dynamic.xyz/assets/networks/eth.svg"],
        name: "Ethereum Mainnet",
        nativeCurrency: NativeCurrency(
            decimals: 18,
            name: "Ether",
            symbol: "ETH"
        ),
        networkId: 1,
        rpcUrls: ["https://mainnet.infura.io/v3/YOUR_INFURA_KEY"],
        vanityName: "ETH Mainnet"
    ),
    GenericNetwork(
        blockExplorerUrls: ["https://polygonscan.com"],
        chainId: 137,
        iconUrls: ["https://app.dynamic.xyz/assets/networks/polygon.svg"],
        name: "Matic Mainnet",
        nativeCurrency: NativeCurrency(
            decimals: 18,
            name: "MATIC",
            symbol: "MATIC"
        ),
        networkId: 137,
        rpcUrls: ["https://polygon-rpc.com"],
        vanityName: "Polygon"
    )
]

let _ = DynamicSDK.initialize(
    props: ClientProps(
        environmentId: "REPLACE_WITH_YOUR_ENV_ID",
        appOrigin: "https://your-app.com",
        evmNetworks: evmNetworks
    )
)

In the GenericNetwork initializer, chainId and networkId accept an Int, Int64, or String. chainName, lcdUrl, nameService, privateCustomerRpcUrls, and vanityName are optional.

Type Reference

GenericNetwork

Attribute	Type	Required/Optional
blockExplorerUrls	`[String]`	Required
chainId	`Int` or `String`	Required
iconUrls	`[String]`	Required
name	`String`	Required
nativeCurrency	`NativeCurrency`	Required
networkId	`Int` or `String`	Required
privateCustomerRpcUrls	`[String]?`	Optional
rpcUrls	`[String]`	Required
vanityName	`String?`	Optional

NativeCurrency

Attribute	Type	Required/Optional
decimals	`Int`	Required
name	`String`	Required
symbol	`String`	Required

Next Steps

Network Management - Switch networks and read the current network
Send ETH - Send transactions on EVM networks

Last modified on August 13, 2026

⌘I