Skip to main content

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.
Hook for prompting users to upgrade to Dynamic’s MPC v3 wallets with Wallet-as-a-Service (WaaS) functionality

Summary

The useUpgradeToDynamicWaasFlow hook provides a programmatic way to prompt users to upgrade their existing wallets to Dynamic’s advanced MPC v3 wallets with Wallet-as-a-Service (WaaS) functionality. This hook opens the upgrade flow modal and navigates users through the process of migrating to enhanced wallet capabilities. The hook needs to be initialized within a child of DynamicContextProvider.

Usage

Available functions:

Return Value

The hook returns an object with the following property:
  • promptUpgradeToDynamicWaasFlow: A function that when called, opens the auth flow modal and navigates to the WaaS upgrade view

What is WaaS Upgrade?

Dynamic’s Wallet-as-a-Service (WaaS) upgrade allows users to migrate from standard wallets to advanced MPC v3 wallets that provide:
  • Enhanced security with multi-party computation (MPC)
  • Advanced key management capabilities
  • Improved backup and recovery options
  • Enterprise-grade wallet infrastructure

Example

Advanced Example with User State Check

Error Handling

The hook will throw errors in the following scenarios:
  • Missing context: If used outside of DynamicContextProvider
  • Context method failures: If internal context methods (setShowAuthFlow or pushView) fail
Last modified on June 25, 2026