@0xmonaco/react 0.0.0-develop-20260120180031

package/dist/hooks/useVault/index.js

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

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

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

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

@@ -0,0 +1,16 @@
+import type { Balance, TransactionResult } from "@0xmonaco/types";
+export interface UseVaultReturn {
+    /** Approve the vault to spend tokens */
+    approve: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<TransactionResult>;
+    /** Deposit tokens into the vault */
+    deposit: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<TransactionResult>;
+    /** Withdraw tokens from the vault */
+    withdraw: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<TransactionResult>;
+    /** Get the balance of a token in the vault */
+    getBalance: (assetId: string) => Promise<Balance>;
+    /** Get the allowance for a token */
+    getAllowance: (assetId: string) => Promise<bigint>;
+    /** Check if a token needs approval for an amount */
+    needsApproval: (assetId: string, amount: bigint) => Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/useVault/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7F,oCAAoC;IACpC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7F,qCAAqC;IACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9F,8CAA8C;IAC9C,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,oCAAoC;IACpC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD,oDAAoD;IACpD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE"}

package/dist/hooks/useVault/types.js

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

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

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

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

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

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

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

package/dist/hooks/useVault/useVault.js

@@ -0,0 +1,66 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+export const useVault = () => {
+    const { sdk } = useMonacoSDK();
+    const approve = useCallback(async (assetId, amount, autoWait) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        if (amount <= 0n)
+            throw new Error("Amount must be greater than 0");
+        return await sdk.vault.approve(assetId, amount, autoWait);
+    }, [sdk]);
+    const deposit = useCallback(async (assetId, amount, autoWait) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        if (amount <= 0n)
+            throw new Error("Amount must be greater than 0");
+        return await sdk.vault.deposit(assetId, amount, autoWait);
+    }, [sdk]);
+    const withdraw = useCallback(async (assetId, amount, autoWait) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        if (amount <= 0n)
+            throw new Error("Amount must be greater than 0");
+        return await sdk.vault.withdraw(assetId, amount, autoWait);
+    }, [sdk]);
+    const getBalance = useCallback(async (assetId) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        return await sdk.vault.getBalance(assetId);
+    }, [sdk]);
+    const getAllowance = useCallback(async (assetId) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        return await sdk.vault.getAllowance(assetId);
+    }, [sdk]);
+    const needsApproval = useCallback(async (assetId, amount) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        if (!assetId?.trim())
+            throw new Error("Asset ID is required and cannot be empty");
+        if (amount <= 0n)
+            throw new Error("Amount must be greater than 0");
+        return await sdk.vault.needsApproval(assetId, amount);
+    }, [sdk]);
+    return {
+        // Token operations
+        approve,
+        deposit,
+        withdraw,
+        // Balance and allowance queries
+        getBalance,
+        getAllowance,
+        needsApproval,
+    };
+};
+//# sourceMappingURL=useVault.js.map

package/dist/hooks/useVault/useVault.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./hooks";
+export * from "./provider";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./hooks";
+export * from "./provider";
+export * from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/provider/MonacoProvider.d.ts

