Track Wallet Events/Changes

import { useEffect } from 'react';
import { useReactiveClient } from '@dynamic-labs/react-hooks';
import { dynamicClient } from '<path to client file>';

export function WalletEventListenerRN() {
  const client = useReactiveClient(dynamicClient);

  useEffect(() => {
    const handlePrimaryChanged = (wallet) => {
      console.log('Primary wallet changed', wallet);
    };

    client.wallets.on('primaryChanged', handlePrimaryChanged);

    return () => {
      client.wallets.off('primaryChanged', handlePrimaryChanged);
    };
  }, [client]);

  return null;
}

​

Types of events

• State change events: fire when a module variable changes. Names match the variable with Changed appended.
• Custom events: fire for specific actions within the module.

​

How to listen

const handleAuthSuccess = (user) => {
  console.log('User logged in', user);
};

dynamicClient.auth.on('authSuccess', handleAuthSuccess);

// Later, clean up
dynamicClient.auth.off('authSuccess', handleAuthSuccess);

​

Event catalog

• authInit
• authSuccess
• authFailed
• loggedOut
• userProfileUpdated
• authenticatedUserChanged
• tokenChanged

• emailVerificationFinished

• smsVerificationFinished

• messageSigned
• walletAdded
• walletRemoved
• primaryChanged
• userWalletsChanged

• embeddedWalletCreated
• hasWalletChanged

• evmChanged
• solanaChanged
• suiChanged

• error
• loadedChanged

• authFlowCancelled
• authFlowClosed
• authFlowOpened

• mfaCompletionSuccess — returns { mfaToken?: string }
• mfaCompletionFailure — returns { error: unknown }

• accountsChanged
• networkChanged
• disconnected

import { onWalletProviderEvent } from '@dynamic-labs-sdk/client';

// Example: listen for account changes on a specific provider
const unsubscribe = onWalletProviderEvent({
  walletProviderKey: 'metamaskevm',
  event: 'accountsChanged',
  callback: ({ addresses }) => {
    console.log('Accounts changed:', addresses);
  },
});

// Later, remove the listener
unsubscribe();

• Use the provider key that matches the chain/app (e.g., metamaskevm, metamasksol, phantomevm, phantomsol).
• Re-run any logic that depends on the active account/network when these events fire (e.g., refresh balances, reconnect clients).