> ## Documentation Index
> Fetch the complete documentation index at: https://developers.squads.so/llms.txt
> Use this file to discover all available pages before exploring further.

# UsePasskeyAuth

```ts theme={null}
function usePasskeyAuth(): {
  passkeyAccount: any;
  sessionKey: any;
  isAuthenticated: boolean;
  hasPasskeySupport: boolean;
  sessionSecrets: SessionSecrets;
  isLoading: any;
  loadingOperation: any;
  error: any;
  errorCode: any;
  sessionStatus: PasskeySessionStatus;
  sessionExpiresAt: number;
  ensureValidSession: () => Promise<void>;
  checkSupport: () => Promise<boolean>;
  hasLocalPasskeyAccount: () => boolean;
  createAccount: (params) => Promise<void>;
  authenticate: (params) => Promise<void>;
  logout: () => void;
  clearError: () => void;
};
```

Passkey authentication hook for Grid SDK

Provides a unified passkey-based authentication flow using WebAuthn for biometric
authentication. Supports both account creation (signup) and authentication (login)
with existing passkeys.

Key Features:

* Browser passkey support detection
* Account creation with biometric enrollment
* Authentication with existing passkeys
* Session management with expiration tracking
* Duplicate account prevention

## Returns

Object containing authentication state and methods

| Name                       | Type                                                                                                      | Default value                   | Description                                                                                                                                                                                                                                                                                                                      |
| -------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `passkeyAccount`           | `any`                                                                                                     | `storedState.passkeyAccount`    | -                                                                                                                                                                                                                                                                                                                                |
| `sessionKey`               | `any`                                                                                                     | `storedState.sessionKey`        | -                                                                                                                                                                                                                                                                                                                                |
| `isAuthenticated`          | `boolean`                                                                                                 | `storedState.isAuthenticated`   | -                                                                                                                                                                                                                                                                                                                                |
| `hasPasskeySupport`        | `boolean`                                                                                                 | `storedState.hasPasskeySupport` | -                                                                                                                                                                                                                                                                                                                                |
| `sessionSecrets`           | `SessionSecrets`                                                                                          | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `isLoading`                | `any`                                                                                                     | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `loadingOperation`         | `any`                                                                                                     | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `error`                    | `any`                                                                                                     | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `errorCode`                | `any`                                                                                                     | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `sessionStatus`            | [`PasskeySessionStatus`](/grid/v1/sdk-reference/react/reference/latest/type-aliases/PasskeySessionStatus) | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `sessionExpiresAt`         | `number`                                                                                                  | -                               | -                                                                                                                                                                                                                                                                                                                                |
| `ensureValidSession()`     | () => `Promise`\<`void`>                                                                                  | -                               | Ensure the passkey session is valid and ready for use                                                                                                                                                                                                                                                                            |
| `checkSupport()`           | () => `Promise`\<`boolean`>                                                                               | -                               | Check if browser supports passkey authentication                                                                                                                                                                                                                                                                                 |
| `hasLocalPasskeyAccount()` | () => `boolean`                                                                                           | -                               | Check if user has already created a passkey account on this device Uses localStorage to track created accounts                                                                                                                                                                                                                   |
| `createAccount()`          | (`params`) => `Promise`\<`void`>                                                                          | -                               | Create a new passkey account (signup flow) This method performs the complete passkey account creation: 1. Generates session key for signing 2. Creates passkey session with the API 3. Prompts user for biometric authentication (WebAuthn) 4. Creates both passkey account and smart account 5. Stores account and session data |
| `authenticate()`           | (`params`) => `Promise`\<`void`>                                                                          | -                               | Authenticate with an existing passkey (login flow) This method performs passkey authentication: 1. Generates session key for signing 2. Creates authorize session with the API 3. Prompts user for biometric authentication 4. Finds existing passkey account 5. Stores account and session data                                 |
| `logout()`                 | () => `void`                                                                                              | -                               | Log out and clear all stored passkey authentication data Clears all browser storage (localStorage and sessionStorage) and disconnects the account from the SDK context. Note: You can also use useAccount().disconnect() directly for the same behavior.                                                                         |
| `clearError()`             | () => `void`                                                                                              | -                               | Clear error state                                                                                                                                                                                                                                                                                                                |

## Example

```tsx theme={null}
import { usePasskeyAuth } from '@sqds/grid-react';

function PasskeyAuth() {
  const { authenticate, createAccount, isAuthenticated, passkeyAccount } = usePasskeyAuth();

  if (isAuthenticated) return <div>Address: {passkeyAccount.data.address}</div>;

  return <button onClick={authenticate}>Sign In</button>;
}
```