Hooks

useCrossmintAuth()

Access Crossmint authentication state and actions: login, logout, the current user, jwt, and auth status. Must be used within a CrossmintAuthProvider.

Returns

any

The underlying Crossmint auth client instance.

() => void

Fetch and refresh the current authenticated user.

string

Current JWT authentication token, if authenticated.

Trigger the login flow. Optionally pass a default email.

Configured login methods.

Initiate a login flow with the specified OAuth provider (e.g. “google”, “twitter”).

() => Promise<void>

Log the user out and clear the session.

AuthStatus

Authentication status: “logged-in” | “logged-out” | “in-progress” | “initializing”.

SDKExternalUser

The currently authenticated user object.

Usage

import { useCrossmintAuth } from "@crossmint/client-sdk-react-ui";

function LoginButton() {
    const { login, logout, user, status } = useCrossmintAuth();

    if (status === "logged-in") {
        return (
            <div>
                <p>Welcome, {user?.email}</p>
                <button onClick={logout}>Logout</button>
            </div>
        );
    }

    return <button onClick={() => login()}>Sign In</button>;
}

Introduction

User Identity

User Authentication

API Reference

useCrossmintAuth()

Returns

Usage

​useCrossmintAuth()

​Returns

​Usage

useCrossmintAuth()

Returns

Usage