Distinguishing Between Login Methods

Introduction

When a user authenticates with Dynamic, they may use various methods such as email, social login, passkey, or connecting a wallet. Understanding which method they used - and which one was used most recently - is essential for building personalized experiences and implementing proper session management. This guide shows you how to:

Find the user’s last used login method
Check all available verified credentials
Determine the type and provider of each credential

Every user has a lastVerifiedCredentialId property that points to the credential they most recently used to authenticate. You can use this ID to look up the credential in the verifiedCredentials array.

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const MyComponent = () => {
  const { user } = useDynamicContext();

  // Get the last verified credential ID
  const lastCredentialId = user?.lastVerifiedCredentialId;

  // Find the credential in the verifiedCredentials array
  const lastCredential = user?.verifiedCredentials?.find(
    (vc) => vc.id === lastCredentialId
  );

  if (!lastCredential) {
    return <div>No verified credentials found</div>;
  }

  // Check the credential type (format)
  console.log('Credential format:', lastCredential.format);
  // Possible values: 'blockchain', 'email', 'oauth', 'passkey'

  // For wallet credentials, check the provider
  if (lastCredential.format === 'blockchain') {
    console.log('Wallet provider:', lastCredential.walletProvider);
    // Possible values: 'browserExtension', 'embeddedWallet', 'walletConnect', 
    // 'qrCode', 'deepLink', 'custodialService', 'smartContractWallet'
  }

  // For OAuth credentials, check the provider
  if (lastCredential.format === 'oauth') {
    console.log('OAuth provider:', lastCredential.oauthProvider);
    // Possible values: 'google', 'apple', 'discord', 'twitter', etc.
  }

  return (
    <div>
      <p>Last login method: {lastCredential.format}</p>
      <p>Public identifier: {lastCredential.publicIdentifier}</p>
    </div>
  );
};

React Native

import { dynamicClient } from '<path to client file>';

const checkLastLoginMethod = () => {
  const user = dynamicClient.auth.authenticatedUser;

  // Get the last verified credential ID
  const lastCredentialId = user?.lastVerifiedCredentialId;

  // Find the credential in the verifiedCredentials array
  const lastCredential = user?.verifiedCredentials?.find(
    (vc) => vc.id === lastCredentialId
  );

  if (!lastCredential) {
    console.log('No verified credentials found');
    return null;
  }

  // Check the credential type (format)
  console.log('Credential format:', lastCredential.format);
  // Possible values: 'blockchain', 'email', 'oauth', 'passkey'

  // For wallet credentials, check the provider
  if (lastCredential.format === 'blockchain') {
    console.log('Wallet provider:', lastCredential.walletProvider);
    // Possible values: 'browserExtension', 'embeddedWallet', 'walletConnect', etc.
  }

  // For OAuth credentials, check the provider
  if (lastCredential.format === 'oauth') {
    console.log('OAuth provider:', lastCredential.oauthProvider);
  }

  return lastCredential;
};

JavaScript

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

const dynamicClient = createDynamicClient({
  environmentId: 'YOUR_ENVIRONMENT_ID',
  metadata: {
    name: 'YOUR_APP_NAME',
    url: 'YOUR_APP_URL',
    iconUrl: 'YOUR_APP_ICON_URL',
  },
});

// Get the current authenticated user
const user = dynamicClient.user;

// Get the last verified credential ID
const lastCredentialId = user?.lastVerifiedCredentialId;

// Find the credential in the verifiedCredentials array
const lastCredential = user?.verifiedCredentials?.find(
  (vc) => vc.id === lastCredentialId
);

if (lastCredential) {
  // Check the credential type (format)
  console.log('Credential format:', lastCredential.format);

  // For wallet credentials, check the provider
  if (lastCredential.format === 'blockchain') {
    console.log('Wallet provider:', lastCredential.walletProvider);
  }

  // For OAuth credentials, check the provider
  if (lastCredential.format === 'oauth') {
    console.log('OAuth provider:', lastCredential.oauthProvider);
  }
}

Swift

import DynamicSwiftSDK

func checkLastLoginMethod() {
    guard let currentUser = dynamicClient.user,
          let credentials = currentUser.verifiedCredentials,
          let lastCredentialId = currentUser.lastVerifiedCredentialId else {
        print("No user or credentials found")
        return
    }

    // Find the credential matching the lastVerifiedCredentialId
    guard let lastCredential = credentials.first(where: { $0.id == lastCredentialId }) else {
        print("Last credential not found")
        return
    }

    // Check the credential type (format)
    print("Credential format: \(lastCredential.format.rawValue)")
    // Possible values: 'blockchain', 'email', 'oauth', 'passkey'

    // For wallet credentials, check the provider
    if lastCredential.format == .blockchain {
        if let walletProvider = lastCredential.walletProvider {
            print("Wallet provider: \(walletProvider.rawValue)")
            // Possible values: 'browserExtension', 'embeddedWallet', etc.
        }
    }

    // For OAuth credentials, check the provider
    if lastCredential.format == .oauth {
        if let oauthProvider = lastCredential.oauthProvider {
            print("OAuth provider: \(oauthProvider.rawValue)")
        }
    }

    // Get the public identifier (email, wallet address, etc.)
    if let publicIdentifier = lastCredential.publicIdentifier {
        print("Public identifier: \(publicIdentifier)")
    }
}

