authenticateWithJWT

function authenticateWithJWT(options?: {
  idempotencyKey?: string;
}): Promise<AuthenticateWithJWTResult>;

Authenticates an end user using a developer-issued JWT from a third-party identity provider (e.g., Auth0, Firebase, Cognito, custom OIDC).

This function validates the JWT, auto-creates the user if they don’t exist, and provisions wallets based on your configuration.

Parameters

Parameter	Type	Description
options?	{ idempotencyKey?: string; }	Optional options for the authentication.
options.idempotencyKey?	string	Optional idempotency key for safe retries. Important: Before using this function, you must: 1. Configure custom auth in the CDP Portal (JWKS endpoint, issuer, etc.) 2. Provide a customAuth.getJwt callback in your config to handle JWT refresh

Returns

Promise<AuthenticateWithJWTResult>

The authentication result with user and wallet information

Examples

// React - With Auth0
import { useAuth0 } from '@auth0/auth0-react';
import { initialize, authenticateWithJWT } from '@coinbase/cdp-core';

const { getAccessTokenSilently } = useAuth0();

await initialize({
  projectId: 'my-project',
  customAuth: {
    getJwt: getAccessTokenSilently
  },
  ethereum: { createOnLogin: 'eoa' }
});

const result = await authenticateWithJWT();
console.log(result.user); // Authenticated user with wallet

// React Native - With Auth0
import { useAuth0 } from 'react-native-auth0';
import { initialize, authenticateWithJWT } from '@coinbase/cdp-core';

const { authorize, getCredentials } = useAuth0();

await initialize({
  projectId: 'my-project',
  customAuth: {
    getJwt: async () => {
      const creds = await getCredentials();
      return creds?.accessToken;
    }
  },
  ethereum: { createOnLogin: 'eoa' }
});

// User clicks sign in - triggers Auth0 login
await authorize();

// Then authenticate with CDP
const result = await authenticateWithJWT();
console.log(result.user); // Authenticated user with wallet

Throws

If customAuth.getJwt callback is not configured or JWT retrieval fails