Enabling Chains
Supported Chains/Networks
We support EVM, Solana, Eclipse, Bitcoin, Flow, StarkNet, Cosmos and Algorand out of the box. If you don’t see the chain/network you need and it’s not EVM compatible, just let us know!
We also support all EVM networks. You can currently turn on many via the dashboard (simply go to the EVM tab in your dashboard and flip the toggle). For any not shown there, you can easily add them manually using our evmNetworks prop.
Enabling a Chain/Network
To integrate a specific chain/network, you should first enable it in the dashboard. You’ll also see that you can add custom RPC URLs for each network. Each provider will use the RPC configured in the Dashboard if present, otherwise they fall back to public RPCs urls. By default, all EVM and Solana networks have public default providers as shown in this table:
Network | Public RPC Url |
---|---|
Ethereum | https://cloudflare-eth.com |
Optimism | https://mainnet.optimism.io |
Gnosis Chain | https://rpc.gnosischain.com |
Aurora | https://mainnet.aurora.dev |
Polygon | https://polygon-rpc.com |
Palm | https://palm-mainnet.infura.io/v3/3a961d6501e54add9a41aa53f15de99b |
BNB Smart Chain | https://arb1.arbitrum.io/rpc |
Solana | https://api.mainnet-beta.solana.com |
Eclipse | https://mainnetbeta-rpc.eclipse.xyz |
Once your chains are enabled and you’re happy with your RPC providers, you’re going to want to add the appropriate Wallet Connector to the Dynamic Context Provider that you integrated when getting started.
Each chain has it’s own wallet connector, and there are also some add on wallet connectors used to enable things like smart wallets. Follow the steps below and you’ll be up and running in no time!
Find the right packages
Below is a list of all the available wallet connectors and their corresponding packages.
Package Name | Chain | WalletConnector to include |
---|---|---|
@dynamic-labs/ethereum | EVM | EthereumWalletConnectors |
@dynamic-labs/algorand | ALGO | AlgorandWalletConnectors |
@dynamic-labs/solana | SOL | SolanaWalletConnectors or SolanaWalletConnectorsWithConfig |
@dynamic-labs/eclipse | ECLIPSE | EclipseWalletConnectors or EclipseWalletConnectorsWithConfig |
@dynamic-labs/flow | FLOW | FlowWalletConnectors |
@dynamic-labs/starknet | STARK | StarknetWalletConnectors |
@dynamic-labs/cosmos | COSMOS | CosmosWalletConnectors |
@dynamic-labs/bitcoin | BTC | BitcoinWalletConnectors |
EVM Addon Wallets
Package Name | Which Wallets | WalletConnector to include |
---|---|---|
@dynamic-labs/magic | magic | MagicWalletConnectors |
@dynamic-labs/blocto-evm | blocto | BloctoEvmWalletConnectors |
@dynamic-labs/starknet | STARK | StarknetWalletConnectors |
@dynamic-labs/ethereum-aa | ZeroDev | ZeroDevSmartWalletConnectors |
EthereumWalletConnectors (@dynamic-labs/ethereum) also includes all EVM compatible chains including layer 2’s i.e. Base as well as Dynamic Embedded Wallets.
Install the connectors
Install 1 or more wallet connectors from the packages listed above. Here is an example for Ethereum and Solana:
Add the connectors to DynamicContextProvider
Add to an array in your settings under walletConnectors
. Here is an example for Ethereum and Solana:
Configurable Wallet Connectors
Some wallet connectors come with a configurable alternative. This is useful if you want to customize the wallet connector to your needs.
For example, you can pass a
ConnectionConfig
to set the commitement level or define HTTP request headers for Solana and Eclipse.
See an example of how to use the configurable wallet connector for Solana:
Here are our available configurable wallet connectors:
Chain | Wallet Connector with Config | Type of Wallet Connector with Config |
---|---|---|
Solana | SolanaWalletConnectorsWithConfig | (connectionConfig: ConnectionConfig) => WalletConnector |
Eclipse | EclipseWalletConnectorsWithConfig | (connectionConfig: ConnectionConfig) => WalletConnector |
ConnectionConfig
is the object type that can be passed as second argument to@solana/web3.js
’sConnection
constructor. You can find more information about it here.
What next?
Click here to learn how to enable chains for embedded wallets!
Was this page helpful?