@volr/react 0.1.70 → 0.1.72

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, PasskeyProviderPort } from '@volr/sdk-core';
+import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, TypedDataInput, PasskeyProviderPort } from '@volr/sdk-core';
 export { AuthorizationTuple, Call, MpcTransport, PrecheckInput, PrecheckQuote, PrfInput, RelayInput, RelayMode, RelayResult, SessionAuth, UploadBlobOptions, createMasterKeyProvider, createMpcProvider, createPasskeyProvider, deriveEvmKey, deriveWrapKey, sealMasterSeed, uploadBlob } from '@volr/sdk-core';
 import { Address, Abi, PublicClient } from 'viem';
 
@@ -434,6 +434,39 @@ type EvmClient = {
      * Send a batch of transactions
      */
     sendBatch: SendBatchOverloads;
+    /**
+     * Sign a message (EIP-191 personal_sign)
+     * @param message - String or bytes to sign
+     * @returns Signature hex string
+     * @example
+     * ```ts
+     * const signature = await evm(1).signMessage('Hello, World!');
+     * // or with raw bytes
+     * const signature = await evm(1).signMessage(new Uint8Array([1, 2, 3]));
+     * ```
+     */
+    signMessage: (message: string | Uint8Array) => Promise<`0x${string}`>;
+    /**
+     * Sign EIP-712 typed data
+     * @param typedData - Typed data with domain, types, and message
+     * @returns Signature hex string
+     * @example
+     * ```ts
+     * const signature = await evm(1).signTypedData({
+     *   domain: {
+     *     name: 'MyApp',
+     *     version: '1',
+     *     chainId: 1,
+     *     verifyingContract: '0x...',
+     *   },
+     *   types: {
+     *     Message: [{ name: 'content', type: 'string' }],
+     *   },
+     *   message: { content: 'Hello' },
+     * });
+     * ```
+     */
+    signTypedData: (typedData: TypedDataInput) => Promise<`0x${string}`>;
 };
 /**
  * Volr client interface
@@ -526,15 +559,52 @@ interface UseVolrLoginReturn {
 declare function useVolrLogin(): UseVolrLoginReturn;
 
 interface UseVolrAuthCallbackOptions {
+    /**
+     * Called when OAuth authentication is successful
+     */
     onSuccess?: (user: VolrUser) => void;
+    /**
+     * Called when OAuth authentication fails
+     */
     onError?: (error: string) => void;
+    /**
+     * If true, automatically clears the URL query params after processing
+     * @default true
+     */
+    clearUrlParams?: boolean;
 }
 interface UseVolrAuthCallbackReturn {
+    /** Whether the callback is being processed */
     isLoading: boolean;
+    /** Error message if authentication failed */
     error: string | null;
+    /** Whether this is a new user (first time sign in) */
     isNewUser: boolean;
+    /** The authenticated user object */
     user: VolrUser | null;
 }
+/**
+ * Hook to handle OAuth callback after social login redirect.
+ *
+ * Usage:
+ * ```tsx
+ * // In your /auth/callback page
+ * function AuthCallbackPage() {
+ *   const { isLoading, error, user, isNewUser } = useVolrAuthCallback({
+ *     onSuccess: (user) => {
+ *       navigate('/dashboard');
+ *     },
+ *     onError: (error) => {
+ *       navigate('/login?error=' + encodeURIComponent(error));
+ *     },
+ *   });
+ *
+ *   if (isLoading) return <LoadingSpinner />;
+ *   if (error) return <ErrorMessage message={error} />;
+ *   return null;
+ * }
+ * ```
+ */
 declare function useVolrAuthCallback(options?: UseVolrAuthCallbackOptions): UseVolrAuthCallbackReturn;
 
 type Erc20Token = {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, PasskeyProviderPort } from '@volr/sdk-core';
+import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, TypedDataInput, PasskeyProviderPort } from '@volr/sdk-core';
 export { AuthorizationTuple, Call, MpcTransport, PrecheckInput, PrecheckQuote, PrfInput, RelayInput, RelayMode, RelayResult, SessionAuth, UploadBlobOptions, createMasterKeyProvider, createMpcProvider, createPasskeyProvider, deriveEvmKey, deriveWrapKey, sealMasterSeed, uploadBlob } from '@volr/sdk-core';
 import { Address, Abi, PublicClient } from 'viem';
 
