Eve library

Troubleshooting Guide

Guide

Revision 1

On this page

Common issues and solutions when using the Lilith API.

Authentication Issues#

Problem: "Invalid token" error#

Cause: JWT token expired or malformed

Solution:

javascript
// Check token expiration
function isTokenExpired(token) {
  if (!token) return true;

  try {
    const payload = JSON.parse(atob(token.split('.')[1]));
    return Date.now() >= payload.exp * 1000;
  } catch (error) {
    return true; // Invalid token format
  }
}

// Refresh token if expired
if (isTokenExpired(accessToken)) {
  const response = await fetch('/v1/auth/refresh', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ refresh_token: refreshToken })
  });

  const tokens = await response.json();
  accessToken = tokens.access_token;
}

Rate Limiting#

Problem: "Rate limit exceeded" (HTTP 429)#

Solution: Implement exponential backoff

javascript
async function handleRateLimit(response) {
  if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    const delay = retryAfter ? parseInt(retryAfter) * 1000 : 1000;

    console.log(`Rate limited. Waiting ${delay}ms before retry...`);
    await new Promise(resolve => setTimeout(resolve, delay));

    return true; // Should retry
  }
  return false;
}

Network Issues#

Problem: Connection timeouts#

Solution: Configure appropriate timeouts

javascript
// Configure fetch with timeout
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 10000); // 10 second timeout

try {
  const response = await fetch(url, {
    ...options,
    signal: controller.signal
  });

  clearTimeout(timeoutId);
  return await response.json();
} catch (error) {
  clearTimeout(timeoutId);

  if (error.name === 'AbortError') {
    throw new Error('Request timed out');
  }

  throw error;
}

Debug Mode#

Enable debug logging#

javascript
// Set environment variable
process.env.LILITH_DEBUG = 'true';

// Or use debug flag
const client = new LilithClient({
  apiKey: process.env.LILITH_API_KEY,
  debug: true
});

// Debug logging function
function debugLog(message, data) {
  if (process.env.LILITH_DEBUG === 'true') {
    console.log(`[DEBUG] ${message}`, data);
  }
}

Common Error Codes#

Code Status Description Solution
INVALID_TOKEN 401 JWT token is invalid or expired Refresh token
RATE_LIMIT_EXCEEDED 429 Too many requests Implement backoff
VALIDATION_ERROR 400 Request data is invalid Check request format
NOT_FOUND 404 Resource not found Verify endpoint URL
INTERNAL_ERROR 500 Server error Retry request

For additional support, check the community forum or contact support.