@volr/react 0.1.135 → 0.2.1

package/README.md

@@ -19,7 +19,6 @@ function App() {
   return (
     <VolrProvider
       config={{
-        defaultChainId: 8453,
         projectApiKey: 'your-project-api-key',
       }}
     >

package/dist/index.cjs

@@ -10785,7 +10785,6 @@ function VolrProvider({ config, children }) {
   );
   const [isLoading, setIsLoading] = react.useState(true);
   const [error, setError] = react.useState(null);
-  const [chainId] = react.useState(config.defaultChainId);
   const userRef = react.useRef(null);
   react.useEffect(() => {
     userRef.current = user;
@@ -10902,7 +10901,6 @@ function VolrProvider({ config, children }) {
           safeStorage.removeItem(STORAGE_KEYS.user);
         }
       },
-      chainId,
       precheck,
       relay,
       logout,
@@ -10914,7 +10912,6 @@ function VolrProvider({ config, children }) {
       user,
       provider,
       setProvider,
-      chainId,
       precheck,
       relay,
       logout,
@@ -18980,6 +18977,28 @@ function normalizeCall(call2) {
 function normalizeCalls(calls) {
   return calls.map(normalizeCall);
 }
+
+// src/errors/wallet-errors.ts
+var WalletRequiredError = class _WalletRequiredError extends Error {
+  constructor(action, message) {
+    super(
+      message || "Wallet is required for this action. Please create a Volr account (passkey/MPC) or provide a wallet provider."
+    );
+    this.code = "WALLET_REQUIRED";
+    this.name = "WalletRequiredError";
+    this.action = action;
+    Object.setPrototypeOf(this, _WalletRequiredError.prototype);
+  }
+};
+function isWalletRequiredError(error) {
+  if (error instanceof WalletRequiredError) return true;
+  if (error && typeof error === "object" && error.code === "WALLET_REQUIRED") {
+    return true;
+  }
+  return false;
+}
+
+// src/wallet/signer.ts
 async function resolveSigner(input) {
   const { explicitSigner, provider, chainId, client, user, setProvider } = input;
   if (explicitSigner) {
@@ -19038,8 +19057,9 @@ async function resolveSigner(input) {
     const signer = await sdkCore.selectSigner(signerContext);
     return { signer, activeProvider: restoredProvider };
   }
-  throw new Error(
-    "No wallet provider configured. Please set up a Passkey provider to sign transactions. SIWE is authentication-only."
+  throw new WalletRequiredError(
+    "send_transaction",
+    "No wallet provider available. Please create a Volr wallet (passkey/MPC) first."
   );
 }
 
@@ -19205,11 +19225,6 @@ async function sendCalls(args) {
   const normalizedFrom = normalizeHex(from14);
   const normalizedCalls = normalizeCalls(calls);
   validateCalls2(normalizedCalls);
-  if (!deps.provider && deps.user?.keyStorageType !== "passkey") {
-    throw new Error(
-      "No wallet provider configured. Please set up a Passkey provider to sign transactions. SIWE is authentication-only."
-    );
-  }
   let currentUser = deps.user;
   if (deps.user?.keyStorageType === "passkey" && !deps.provider) {
     try {
@@ -19281,15 +19296,52 @@ async function sendCalls(args) {
   let signer;
   let activeProvider = null;
   try {
-    const resolved = await resolveSigner({
-      explicitSigner: void 0,
-      // Always resolve internally
-      provider: deps.provider,
-      chainId,
-      client: deps.client,
-      user: currentUser,
-      setProvider: deps.setProvider
-    });
+    let resolved = null;
+    try {
+      resolved = await resolveSigner({
+        explicitSigner: void 0,
+        // Always resolve internally
+        provider: deps.provider,
+        chainId,
+        client: deps.client,
+        user: currentUser,
+        setProvider: deps.setProvider
+      });
+    } catch (err) {
+      if (isWalletRequiredError(err) && deps.onWalletRequired) {
+        const maybeProvider = await deps.onWalletRequired({
+          type: "transaction",
+          chainId
+        });
+        if (!maybeProvider) {
+          throw err;
+        }
+        await deps.setProvider(maybeProvider);
+        try {
+          const refreshedUser = await deps.client.refreshSession();
+          if (refreshedUser) {
+            currentUser = refreshedUser;
+          }
+        } catch {
+        }
+        resolved = await resolveSigner({
+          explicitSigner: void 0,
+          provider: maybeProvider,
+          chainId,
+          client: deps.client,
+          user: currentUser,
+          setProvider: deps.setProvider
+        });
+      } else {
+        throw err;
+      }
+    }
+    if (!resolved) {
+      throw new WalletRequiredError(
+        "send_transaction",
+        "No wallet provider available. Please create a Volr wallet (passkey/MPC) first."
+      );
+    }
     signer = resolved.signer;
     activeProvider = resolved.activeProvider;
     const result = await deps.relay(
@@ -19322,61 +19374,77 @@ function useVolr() {
   const { relay } = useRelay();
   const { client: apiClient } = useInternalAuth();
   const restoringRef = react.useRef(null);
+  const userRef = react.useRef(user);
+  const providerRef = react.useRef(provider);
+  react.useEffect(() => {
+    userRef.current = user;
+  }, [user]);
+  react.useEffect(() => {
+    providerRef.current = provider;
+  }, [provider]);
   const getRpcUrl = react.useCallback(
     createGetRpcUrl({ client: apiClient, rpcOverrides: config.rpcOverrides }),
     [apiClient, config.rpcOverrides]
   );
-  const ensureProvider = react.useCallback(async () => {
-    if (provider) {
-      return provider;
-    }
-    if (!user?.keyStorageType || user.keyStorageType !== "passkey") {
-      throw new Error(
-        "No wallet provider available. Please complete passkey enrollment first."
-      );
-    }
-    if (!user.id) {
-      throw new Error(
-        "Missing passkey data. Please re-enroll your passkey."
-      );
-    }
-    const currentRpId = typeof window !== "undefined" ? window.location.hostname : "localhost";
-    const domainPasskey = user.registeredPasskeys?.find((p) => p.rpId === currentRpId) ?? null;
-    const blobUrl = domainPasskey?.blobUrl ?? user.blobUrl;
-    const prfInput = domainPasskey?.prfInput ?? user.prfInput;
-    const credentialId = domainPasskey?.credentialId ?? user.credentialId;
-    if (user.registeredPasskeys?.length && !domainPasskey) {
-      throw new Error(
-        `PASSKEY_DOMAIN_MISMATCH: No passkey registered for rpId=${currentRpId}`
-      );
-    }
-    if (!blobUrl || !prfInput) {
-      throw new Error("Missing passkey data. Please re-enroll your passkey.");
-    }
-    if (restoringRef.current) {
+  const ensureProvider = react.useCallback(
+    async (args) => {
+      if (providerRef.current) {
+        return providerRef.current;
+      }
+      const currentUser = userRef.current;
+      if (!currentUser?.keyStorageType || currentUser.keyStorageType !== "passkey") {
+        if (config.onWalletRequired) {
+          const maybeProvider = await config.onWalletRequired(args.request);
+          if (maybeProvider) {
+            await setProvider(maybeProvider);
+            return maybeProvider;
+          }
+        }
+        throw new WalletRequiredError(args.action);
+      }
+      if (!currentUser.id) {
+        throw new Error("Missing user id. Please login again.");
+      }
+      const currentRpId = typeof window !== "undefined" ? window.location.hostname : "localhost";
+      const domainPasskey = currentUser.registeredPasskeys?.find((p) => p.rpId === currentRpId) ?? null;
+      const blobUrl = domainPasskey?.blobUrl ?? currentUser.blobUrl;
+      const prfInput = domainPasskey?.prfInput ?? currentUser.prfInput;
+      const credentialId = domainPasskey?.credentialId ?? currentUser.credentialId;
+      if (currentUser.registeredPasskeys?.length && !domainPasskey) {
+        throw new Error(
+          `PASSKEY_DOMAIN_MISMATCH: No passkey registered for rpId=${currentRpId}`
+        );
+      }
+      if (!blobUrl || !prfInput) {
+        throw new Error("Missing passkey data. Please re-enroll your passkey.");
+      }
+      if (restoringRef.current) {
+        return restoringRef.current;
+      }
+      restoringRef.current = restorePasskey({
+        client: apiClient,
+        userId: currentUser.id,
+        blobUrl,
+        prfInput,
+        credentialId
+      }).then(async ({ provider: restoredProvider }) => {
+        await setProvider(restoredProvider);
+        restoringRef.current = null;
+        return restoredProvider;
+      }).catch((err) => {
+        restoringRef.current = null;
+        throw err;
+      });
       return restoringRef.current;
-    }
-    console.log("[useVolr] Auto-restoring passkey provider...");
-    restoringRef.current = restorePasskey({
-      client: apiClient,
-      userId: user.id,
-      blobUrl,
-      prfInput,
-      credentialId
-    }).then(async ({ provider: restoredProvider }) => {
-      await setProvider(restoredProvider);
-      console.log("[useVolr] Passkey provider restored successfully");
-      restoringRef.current = null;
-      return restoredProvider;
-    }).catch((err) => {
-      restoringRef.current = null;
-      throw err;
-    });
-    return restoringRef.current;
-  }, [provider, user, apiClient, setProvider]);
+    },
+    [apiClient, config.onWalletRequired, setProvider]
+  );
   const signMessage = react.useCallback(
     async (message) => {
-      const activeProvider = await ensureProvider();
+      const activeProvider = await ensureProvider({
+        request: { type: "message" },
+        action: "sign_message"
+      });
       if (config.onSignRequest) {
         await config.onSignRequest({ type: "message", message });
       }
@@ -19400,7 +19468,10 @@ function useVolr() {
   );
   const signTypedData = react.useCallback(
     async (typedData) => {
-      const activeProvider = await ensureProvider();
+      const activeProvider = await ensureProvider({
+        request: { type: "typedData" },
+        action: "sign_typed_data"
+      });
       if (config.onSignRequest) {
         await config.onSignRequest({ type: "typedData", typedData });
       }
@@ -19437,10 +19508,30 @@ function useVolr() {
         },
         sendTransaction: async (tx, opts = {}) => {
           const { publicClient: publicClient2, extendedRpcClient: rpcClient } = await ensureRpcClient();
-          const from14 = opts.from ?? user?.evmAddress;
+          let from14 = opts.from ?? userRef.current?.evmAddress;
+          let providerForDeps = providerRef.current ?? null;
+          if (!from14 && config.onWalletRequired) {
+            const maybeProvider = await config.onWalletRequired({
+              type: "transaction",
+              chainId
+            });
+            if (maybeProvider) {
+              providerForDeps = maybeProvider;
+              await setProvider(maybeProvider);
+              try {
+                const refreshed = await apiClient.refreshSession();
+                if (refreshed?.evmAddress) {
+                  from14 = refreshed.evmAddress;
+                }
+              } catch {
+              }
+              from14 = from14 ?? userRef.current?.evmAddress;
+            }
+          }
           if (!from14) {
-            throw new Error(
-              "from address is required. Provide it in opts.from or ensure user is logged in."
+            throw new WalletRequiredError(
+              "send_transaction",
+              "Wallet address is required. Please create a Volr wallet (passkey/MPC) first."
             );
           }
           const call2 = {
@@ -19460,18 +19551,39 @@ function useVolr() {
               precheck,
               relay,
               client: apiClient,
-              user: user ?? null,
-              provider: provider ?? null,
-              setProvider
+              user: userRef.current ?? null,
+              provider: providerForDeps,
+              setProvider,
+              onWalletRequired: config.onWalletRequired
             }
           });
         },
         sendBatch: (async (calls, opts = {}) => {
           const { publicClient: publicClient2, extendedRpcClient: rpcClient } = await ensureRpcClient();
-          const from14 = opts.from ?? user?.evmAddress;
+          let from14 = opts.from ?? userRef.current?.evmAddress;
+          let providerForDeps = providerRef.current ?? null;
+          if (!from14 && config.onWalletRequired) {
+            const maybeProvider = await config.onWalletRequired({
+              type: "transaction",
+              chainId
+            });
+            if (maybeProvider) {
+              providerForDeps = maybeProvider;
+              await setProvider(maybeProvider);
+              try {
+                const refreshed = await apiClient.refreshSession();
+                if (refreshed?.evmAddress) {
+                  from14 = refreshed.evmAddress;
+                }
+              } catch {
+              }
+              from14 = from14 ?? userRef.current?.evmAddress;
+            }
+          }
           if (!from14) {
-            throw new Error(
-              "from address is required. Provide it in opts.from or ensure user is logged in."
+            throw new WalletRequiredError(
+              "send_transaction",
+              "Wallet address is required. Please create a Volr wallet (passkey/MPC) first."
             );
           }
           const isCallArray = (calls2) => {
@@ -19494,15 +19606,16 @@ function useVolr() {
               precheck,
               relay,
               client: apiClient,
-              user: user ?? null,
-              provider: provider ?? null,
-              setProvider
+              user: userRef.current ?? null,
+              provider: providerForDeps,
+              setProvider,
+              onWalletRequired: config.onWalletRequired
             }
           });
         })
       };
     },
-    [user, provider, precheck, relay, getRpcUrl, setProvider, apiClient]
+    [precheck, relay, getRpcUrl, setProvider, apiClient, config.onWalletRequired]
   );
   const evm = react.useMemo(
     () => ({
@@ -19520,11 +19633,101 @@ function useVolr() {
     email: user?.email,
     isLoggedIn: user !== null,
     signerType: user?.signerType,
+    hasWallet: Boolean(user?.evmAddress),
     logout,
     isLoading,
     error
   };
 }
+
+// src/utils/session-broadcast.ts
+function broadcastSessionEvent(event) {
+  if (typeof window === "undefined") return;
+  if (!("BroadcastChannel" in window)) return;
+  const channel = new BroadcastChannel(STORAGE_CHANNELS.session);
+  channel.postMessage(event);
+  channel.close();
+}
+
+// src/hooks/useVolrSession.ts
+function toVolrUser(u) {
+  return {
+    id: u.id,
+    projectId: u.projectId,
+    projectName: u.projectName,
+    email: u.email,
+    authWallet: u.authWallet ?? void 0,
+    evmAddress: u.evmAddress,
+    keyStorageType: u.keyStorageType ?? void 0,
+    signerType: u.signerType ?? void 0,
+    walletConnector: u.walletConnector ?? void 0,
+    lastWalletChainId: u.lastWalletChainId ?? void 0,
+    blobUrl: u.blobUrl ?? void 0,
+    prfInput: u.prfInput ?? void 0,
+    credentialId: u.credentialId ?? void 0,
+    registeredPasskeys: u.registeredPasskeys ?? void 0
+  };
+}
+function useVolrSession() {
+  const { setUser, logout } = useVolrContext();
+  const { client, setAccessToken, setRefreshToken } = useInternalAuth();
+  const setSession = react.useCallback(
+    async (session) => {
+      setAccessToken(session.accessToken);
+      setRefreshToken(session.refreshToken);
+      const refreshedUser = await client.refreshSession();
+      if (!refreshedUser) {
+        throw new Error("Failed to refresh session. Please try logging in again.");
+      }
+      const nextUser = toVolrUser(refreshedUser);
+      setUser(nextUser);
+      const nextAccess = client.getAccessToken();
+      const nextRefresh = client.getRefreshToken();
+      if (nextAccess) setAccessToken(nextAccess);
+      if (nextRefresh) setRefreshToken(nextRefresh);
+      if (nextAccess && nextRefresh) {
+        broadcastSessionEvent({
+          type: "LOGIN",
+          payload: { accessToken: nextAccess, refreshToken: nextRefresh, user: refreshedUser }
+        });
+      }
+      return nextUser;
+    },
+    [client, setAccessToken, setRefreshToken, setUser]
+  );
+  const clearSession = react.useCallback(async () => {
+    await logout();
+    broadcastSessionEvent({ type: "LOGOUT" });
+  }, [logout]);
+  const exchangeOidc = react.useCallback(
+    async (idToken) => {
+      const response = await client.post("/auth/oidc/exchange", {
+        idToken
+      });
+      setAccessToken(response.accessToken);
+      setRefreshToken(response.refreshToken);
+      const nextUser = toVolrUser(response.user);
+      setUser(nextUser);
+      broadcastSessionEvent({
+        type: "LOGIN",
+        payload: {
+          accessToken: response.accessToken,
+          refreshToken: response.refreshToken,
+          user: response.user
+        }
+      });
+      return {
+        userId: response.user?.id || "",
+        isNewUser: response.isNewUser,
+        keyStorageType: response.user?.keyStorageType ?? null,
+        signerType: response.user?.signerType ?? null,
+        accessToken: response.accessToken
+      };
+    },
+    [client, setAccessToken, setRefreshToken, setUser]
+  );
+  return { setSession, clearSession, exchangeOidc };
+}
 init_sha3();
 init_utils2();
 function toChecksumAddress(address) {
@@ -19543,7 +19746,7 @@ function toChecksumAddress(address) {
 function useVolrLogin() {
   const { config, setUser } = useVolrContext();
   const { setAccessToken, setRefreshToken, client } = useInternalAuth();
-  const toVolrUser = react.useCallback((u) => {
+  const toVolrUser2 = react.useCallback((u) => {
     return {
       id: u.id,
       projectId: u.projectId,
@@ -19602,7 +19805,7 @@ function useVolrLogin() {
         );
       }
       if (userFromServer) {
-        setUser(toVolrUser(userFromServer));
+        setUser(toVolrUser2(userFromServer));
       } else {
         setUser({ id: "", email: normalizedEmail });
       }
@@ -19614,7 +19817,7 @@ function useVolrLogin() {
         accessToken
       };
     },
-    [client, setAccessToken, setRefreshToken, setUser, toVolrUser]
+    [client, setAccessToken, setRefreshToken, setUser, toVolrUser2]
   );
   const handleSocialLogin = react.useCallback(
     async (provider) => {
@@ -19652,7 +19855,7 @@ function useVolrLogin() {
           setRefreshToken(refreshToken);
         }
         if (userFromServer) {
-          setUser(toVolrUser(userFromServer));
+          setUser(toVolrUser2(userFromServer));
         }
         return {
           userId: userFromServer?.id || "",
@@ -19670,7 +19873,7 @@ function useVolrLogin() {
         throw error;
       }
     },
-    [client, setAccessToken, setRefreshToken, setUser, toVolrUser]
+    [client, setAccessToken, setRefreshToken, setUser, toVolrUser2]
   );
   const signWithWallet = react.useCallback(
     async (walletAddress, options) => {
@@ -19717,11 +19920,11 @@ Issued At: ${issuedAt}`;
       if (response.status === "completed" && response.tokens && response.user) {
         setAccessToken(response.tokens.accessToken);
         setRefreshToken(response.tokens.refreshToken);
-        setUser(toVolrUser(response.user));
+        setUser(toVolrUser2(response.user));
       }
       return response;
     },
-    [client, setAccessToken, setRefreshToken, setUser, toVolrUser]
+    [client, setAccessToken, setRefreshToken, setUser, toVolrUser2]
   );
   const getSiweSignUrl = react.useCallback(
     (sessionId) => {
@@ -19761,7 +19964,7 @@ function useVolrAuthCallback(options = {}) {
   const [isNewUser, setIsNewUser] = react.useState(false);
   const [user, setLocalUser] = react.useState(null);
   const hasProcessed = react.useRef(false);
-  const toVolrUser = react.useCallback((u) => {
+  const toVolrUser2 = react.useCallback((u) => {
     return {
       id: u.id,
       projectId: u.projectId,
@@ -19821,7 +20024,7 @@ function useVolrAuthCallback(options = {}) {
         if (refreshToken) {
           setRefreshToken(refreshToken);
         }
-        const volrUser = toVolrUser(userData);
+        const volrUser = toVolrUser2(userData);
         setUser(volrUser);
         setLocalUser(volrUser);
         if (clearUrlParams && typeof window !== "undefined") {
@@ -21399,6 +21602,7 @@ exports.PasskeyNotFoundError = PasskeyNotFoundError;
 exports.PrfNotSupportedError = PrfNotSupportedError;
 exports.UserCancelledError = UserCancelledError;
 exports.VolrProvider = VolrProvider;
+exports.WalletRequiredError = WalletRequiredError;
 exports.WebAuthnBusyError = WebAuthnBusyError;
 exports.analyzeContractForEIP7702 = analyzeContractForEIP7702;
 exports.buildCall = buildCall;
@@ -21427,6 +21631,7 @@ exports.isEIP7702Delegated = isEIP7702Delegated;
 exports.isInAppBrowser = isInAppBrowser;
 exports.isInAppBrowserNotSupportedError = isInAppBrowserNotSupportedError;
 exports.isUserCancelledError = isUserCancelledError;
+exports.isWalletRequiredError = isWalletRequiredError;
 exports.isWebAuthnBusyError = isWebAuthnBusyError;
 exports.listenForSeedRequests = listenForSeedRequests;
 exports.normalizeHex = normalizeHex;
@@ -21449,6 +21654,7 @@ exports.useVolrAuthCallback = useVolrAuthCallback;
 exports.useVolrContext = useVolrContext;
 exports.useVolrLogin = useVolrLogin;
 exports.useVolrPaymentApi = useVolrPaymentApi;
+exports.useVolrSession = useVolrSession;
 exports.useWithdraw = useWithdraw;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map