@temple-digital-group/temple-canton-js 1.0.37 → 1.0.38-beta

package/src/api/index.ts

@@ -1,355 +1,355 @@
-import axios, { type AxiosRequestConfig } from "axios";
-import config, { initializeConfig, setWalletAdapter } from "../../src/config/index.js";
-import {
-	setTokens,
-	getAccessToken,
-	getRefreshToken,
-	getApiKey,
-	setApiKey as setApiKeyFromConfig,
-	isTokenExpired,
-	clearTokens,
-	getAuthHeader,
-} from "./tokenStore.js";
-import type {
-	ApiError,
-	LoginUser,
-	LoginResponse,
-	RefreshResponse,
-	Ticker,
-	OrderBook,
-	OrderBookOptions,
-	SymbolConfig,
-	OpenInterest,
-	Trade,
-	RecentTradesOptions,
-	ActiveOrder,
-	ActiveOrdersOptions,
-	CancelOrderResponse,
-	CancelAllOrdersOptions,
-	CancelAllOrdersResponse,
-	DisclosuresResponse,
-} from "./types.js";
-
-// Re-export types and token utilities consumers may need
-export type {
-	ApiError,
-	LoginUser,
-	LoginResponse,
-	RefreshResponse,
-	Ticker,
-	OrderBook,
-	OrderBookOptions,
-	SymbolConfig,
-	OpenInterest,
-	Trade,
-	RecentTradesOptions,
-	ActiveOrder,
-	ActiveOrdersOptions,
-	CancelOrderResponse,
-	CancelAllOrdersOptions,
-	CancelAllOrdersResponse,
-	DisclosuresResponse,
-};
-export { setApiKey, getUserId } from "./tokenStore.js";
-export { setWalletAdapter } from "../../src/config/index.js";
-
-// ── Initialization ──
-
-/**
- * Initialize the Temple SDK — sets config and optionally authenticates with the REST API.
- * Pass `API_EMAIL`/`API_PASSWORD` or `API_KEY` to authenticate eagerly at init time.
- *
- * @returns The login response on success, or an ApiError on failure.
- *          Returns `null` if no API credentials were provided (config-only init).
- */
-export async function initialize(cfg: Record<string, unknown>): Promise<LoginResponse | ApiError | null> {
-	initializeConfig(cfg);
-
-	if (cfg.WALLET_ADAPTER) {
-		setWalletAdapter(cfg.WALLET_ADAPTER);
-	}
-
-	const apiKey = cfg.API_KEY as string | undefined;
-	if (apiKey) {
-		setApiKeyFromConfig(apiKey);
-		return null;
-	}
-
-	const email = cfg.API_EMAIL as string | undefined;
-	const password = cfg.API_PASSWORD as string | undefined;
-	if (email && password) {
-		return login(email, password);
-	}
-
-	return null;
-}
-
-// ── Internal helpers ──
-
-/** Pending auto-login promise for dedup. */
-let autoLoginPromise: Promise<LoginResponse | ApiError> | null = null;
-
-function handleApiError(error: unknown, context: string): ApiError {
-	const err = error as { response?: { status?: number; data?: { message?: string; error?: string; code?: string } }; message?: string };
-	const status = err.response?.status ?? null;
-	const message =
-		err.response?.data?.message ??
-		err.response?.data?.error ??
-		err.message ??
-		"Unknown error";
-	const code = err.response?.data?.code ?? null;
-
-	console.error(`[Temple API] ${context}: ${message}${status ? ` (HTTP ${status})` : ""}`);
-
-	return { error: true, status, code, message };
-}
-
-/** Pending refresh promise for dedup. */
-let refreshPromise: Promise<RefreshResponse | ApiError> | null = null;
-
-async function ensureAuthenticated(): Promise<ApiError | null> {
-	// API key takes priority — no login needed
-	const configApiKey = (config as Record<string, unknown>).API_KEY as string | undefined;
-	if (!getApiKey() && configApiKey) {
-		setApiKeyFromConfig(configApiKey);
-	}
-	if (getApiKey()) return null;
-
-	// Auto-login from config if no token exists
-	if (!getAccessToken()) {
-		const email = (config as Record<string, unknown>).API_EMAIL as string | undefined;
-		const password = (config as Record<string, unknown>).API_PASSWORD as string | undefined;
-		if (email && password) {
-			if (!autoLoginPromise) {
-				autoLoginPromise = login(email, password).finally(() => {
-					autoLoginPromise = null;
-				});
-			}
-			const result = await autoLoginPromise;
-			if ("error" in result && result.error) return result as ApiError;
-		} else {
-			return { error: true, status: 401, code: "NOT_AUTHENTICATED", message: "Not logged in. Call login() or provide API_EMAIL/API_PASSWORD in config." };
-		}
-	}
-
-	// Auto-refresh if expired
-	if (isTokenExpired()) {
-		if (!refreshPromise) {
-			refreshPromise = refreshAccessToken().finally(() => {
-				refreshPromise = null;
-			});
-		}
-		const result = await refreshPromise;
-		if ("error" in result && result.error) return result as ApiError;
-	}
-
-	return null;
-}
-
-async function authenticatedGet<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T | ApiError> {
-	const authError = await ensureAuthenticated();
-	if (authError) return authError;
-
-	const headers = {
-		...getAuthHeader(),
-		"Content-Type": "application/json",
-	};
-
-	// Filter out undefined params
-	const cleanParams: Record<string, string | number> = {};
-	if (params) {
-		for (const [key, value] of Object.entries(params)) {
-			if (value !== undefined) cleanParams[key] = value;
-		}
-	}
-
-	try {
-		const response = await axios.get<T>(`${config.API_BASE_URL}${path}`, {
-			headers,
-			params: Object.keys(cleanParams).length > 0 ? cleanParams : undefined,
-		} as AxiosRequestConfig);
-		return response.data;
-	} catch (error) {
-		return handleApiError(error, `GET ${path}`);
-	}
-}
-
-async function authenticatedPost<T>(path: string, body?: Record<string, unknown>): Promise<T | ApiError> {
-	const authError = await ensureAuthenticated();
-	if (authError) return authError;
-
-	const headers = {
-		...getAuthHeader(),
-		"Content-Type": "application/json",
-	};
-
-	try {
-		const response = await axios.post<T>(`${config.API_BASE_URL}${path}`, body ?? {}, { headers } as AxiosRequestConfig);
-		return response.data;
-	} catch (error) {
-		return handleApiError(error, `POST ${path}`);
-	}
-}
-
-// ── Auth ──
-
-/**
- * Login to the Temple REST API with email and password.
- * Stores tokens automatically for subsequent API calls.
- * @param email - User email
- * @param password - User password
- */
-export async function login(email: string, password: string): Promise<LoginResponse | ApiError> {
-	if (!email || !password) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Email and password are required." };
-	}
-
-	try {
-		const response = await axios.post<LoginResponse>(`${config.API_BASE_URL}/auth/login`, {
-			email,
-			password,
-		});
-		setTokens(response.data);
-		return response.data;
-	} catch (error) {
-		return handleApiError(error, "login");
-	}
-}
-
-/**
- * Refresh the access token using the stored or provided refresh token.
- * Updates the token store automatically on success.
- * @param refreshTokenOverride - Optional explicit refresh token (uses stored one if omitted)
- */
-export async function refreshAccessToken(refreshTokenOverride?: string): Promise<RefreshResponse | ApiError> {
-	const token = refreshTokenOverride ?? getRefreshToken();
-	if (!token) {
-		return { error: true, status: null, code: "NO_REFRESH_TOKEN", message: "No refresh token available. Call login() first." };
-	}
-
-	try {
-		const response = await axios.post<RefreshResponse>(`${config.API_BASE_URL}/auth/refresh`, {
-			refresh_token: token,
-		});
-		setTokens(response.data);
-		return response.data;
-	} catch (error) {
-		return handleApiError(error, "refreshAccessToken");
-	}
-}
-
-/**
- * Logout: clear all stored REST API tokens.
- */
-export function logout(): void {
-	clearTokens();
-}
-
-// ── Market Data ──
-
-/**
- * Get ticker data for one or all trading pairs.
- * @param symbol - Optional symbol filter (e.g., "Amulet/USDCx")
- */
-export async function getTicker(symbol?: string): Promise<Ticker | Ticker[] | ApiError> {
-	return authenticatedGet("/api/v1/market/ticker", { symbol });
-}
-
-/**
- * Get the order book for a trading pair.
- * @param symbol - Trading pair symbol (required)
- * @param options - Optional levels and precision parameters
- */
-export async function getOrderBook(symbol: string, options: OrderBookOptions = {}): Promise<OrderBook | ApiError> {
-	if (!symbol) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
-	}
-	return authenticatedGet("/api/v1/market/orderbook", {
-		symbol,
-		levels: options.levels,
-		precision: options.precision,
-	});
-}
-
-/**
- * Get symbol configuration (paused status, decimals, minimum quantity).
- * @param symbol - Trading pair symbol (required)
- */
-export async function getSymbolConfig(symbol: string): Promise<SymbolConfig | ApiError> {
-	if (!symbol) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
-	}
-	return authenticatedGet("/api/v1/trading/symbol-config", { symbol });
-}
-
-/**
- * Get open interest for a trading pair.
- * @param symbol - Trading pair symbol (required)
- */
-export async function getOpenInterest(symbol: string): Promise<OpenInterest | ApiError> {
-	if (!symbol) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
-	}
-	return authenticatedGet("/api/v1/market/open-interest", { symbol });
-}
-
-/**
- * Get recent trades for a trading pair.
- * @param symbol - Trading pair symbol (required)
- * @param options - Optional limit (max 500)
- */
-export async function getRecentTrades(symbol: string, options: RecentTradesOptions = {}): Promise<Trade[] | ApiError> {
-	if (!symbol) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
-	}
-	return authenticatedGet("/api/v1/market/trades", {
-		symbol,
-		limit: options.limit,
-	});
-}
-
-// ── Orders ──
-
-/**
- * Get active orders, optionally filtered by symbol.
- * @param options - Optional symbol and limit filters
- */
-export async function getActiveOrders(options: ActiveOrdersOptions = {}): Promise<ActiveOrder[] | ApiError> {
-	return authenticatedGet("/api/trading/orders/active", {
-		symbol: options.symbol,
-		limit: options.limit,
-	});
-}
-
-/**
- * Cancel a specific order by ID.
- * @param orderId - The order ID to cancel
- */
-export async function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError> {
-	if (!orderId) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Order ID is required." };
-	}
-	return authenticatedPost(`/api/trading/orders/${encodeURIComponent(orderId)}/cancel`);
-}
-
-/**
- * Cancel all active orders, optionally filtered by symbol.
- * @param options - Optional symbol filter
- */
-export async function cancelAllOrders(options: CancelAllOrdersOptions = {}): Promise<CancelAllOrdersResponse | ApiError> {
-	return authenticatedPost("/api/v1/trading/orders/cancel-all", options.symbol ? { symbol: options.symbol } : undefined);
-}
-
-// ── Disclosures ──
-
-/**
- * Get amulet disclosure data for a party from the Temple REST API.
- * Returns protocol disclosures (amulet rules, open mining rounds, external party amulet rules).
- * @param partyId - Canton party ID
- */
-export async function getDisclosures(partyId: string): Promise<DisclosuresResponse | ApiError> {
-	if (!partyId) {
-		return { error: true, status: null, code: "INVALID_PARAMS", message: "Party ID is required." };
-	}
-	return authenticatedGet("/api/amulet/disclosures", { partyId });
-}
+import axios, { type AxiosRequestConfig } from "axios";
+import config, { initializeConfig, setWalletAdapter } from "../../src/config/index.js";
+import {
+	setTokens,
+	getAccessToken,
+	getRefreshToken,
+	getApiKey,
+	setApiKey as setApiKeyFromConfig,
+	isTokenExpired,
+	clearTokens,
+	getAuthHeader,
+} from "./tokenStore.js";
+import type {
+	ApiError,
+	LoginUser,
+	LoginResponse,
+	RefreshResponse,
+	Ticker,
+	OrderBook,
+	OrderBookOptions,
+	SymbolConfig,
+	OpenInterest,
+	Trade,
+	RecentTradesOptions,
+	ActiveOrder,
+	ActiveOrdersOptions,
+	CancelOrderResponse,
+	CancelAllOrdersOptions,
+	CancelAllOrdersResponse,
+	DisclosuresResponse,
+} from "./types.js";
+
+// Re-export types and token utilities consumers may need
+export type {
+	ApiError,
+	LoginUser,
+	LoginResponse,
+	RefreshResponse,
+	Ticker,
+	OrderBook,
+	OrderBookOptions,
+	SymbolConfig,
+	OpenInterest,
+	Trade,
+	RecentTradesOptions,
+	ActiveOrder,
+	ActiveOrdersOptions,
+	CancelOrderResponse,
+	CancelAllOrdersOptions,
+	CancelAllOrdersResponse,
+	DisclosuresResponse,
+};
+export { setApiKey, getUserId } from "./tokenStore.js";
+export { setWalletAdapter } from "../../src/config/index.js";
+
+// ── Initialization ──
+
+/**
+ * Initialize the Temple SDK — sets config and optionally authenticates with the REST API.
+ * Pass `API_EMAIL`/`API_PASSWORD` or `API_KEY` to authenticate eagerly at init time.
+ *
+ * @returns The login response on success, or an ApiError on failure.
+ *          Returns `null` if no API credentials were provided (config-only init).
+ */
+export async function initialize(cfg: Record<string, unknown>): Promise<LoginResponse | ApiError | null> {
+	initializeConfig(cfg);
+
+	if (cfg.WALLET_ADAPTER) {
+		setWalletAdapter(cfg.WALLET_ADAPTER);
+	}
+
+	const apiKey = cfg.API_KEY as string | undefined;
+	if (apiKey) {
+		setApiKeyFromConfig(apiKey);
+		return null;
+	}
+
+	const email = cfg.API_EMAIL as string | undefined;
+	const password = cfg.API_PASSWORD as string | undefined;
+	if (email && password) {
+		return login(email, password);
+	}
+
+	return null;
+}
+
+// ── Internal helpers ──
+
+/** Pending auto-login promise for dedup. */
+let autoLoginPromise: Promise<LoginResponse | ApiError> | null = null;
+
+function handleApiError(error: unknown, context: string): ApiError {
+	const err = error as { response?: { status?: number; data?: { message?: string; error?: string; code?: string } }; message?: string };
+	const status = err.response?.status ?? null;
+	const message =
+		err.response?.data?.message ??
+		err.response?.data?.error ??
+		err.message ??
+		"Unknown error";
+	const code = err.response?.data?.code ?? null;
+
+	console.error(`[Temple API] ${context}: ${message}${status ? ` (HTTP ${status})` : ""}`);
+
+	return { error: true, status, code, message };
+}
+
+/** Pending refresh promise for dedup. */
+let refreshPromise: Promise<RefreshResponse | ApiError> | null = null;
+
+async function ensureAuthenticated(): Promise<ApiError | null> {
+	// API key takes priority — no login needed
+	const configApiKey = (config as Record<string, unknown>).API_KEY as string | undefined;
+	if (!getApiKey() && configApiKey) {
+		setApiKeyFromConfig(configApiKey);
+	}
+	if (getApiKey()) return null;
+
+	// Auto-login from config if no token exists
+	if (!getAccessToken()) {
+		const email = (config as Record<string, unknown>).API_EMAIL as string | undefined;
+		const password = (config as Record<string, unknown>).API_PASSWORD as string | undefined;
+		if (email && password) {
+			if (!autoLoginPromise) {
+				autoLoginPromise = login(email, password).finally(() => {
+					autoLoginPromise = null;
+				});
+			}
+			const result = await autoLoginPromise;
+			if ("error" in result && result.error) return result as ApiError;
+		} else {
+			return { error: true, status: 401, code: "NOT_AUTHENTICATED", message: "Not logged in. Call login() or provide API_EMAIL/API_PASSWORD in config." };
+		}
+	}
+
+	// Auto-refresh if expired
+	if (isTokenExpired()) {
+		if (!refreshPromise) {
+			refreshPromise = refreshAccessToken().finally(() => {
+				refreshPromise = null;
+			});
+		}
+		const result = await refreshPromise;
+		if ("error" in result && result.error) return result as ApiError;
+	}
+
+	return null;
+}
+
+async function authenticatedGet<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T | ApiError> {
+	const authError = await ensureAuthenticated();
+	if (authError) return authError;
+
+	const headers = {
+		...getAuthHeader(),
+		"Content-Type": "application/json",
+	};
+
+	// Filter out undefined params
+	const cleanParams: Record<string, string | number> = {};
+	if (params) {
+		for (const [key, value] of Object.entries(params)) {
+			if (value !== undefined) cleanParams[key] = value;
+		}
+	}
+
+	try {
+		const response = await axios.get<T>(`${config.API_BASE_URL}${path}`, {
+			headers,
+			params: Object.keys(cleanParams).length > 0 ? cleanParams : undefined,
+		} as AxiosRequestConfig);
+		return response.data;
+	} catch (error) {
+		return handleApiError(error, `GET ${path}`);
+	}
+}
+
+async function authenticatedPost<T>(path: string, body?: Record<string, unknown>): Promise<T | ApiError> {
+	const authError = await ensureAuthenticated();
+	if (authError) return authError;
+
+	const headers = {
+		...getAuthHeader(),
+		"Content-Type": "application/json",
+	};
+
+	try {
+		const response = await axios.post<T>(`${config.API_BASE_URL}${path}`, body ?? {}, { headers } as AxiosRequestConfig);
+		return response.data;
+	} catch (error) {
+		return handleApiError(error, `POST ${path}`);
+	}
+}
+
+// ── Auth ──
+
+/**
+ * Login to the Temple REST API with email and password.
+ * Stores tokens automatically for subsequent API calls.
+ * @param email - User email
+ * @param password - User password
+ */
+export async function login(email: string, password: string): Promise<LoginResponse | ApiError> {
+	if (!email || !password) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Email and password are required." };
+	}
+
+	try {
+		const response = await axios.post<LoginResponse>(`${config.API_BASE_URL}/auth/login`, {
+			email,
+			password,
+		});
+		setTokens(response.data);
+		return response.data;
+	} catch (error) {
+		return handleApiError(error, "login");
+	}
+}
+
+/**
+ * Refresh the access token using the stored or provided refresh token.
+ * Updates the token store automatically on success.
+ * @param refreshTokenOverride - Optional explicit refresh token (uses stored one if omitted)
+ */
+export async function refreshAccessToken(refreshTokenOverride?: string): Promise<RefreshResponse | ApiError> {
+	const token = refreshTokenOverride ?? getRefreshToken();
+	if (!token) {
+		return { error: true, status: null, code: "NO_REFRESH_TOKEN", message: "No refresh token available. Call login() first." };
+	}
+
+	try {
+		const response = await axios.post<RefreshResponse>(`${config.API_BASE_URL}/auth/refresh`, {
+			refresh_token: token,
+		});
+		setTokens(response.data);
+		return response.data;
+	} catch (error) {
+		return handleApiError(error, "refreshAccessToken");
+	}
+}
+
+/**
+ * Logout: clear all stored REST API tokens.
+ */
+export function logout(): void {
+	clearTokens();
+}
+
+// ── Market Data ──
+
+/**
+ * Get ticker data for one or all trading pairs.
+ * @param symbol - Optional symbol filter (e.g., "Amulet/USDCx")
+ */
+export async function getTicker(symbol?: string): Promise<Ticker | Ticker[] | ApiError> {
+	return authenticatedGet("/api/v1/market/ticker", { symbol });
+}
+
+/**
+ * Get the order book for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ * @param options - Optional levels and precision parameters
+ */
+export async function getOrderBook(symbol: string, options: OrderBookOptions = {}): Promise<OrderBook | ApiError> {
+	if (!symbol) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
+	}
+	return authenticatedGet("/api/v1/market/orderbook", {
+		symbol,
+		levels: options.levels,
+		precision: options.precision,
+	});
+}
+
+/**
+ * Get symbol configuration (paused status, decimals, minimum quantity).
+ * @param symbol - Trading pair symbol (required)
+ */
+export async function getSymbolConfig(symbol: string): Promise<SymbolConfig | ApiError> {
+	if (!symbol) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
+	}
+	return authenticatedGet("/api/v1/trading/symbol-config", { symbol });
+}
+
+/**
+ * Get open interest for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ */
+export async function getOpenInterest(symbol: string): Promise<OpenInterest | ApiError> {
+	if (!symbol) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
+	}
+	return authenticatedGet("/api/v1/market/open-interest", { symbol });
+}
+
+/**
+ * Get recent trades for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ * @param options - Optional limit (max 500)
+ */
+export async function getRecentTrades(symbol: string, options: RecentTradesOptions = {}): Promise<Trade[] | ApiError> {
+	if (!symbol) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
+	}
+	return authenticatedGet("/api/v1/market/trades", {
+		symbol,
+		limit: options.limit,
+	});
+}
+
+// ── Orders ──
+
+/**
+ * Get active orders, optionally filtered by symbol.
+ * @param options - Optional symbol and limit filters
+ */
+export async function getActiveOrders(options: ActiveOrdersOptions = {}): Promise<ActiveOrder[] | ApiError> {
+	return authenticatedGet("/api/trading/orders/active", {
+		symbol: options.symbol,
+		limit: options.limit,
+	});
+}
+
+/**
+ * Cancel a specific order by ID.
+ * @param orderId - The order ID to cancel
+ */
+export async function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError> {
+	if (!orderId) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Order ID is required." };
+	}
+	return authenticatedPost(`/api/trading/orders/${encodeURIComponent(orderId)}/cancel`);
+}
+
+/**
+ * Cancel all active orders, optionally filtered by symbol.
+ * @param options - Optional symbol filter
+ */
+export async function cancelAllOrders(options: CancelAllOrdersOptions = {}): Promise<CancelAllOrdersResponse | ApiError> {
+	return authenticatedPost("/api/v1/trading/orders/cancel-all", options.symbol ? { symbol: options.symbol } : undefined);
+}
+
+// ── Disclosures ──
+
+/**
+ * Get amulet disclosure data for a party from the Temple REST API.
+ * Returns protocol disclosures (amulet rules, open mining rounds, external party amulet rules).
+ * @param partyId - Canton party ID
+ */
+export async function getDisclosures(partyId: string): Promise<DisclosuresResponse | ApiError> {
+	if (!partyId) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "Party ID is required." };
+	}
+	return authenticatedGet("/api/amulet/disclosures", { partyId });
+}