@@ -0,0 +1,4 @@
+import { type MonacoContextValue, type MonacoProviderProps } from "./types";
+export declare const MonacoProvider: ({ children, clientId, network, seiRpcUrl, wsUrl, tokenLifecycle: tokenLifecycleConfig }: MonacoProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useMonacoContext: () => MonacoContextValue;
+//# sourceMappingURL=MonacoProvider.d.ts.map

package/dist/provider/MonacoProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonacoProvider.d.ts","sourceRoot":"","sources":["../../src/provider/MonacoProvider.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIlG,eAAO,MAAM,cAAc,GAAI,yFAAyF,mBAAmB,4CAsG1I,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,kBAQnC,CAAC"}

package/dist/provider/MonacoProvider.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MonacoSDK } from "@0xmonaco/core";
+import { createContext, useContext, useEffect, useMemo, useState } from "react";
+import { useWalletClient } from "wagmi";
+import { useTokenLifecycle } from "../hooks";
+import { loadAuthState } from "../utils";
+import { AuthenticationStatus } from "./types";
+const MonacoContext = createContext(null);
+export const MonacoProvider = ({ children, clientId, network, seiRpcUrl, wsUrl, tokenLifecycle: tokenLifecycleConfig }) => {
+    const { data: walletClient } = useWalletClient();
+    const [sdk, setSdk] = useState(null);
+    const [error, setError] = useState(null);
+    // Global authentication state (shared across all components)
+    const [authenticationStatus, setAuthenticationStatus] = useState(AuthenticationStatus.UNAUTHENTICATED);
+    // Token lifecycle management
+    const tokenLifecycle = useTokenLifecycle(sdk, tokenLifecycleConfig);
+    useEffect(() => {
+        const initializeSDK = async () => {
+            if (!walletClient) {
+                setSdk(null);
+                return;
+            }
+            setError(null);
+            const sdkConfig = {
+                walletClient,
+                network,
+                seiRpcUrl,
+                wsUrl
+            };
+            const newSdk = new MonacoSDK(sdkConfig);
+            setSdk(newSdk);
+        };
+        initializeSDK().catch((err) => {
+            // Normalize error to "Error" type and clear SDK on failure
+            const normalizedError = err instanceof Error ? err : new Error(String(err));
+            setError(normalizedError);
+            setSdk(null);
+        });
+    }, [network, walletClient, seiRpcUrl, wsUrl]);
+    // Restore cached tokens when the provider mounts
+    useEffect(() => {
+        if (!sdk)
+            return;
+        const persistTokens = tokenLifecycleConfig?.persistTokens ?? true;
+        if (!persistTokens)
+            return;
+        const cachedAuthState = loadAuthState();
+        if (!cachedAuthState)
+            return;
+        // Check if the token is expired
+        if (tokenLifecycle.isTokenExpired(cachedAuthState)) {
+            // Set the auth state first so refreshAuth has a refresh token to use
+            sdk.setAuthState(cachedAuthState);
+            tokenLifecycle.initializeTokens(cachedAuthState);
+            // Attempt to refresh
+            tokenLifecycle.refreshTokens().then((newAuthState) => {
+                if (newAuthState) {
+                    // Refresh succeeded, SDK auth state is already updated by refreshAuth
+                    setAuthenticationStatus(AuthenticationStatus.AUTHENTICATED);
+                }
+                else {
+                    // Refresh failed, clear tokens and SDK state
+                    tokenLifecycle.clearTokens();
+                    sdk.logout().catch(() => { }); // Ignore errors, we're already in cleanup mode
+                    setAuthenticationStatus(AuthenticationStatus.UNAUTHENTICATED);
+                }
+            }).catch((err) => {
+                const normalizedError = err instanceof Error ? err : new Error(String(err));
+                setError(normalizedError);
+                tokenLifecycle.clearTokens();
+                sdk.logout().catch(() => { }); // Ignore errors, we're already in cleanup mode
+                setAuthenticationStatus(AuthenticationStatus.UNAUTHENTICATED);
+            });
+        }
+        else {
+            // Token is still valid, restore it
+            sdk.setAuthState(cachedAuthState);
+            tokenLifecycle.initializeTokens(cachedAuthState);
+            setAuthenticationStatus(AuthenticationStatus.AUTHENTICATED);
+        }
+    }, [sdk, tokenLifecycle, tokenLifecycleConfig?.persistTokens]);
+    const contextValue = useMemo(() => ({
+        sdk,
+        clientId,
+        error,
+        // Global authentication state
+        authenticationStatus,
+        // Token lifecycle management
+        tokenLifecycle,
+        // Global authentication state setters
+        setAuthenticationStatus,
+        setError,
+    }), [sdk, clientId, error, authenticationStatus, tokenLifecycle]);
+    return _jsx(MonacoContext.Provider, { value: contextValue, children: children });
+};
+export const useMonacoContext = () => {
+    const context = useContext(MonacoContext);
+    if (!context) {
+        throw new Error("useMonacoContext must be used within a MonacoProvider. " + "Make sure to wrap your app with <MonacoProvider>.");
+    }
+    return context;
+};
+//# sourceMappingURL=MonacoProvider.js.map

package/dist/provider/MonacoProvider.js.map

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

package/dist/provider/index.d.ts

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

package/dist/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/provider/index.js

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

package/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/provider/types.d.ts

