Migrate legacy React Native SDK packages to v5

The legacy React Native SDK packages have been renamed with a legacy- prefix in v5 to avoid conflicts with the new JavaScript SDK (@dynamic-labs-sdk/*). If you are upgrading from v4, update every Dynamic package name in your package.json, import statements, and lockfile.

Only the package names changed — the exported identifiers (createClient, ReactNativeExtension, ViemExtension, useReactiveClient, etc.) are unchanged.

What changed

v4 package name	v5 package name
`@dynamic-labs/client`	`@dynamic-labs/legacy-client`
`@dynamic-labs/react-hooks`	`@dynamic-labs/legacy-react-hooks`
`@dynamic-labs/react-native-extension`	`@dynamic-labs/legacy-react-native-extension`
`@dynamic-labs/viem-extension`	`@dynamic-labs/legacy-viem-extension`
`@dynamic-labs/solana-extension`	`@dynamic-labs/legacy-solana-extension`
`@dynamic-labs/sui-extension`	`@dynamic-labs/legacy-sui-extension`
`@dynamic-labs/zerodev-extension`	`@dynamic-labs/legacy-zerodev-extension`

Migration steps

Update package.json

Replace every @dynamic-labs/* package your app uses with the corresponding legacy-* name.

package.json

{
  "dependencies": {
    "@dynamic-labs/legacy-client": "^5.0.0",
    "@dynamic-labs/legacy-react-native-extension": "^5.0.0",
    "@dynamic-labs/legacy-react-hooks": "^5.0.0",
    "@dynamic-labs/legacy-viem-extension": "^5.0.0",
    "react-native-keychain": "^10.0.0"
  }
}

Replace the example versions above with the latest v5 version you want to target.If you have expo-secure-store installed, remove it — the v5 SDK uses react-native-keychain for secure storage, so expo-secure-store is redundant.

Update imports

Keep the same import names; only the package path changes.

// Before
import { createClient } from '@dynamic-labs/client';
import { ReactNativeExtension } from '@dynamic-labs/react-native-extension';
import { ViemExtension } from '@dynamic-labs/viem-extension';
import { useReactiveClient } from '@dynamic-labs/react-hooks';

// After
import { createClient } from '@dynamic-labs/legacy-client';
import { ReactNativeExtension } from '@dynamic-labs/legacy-react-native-extension';
import { ViemExtension } from '@dynamic-labs/legacy-viem-extension';
import { useReactiveClient } from '@dynamic-labs/legacy-react-hooks';

Clean install and rebuild

Delete your lockfile and node_modules, reinstall, and rebuild the native layer.

Expo
Bare React Native

You must run npx expo prebuild so the new react-native-keychain native module is linked. Skipping this step causes a native-module error.

Shell

rm -rf node_modules package-lock.json
npm install
npx expo prebuild
npx expo run:ios
npx expo run:android

Shell

rm -rf node_modules package-lock.json
npm install
cd ios && pod install && cd ..
npx react-native run-ios
npx react-native run-android

If you are also moving from expo-secure-store to react-native-keychain, see the React Native secure-storage migration guide.

Getting Started

Going Live

Wallets

Chains & External Wallet Support

Accept Stablecoins & Crypto

Earn

Agents

Authentication

Security

Rate Limits

Developer Dashboard

API Upgrades

Migrations

Troubleshooting

Migrate legacy React Native SDK packages to v5

What changed

Migration steps

​What changed

​Migration steps

​Related migration

What changed

Migration steps

Related migration