Creating Extensions

An extension is a function that adds functionality to a DynamicClient. Use it to integrate a wallet that Dynamic does not officially support, or to add new features that the Dynamic team has not implemented. If you publish it to npm, other developers can import and call the extension to add that functionality to their own Dynamic client; you can also keep it internal to your own codebase.

The core extension APIs (WalletProvider, Storage, registerExtension, etc.) may change between major versions of the Dynamic SDK. Pin your extension to a specific major version and review the release notes before upgrading.

Extension skeleton

Every extension follows the same pattern: check whether it is already registered with hasExtension, call registerExtension, then add the providers or services the extension contributes.

import {
  getDefaultClient,
  hasExtension,
  registerExtension,
} from "@dynamic-labs-sdk/client/core";
import type { DynamicClient } from "@dynamic-labs-sdk/client";

const MY_EXTENSION_KEY = "myCustomExtension";

export const addMyExtension = (
  client: DynamicClient = getDefaultClient()
): void => {
  if (hasExtension({ extensionKey: MY_EXTENSION_KEY }, client)) {
    return;
  }

  registerExtension({ extensionKey: MY_EXTENSION_KEY }, client);

  // Register wallet providers or use core services below.
};

extensionKey is a unique string for your extension.
hasExtension makes the call idempotent so multiple imports do not double-register.
client defaults to getDefaultClient(). Only pass a client explicitly if your app uses multiple Dynamic clients.

Extension interfaces

Publish

Package and publish your extension to npm.

Custom Functions

Add standalone functions that use DynamicClient services.

Wallet Provider

Integrate a custom wallet through supported standards or a WalletProvider.

Services

Use storage, deep links, and registry priority from DynamicCore.

Glossary

Term	Definition
`Extension (or custom extension)`	A function or set of functions that adds runtime behavior to a `DynamicClient` through `registerExtension`.
`Extension author`	The developer who builds the extension.
`Consumer app / final developer`	The application that imports the extension, calls its setup function, and uses the Dynamic SDK alongside it.
`DynamicClient`	The SDK client that holds state, services, and registered extensions. Create one with `createDynamicClient`.
`DynamicCore`	The service container inside `DynamicClient`; exposes `Storage`, `openDeeplink`, and other services.
`extensionKey`	A unique string identifying an extension, used with `registerExtension` and `hasExtension`.
`WalletProvider`	Interface that connects a wallet to the SDK so it can be discovered, connected, and used for signing.
`WalletProviderRegistry`	The registry that stores wallet providers and resolves them by `key`.
`WalletProviderPriority`	Priority value that controls which registration wins when multiple providers share a `key`.
`Storage`	`DynamicCore` service for persisting extension state, with `default` and `secure` tiers.
`openDeeplink`	`DynamicCore` service for opening cross-platform deep links from an extension.

Adding Extensions — Use existing chain and addon extensions.
Creating a Dynamic Client
Initializing the Dynamic Client

Installation & Configuration

Chains & Networks

Authenticate

User & Session Management

Wallets

Flow

Swaps

Funding & Onramp

Events

Building UI

Migrating from React

Extension Development

Creating Extensions

Extension skeleton

Extension interfaces

Publish

Custom Functions

Wallet Provider

Services

Glossary

​Extension skeleton

​Extension interfaces

Publish

Custom Functions

Wallet Provider

Services

​Glossary

​Related

Extension skeleton

Extension interfaces

Glossary

Related