Skip to main content
This guide is for Using Your UI, as Dynamic UI components already display the wallets for you.

​
Wallet keys (when you need them)

Some flows require a stable identifier for a wallet option/provider (for example passing a key into a “connect/link this wallet” call, or rendering a wallet icon). Depending on your SDK, you can get these keys in a few ways:

​
1) From wallet options/providers returned by the SDK

Use useWalletOptions and read walletOptions[].key.
Using the JavaScript SDK? Use getAvailableWalletProvidersData() and read providers[].key. See Getting Available Wallets to Connect for more details.

​
2) From Wallet Book (for keys + metadata/icons)

The full wallet list is available from https://dynamic-static-assets.com/wallet-book/v1/latest/wallet-book.json. Each wallet entry includes its key, name, and branding metadata (useful when rendering icons): 
"argentx": {
  "brand": {
    "alt": "ArgentX",
    "primaryColor": "#FF875B",
    "spriteId": "argentx"
  },
  "key": "argentx",
  "name": "ArgentX"
},

​
3) From the dashboard chain pages

Each chain page in the dashboard lists supported wallets and their keys (for example EVM or Solana).
You can find the list of available wallets in the walletOptions prop returned by the useWalletOptions hook.
When browsing wallets in the Dynamic Widget, you might see labels beside them like “Last Used”, “Multichain” or “Recommended”.Last used comes from the “dynamic_last_used_wallet” value in localstorage. “Multichain” comes from the chainGroup node in each wallet (Remember to also add the WalletConnectors for each chain). “Recommended” from the Recommended Wallets feature.
Use the @dynamic-labs/wallet-book library to display a wallet icon using the exported WalletIcon component. This component takes a walletKey prop, which is the key of the wallet you want to display.
React
import { WalletIcon } from '@dynamic-labs/wallet-book'

const WalletIconComponent = () => {
  return <WalletIcon walletKey="metamask" />
}
Using the JavaScript SDK? See Getting Available Wallets to Connect and Connecting and Verifying a Wallet for the equivalent guides.