diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 9fce85c0..0f37731f 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -3,12 +3,20 @@
* All pages wrapped in WalletProvider + SiteLayout.
* @module App
*/
-import { lazy, Suspense } from 'react';
+import React, { lazy, Suspense } from 'react';
import { BrowserRouter, Routes, Route, Navigate, useLocation } from 'react-router-dom';
import { useWallet } from '@solana/wallet-adapter-react';
import { WalletProvider } from './components/wallet/WalletProvider';
import { SiteLayout } from './components/layout/SiteLayout';
+/** Catches render errors with retry. */
+class ErrorBoundary extends React.Component<{ children: React.ReactNode }, { error: Error | null }> {
+ state = { error: null as Error | null };
+ static getDerivedStateFromError(e: Error) { return { error: e }; }
+ componentDidCatch(e: Error) { console.error('[ErrorBoundary]', e); }
+ render() { const err = this.state.error; if (!err) return this.props.children; return (Something went wrong
{err.message}
;
+ return (
+
+ );
}
diff --git a/frontend/src/services/apiClient.ts b/frontend/src/services/apiClient.ts
new file mode 100644
index 00000000..9f59acf3
--- /dev/null
+++ b/frontend/src/services/apiClient.ts
@@ -0,0 +1,31 @@
+/** API client with auth, retry, and TTL cache (keyed by URL + auth). @module services/apiClient */
+export interface ApiError { status: number; message: string; code: string; }
+const BASE: string = (import.meta.env?.VITE_API_URL as string) || '';
+let token: string | null = null;
+/** Set/clear JWT. Clears cache to prevent cross-auth leaks. */
+export function setAuthToken(t: string | null): void { token = t; cache.clear(); }
+export function getAuthToken(): string | null { return token; }
+const cache = new Map();
+export function clearApiCache(): void { cache.clear(); }
+export function isApiError(e: unknown): e is ApiError { return typeof e === 'object' && e !== null && 'status' in e && 'message' in e; }
+function ck(url: string): string { return token ? `${token.slice(-8)}:${url}` : url; }
+export async function apiClient(ep: string, o: RequestInit & { params?: Record; retries?: number; cacheTtl?: number; body?: unknown } = {}): Promise {
+ const { params, retries = 2, cacheTtl = 0, body, headers: hx, ...r } = o;
+ let url = `${BASE}${ep}`;
+ if (params) { const s = new URLSearchParams(); for (const [k, v] of Object.entries(params)) if (v !== undefined && v !== '') s.set(k, String(v)); const q = s.toString(); if (q) url += `?${q}`; }
+ const m = (r.method ?? (body ? 'POST' : 'GET')).toUpperCase();
+ const key = ck(url);
+ if (m === 'GET' && cacheTtl > 0) { const c = cache.get(key); if (c && c.e > Date.now()) return c.d as T; }
+ const h: Record = { 'Content-Type': 'application/json', ...(hx as Record) };
+ if (token) h['Authorization'] = `Bearer ${token}`;
+ let last: ApiError = { status: 0, message: 'Request failed', code: 'UNKNOWN' };
+ for (let i = 0; i <= retries; i++) {
+ try {
+ const res = await fetch(url, { ...r, method: m, headers: h, body: body ? JSON.stringify(body) : undefined });
+ if (!res.ok) { let b: Record = {}; try { b = await res.json(); } catch { /* */ } const err: ApiError = { status: res.status, message: b.message ?? b.detail ?? res.statusText, code: b.code ?? `HTTP_${res.status}` }; if (res.status < 500 && res.status !== 429) throw err; last = err; }
+ else { const d = (await res.json()) as T; if (m === 'GET' && cacheTtl > 0) cache.set(key, { d, e: Date.now() + cacheTtl }); return d; }
+ } catch (e: unknown) { if (isApiError(e) && e.status > 0 && e.status < 500 && e.status !== 429) throw e; last = isApiError(e) ? e : { status: 0, message: e instanceof Error ? e.message : 'Network error', code: 'NETWORK_ERROR' }; }
+ if (i < retries) await new Promise(w => setTimeout(w, 300 * 2 ** i));
+ }
+ throw last;
+}