@0xmonaco/react 0.0.0-develop-20260120180031

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.js

@@ -0,0 +1,126 @@
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { clearAuthState, getTimeUntilExpiry, isTokenExpired, saveAuthState } from "../../utils";
+import { validateRefreshBuffer } from "./utils";
+/**
+ * Hook for managing token lifecycle including automatic refresh and persistence
+ *
+ * @param sdk - Monaco SDK instance
+ * @param config - Configuration options for token lifecycle
+ * @returns Token lifecycle management functions
+ *
+ * @example
+ * ```tsx
+ * const { initializeTokens, clearTokens, refreshTokens } = useTokenLifecycle(sdk, {
+ *   autoRefresh: true,
+ *   persistTokens: true,
+ *   refreshBufferSeconds: 300, // 5 minutes
+ *   onRefreshError: (error) => console.error('Token refresh failed:', error),
+ * });
+ * ```
+ */
+export const useTokenLifecycle = (sdk, config = {}) => {
+    const { autoRefresh = true, persistTokens = true, onRefreshError, onRefreshSuccess } = config;
+    const refreshBufferSeconds = validateRefreshBuffer(config.refreshBufferSeconds);
+    const refreshTimerRef = useRef(null);
+    const currentAuthStateRef = useRef(null);
+    const refreshPromiseRef = useRef(null);
+    const clearRefreshTimer = useCallback(() => {
+        if (refreshTimerRef.current) {
+            clearTimeout(refreshTimerRef.current);
+            refreshTimerRef.current = null;
+        }
+    }, []);
+    const isTokenExpiredCheck = useCallback((authState) => {
+        if (!authState)
+            return true;
+        return isTokenExpired(authState, refreshBufferSeconds);
+    }, [refreshBufferSeconds]);
+    const scheduleRefresh = useCallback((authState) => {
+        if (!autoRefresh)
+            return;
+        clearRefreshTimer();
+        const timeUntilExpiry = getTimeUntilExpiry(authState);
+        const refreshIn = Math.max(0, timeUntilExpiry - refreshBufferSeconds);
+        const refreshInMs = refreshIn * 1000;
+        refreshTimerRef.current = setTimeout(() => {
+            refreshTokensRef.current?.();
+        }, refreshInMs);
+    }, [autoRefresh, refreshBufferSeconds, clearRefreshTimer]);
+    const refreshTokens = useCallback(async () => {
+        if (!sdk)
+            return null;
+        if (refreshPromiseRef.current) {
+            return refreshPromiseRef.current;
+        }
+        const currentAuthState = currentAuthStateRef.current;
+        if (!currentAuthState?.refreshToken) {
+            console.warn("No refresh token available for token refresh");
+            return null;
+        }
+        const refreshPromise = (async () => {
+            try {
+                // Re-check SDK in case it became null during async operations
+                if (!sdk) {
+                    console.warn("SDK became null during token refresh");
+                    return null;
+                }
+                const newAuthState = await sdk.refreshAuth();
+                currentAuthStateRef.current = newAuthState;
+                if (persistTokens) {
+                    saveAuthState(newAuthState);
+                }
+                scheduleRefresh(newAuthState);
+                onRefreshSuccess?.(newAuthState);
+                return newAuthState;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                console.error("Failed to refresh tokens:", err);
+                if (persistTokens) {
+                    clearAuthState();
+                }
+                currentAuthStateRef.current = null;
+                clearRefreshTimer();
+                onRefreshError?.(err);
+                return null;
+            }
+            finally {
+                refreshPromiseRef.current = null;
+            }
+        })();
+        refreshPromiseRef.current = refreshPromise;
+        return refreshPromise;
+    }, [sdk, persistTokens, onRefreshError, onRefreshSuccess, scheduleRefresh, clearRefreshTimer]);
+    const refreshTokensRef = useRef(refreshTokens);
+    useEffect(() => {
+        refreshTokensRef.current = refreshTokens;
+    }, [refreshTokens]);
+    const initializeTokens = useCallback((authState) => {
+        currentAuthStateRef.current = authState;
+        if (persistTokens) {
+            saveAuthState(authState);
+        }
+        if (autoRefresh) {
+            scheduleRefresh(authState);
+        }
+    }, [persistTokens, autoRefresh, scheduleRefresh]);
+    const clearTokens = useCallback(() => {
+        currentAuthStateRef.current = null;
+        clearRefreshTimer();
+        if (persistTokens) {
+            clearAuthState();
+        }
+    }, [persistTokens, clearRefreshTimer]);
+    useEffect(() => {
+        return () => {
+            clearRefreshTimer();
+        };
+    }, [clearRefreshTimer]);
+    return useMemo(() => ({
+        initializeTokens,
+        clearTokens,
+        refreshTokens,
+        isTokenExpired: isTokenExpiredCheck,
+    }), [initializeTokens, clearTokens, refreshTokens, isTokenExpiredCheck]);
+};
+//# sourceMappingURL=useTokenLifecycle.js.map

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTokenLifecycle.js","sourceRoot":"","sources":["../../../src/hooks/useTokenLifecycle/useTokenLifecycle.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useTokenLifecycle/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Validates and returns a safe refreshBufferSeconds value
+ *
+ * @param value - The refresh buffer value to validate (in seconds)
+ * @returns A safe refresh buffer value between 1-3600 seconds
+ */
+export declare const validateRefreshBuffer: (value: number | undefined) => number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/hooks/useTokenLifecycle/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTokenLifecycle/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAUjE,CAAC"}

