@chipi-stack/chipi-react 14.13.0 → 14.14.0

package/dist/index.mjs

@@ -71,6 +71,18 @@ function useChipiContext() {
   }
   return context;
 }
+
+// src/utils/with-error-code.ts
+function withErrorCode(wrapped, original) {
+  const code = original.code;
+  if (typeof code === "string") {
+    Object.defineProperty(wrapped, "code", { value: code, enumerable: true });
+  }
+  Object.defineProperty(wrapped, "cause", { value: original, enumerable: false });
+  return wrapped;
+}
+
+// src/hooks/useCreateWallet.ts
 function useCreateWallet() {
   const { chipiSDK } = useChipiContext();
   const mutation = useMutation({
@@ -101,7 +113,7 @@ function useCreateWallet() {
           }
         } catch (error) {
           if (error instanceof Error) {
-            throw new Error(`Passkey creation failed: ${error.message}`);
+            throw withErrorCode(new Error(`Passkey creation failed: ${error.message}`), error);
           }
           throw new Error("Failed to create passkey for wallet");
         }
@@ -181,6 +193,17 @@ function useGetWallet(input) {
     fetchWallet
   };
 }
+
+// src/utils/wallet-capabilities.ts
+var SHHH_SESSION_SIGNER_KINDS = /* @__PURE__ */ new Set(["STARK", "ED25519"]);
+function walletSupportsSessions(wallet) {
+  if (!wallet) return false;
+  if (wallet.walletType === "CHIPI") return true;
+  if (wallet.walletType === "SHHH") {
+    return !wallet.signerKind || SHHH_SESSION_SIGNER_KINDS.has(wallet.signerKind);
+  }
+  return false;
+}
 function useChipiWallet(config3) {
   const { chipiSDK } = useChipiContext();
   const queryClient = useQueryClient();
@@ -261,7 +284,7 @@ function useChipiWallet(config3) {
     const data = walletQuery.data;
     return {
       ...data,
-      supportsSessionKeys: data.walletType === "CHIPI",
+      supportsSessionKeys: walletSupportsSessions(data),
       shortAddress: formatAddress(data.publicKey)
     };
   }, [walletQuery.data, walletQuery.isLoading]);
@@ -318,6 +341,7 @@ function useChipiSession(config3) {
   const {
     wallet,
     encryptKey,
+    getEncryptKey,
     getBearerToken,
     storedSession,
     onSessionCreated,
@@ -331,10 +355,13 @@ function useChipiSession(config3) {
   useEffect(() => {
     setLocalSession(storedSession ?? null);
   }, [storedSession]);
-  const supportsSession = useMemo(() => {
-    if (!wallet) return false;
-    return wallet.walletType === "CHIPI";
-  }, [wallet]);
+  const supportsSession = useMemo(() => walletSupportsSessions(wallet), [wallet]);
+  const resolveEncryptKey = useCallback(async () => {
+    const key = encryptKey || (getEncryptKey ? await getEncryptKey() : void 0);
+    if (!key) throw new Error("Encryption key (PIN) is required");
+    return key;
+  }, [encryptKey, getEncryptKey]);
+  const [awaitingRegistrationUntil, setAwaitingRegistrationUntil] = useState(null);
   const sessionStatusQuery = useQuery({
     queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey],
     queryFn: async () => {
@@ -347,34 +374,41 @@ function useChipiSession(config3) {
     enabled: Boolean(
       autoCheckStatus && wallet?.publicKey && localSession?.publicKey && supportsSession
     ),
-    staleTime: 3e4
+    staleTime: 3e4,
     // 30 seconds
+    // The registration hash comes back before the transaction is in a block, so
+    // right after registerSession the struct can still read as zero. Poll until
+    // it shows up (or for two minutes), then go back to on-demand reads.
+    refetchInterval: (query) => awaitingRegistrationUntil !== null && Date.now() < awaitingRegistrationUntil && (query.state.data?.validUntil ?? 0) === 0 ? 3e3 : false
   });
+  const [revokedSessionKey, setRevokedSessionKey] = useState(null);
   const sessionState = useMemo(() => {
     if (!localSession) return "none";
+    if (revokedSessionKey === localSession.publicKey) return "revoked";
+    if (localSession.validUntil * 1e3 < Date.now()) return "expired";
     const status = sessionStatusQuery.data;
     if (status) {
-      if (!status.isActive) return "revoked";
+      if (status.validUntil === 0) return "created";
       if (status.validUntil * 1e3 < Date.now()) return "expired";
       if (status.remainingCalls <= 0) return "expired";
+      if (!status.isActive) return "revoked";
       return "active";
     }
-    if (localSession.validUntil * 1e3 < Date.now()) return "expired";
     return "created";
-  }, [localSession, sessionStatusQuery.data]);
+  }, [localSession, revokedSessionKey, sessionStatusQuery.data]);
   const hasActiveSession = sessionState === "active";
   const isSessionExpired = sessionState === "expired";
   const remainingCalls = sessionStatusQuery.data?.remainingCalls;
   const createSessionMutation = useMutation(
     {
       mutationFn: async (params = {}) => {
-        if (!encryptKey) throw new Error("Encryption key (PIN) is required");
         if (!supportsSession)
           throw new Error(
-            "Wallet does not support sessions. Only CHIPI wallets support session keys."
+            "Wallet does not support sessions. Session keys need a CHIPI wallet or a SHHH wallet with a STARK / ED25519 signer."
           );
+        const key = await resolveEncryptKey();
         const sessionData = chipiSDK.sessions.createSessionKey({
-          encryptKey,
+          encryptKey: key,
           durationSeconds: params.durationSeconds ?? defaultDurationSeconds
         });
         return sessionData;
@@ -394,28 +428,38 @@ function useChipiSession(config3) {
   const registerSessionMutation = useMutation({
     mutationFn: async (sessionConfig = {}) => {
       if (!wallet) throw new Error("Wallet is required");
-      if (!localSession) throw new Error("No session to register. Call createSession first.");
-      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
+      const sessionPublicKey = sessionConfig.sessionPublicKey ?? localSession?.publicKey;
+      const validUntil = sessionConfig.validUntil ?? localSession?.validUntil;
+      if (!sessionPublicKey || validUntil === void 0)
+        throw new Error(
+          "No session to register. Call createSession first, or pass sessionPublicKey and validUntil."
+        );
       if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const key = await resolveEncryptKey();
       const bearerToken = await getBearerToken();
       if (!bearerToken) throw new Error("Bearer token is required");
-      const txHash = await chipiSDK.sessions.addSessionKeyToContract(
-        {
-          encryptKey,
-          wallet,
-          sessionConfig: {
-            sessionPublicKey: localSession.publicKey,
-            validUntil: sessionConfig.validUntil ?? localSession.validUntil,
-            maxCalls: sessionConfig.maxCalls ?? defaultMaxCalls,
-            allowedEntrypoints: sessionConfig.allowedEntrypoints ?? []
-          }
-        },
-        bearerToken
-      );
-      return txHash;
+      const params = {
+        encryptKey: key,
+        wallet,
+        sessionConfig: {
+          sessionPublicKey,
+          validUntil,
+          maxCalls: sessionConfig.maxCalls ?? defaultMaxCalls,
+          allowedEntrypoints: sessionConfig.allowedEntrypoints ?? []
+        }
+      };
+      if (sessionConfig.spendingPolicies?.length) {
+        return chipiSDK.sessions.setupSession(
+          { ...params, spendingPolicies: sessionConfig.spendingPolicies },
+          bearerToken
+        );
+      }
+      return chipiSDK.sessions.addSessionKeyToContract(params, bearerToken);
     },
     onSuccess: () => {
       setError(null);
+      if (localSession && revokedSessionKey === localSession.publicKey) setRevokedSessionKey(null);
+      setAwaitingRegistrationUntil(Date.now() + 12e4);
       queryClient.invalidateQueries({
         queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey]
       });
@@ -425,25 +469,28 @@ function useChipiSession(config3) {
     }
   });
   const revokeSessionMutation = useMutation({
-    mutationFn: async () => {
+    mutationFn: async (sessionPublicKey) => {
       if (!wallet) throw new Error("Wallet is required");
-      if (!localSession) throw new Error("No session to revoke");
-      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
+      const target = sessionPublicKey ?? localSession?.publicKey;
+      if (!target) throw new Error("No session to revoke");
       if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const key = await resolveEncryptKey();
       const bearerToken = await getBearerToken();
       if (!bearerToken) throw new Error("Bearer token is required");
       const txHash = await chipiSDK.sessions.revokeSessionKey(
         {
-          encryptKey,
+          encryptKey: key,
           wallet,
-          sessionPublicKey: localSession.publicKey
+          sessionPublicKey: target
         },
         bearerToken
       );
       return txHash;
     },
-    onSuccess: () => {
+    onSuccess: (_txHash, sessionPublicKey) => {
       setError(null);
+      const target = sessionPublicKey ?? localSession?.publicKey;
+      if (target) setRevokedSessionKey(target);
       queryClient.invalidateQueries({
         queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey]
       });
@@ -456,13 +503,13 @@ function useChipiSession(config3) {
     mutationFn: async (calls) => {
       if (!wallet) throw new Error("Wallet is required");
       if (!localSession) throw new Error("No active session");
-      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
       if (!hasActiveSession) throw new Error("Session is not active. Register the session first.");
+      const key = await resolveEncryptKey();
       const bearerToken = await getBearerToken();
       if (!bearerToken) throw new Error("Bearer token is required");
       const txHash = await chipiSDK.executeTransactionWithSession({
         params: {
-          encryptKey,
+          encryptKey: key,
           wallet,
           session: localSession,
           calls
@@ -486,13 +533,13 @@ function useChipiSession(config3) {
       if (!wallet) throw new Error("Wallet is required");
       if (!localSession)
         throw new Error("No session to set policy on. Create and register a session first.");
-      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
       if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const key = await resolveEncryptKey();
       const bearerToken = await getBearerToken();
       if (!bearerToken) throw new Error("Bearer token is required");
       const txHash = await chipiSDK.sessions.setSpendingPolicy(
         {
-          encryptKey,
+          encryptKey: key,
           wallet,
           spendingPolicyConfig: {
             sessionPublicKey: localSession.publicKey,
@@ -514,13 +561,13 @@ function useChipiSession(config3) {
     mutationFn: async (token) => {
       if (!wallet) throw new Error("Wallet is required");
       if (!localSession) throw new Error("No session to remove policy from");
-      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
       if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const key = await resolveEncryptKey();
       const bearerToken = await getBearerToken();
       if (!bearerToken) throw new Error("Bearer token is required");
       const txHash = await chipiSDK.sessions.removeSpendingPolicy(
         {
-          encryptKey,
+          encryptKey: key,
           wallet,
           sessionPublicKey: localSession.publicKey,
           token
@@ -548,9 +595,14 @@ function useChipiSession(config3) {
     },
     [registerSessionMutation]
   );
-  const revokeSession = useCallback(async () => {
-    return revokeSessionMutation.mutateAsync();
-  }, [revokeSessionMutation]);
+  const revokeSession = useCallback(
+    async (sessionPublicKey) => {
+      return revokeSessionMutation.mutateAsync(
+        typeof sessionPublicKey === "string" ? sessionPublicKey : void 0
+      );
+    },
+    [revokeSessionMutation]
+  );
   const executeWithSession = useCallback(
     async (calls) => {
       return executeWithSessionMutation.mutateAsync(calls);
@@ -684,7 +736,7 @@ function useMigrateWalletToPasskey() {
         };
       } catch (error) {
         if (error instanceof Error) {
-          throw new Error(`Migration failed: ${error.message}`);
+          throw withErrorCode(new Error(`Migration failed: ${error.message}`), error);
         }
         throw new Error("Failed to migrate wallet to passkey");
       }
@@ -21237,6 +21289,21 @@ function ChipiInjector({ children, ...config3 }) {
   }, [walletAddr]);
   return children ?? null;
 }
+var DEFAULT_RECOVER_LABELS = {
+  proposeAddDevice: "Propose new device",
+  proposeRecovery: "Initiate recovery",
+  executeAddDevice: "Execute add-owner",
+  executeRecovery: "Finalize recovery",
+  timelockAddDevice: "48-hour timelock before this device becomes active.",
+  timelockRecovery: "7-day timelock before the recovered wallet becomes active.",
+  submitting: "Submitting\u2026",
+  secondsRemaining: (s) => `${s}s remaining`,
+  cancel: "Cancel pending op",
+  timelockElapsed: "Timelock elapsed.",
+  cancelling: "Cancelling\u2026",
+  doneAddDevice: "New device added.",
+  doneRecovery: "Wallet recovered."
+};
 function deriveStaticPhase(pendingOp, executed, isReady, nowSecs) {
   if (executed) return "done";
   if (!pendingOp) return "form-idle";
@@ -21318,10 +21385,17 @@ function Recover(props) {
       setSubmittingAction(null);
     }
   }, [activePendingOp, onCancel]);
+  const L = useMemo(
+    () => ({
+      ...DEFAULT_RECOVER_LABELS,
+      ...Object.fromEntries(Object.entries(props.labels ?? {}).filter(([, v]) => v !== void 0))
+    }),
+    [props.labels]
+  );
   const isAddDevice = mode === "add-device";
-  const proposeLabel = isAddDevice ? "Propose new device" : "Initiate recovery";
-  const executeLabel = isAddDevice ? "Execute add-owner" : "Finalize recovery";
-  const timelockDescription = isAddDevice ? "48-hour timelock before this device becomes active." : "7-day timelock before the recovered wallet becomes active.";
+  const proposeLabel = isAddDevice ? L.proposeAddDevice : L.proposeRecovery;
+  const executeLabel = isAddDevice ? L.executeAddDevice : L.executeRecovery;
+  const timelockDescription = isAddDevice ? L.timelockAddDevice : L.timelockRecovery;
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -21349,18 +21423,15 @@ function Recover(props) {
             }
           )
         ] }),
-        phase === "submitting-propose" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "propose", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "submitting", children: "Submitting\u2026" }) }),
+        phase === "submitting-propose" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "propose", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "submitting", children: L.submitting }) }),
         phase === "awaiting-timelock" && activePendingOp && /* @__PURE__ */ jsxs("section", { "data-chipi-recover-section": "awaiting", children: [
           /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "awaiting", children: timelockDescription }),
-          /* @__PURE__ */ jsxs(
+          /* @__PURE__ */ jsx(
             "p",
             {
               "data-chipi-recover-countdown": "",
               "data-chipi-recover-seconds-remaining": String(secondsRemaining),
-              children: [
-                secondsRemaining,
-                "s remaining"
-              ]
+              children: L.secondsRemaining(secondsRemaining)
             }
           ),
           /* @__PURE__ */ jsx("p", { "data-chipi-recover-op-id": "", children: String(activePendingOp.opId) }),
@@ -21371,12 +21442,12 @@ function Recover(props) {
               "data-chipi-recover-action": "cancel",
               onClick: handleCancel,
               disabled: submittingAction !== null,
-              children: "Cancel pending op"
+              children: L.cancel
             }
           )
         ] }),
         (phase === "ready-to-execute" || phase === "submitting-execute") && activePendingOp && /* @__PURE__ */ jsxs("section", { "data-chipi-recover-section": "execute", children: [
-          /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "ready", children: "Timelock elapsed." }),
+          /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "ready", children: L.timelockElapsed }),
           /* @__PURE__ */ jsx(
             "button",
             {
@@ -21394,12 +21465,12 @@ function Recover(props) {
               "data-chipi-recover-action": "cancel",
               onClick: handleCancel,
               disabled: submittingAction !== null,
-              children: "Cancel pending op"
+              children: L.cancel
             }
           )
         ] }),
-        phase === "submitting-cancel" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "cancel", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "submitting", children: "Cancelling\u2026" }) }),
-        phase === "done" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "done", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "done", children: isAddDevice ? "New device added." : "Wallet recovered." }) }),
+        phase === "submitting-cancel" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "cancel", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "submitting", children: L.cancelling }) }),
+        phase === "done" && /* @__PURE__ */ jsx("section", { "data-chipi-recover-section": "done", children: /* @__PURE__ */ jsx("p", { "data-chipi-recover-status": "done", children: isAddDevice ? L.doneAddDevice : L.doneRecovery }) }),
         error && /* @__PURE__ */ jsx("p", { "data-chipi-recover-error": "", role: "alert", children: error.message })
       ]
     }
