authenticate() — SocketFi Client SDK Auth Method

authenticate(): Promise<Session>

authenticate() called
       ↓
  Hosted popup opens
       ↓
  User signs in or registers with a passkey
       ↓
  Passkey verified by SocketFi
       ↓
  Embedded Stellar wallet loaded or created
       ↓
  Session returned to your application

import { socketfi } from '@/lib/socketfi';

async function handleSignIn() {
  try {
    const session = await socketfi.authenticate();

    console.log('User ID:', session.userProfile.id);
    console.log('Access token:', session.socketfiAccessToken);

    // Forward the token to your backend
    await fetch('/api/session', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${session.socketfiAccessToken}`,
        'Content-Type': 'application/json',
      },
    });
  } catch (error) {
    if (error.code === 'USER_CANCELLED') {
      // User closed the popup — not an error, just reset the UI
      console.log('User cancelled sign-in');
    } else {
      console.error('Authentication failed:', error.code, error.message);
    }
  }
}

import { useState } from 'react';
import { socketfi } from '@/lib/socketfi';
import type { Session } from '@socketfi/react';

export function SignInButton() {
  const [session, setSession] = useState<Session | null>(null);
  const [loading, setLoading] = useState(false);

  async function handleClick() {
    setLoading(true);
    try {
      const result = await socketfi.authenticate();
      setSession(result);
    } catch (error) {
      if (error.code !== 'USER_CANCELLED') {
        console.error(error.message);
      }
    } finally {
      setLoading(false);
    }
  }

  if (session) {
    return <p>Signed in as {session.userProfile.id}</p>;
  }

  return (
    <button onClick={handleClick} disabled={loading}>
      {loading ? 'Signing in…' : 'Sign in with passkey'}
    </button>
  );
}

// Example: storing the token in React context
const { setToken } = useAuthContext();
const session = await socketfi.authenticate();
setToken(session.socketfiAccessToken);