Error Handling

try {
  await createWallet();
} catch (error) {
  if (error.message.includes('cancelled') || 
      error.message.includes('abort')) {
    // User cancelled biometric prompt
    showMessage('Please authenticate to continue');
  }
}

// Check before attempting
const supported = await cavos.isPasskeySupported?.();
if (!supported) {
  // Fall back to OAuth-only
  showOAuthLogin();
}

try {
  await login('google');
} catch (error) {
  if (error.message.includes('popup')) {
    // Popup blocked
    showMessage('Please allow popups');
  }
}

try {
  await loadWallet();
} catch (error) {
  if (error.message === 'No wallet found') {
    // User doesn't have a wallet yet
    showCreateWalletPrompt();
  }
}

try {
  await createWallet();
} catch (error) {
  if (error.message.includes('MAU limit')) {
    showMessage('App limit reached. Please try later.');
  }
}

try {
  await execute(calls);
} catch (error) {
  if (error.message.includes('not initialized')) {
    // Need to create/load wallet first
    await createWallet();
    await execute(calls);
  }
}

try {
  await execute(calls, { gasless: true });
} catch (error) {
  // Parse Starknet error
  console.error('Transaction failed:', error.message);
  // Common: "Contract not found", "Entry point not found"
}

try {
  await execute(calls, { gasless: true });
} catch (error) {
  if (error.message.includes('paymaster')) {
    // Fallback to paid transaction
    await execute(calls, { gasless: false });
  }
}

try {
  await execute(calls);
} catch (error) {
  if (error.message.includes('timeout') || 
      error.message.includes('network')) {
    showMessage('Network error. Please try again.');
  }
}

const config = {
  appId: 'your-app-id',
  starknetRpcUrl: 'https://your-own-rpc.com',  // Use own RPC
};

Error: No matching passkeys found

try {
  await loadWallet();
} catch (error) {
  if (error.message.includes('SecureStore')) {
    // Storage issue, may need to clear and recreate
    await clearWallet();
    showMessage('Please create a new wallet');
  }
}

const config = {
  appId: 'your-app-id',
  enableLogging: true,  // Console logs from SDK
};

const { cavos } = useCavos();

console.log('Address:', cavos.getAddress());
console.log('Authenticated:', cavos.isAuthenticated());
console.log('Has wallet:', await cavos.hasWallet());
console.log('Is deployed:', await cavos.isAccountDeployed());

async function handleError(error, operation) {
  if (error.message.includes('cancelled')) {
    // User action needed
    return { action: 'retry', message: 'Please authenticate' };
  }
  
  if (error.message.includes('MAU limit')) {
    // App limit
    return { action: 'wait', message: 'Limit reached' };
  }
  
  if (error.message.includes('network')) {
    // Network issue
    return { action: 'retry', message: 'Network error' };
  }
  
  // Unknown error
  console.error(`${operation} failed:`, error);
  return { action: 'support', message: 'Please contact support' };
}