@@ -434,6 +434,39 @@ type EvmClient = {
      * Send a batch of transactions
      */
     sendBatch: SendBatchOverloads;
+    /**
+     * Sign a message (EIP-191 personal_sign)
+     * @param message - String or bytes to sign
+     * @returns Signature hex string
+     * @example
+     * ```ts
+     * const signature = await evm(1).signMessage('Hello, World!');
+     * // or with raw bytes
+     * const signature = await evm(1).signMessage(new Uint8Array([1, 2, 3]));
+     * ```
+     */
+    signMessage: (message: string | Uint8Array) => Promise<`0x${string}`>;
+    /**
+     * Sign EIP-712 typed data
+     * @param typedData - Typed data with domain, types, and message
+     * @returns Signature hex string
+     * @example
+     * ```ts
+     * const signature = await evm(1).signTypedData({
+     *   domain: {
+     *     name: 'MyApp',
+     *     version: '1',
+     *     chainId: 1,
+     *     verifyingContract: '0x...',
+     *   },
+     *   types: {
+     *     Message: [{ name: 'content', type: 'string' }],
+     *   },
+     *   message: { content: 'Hello' },
+     * });
+     * ```
+     */
+    signTypedData: (typedData: TypedDataInput) => Promise<`0x${string}`>;
 };
 /**
  * Volr client interface
@@ -526,15 +559,52 @@ interface UseVolrLoginReturn {
 declare function useVolrLogin(): UseVolrLoginReturn;
 
 interface UseVolrAuthCallbackOptions {
+    /**
+     * Called when OAuth authentication is successful
+     */
     onSuccess?: (user: VolrUser) => void;
+    /**
+     * Called when OAuth authentication fails
+     */
     onError?: (error: string) => void;
+    /**
+     * If true, automatically clears the URL query params after processing
+     * @default true
+     */
+    clearUrlParams?: boolean;
 }
 interface UseVolrAuthCallbackReturn {
+    /** Whether the callback is being processed */
     isLoading: boolean;
+    /** Error message if authentication failed */
     error: string | null;
+    /** Whether this is a new user (first time sign in) */
     isNewUser: boolean;
+    /** The authenticated user object */
     user: VolrUser | null;
 }
+/**
+ * Hook to handle OAuth callback after social login redirect.
+ *
+ * Usage:
+ * ```tsx
+ * // In your /auth/callback page
+ * function AuthCallbackPage() {
+ *   const { isLoading, error, user, isNewUser } = useVolrAuthCallback({
+ *     onSuccess: (user) => {
+ *       navigate('/dashboard');
+ *     },
+ *     onError: (error) => {
+ *       navigate('/login?error=' + encodeURIComponent(error));
+ *     },
+ *   });
+ *
+ *   if (isLoading) return <LoadingSpinner />;
+ *   if (error) return <ErrorMessage message={error} />;
+ *   return null;
+ * }
+ * ```
+ */
 declare function useVolrAuthCallback(options?: UseVolrAuthCallbackOptions): UseVolrAuthCallbackReturn;
 
 type Erc20Token = {

package/dist/index.js

@@ -18516,7 +18516,37 @@ function useVolr() {
               setProvider
             }
           });