Flutter

import 'package:dynamic_sdk/dynamic_sdk.dart';

void checkLastLoginMethod() {
  final user = DynamicSDK.instance.auth.authenticatedUser;

  // Get the last verified credential ID
  final lastCredentialId = user?.lastVerifiedCredentialId;

  // Find the credential in the verifiedCredentials array
  final lastCredential = user?.verifiedCredentials.firstWhere(
    (vc) => vc.id == lastCredentialId
  );

  if (lastCredential == null) {
    debugPrint('No verified credentials found');
    return;
  }

  // Check the credential type (format)
  debugPrint('Credential format: ${lastCredential.format}');
  // Possible values: 'blockchain', 'email', 'oauth', 'passkey'

  // For wallet credentials, check the provider
  if (lastCredential.format == 'blockchain') {
    debugPrint('Wallet provider: ${lastCredential.walletProvider}');
    // Possible values: 'browserExtension', 'embeddedWallet', etc.
  }

  // For OAuth credentials, check the provider
  if (lastCredential.format == 'oauth') {
    debugPrint('OAuth provider: ${lastCredential.oauthProvider}');
  }

  debugPrint('Public identifier: ${lastCredential.publicIdentifier}');
}

Credential Types (Format)

The format field on a verified credential indicates what type of authentication method was used:

Format	Description
`blockchain`	User authenticated by signing a message with a blockchain wallet
`email`	User authenticated via email (OTP or magic link)
`oauth`	User authenticated via a social provider (Google, Apple, Discord, etc.)
`passkey`	User authenticated using a passkey (WebAuthn)

Wallet Provider Types

When a credential has a format of blockchain, the walletProvider field indicates what type of wallet was used:

Wallet Provider	Description
`browserExtension`	Browser extension wallet (MetaMask, Coinbase Wallet extension, etc.)
`embeddedWallet`	Dynamic’s embedded wallet
`walletConnect`	Wallet connected via WalletConnect protocol
`qrCode`	Wallet connected by scanning a QR code
`deepLink`	Wallet connected via deep link (mobile)
`custodialService`	Custodial wallet service
`smartContractWallet`	Smart contract wallet (account abstraction)

OAuth Provider Types

When a credential has a format of oauth, the oauthProvider field indicates which social provider was used:

OAuth Provider	Description
`google`	Google account
`apple`	Apple ID
`discord`	Discord account
`twitter`	Twitter/X account
`github`	GitHub account
`facebook`	Facebook account
`twitch`	Twitch account
`linkedin`	LinkedIn account
`microsoft`	Microsoft account
`farcaster`	Farcaster account
`telegram`	Telegram account

See the full list of supported social providers in Social Providers.

Iterating Through All Credentials

You can also iterate through all of a user’s verified credentials to understand their full authentication history:

React
React Native
JavaScript
Swift
Flutter

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

const AllCredentials = () => {
  const { user } = useDynamicContext();

  return (
    <div>
      <h3>All Verified Credentials</h3>
      {user?.verifiedCredentials?.map((vc) => (
        <div key={vc.id}>
          <p>Format: {vc.format}</p>
          <p>Identifier: {vc.publicIdentifier}</p>
          {vc.format === 'blockchain' && (
            <p>Wallet Provider: {vc.walletProvider}</p>
          )}
          {vc.format === 'oauth' && (
            <p>OAuth Provider: {vc.oauthProvider}</p>
          )}
          {vc.id === user.lastVerifiedCredentialId && (
            <span>(Last used)</span>
          )}
          <hr />
        </div>
      ))}
    </div>
  );
};

React Native

import { dynamicClient } from '<path to client file>';
import { View, Text } from 'react-native';

const AllCredentials = () => {
  const user = dynamicClient.auth.authenticatedUser;

  return (
    <View>
      {user?.verifiedCredentials?.map((vc) => (
        <View key={vc.id}>
          <Text>Format: {vc.format}</Text>
          <Text>Identifier: {vc.publicIdentifier}</Text>
          {vc.format === 'blockchain' && (
            <Text>Wallet Provider: {vc.walletProvider}</Text>
          )}
          {vc.format === 'oauth' && (
            <Text>OAuth Provider: {vc.oauthProvider}</Text>
          )}
          {vc.id === user.lastVerifiedCredentialId && (
            <Text>(Last used)</Text>
          )}
        </View>
      ))}
    </View>
  );
};

JavaScript

const user = dynamicClient.user;

user?.verifiedCredentials?.forEach((vc) => {
  console.log('---');
  console.log('Format:', vc.format);
  console.log('Identifier:', vc.publicIdentifier);

  if (vc.format === 'blockchain') {
    console.log('Wallet Provider:', vc.walletProvider);
    console.log('Address:', vc.address);
    console.log('Chain:', vc.chain);
  }

  if (vc.format === 'oauth') {
    console.log('OAuth Provider:', vc.oauthProvider);
  }

  if (vc.id === user.lastVerifiedCredentialId) {
    console.log('(Last used)');
  }
});

