Guest Authentication Now Available

What's New

Instant Wallet Creation - Users can now create ephemeral wallets instantly without providing email, phone, or social accounts. Perfect for demos, testing, or onboarding new users to your dApp.

How It Works

// Create a guest wallet instantly
const response = await fetch('https://api.thirdweb.com/v1/auth/complete', {
  method: 'POST',
  headers: {
    'x-secret-key': 'your-secret-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    method: 'guest',
    sessionId: 'optional-session-id' // Auto-generated if not provided
  })
});

const { walletAddress, token } = await response.json();

Key Benefits

• Zero Friction - No user information required
• Instant Setup - Wallets created in milliseconds
• Session Support - Optional sessionId for temporary persistence
• Full Functionality - Sign messages, send transactions, interact with contracts
• Easy Migration - Users can upgrade to permanent accounts later

Use Cases

• Demo Applications - Let users try your dApp immediately
• Testing Environments - Quick wallet creation for integration tests
• Onboarding Flows - Reduce barriers for new users
• Temporary Sessions - Perfect for short-lived interactions

API Endpoints

• POST /v1/auth/complete - Create guest wallet
• GET /v1/wallets/me - Get wallet info (with Bearer token)
• All existing wallet operations work with guest wallets

Try it yourself

Ready to reduce onboarding friction? Get started with guest auth →