-        })
+        }),
+        signMessage: async (message) => {
+          if (!provider) {
+            throw new Error(
+              "No wallet provider available. Please log in with a Passkey or MPC wallet to sign messages."
+            );
+          }
+          await provider.ensureSession({ interactive: true });
+          const messageHash = hashMessage(
+            typeof message === "string" ? message : { raw: message }
+          );
+          const hashBytes = new Uint8Array(32);
+          const hex = messageHash.slice(2);
+          for (let i = 0; i < 32; i++) {
+            hashBytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+          }
+          const sig = await provider.signMessage(hashBytes);
+          const v = sig.yParity + 27;
+          const rHex = Array.from(sig.r).map((b) => b.toString(16).padStart(2, "0")).join("");
+          const sHex = Array.from(sig.s).map((b) => b.toString(16).padStart(2, "0")).join("");
+          const vHex = v.toString(16).padStart(2, "0");
+          return `0x${rHex}${sHex}${vHex}`;
+        },
+        signTypedData: async (typedData) => {
+          if (!provider) {
+            throw new Error(
+              "No wallet provider available. Please log in with a Passkey or MPC wallet to sign typed data."
+            );
+          }
+          return provider.signTypedData(typedData);
+        }
       };
     },
     [user, config, provider, precheck, relay, getRpcUrl, setProvider, client]
@@ -18609,7 +18639,12 @@ function useVolrLogin() {
     async (provider) => {
       if (typeof window !== "undefined") {
         const baseUrl = apiBaseUrl.replace(/\/+$/, "");
-        window.location.href = `${baseUrl}/auth/${provider}?projectApiKey=${encodeURIComponent(config.projectApiKey)}`;
+        const params = new URLSearchParams({
+          projectApiKey: config.projectApiKey,
+          callbackUrl: window.location.href
+          // Return to current page after login
+        });
+        window.location.href = `${baseUrl}/auth/${provider}?${params.toString()}`;
       }
     },
     [apiBaseUrl, config.projectApiKey]
@@ -18667,45 +18702,15 @@ function useVolrLogin() {
     handlePasskeyComplete
   };
 }