Swift

if let currentUser = dynamicClient.user,
   let credentials = currentUser.verifiedCredentials {
    for credential in credentials {
        print("---")
        print("Format: \(credential.format.rawValue)")

        if let publicIdentifier = credential.publicIdentifier {
            print("Identifier: \(publicIdentifier)")
        }

        if credential.format == .blockchain {
            if let walletProvider = credential.walletProvider {
                print("Wallet Provider: \(walletProvider.rawValue)")
            }
            if let address = credential.address {
                print("Address: \(address)")
            }
        }

        if credential.format == .oauth {
            if let oauthProvider = credential.oauthProvider {
                print("OAuth Provider: \(oauthProvider.rawValue)")
            }
        }

        if credential.id == currentUser.lastVerifiedCredentialId {
            print("(Last used)")
        }
    }
}

Flutter

final user = DynamicSDK.instance.auth.authenticatedUser;

user?.verifiedCredentials.forEach((vc) {
  debugPrint('---');
  debugPrint('Format: ${vc.format}');
  debugPrint('Identifier: ${vc.publicIdentifier}');

  if (vc.format == 'blockchain') {
    debugPrint('Wallet Provider: ${vc.walletProvider}');
    debugPrint('Address: ${vc.address}');
    debugPrint('Chain: ${vc.chain}');
  }

  if (vc.format == 'oauth') {
    debugPrint('OAuth Provider: ${vc.oauthProvider}');
  }

  if (vc.id == user.lastVerifiedCredentialId) {
    debugPrint('(Last used)');
  }
});

Here’s a helper function pattern you can use to easily determine the login method type:

React
JavaScript

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

type LoginMethod = 
  | 'email'
  | 'social'
  | 'passkey'
  | 'browser-wallet'
  | 'embedded-wallet'
  | 'wallet-connect'
  | 'unknown';

const useLastLoginMethod = (): LoginMethod => {
  const { user } = useDynamicContext();

  const lastCredentialId = user?.lastVerifiedCredentialId;
  const lastCredential = user?.verifiedCredentials?.find(
    (vc) => vc.id === lastCredentialId
  );

  if (!lastCredential) return 'unknown';

  switch (lastCredential.format) {
    case 'email':
      return 'email';
    case 'passkey':
      return 'passkey';
    case 'oauth':
      return 'social';
    case 'blockchain':
      if (lastCredential.walletProvider === 'embeddedWallet') {
        return 'embedded-wallet';
      }
      if (lastCredential.walletProvider === 'browserExtension') {
        return 'browser-wallet';
      }
      if (lastCredential.walletProvider === 'walletConnect') {
        return 'wallet-connect';
      }
      return 'browser-wallet';
    default:
      return 'unknown';
  }
};

// Usage
const MyComponent = () => {
  const loginMethod = useLastLoginMethod();

  return <div>You logged in via: {loginMethod}</div>;
};

JavaScript

function getLoginMethod(user) {
  const lastCredentialId = user?.lastVerifiedCredentialId;
  const lastCredential = user?.verifiedCredentials?.find(
    (vc) => vc.id === lastCredentialId
  );

  if (!lastCredential) return 'unknown';

  switch (lastCredential.format) {
    case 'email':
      return 'email';
    case 'passkey':
      return 'passkey';
    case 'oauth':
      return `social-${lastCredential.oauthProvider}`;
    case 'blockchain':
      if (lastCredential.walletProvider === 'embeddedWallet') {
        return 'embedded-wallet';
      }
      if (lastCredential.walletProvider === 'browserExtension') {
        return 'browser-wallet';
      }
      if (lastCredential.walletProvider === 'walletConnect') {
        return 'wallet-connect';
      }
      return 'wallet';
    default:
      return 'unknown';
  }
}

// Usage
const user = dynamicClient.user;
const loginMethod = getLoginMethod(user);
console.log(`User logged in via: ${loginMethod}`);

Verified Credentials

Learn more about the verified credential structure and all available fields

Accessing Users

Different ways to access user information in your application

Installation & Configuration

Authenticate

Bring Your Own Authentication

Wallets

Money & Funding

Chains & Networks

Users & Verified Credentials

Gating & Access Control

Customizing Our UI

General Guidance

Distinguishing Between Login Methods

Introduction

Credential Types (Format)

Wallet Provider Types

OAuth Provider Types

Iterating Through All Credentials

Verified Credentials

Accessing Users

Installation & Configuration

Authenticate

Bring Your Own Authentication

Wallets

Money & Funding

Chains & Networks

Users & Verified Credentials

Gating & Access Control

Customizing Our UI

General Guidance

​Introduction

​Finding the Last Used Login Method

​Credential Types (Format)

​Wallet Provider Types

​OAuth Provider Types

​Iterating Through All Credentials

​Determining Login Method Type with Helper Functions

​Related Resources

Verified Credentials

Accessing Users

Introduction

Finding the Last Used Login Method

Credential Types (Format)

Wallet Provider Types

OAuth Provider Types

Iterating Through All Credentials

Determining Login Method Type with Helper Functions

Related Resources