@@ -21429,6 +21500,6 @@ pako/dist/pako.esm.mjs:
   (*! pako 2.1.0 https://github.com/nodeca/pako @license (MIT AND Zlib) *)
 */
 
-export { ChipiInjector, ChipiProvider, Recover, createChipiWindowObject, derivePrivacyAccount, injectChipiWallet, netPrivateBalance, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiContext, useChipiSession, useChipiWallet, useChipiWalletObject, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransaction, useGetTransactionList, useGetTransactionStatus, useGetWallet, useGuardianRecovery, useMigrateWalletToPasskey, useMigrateWalletToShhh, usePrivateBalance, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useShhhSigner, useShield, useSignTypedData, useSyncOnChainTransfers, useThresholdSign, useTransfer, useUnshield, useUpdateWalletEncryption, useX402Payment };
+export { ChipiInjector, ChipiProvider, DEFAULT_RECOVER_LABELS, Recover, createChipiWindowObject, derivePrivacyAccount, injectChipiWallet, netPrivateBalance, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiContext, useChipiSession, useChipiWallet, useChipiWalletObject, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransaction, useGetTransactionList, useGetTransactionStatus, useGetWallet, useGuardianRecovery, useMigrateWalletToPasskey, useMigrateWalletToShhh, usePrivateBalance, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useShhhSigner, useShield, useSignTypedData, useSyncOnChainTransfers, useThresholdSign, useTransfer, useUnshield, useUpdateWalletEncryption, useX402Payment, walletSupportsSessions };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map