package/dist/hooks/useTokenLifecycle/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Validates and returns a safe refreshBufferSeconds value
+ *
+ * @param value - The refresh buffer value to validate (in seconds)
+ * @returns A safe refresh buffer value between 1-3600 seconds
+ */
+export const validateRefreshBuffer = (value) => {
+    const defaultValue = 300;
+    const buffer = value ?? defaultValue;
+    if (buffer < 1 || buffer > 3600) {
+        console.warn(`Invalid refreshBufferSeconds: ${buffer}. Must be between 1-3600 seconds. Using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    return buffer;
+};
+//# sourceMappingURL=utils.js.map

package/dist/hooks/useTokenLifecycle/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/hooks/useTokenLifecycle/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAyB,EAAU,EAAE;IACzE,MAAM,YAAY,GAAG,GAAG,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,IAAI,YAAY,CAAC;IAErC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,iCAAiC,MAAM,oDAAoD,YAAY,EAAE,CAAC,CAAC;QACxH,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/hooks/useTrade/index.d.ts

@@ -0,0 +1,3 @@
+export type { UseTradeReturn } from "./types";
+export { useTrade } from "./useTrade";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useTrade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTrade/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/useTrade/index.js

@@ -0,0 +1,2 @@
+export { useTrade } from "./useTrade";
+//# sourceMappingURL=index.js.map

package/dist/hooks/useTrade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/useTrade/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/useTrade/types.d.ts

@@ -0,0 +1,29 @@
+import type { CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, OrderSide, ReplaceOrderResponse, TimeInForce, TradingMode } from "@0xmonaco/types";
+export interface UseTradeReturn {
+    /** Place a limit order */
+    placeLimitOrder: (tradingPairId: string, side: OrderSide, quantity: string, price: string, options?: {
+        tradingMode?: TradingMode;
+        useMasterBalance?: boolean;
+        expirationDate?: string;
+        timeInForce?: TimeInForce;
+    }) => Promise<CreateOrderResponse>;
+    /** Place a market order */
+    placeMarketOrder: (tradingPairId: string, side: OrderSide, quantity: string, options?: {
+        tradingMode?: TradingMode;
+        slippageTolerance?: number;
+        timeInForce?: TimeInForce;
+    }) => Promise<CreateOrderResponse>;
+    /** Cancel an existing order */
+    cancelOrder: (orderId: string) => Promise<CancelOrderResponse>;
+    /** Replace an existing order */
+    replaceOrder: (orderId: string, newOrder: {
+        price?: string;
+        quantity?: string;
+        useMasterBalance?: boolean;
+    }) => Promise<ReplaceOrderResponse>;
+    /** Get paginated orders */
+    getPaginatedOrders: (params?: GetPaginatedOrdersParams) => Promise<GetPaginatedOrdersResponse>;
+    /** Get a single order by ID */
+    getOrder: (orderId: string) => Promise<GetOrderResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/useTrade/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTrade/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,eAAe,EAAE,CACf,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,KACpH,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAElC,2BAA2B;IAC3B,gBAAgB,EAAE,CAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,KAC3F,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAElC,+BAA+B;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/D,gCAAgC;IAChC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE9I,2BAA2B;IAC3B,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE/F,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1D"}

package/dist/hooks/useTrade/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/useTrade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/useTrade/types.ts"],"names":[],"mappings":""}

package/dist/hooks/useTrade/useTrade.d.ts

@@ -0,0 +1,3 @@
+import type { UseTradeReturn } from "./types";
+export declare const useTrade: () => UseTradeReturn;
+//# sourceMappingURL=useTrade.d.ts.map

package/dist/hooks/useTrade/useTrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrade.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTrade/useTrade.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,QAAQ,QAAO,cAkH3B,CAAC"}

package/dist/hooks/useTrade/useTrade.js

@@ -0,0 +1,89 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+export const useTrade = () => {
+    const { sdk } = useMonacoSDK();
+    const placeLimitOrder = useCallback(async (tradingPairId, side, quantity, price, options) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!tradingPairId?.trim())
+            throw new Error("Trading pair ID is required and cannot be empty");
+        if (!side)
+            throw new Error("Order side is required");
+        if (!quantity?.trim())
+            throw new Error("Quantity is required and cannot be empty");
+        if (!price?.trim())
+            throw new Error("Price is required and cannot be empty");
+        if (Number(quantity) <= 0)
+            throw new Error("Quantity must be greater than 0");
+        if (Number(price) <= 0)
+            throw new Error("Price must be greater than 0");
+        return await sdk.trading.placeLimitOrder(tradingPairId, side, quantity, price, options);
+    }, [sdk]);
+    const placeMarketOrder = useCallback(async (tradingPairId, side, quantity, options) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!tradingPairId?.trim())
+            throw new Error("Trading pair ID is required and cannot be empty");
+        if (!side)
+            throw new Error("Order side is required");
+        if (!quantity?.trim())
+            throw new Error("Quantity is required and cannot be empty");
+        if (Number(quantity) <= 0)
+            throw new Error("Quantity must be greater than 0");
+        return await sdk.trading.placeMarketOrder(tradingPairId, side, quantity, options);
+    }, [sdk]);
+    const cancelOrder = useCallback(async (orderId) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!orderId?.trim())
+            throw new Error("Order ID is required and cannot be empty");
+        return await sdk.trading.cancelOrder(orderId);
+    }, [sdk]);
+    const replaceOrder = useCallback(async (orderId, newOrder) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!orderId?.trim())
+            throw new Error("Order ID is required and cannot be empty");
+        if (!newOrder)
+            throw new Error("New order object is required");
+        // Validate quantity only if provided
+        if (newOrder.quantity !== undefined) {
+            if (!newOrder.quantity?.trim())
+                throw new Error("Quantity cannot be empty");
+            if (Number(newOrder.quantity) <= 0)
+                throw new Error("Quantity must be greater than 0");
+        }
+        // Validate price only if provided
+        if (newOrder.price !== undefined) {
+            if (!newOrder.price?.trim())
+                throw new Error("Price cannot be empty");
+            if (Number(newOrder.price) <= 0)
+                throw new Error("Price must be a valid positive number");
+        }
+        return await sdk.trading.replaceOrder(orderId, newOrder);
+    }, [sdk]);
+    const getPaginatedOrders = useCallback(async (params) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.trading.getPaginatedOrders(params);
+    }, [sdk]);
+    const getOrder = useCallback(async (orderId) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!orderId?.trim())
+            throw new Error("Order ID is required and cannot be empty");
+        return await sdk.trading.getOrder(orderId);
+    }, [sdk]);
+    return {
+        // Order placement
+        placeLimitOrder,
+        placeMarketOrder,
+        // Order management
+        cancelOrder,
+        replaceOrder,
+        // Order queries
+        getPaginatedOrders,
+        getOrder,
+    };
+};
+//# sourceMappingURL=useTrade.js.map

package/dist/hooks/useTrade/useTrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrade.js","sourceRoot":"","sources":["../../../src/hooks/useTrade/useTrade.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useTradeFeed/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export { useTradeFeed } from "./useTradeFeed";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useTradeFeed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/useTradeFeed/index.js

@@ -0,0 +1,3 @@
+export * from "./types";
+export { useTradeFeed } from "./useTradeFeed";
+//# sourceMappingURL=index.js.map

package/dist/hooks/useTradeFeed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/useTradeFeed/types.d.ts

@@ -0,0 +1,15 @@
+import type { TradeEvent } from "@0xmonaco/types";
+/**
+ * Return type for the useTradeFeed hook
+ */
+export interface UseTradeFeedReturn {
+    /** Array of trade events from WebSocket and REST API */
+    trades: TradeEvent[];
+    /** Whether currently subscribed to a market */
+    subscribed: boolean;
+    /** Any error that occurred during connection or subscription */
+    error: Error | null;
+    /** Clear the current error state */
+    clearError: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/useTradeFeed/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,oCAAoC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB"}

package/dist/hooks/useTradeFeed/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/useTradeFeed/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/types.ts"],"names":[],"mappings":""}

package/dist/hooks/useTradeFeed/useTradeFeed.d.ts

@@ -0,0 +1,9 @@
+import type { UseTradeFeedReturn } from "./types";
+/**
+ * Hook for subscribing to real-time trade events via WebSocket (public)
+ *
+ * @param tradingPairId - The trading pair UUID to subscribe to
+ * @param maxTrades - Maximum number of trades to keep in state (default: 50)
+ */
+export declare function useTradeFeed(tradingPairId: string, maxTrades?: number): UseTradeFeedReturn;
+//# sourceMappingURL=useTradeFeed.d.ts.map

package/dist/hooks/useTradeFeed/useTradeFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTradeFeed.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/useTradeFeed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,kBAAkB,CA6CtF"}

package/dist/hooks/useTradeFeed/useTradeFeed.js

@@ -0,0 +1,47 @@
+import { useCallback, useEffect, useState } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Hook for subscribing to real-time trade events via WebSocket (public)
+ *
+ * @param tradingPairId - The trading pair UUID to subscribe to
+ * @param maxTrades - Maximum number of trades to keep in state (default: 50)
+ */
+export function useTradeFeed(tradingPairId, maxTrades = 50) {
+    const { sdk } = useMonacoSDK();
+    const [trades, setTrades] = useState([]);
+    const [error, setError] = useState(null);
+    const [subscribed, setSubscribed] = useState(false);
+    const clearError = useCallback(() => setError(null), []);
+    // Fetch initial trades and subscribe to WebSocket updates
+    useEffect(() => {
+        if (!sdk?.ws || !sdk?.trades || !tradingPairId) {
+            setSubscribed(false);
+            return;
+        }
+        setTrades([]);
+        setError(null);
+        // Fetch initial trades via REST API
+        const limit = Number.isFinite(maxTrades) ? maxTrades : 50;
+        sdk.trades
+            .getTrades(tradingPairId, { limit })
+            .then((initialTrades) => setTrades(initialTrades))
+            .catch((err) => setError(err instanceof Error ? err : new Error(String(err))));
+        // Subscribe to WebSocket trade updates
+        const unsubscribe = sdk.ws.trades(tradingPairId, (event) => {
+            setTrades((prev) => {
+                // Deduplicate by tradeId and keep newest first
+                const exists = prev.some((t) => t.data.tradeId === event.data.tradeId);
+                if (exists)
+                    return prev;
+                return [event, ...prev].slice(0, limit);
+            });
+        });
+        setSubscribed(true);
+        return () => {
+            unsubscribe();
+            setSubscribed(false);
+        };
+    }, [sdk?.ws, sdk?.trades, tradingPairId, maxTrades]);
+    return { trades, subscribed, error, clearError };
+}
+//# sourceMappingURL=useTradeFeed.js.map

package/dist/hooks/useTradeFeed/useTradeFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTradeFeed.js","sourceRoot":"","sources":["../../../src/hooks/useTradeFeed/useTradeFeed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB,EAAE,SAAS,GAAG,EAAE;IAChE,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAE/B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,0DAA0D;IAC1D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/C,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,oCAAoC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM;aACP,SAAS,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC;aACnC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;aACjD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,uCAAuC;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,KAAiB,EAAE,EAAE;YACrE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjB,+CAA+C;gBAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvE,IAAI,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACxB,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,IAAI,CAAC,CAAC;QAEpB,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dist/hooks/useUserMovements/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export { useUserMovements } from "./useUserMovements";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useUserMovements/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/useUserMovements/index.js

@@ -0,0 +1,3 @@
+export * from "./types";
+export { useUserMovements } from "./useUserMovements";
+//# sourceMappingURL=index.js.map

package/dist/hooks/useUserMovements/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/useUserMovements/types.d.ts

@@ -0,0 +1,17 @@
+import type { UserMovementEvent } from "@0xmonaco/types";
+/**
+ * Return type for the useUserMovements hook
+ */
+export interface UseUserMovementsReturn {
+    /** Array of user movement events from WebSocket */
+    movements: UserMovementEvent[];
+    /** Whether initial data is being loaded */
+    loading: boolean;
+    /** Whether currently subscribed to movements channel */
+    subscribed: boolean;
+    /** Any error that occurred during connection or subscription */
+    error: Error | null;
+    /** Clear the current error state */
+    clearError: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/useUserMovements/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,oCAAoC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB"}

package/dist/hooks/useUserMovements/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/useUserMovements/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/types.ts"],"names":[],"mappings":""}

package/dist/hooks/useUserMovements/useUserMovements.d.ts

@@ -0,0 +1,12 @@
+import type { UseUserMovementsReturn } from "./types";
+/**
+ * Hook for subscribing to real-time user movement events via WebSocket (authenticated)
+ *
+ * Fetches initial movements from the REST API, then subscribes to real-time updates.
+ * Requires authentication - the user must be logged in with a valid JWT token.
+ * User is identified on the backend via the JWT token.
+ *
+ * @param maxMovements - Maximum number of movements to keep in state (default: 50)
+ */
+export declare function useUserMovements(maxMovements?: number): UseUserMovementsReturn;
+//# sourceMappingURL=useUserMovements.d.ts.map

package/dist/hooks/useUserMovements/useUserMovements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserMovements.d.ts","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/useUserMovements.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AA4BtD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,SAAK,GAAG,sBAAsB,CA+D1E"}

package/dist/hooks/useUserMovements/useUserMovements.js

@@ -0,0 +1,92 @@
+import { useCallback, useEffect, useState } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Convert a LedgerMovement from the REST API to a UserMovementEvent format
+ */
+function ledgerMovementToEvent(movement, userId) {
+    return {
+        eventType: "movement",
+        userId,
+        data: {
+            id: movement.id,
+            entryType: movement.entry_type,
+            transactionType: movement.transaction_type,
+            tokenAddress: movement.token,
+            amount: movement.amount,
+            balanceBefore: movement.balance_before ?? undefined,
+            balanceAfter: movement.balance_after ?? undefined,
+            lockedBefore: movement.locked_before ?? undefined,
+            lockedAfter: movement.locked_after ?? undefined,
+            referenceId: movement.reference_id ?? undefined,
+            referenceType: movement.reference_type ?? undefined,
+            description: movement.description ?? undefined,
+            txHash: movement.tx_hash ?? undefined,
+            createdAt: movement.created_at ?? undefined,
+        },
+    };
+}
+/**
+ * Hook for subscribing to real-time user movement events via WebSocket (authenticated)
+ *
+ * Fetches initial movements from the REST API, then subscribes to real-time updates.
+ * Requires authentication - the user must be logged in with a valid JWT token.
+ * User is identified on the backend via the JWT token.
+ *
+ * @param maxMovements - Maximum number of movements to keep in state (default: 50)
+ */
+export function useUserMovements(maxMovements = 50) {
+    const { sdk } = useMonacoSDK();
+    const [movements, setMovements] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [subscribed, setSubscribed] = useState(false);
+    const clearError = useCallback(() => setError(null), []);
+    useEffect(() => {
+        if (!sdk?.ws || !sdk?.profile) {
+            setSubscribed(false);
+            return;
+        }
+        setMovements([]);
+        setError(null);
+        setLoading(true);
+        const limit = Number.isFinite(maxMovements) ? maxMovements : 50;
+        // Fetch initial movements via REST API, then subscribe to WebSocket updates
+        let unsubscribe;
+        sdk.profile
+            .getProfile()
+            .then((profile) => {
+            return sdk.profile.getPaginatedUserMovements({ limit }).then((response) => {
+                const initialMovements = response.movements.map((m) => ledgerMovementToEvent(m, profile.id));
+                setMovements(initialMovements);
+                // Subscribe to WebSocket movement updates after initial data is loaded
+                // This prevents race conditions where WS events could be overwritten by REST response
+                try {
+                    unsubscribe = sdk.ws.movements((event) => {
+                        setMovements((prev) => {
+                            // Deduplicate by id and keep newest first
+                            const exists = prev.some((m) => m.data.id === event.data.id);
+                            if (exists) {
+                                // Update existing movement
+                                return prev.map((m) => (m.data.id === event.data.id ? event : m));
+                            }
+                            return [event, ...prev].slice(0, limit);
+                        });
+                    });
+                    setSubscribed(true);
+                }
+                catch (err) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setSubscribed(false);
+                }
+            });
+        })
+            .catch((err) => setError(err instanceof Error ? err : new Error(String(err))))
+            .finally(() => setLoading(false));
+        return () => {
+            unsubscribe?.();
+            setSubscribed(false);
+        };
+    }, [sdk?.ws, sdk?.profile, maxMovements]);
+    return { movements, loading, subscribed, error, clearError };
+}
+//# sourceMappingURL=useUserMovements.js.map

package/dist/hooks/useUserMovements/useUserMovements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserMovements.js","sourceRoot":"","sources":["../../../src/hooks/useUserMovements/useUserMovements.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useVault/index.d.ts

@@ -0,0 +1,3 @@
+export type { UseVaultReturn } from "./types";
+export { useVault } from "./useVault";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useVault/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useVault/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}