-function createAxiosInstance(baseUrl, apiKey) {
-  const instance = axios.create({
-    baseURL: baseUrl.replace(/\/+$/, ""),
-    // Remove trailing slashes
-    withCredentials: true,
-    // Include cookies
-    headers: {
-      "Content-Type": "application/json"
-    }
-  });
-  instance.interceptors.request.use((config) => {
-    if (apiKey) {
-      config.headers["X-API-Key"] = apiKey;
-    }
-    return config;
-  });
-  instance.interceptors.response.use(
-    (response) => response,
-    (error) => {
-      if (error.response?.data) {
-        const errorData = error.response.data;
-        if (errorData.error?.message) {
-          error.message = errorData.error.message;
-        }
-      }
-      return Promise.reject(error);
-    }
-  );
-  return instance;
-}
-
-// src/hooks/useVolrAuthCallback.ts
 function useVolrAuthCallback(options = {}) {
-  const { config, setUser } = useVolrContext();
-  const { refreshAccessToken, setAccessToken, setRefreshToken, client } = useInternalAuth();
+  const { clearUrlParams = true } = options;
+  const { setUser } = useVolrContext();
+  const { setAccessToken, setRefreshToken, client } = useInternalAuth();
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
   const [isNewUser, setIsNewUser] = useState(false);
   const [user, setLocalUser] = useState(null);
+  const hasProcessed = useRef(false);
   const toVolrUser = useCallback((u) => {
     return {
       id: u.id,
@@ -18721,24 +18726,35 @@ function useVolrAuthCallback(options = {}) {
       credentialId: u.credentialId ?? void 0
     };
   }, []);
-  const apiBaseUrl = resolveApiBaseUrl(config);
   useEffect(() => {
     const handleCallback = async () => {
       if (typeof window === "undefined") return;
+      if (hasProcessed.current) return;
+      hasProcessed.current = true;
       const searchParams = new URLSearchParams(window.location.search);
-      const success = searchParams.get("success");
+      const authCode = searchParams.get("code");
       const errorParam = searchParams.get("error");
-      const userId = searchParams.get("userId");
       const isNew = searchParams.get("isNewUser") === "true";
+      const warning = searchParams.get("warning");
+      if (warning) {
+        console.warn(`[Volr] ${warning}`);
+      }
       if (errorParam) {
-        const errorMsg = `Authentication failed: ${errorParam}`;
+        const errorMsg = `Authentication failed: ${errorParam.replace(/_/g, " ")}`;
         setError(errorMsg);
         setIsLoading(false);
         options.onError?.(errorMsg);
         return;
       }
-      if (success !== "true" || !userId) {
-        const errorMsg = "Invalid callback parameters";
+      if (!authCode) {
+        const errorMsg = "No authorization code found. Please try logging in again.";
+        setError(errorMsg);
+        setIsLoading(false);
+        options.onError?.(errorMsg);
+        return;
+      }
+      if (!authCode.startsWith("volr_auth_")) {
+        const errorMsg = "Invalid authorization code format";
         setError(errorMsg);
         setIsLoading(false);
         options.onError?.(errorMsg);
@@ -18746,45 +18762,44 @@ function useVolrAuthCallback(options = {}) {
       }
       try {
         setIsNewUser(isNew);
-        await refreshAccessToken();
-        const api = createAxiosInstance(
-          apiBaseUrl,
-          config.projectApiKey
-        );
-        const userRes = await api.get(`/auth/onboarding/${userId}`);
-        if (!userRes.data?.ok) {
-          throw new Error("Failed to fetch user details");
-        }
-        const currentRefreshToken = client.getRefreshToken();
-        if (!currentRefreshToken) {
-          throw new Error("No refresh token available. Please log in again.");
-        }
-        const refreshRes = await api.post("/auth/refresh", { refreshToken: currentRefreshToken });
-        if (!refreshRes.data?.ok) {
-          throw new Error("Failed to refresh session");
+        const response = await client.post("/auth/token/exchange", { code: authCode });
+        const { user: userData, accessToken, refreshToken } = response;
+        if (!accessToken) {
+          throw new Error("No access token received from server");
         }
-        const userData = refreshRes.data.data.user;
-        const accessToken = refreshRes.data.data.accessToken;
-        const newRefreshToken = refreshRes.data.data.refreshToken;
         setAccessToken(accessToken);
-        if (newRefreshToken) {
-          setRefreshToken(newRefreshToken);
+        if (refreshToken) {
+          setRefreshToken(refreshToken);
         }
         const volrUser = toVolrUser(userData);
         setUser(volrUser);
         setLocalUser(volrUser);
+        if (clearUrlParams && typeof window !== "undefined") {
+          const url = new URL(window.location.href);
+          url.search = "";
+          window.history.replaceState({}, "", url.toString());
+        }
         setIsLoading(false);
         options.onSuccess?.(volrUser);
       } catch (err) {
-        console.error("Callback error:", err);
-        const errorMsg = err.message || "Failed to complete authentication";
+        console.error("[useVolrAuthCallback] Token exchange error:", err);
+        let errorMsg = "Failed to complete authentication";
+        if (err instanceof Error) {
+          if (err.message.includes("AUTH_CODE_EXPIRED")) {
+            errorMsg = "Login link has expired. Please try again.";
+          } else if (err.message.includes("AUTH_INVALID_CODE")) {
+            errorMsg = "Invalid login link. Please try again.";
+          } else {
+            errorMsg = err.message;
+          }
+        }
         setError(errorMsg);
         setIsLoading(false);
         options.onError?.(errorMsg);
       }
     };
     handleCallback();
-  }, [apiBaseUrl, config.projectApiKey, refreshAccessToken, setAccessToken, setRefreshToken, setUser, toVolrUser, client]);
+  }, []);
   return {
     isLoading,
     error,
@@ -19334,6 +19349,36 @@ function useMpcConnection() {
     error
   };
 }
+function createAxiosInstance(baseUrl, apiKey) {
+  const instance = axios.create({
+    baseURL: baseUrl.replace(/\/+$/, ""),
+    // Remove trailing slashes
+    withCredentials: true,
+    // Include cookies
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use((config) => {
+    if (apiKey) {
+      config.headers["X-API-Key"] = apiKey;
+    }
+    return config;
+  });
+  instance.interceptors.response.use(
+    (response) => response,
+    (error) => {
+      if (error.response?.data) {
+        const errorData = error.response.data;
+        if (errorData.error?.message) {
+          error.message = errorData.error.message;
+        }
+      }
+      return Promise.reject(error);
+    }
+  );
+  return instance;
+}
 
 // src/headless/blobs.ts
 async function uploadBlobViaPresign(params) {