Wallet Book

Wallet Book is Dynamic’s registry of supported wallets. Each entry maps a wallet key to its display name, brand assets, supported chains, and connection metadata. Use it when you need wallet metadata outside the SDK, such as rendering a custom wallet list or enriching records on your backend.

The registry file

The full registry is published as a single public JSON document; no API token is required:

curl

curl "https://dynamic-static-assets.com/wallet-book/v1/latest/wallet-book.json"

The document has three top-level sections:

Section	Contents
`wallets`	One entry per wallet key, with chains, brand, and connection metadata.
`groups`	Display metadata for wallet groups such as a brand shared across wallets.
`priority`	Wallet ordering used by Dynamic surfaces.

An entry in wallets is keyed by the wallet key and looks like this:

{
  "wallets": {
    "argentx": {
      "brand": {
        "alt": "Argent X Wallet",
        "primaryColor": "#FF875B",
        "spriteId": "argentx"
      },
      "desktop": {
        "chromeId": "dlcobpjiigpikoobohmabehhmhfoodbb",
        "edgeId": "ajcicjlkibolbeaaagejfhnofogocgcj",
        "firefoxId": "argent-x"
      },
      "name": "Ready X",
      "shortName": "Ready X"
    }
  }
}

The object key ("argentx") is the wallet key the SDK returns in walletOptions[].key. Chain identifiers use CAIP-2 format such as eip155:1 and solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.

Cache and refresh

The registry serves ETag and Last-Modified headers with a Cache-Control of public, max-age=600. Send the saved ETag in If-None-Match to get a 304 Not Modified when the file has not changed, and cache it for up to ten minutes between polls.

The JavaScript package

The @dynamic-labs/wallet-book package exports the same data with typed accessors and a WalletIcon component for rendering wallet icons by key:

React

import { WalletIcon } from '@dynamic-labs/wallet-book'

const WalletIconComponent = () => {
  return <WalletIcon walletKey="metamask" />
}

For fetching wallet keys from the SDK rather than the registry, see Fetch and display wallets (React) or Getting available wallets to connect (JavaScript).

Overview

Endpoints

Schemas

The registry file

Cache and refresh

The JavaScript package

​The registry file

​Cache and refresh

​The JavaScript package

The registry file

Cache and refresh

The JavaScript package