@@ -0,0 +1,46 @@
+import type { MonacoSDK, Network } from "@0xmonaco/types";
+import type { ReactNode } from "react";
+import type { TokenLifecycleConfig, UseTokenLifecycleReturn } from "../hooks";
+export declare enum AuthenticationStatus {
+    /** User is not authenticated */
+    UNAUTHENTICATED = "unauthenticated",
+    /** Authentication is in progress */
+    AUTHENTICATING = "authenticating",
+    /** User is successfully authenticated */
+    AUTHENTICATED = "authenticated"
+}
+export interface MonacoContextValue {
+    /** Monaco SDK instance */
+    sdk: MonacoSDK | null;
+    /** Client ID for authentication */
+    clientId: string;
+    /** Any error that occurred (SDK initialization, authentication, etc.) */
+    error: Error | null;
+    /** Current authentication status */
+    authenticationStatus: AuthenticationStatus;
+    /** Token lifecycle manager */
+    tokenLifecycle: UseTokenLifecycleReturn;
+    /** Function to update authentication status */
+    setAuthenticationStatus: (status: AuthenticationStatus) => void;
+    /** Function to update error */
+    setError: (error: Error | null) => void;
+}
+export interface MonacoProviderProps {
+    /** Child components */
+    children: ReactNode;
+    /** Client ID for authentication */
+    clientId: string;
+    /**
+     * Network to use - can be a preset ("local", "testnet", "mainnet") or a custom API URL.
+     *
+     * For custom API URLs, pass the full URL as a string (e.g., "https://my-custom-monaco-api.com")
+     */
+    network: Network;
+    /** WebSocket URL for Monaco (required) */
+    wsUrl: string;
+    /** RPC URL for Sei blockchain interactions (required) */
+    seiRpcUrl: string;
+    /** Token lifecycle configuration options */
+    tokenLifecycle?: TokenLifecycleConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/provider/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAE9E,oBAAY,oBAAoB;IAC9B,gCAAgC;IAChC,eAAe,oBAAoB;IACnC,oCAAoC;IACpC,cAAc,mBAAmB;IACjC,yCAAyC;IACzC,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,oCAAoC;IACpC,oBAAoB,EAAE,oBAAoB,CAAC;IAG3C,8BAA8B;IAC9B,cAAc,EAAE,uBAAuB,CAAC;IAGxC,+CAA+C;IAC/C,uBAAuB,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAChE,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC"}

package/dist/provider/types.js

@@ -0,0 +1,10 @@
+export var AuthenticationStatus;
+(function (AuthenticationStatus) {
+    /** User is not authenticated */
+    AuthenticationStatus["UNAUTHENTICATED"] = "unauthenticated";
+    /** Authentication is in progress */
+    AuthenticationStatus["AUTHENTICATING"] = "authenticating";
+    /** User is successfully authenticated */
+    AuthenticationStatus["AUTHENTICATED"] = "authenticated";
+})(AuthenticationStatus || (AuthenticationStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/provider/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/provider/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,gCAAgC;IAChC,2DAAmC,CAAA;IACnC,oCAAoC;IACpC,yDAAiC,CAAA;IACjC,yCAAyC;IACzC,uDAA+B,CAAA;AACjC,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./tokenStorage";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./tokenStorage";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/utils/tokenStorage.d.ts

@@ -0,0 +1,39 @@
+import type { AuthState } from "@0xmonaco/types";
+/**
+ * Save auth state to localStorage
+ *
+ * @security This function stores authentication tokens (including refresh tokens) in localStorage,
+ * which is accessible to any JavaScript running on the page. This makes tokens vulnerable to XSS attacks.
+ *
+ * Security recommendations:
+ * - Implement Content Security Policy (CSP) headers to mitigate XSS risks
+ * - Sanitize all user input to prevent XSS vulnerabilities
+ * - Consider the tradeoffs: localStorage provides persistence across sessions but sacrifices XSS protection
+ * - For high-security requirements, consider httpOnly cookies (requires backend changes)
+ *
+ * @param authState - The authentication state to persist
+ */
+export declare function saveAuthState(authState: AuthState): void;
+/**
+ * Load auth state from localStorage
+ * @returns The persisted auth state or null if not found/invalid
+ */
+export declare function loadAuthState(): AuthState | null;
+/**
+ * Clear auth state from localStorage
+ */
+export declare function clearAuthState(): void;
+/**
+ * Check if the stored token is expired
+ * @param authState - The auth state to check
+ * @param bufferSeconds - Buffer time before actual expiry (default: 60 seconds)
+ * @returns True if token is expired or will expire within buffer time
+ */
+export declare function isTokenExpired(authState: AuthState, bufferSeconds?: number): boolean;
+/**
+ * Get time until token expiration in seconds
+ * @param authState - The auth state to check
+ * @returns Seconds until expiration (negative if already expired)
+ */
+export declare function getTimeUntilExpiry(authState: AuthState): number;
+//# sourceMappingURL=tokenStorage.d.ts.map

package/dist/utils/tokenStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../src/utils/tokenStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAYxD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,SAAS,GAAG,IAAI,CAsChD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,SAAK,GAAG,OAAO,CAGhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAG/D"}

package/dist/utils/tokenStorage.js

@@ -0,0 +1,103 @@
+/**
+ * Storage key for persisting auth tokens
+ */
+const STORAGE_KEY = "monaco_auth_state";
+/**
+ * Save auth state to localStorage
+ *
+ * @security This function stores authentication tokens (including refresh tokens) in localStorage,
+ * which is accessible to any JavaScript running on the page. This makes tokens vulnerable to XSS attacks.
+ *
+ * Security recommendations:
+ * - Implement Content Security Policy (CSP) headers to mitigate XSS risks
+ * - Sanitize all user input to prevent XSS vulnerabilities
+ * - Consider the tradeoffs: localStorage provides persistence across sessions but sacrifices XSS protection
+ * - For high-security requirements, consider httpOnly cookies (requires backend changes)
+ *
+ * @param authState - The authentication state to persist
+ */
+export function saveAuthState(authState) {
+    try {
+        const data = JSON.stringify({
+            accessToken: authState.accessToken,
+            refreshToken: authState.refreshToken,
+            expiresAt: authState.expiresAt,
+            user: authState.user,
+        });
+        localStorage.setItem(STORAGE_KEY, data);
+    }
+    catch (error) {
+        console.warn("Failed to save auth state to localStorage:", error);
+    }
+}
+/**
+ * Load auth state from localStorage
+ * @returns The persisted auth state or null if not found/invalid
+ */
+export function loadAuthState() {
+    try {
+        const data = localStorage.getItem(STORAGE_KEY);
+        if (!data)
+            return null;
+        const parsed = JSON.parse(data);
+        // Validate required fields and types
+        if (typeof parsed.accessToken !== "string" ||
+            parsed.accessToken.length === 0 ||
+            typeof parsed.refreshToken !== "string" ||
+            parsed.refreshToken.length === 0 ||
+            typeof parsed.expiresAt !== "number" ||
+            !Number.isFinite(parsed.expiresAt) ||
+            parsed.expiresAt <= 0 ||
+            typeof parsed.user !== "object" ||
+            parsed.user === null ||
+            typeof parsed.user.id !== "string" ||
+            parsed.user.id.length === 0 ||
+            typeof parsed.user.address !== "string" ||
+            parsed.user.address.length === 0) {
+            clearAuthState();
+            return null;
+        }
+        return {
+            accessToken: parsed.accessToken,
+            refreshToken: parsed.refreshToken,
+            expiresAt: parsed.expiresAt,
+            user: parsed.user,
+        };
+    }
+    catch (error) {
+        console.warn("Failed to load auth state from localStorage:", error);
+        clearAuthState();
+        return null;
+    }
+}
+/**
+ * Clear auth state from localStorage
+ */
+export function clearAuthState() {
+    try {
+        localStorage.removeItem(STORAGE_KEY);
+    }
+    catch (error) {
+        console.warn("Failed to clear auth state from localStorage:", error);
+    }
+}
+/**
+ * Check if the stored token is expired
+ * @param authState - The auth state to check
+ * @param bufferSeconds - Buffer time before actual expiry (default: 60 seconds)
+ * @returns True if token is expired or will expire within buffer time
+ */
+export function isTokenExpired(authState, bufferSeconds = 60) {
+    const now = Math.floor(Date.now() / 1000);
+    return authState.expiresAt <= now + bufferSeconds;
+}
+/**
+ * Get time until token expiration in seconds
+ * @param authState - The auth state to check
+ * @returns Seconds until expiration (negative if already expired)
+ */
+export function getTimeUntilExpiry(authState) {
+    const now = Math.floor(Date.now() / 1000);
+    return authState.expiresAt - now;
+}
+//# sourceMappingURL=tokenStorage.js.map

package/dist/utils/tokenStorage.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@0xmonaco/react",
+  "version": "0.0.0-develop-20260120180031",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@0xmonaco/core": "0.0.0-develop-20260120180031",
+    "@0xmonaco/types": "0.0.0-develop-20260120180031"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.12",
+    "typescript": "5.9.2",
+    "react": "^18.3.1",
+    "wagmi": "^2.17.5",
+    "viem": "^2.31.7"
+  },
+  "peerDependencies": {
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "wagmi": "^2.17.5",
+    "viem": "^2.31.7"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts,.tsx"
+  }
+}