@chipi-stack/chipi-react 11.22.0 → 12.1.0

package/dist/index.js

@@ -115,6 +115,367 @@ function useGetWallet(input) {
     fetchWallet
   };
 }
+function useChipiWallet(config) {
+  const { chipiSDK } = useChipiContext();
+  const queryClient = reactQuery.useQueryClient();
+  const {
+    externalUserId,
+    getBearerToken,
+    defaultToken = "USDC",
+    enabled = true
+  } = config;
+  const isEnabled = Boolean(
+    enabled && externalUserId && externalUserId.trim() !== ""
+  );
+  const walletQuery = reactQuery.useQuery({
+    queryKey: ["chipi-wallet", externalUserId],
+    queryFn: async () => {
+      if (!externalUserId) return null;
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      return chipiSDK.getWallet({ externalUserId }, bearerToken);
+    },
+    enabled: isEnabled,
+    retry: (failureCount, error) => {
+      if (error instanceof shared.ChipiApiError || error?.status) {
+        return false;
+      }
+      return failureCount < 3;
+    }
+  });
+  const walletPublicKey = walletQuery.data?.wallet.publicKey;
+  const balanceQuery = reactQuery.useQuery({
+    queryKey: ["chipi-wallet-balance", walletPublicKey, defaultToken],
+    queryFn: async () => {
+      if (!walletPublicKey) throw new Error("No wallet");
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      return chipiSDK.getTokenBalance(
+        {
+          chain: "STARKNET",
+          chainToken: defaultToken,
+          walletPublicKey
+        },
+        bearerToken
+      );
+    },
+    enabled: Boolean(walletPublicKey),
+    retry: (failureCount, error) => {
+      if (error instanceof shared.ChipiApiError || error?.status) {
+        return false;
+      }
+      return failureCount < 3;
+    }
+  });
+  const createWalletMutation = reactQuery.useMutation({
+    mutationFn: async ({ encryptKey, walletType = "CHIPI" }) => {
+      if (!externalUserId) throw new Error("External user ID is required");
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      return chipiSDK.createWallet({
+        params: {
+          encryptKey,
+          externalUserId,
+          walletType
+        },
+        bearerToken
+      });
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: ["chipi-wallet", externalUserId]
+      });
+    }
+  });
+  const wallet = React.useMemo(() => {
+    if (walletQuery.isLoading) return void 0;
+    if (!walletQuery.data) return null;
+    const data = walletQuery.data;
+    return {
+      ...data,
+      supportsSessionKeys: data.wallet.walletType === "CHIPI",
+      shortAddress: formatAddress(data.wallet.publicKey)
+    };
+  }, [walletQuery.data, walletQuery.isLoading]);
+  const formattedBalance = React.useMemo(() => {
+    if (!balanceQuery.data?.balance) return "0.00";
+    const num = Number(balanceQuery.data.balance);
+    return num.toLocaleString(void 0, {
+      minimumFractionDigits: 2,
+      maximumFractionDigits: defaultToken === "ETH" || defaultToken === "STRK" ? 6 : 2
+    });
+  }, [balanceQuery.data, defaultToken]);
+  const refetchWallet = React.useCallback(async () => {
+    await walletQuery.refetch();
+  }, [walletQuery]);
+  const refetchBalance = React.useCallback(async () => {
+    await balanceQuery.refetch();
+  }, [balanceQuery]);
+  const refetchAll = React.useCallback(async () => {
+    await Promise.all([walletQuery.refetch(), balanceQuery.refetch()]);
+  }, [walletQuery, balanceQuery]);
+  const createWallet = React.useCallback(
+    async (params) => {
+      return createWalletMutation.mutateAsync(params);
+    },
+    [createWalletMutation]
+  );
+  return {
+    // Wallet data
+    wallet,
+    hasWallet: wallet !== null && wallet !== void 0,
+    isLoadingWallet: walletQuery.isLoading,
+    walletError: walletQuery.error,
+    // Balance data
+    balance: balanceQuery.data,
+    formattedBalance,
+    isLoadingBalance: balanceQuery.isLoading,
+    // Create wallet
+    createWallet,
+    isCreating: createWalletMutation.isPending,
+    createdWallet: createWalletMutation.data,
+    // Actions
+    refetchWallet,
+    refetchBalance,
+    refetchAll
+  };
+}
+function formatAddress(address, chars = 6) {
+  if (!address || address.length < chars * 2) return address;
+  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
+}
+function useChipiSession(config) {
+  const { chipiSDK } = useChipiContext();
+  const queryClient = reactQuery.useQueryClient();
+  const {
+    wallet,
+    encryptKey,
+    getBearerToken,
+    storedSession,
+    onSessionCreated,
+    defaultDurationSeconds = 21600,
+    // 6 hours
+    defaultMaxCalls = 1e3,
+    autoCheckStatus = true
+  } = config;
+  const [localSession, setLocalSession] = React.useState(
+    storedSession ?? null
+  );
+  const [error, setError] = React.useState(null);
+  React.useEffect(() => {
+    if (storedSession) {
+      setLocalSession(storedSession);
+    }
+  }, [storedSession]);
+  const supportsSession = React.useMemo(() => {
+    if (!wallet) return false;
+    return wallet.walletType === "CHIPI";
+  }, [wallet]);
+  const sessionStatusQuery = reactQuery.useQuery({
+    queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey],
+    queryFn: async () => {
+      if (!wallet?.publicKey || !localSession?.publicKey) return null;
+      return chipiSDK.sessions.getSessionData({
+        walletAddress: wallet.publicKey,
+        sessionPublicKey: localSession.publicKey
+      });
+    },
+    enabled: Boolean(
+      autoCheckStatus && wallet?.publicKey && localSession?.publicKey && supportsSession
+    ),
+    staleTime: 3e4
+    // 30 seconds
+  });
+  const sessionState = React.useMemo(() => {
+    if (!localSession) return "none";
+    const status = sessionStatusQuery.data;
+    if (status) {
+      if (!status.isActive) return "revoked";
+      if (status.validUntil * 1e3 < Date.now()) return "expired";
+      if (status.remainingCalls <= 0) return "expired";
+      return "active";
+    }
+    if (localSession.validUntil * 1e3 < Date.now()) return "expired";
+    return "created";
+  }, [localSession, sessionStatusQuery.data]);
+  const hasActiveSession = sessionState === "active";
+  const isSessionExpired = sessionState === "expired";
+  const remainingCalls = sessionStatusQuery.data?.remainingCalls;
+  const createSessionMutation = reactQuery.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.");
+      const sessionData = chipiSDK.sessions.createSessionKey({
+        encryptKey,
+        durationSeconds: params.durationSeconds ?? defaultDurationSeconds
+      });
+      return sessionData;
+    },
+    onSuccess: async (sessionData) => {
+      setLocalSession(sessionData);
+      setError(null);
+      if (onSessionCreated) {
+        await onSessionCreated(sessionData);
+      }
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
+  const registerSessionMutation = reactQuery.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");
+      if (!supportsSession) throw new Error("Wallet does not support sessions");
+      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;
+    },
+    onSuccess: () => {
+      setError(null);
+      queryClient.invalidateQueries({
+        queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey]
+      });
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
+  const revokeSessionMutation = reactQuery.useMutation({
+    mutationFn: async () => {
+      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");
+      if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      const txHash = await chipiSDK.sessions.revokeSessionKey(
+        {
+          encryptKey,
+          wallet,
+          sessionPublicKey: localSession.publicKey
+        },
+        bearerToken
+      );
+      return txHash;
+    },
+    onSuccess: () => {
+      setError(null);
+      queryClient.invalidateQueries({
+        queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey]
+      });
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
+  const executeWithSessionMutation = reactQuery.useMutation({
+    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 bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      const txHash = await chipiSDK.executeTransactionWithSession({
+        params: {
+          encryptKey,
+          wallet,
+          session: localSession,
+          calls
+        },
+        bearerToken
+      });
+      return txHash;
+    },
+    onSuccess: () => {
+      setError(null);
+      queryClient.invalidateQueries({
+        queryKey: ["chipi-session-status", wallet?.publicKey, localSession?.publicKey]
+      });
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
+  const createSession = React.useCallback(
+    async (params) => {
+      return createSessionMutation.mutateAsync(params ?? {});
+    },
+    [createSessionMutation]
+  );
+  const registerSession = React.useCallback(
+    async (sessionConfig) => {
+      return registerSessionMutation.mutateAsync(sessionConfig ?? {});
+    },
+    [registerSessionMutation]
+  );
+  const revokeSession = React.useCallback(async () => {
+    return revokeSessionMutation.mutateAsync();
+  }, [revokeSessionMutation]);
+  const executeWithSession = React.useCallback(
+    async (calls) => {
+      return executeWithSessionMutation.mutateAsync(calls);
+    },
+    [executeWithSessionMutation]
+  );
+  const clearSession = React.useCallback(() => {
+    setLocalSession(null);
+    setError(null);
+  }, []);
+  const refetchStatus = React.useCallback(async () => {
+    await sessionStatusQuery.refetch();
+  }, [sessionStatusQuery]);
+  const combinedError = React.useMemo(() => {
+    return error || createSessionMutation.error || registerSessionMutation.error || revokeSessionMutation.error || executeWithSessionMutation.error || sessionStatusQuery.error || null;
+  }, [
+    error,
+    createSessionMutation.error,
+    registerSessionMutation.error,
+    revokeSessionMutation.error,
+    executeWithSessionMutation.error,
+    sessionStatusQuery.error
+  ]);
+  return {
+    // Session data
+    session: localSession,
+    sessionStatus: sessionStatusQuery.data ?? void 0,
+    sessionState,
+    hasActiveSession,
+    isSessionExpired,
+    remainingCalls,
+    supportsSession,
+    // Actions
+    createSession,
+    registerSession,
+    revokeSession,
+    executeWithSession,
+    clearSession,
+    refetchStatus,
+    // Loading states
+    isCreating: createSessionMutation.isPending,
+    isRegistering: registerSessionMutation.isPending,
+    isRevoking: revokeSessionMutation.isPending,
+    isExecuting: executeWithSessionMutation.isPending,
+    isLoadingStatus: sessionStatusQuery.isLoading,
+    // Errors
+    error: combinedError
+  };
+}
 function useTransfer() {
   const { chipiSDK } = useChipiContext();
   const mutation = reactQuery.useMutation(
@@ -442,8 +803,15 @@ function useRecordSendTransaction() {
 function useGetTokenBalance(input) {
   const { chipiSDK } = useChipiContext();
   const queryClient = reactQuery.useQueryClient();
+  const buildQueryKey = (params) => [
+    "chain-token-balance",
+    params?.chainToken ?? null,
+    params?.chain ?? null,
+    params?.walletPublicKey ?? null,
+    params?.externalUserId ?? null
+  ];
   const query = reactQuery.useQuery({
-    queryKey: ["chain-token-balance", input?.params?.chainToken, input?.params?.chain, input?.params?.walletPublicKey, input?.params?.externalUserId],
+    queryKey: buildQueryKey(input?.params),
     queryFn: async () => {
       if (!input || !input.params || !input.getBearerToken) throw new Error("Input is required");
       const bearerToken = await input.getBearerToken();
@@ -451,17 +819,17 @@ function useGetTokenBalance(input) {
       return chipiSDK.getTokenBalance(input.params, bearerToken);
     },
     enabled: Boolean(input?.params && input?.getBearerToken),
-    ...input?.queryOptions,
     retry: (failureCount, error) => {
       if (error instanceof shared.ChipiApiError || error?.status) {
         return false;
       }
       return failureCount < 3;
-    }
+    },
+    ...input?.queryOptions
   });
   const fetchTokenBalance = async (newInput) => {
     return queryClient.fetchQuery({
-      queryKey: ["chain-token-balance", newInput?.params?.chainToken, newInput?.params?.chain, newInput?.params?.walletPublicKey, newInput?.params?.externalUserId],
+      queryKey: buildQueryKey(newInput?.params),
       queryFn: async () => {
         if (!newInput || !newInput.getBearerToken || !newInput.params) throw new Error("Input is required");
         const bearerToken = await newInput.getBearerToken();
@@ -565,14 +933,115 @@ function useCreateUser() {
     reset: mutation.reset
   };
 }
+function useCreateSessionKey() {
+  const { chipiSDK } = useChipiContext();
+  const mutation = reactQuery.useMutation({
+    mutationFn: async (params) => chipiSDK.sessions.createSessionKey(params)
+  });
+  return {
+    createSessionKey: mutation.mutate,
+    createSessionKeyAsync: mutation.mutateAsync,
+    data: mutation.data,
+    isLoading: mutation.isPending,
+    isError: mutation.isError,
+    error: mutation.error,
+    isSuccess: mutation.isSuccess,
+    reset: mutation.reset
+  };
+}
+function useAddSessionKeyToContract() {
+  const { chipiSDK } = useChipiContext();
+  const mutation = reactQuery.useMutation({
+    mutationFn: (input) => chipiSDK.sessions.addSessionKeyToContract(
+      input.params,
+      input.bearerToken
+    )
+  });
+  return {
+    addSessionKeyToContract: mutation.mutate,
+    addSessionKeyToContractAsync: mutation.mutateAsync,
+    data: mutation.data,
+    isLoading: mutation.isPending,
+    isError: mutation.isError,
+    error: mutation.error,
+    isSuccess: mutation.isSuccess,
+    reset: mutation.reset
+  };
+}
+function useRevokeSessionKey() {
+  const { chipiSDK } = useChipiContext();
+  const mutation = reactQuery.useMutation({
+    mutationFn: (input) => chipiSDK.sessions.revokeSessionKey(input.params, input.bearerToken)
+  });
+  return {
+    revokeSessionKey: mutation.mutate,
+    revokeSessionKeyAsync: mutation.mutateAsync,
+    data: mutation.data,
+    isLoading: mutation.isPending,
+    isError: mutation.isError,
+    error: mutation.error,
+    isSuccess: mutation.isSuccess,
+    reset: mutation.reset
+  };
+}
+function useGetSessionData(params, options) {
+  const { chipiSDK } = useChipiContext();
+  const query = reactQuery.useQuery({
+    queryKey: [
+      "sessionData",
+      params?.walletAddress,
+      params?.sessionPublicKey
+    ],
+    queryFn: () => {
+      if (!params) {
+        throw new Error("Session data params are required");
+      }
+      return chipiSDK.sessions.getSessionData(params);
+    },
+    enabled: options?.enabled !== false && params !== null
+  });
+  return {
+    data: query.data,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    isSuccess: query.isSuccess,
+    refetch: query.refetch
+  };
+}
+function useExecuteWithSession() {
+  const { chipiSDK } = useChipiContext();
+  const mutation = reactQuery.useMutation({
+    mutationFn: (input) => chipiSDK.executeTransactionWithSession({
+      params: input.params,
+      bearerToken: input.bearerToken
+    })
+  });
+  return {
+    executeWithSession: mutation.mutate,
+    executeWithSessionAsync: mutation.mutateAsync,
+    data: mutation.data,
+    isLoading: mutation.isPending,
+    isError: mutation.isError,
+    error: mutation.error,
+    isSuccess: mutation.isSuccess,
+    reset: mutation.reset
+  };
+}
 
 exports.ChipiProvider = ChipiProvider;
+exports.useAddSessionKeyToContract = useAddSessionKeyToContract;
 exports.useApprove = useApprove;
 exports.useCallAnyContract = useCallAnyContract;
 exports.useChipiContext = useChipiContext;
+exports.useChipiSession = useChipiSession;
+exports.useChipiWallet = useChipiWallet;
+exports.useCreateSessionKey = useCreateSessionKey;
 exports.useCreateSkuTransaction = useCreateSkuTransaction;
 exports.useCreateUser = useCreateUser;
 exports.useCreateWallet = useCreateWallet;
+exports.useExecuteWithSession = useExecuteWithSession;
+exports.useGetSessionData = useGetSessionData;
 exports.useGetSku = useGetSku;
 exports.useGetSkuList = useGetSkuList;
 exports.useGetSkuTransaction = useGetSkuTransaction;
@@ -581,6 +1050,7 @@ exports.useGetTransactionList = useGetTransactionList;
 exports.useGetUser = useGetUser;
 exports.useGetWallet = useGetWallet;
 exports.useRecordSendTransaction = useRecordSendTransaction;
+exports.useRevokeSessionKey = useRevokeSessionKey;
 exports.useStakeVesuUsdc = useStakeVesuUsdc;
 exports.useTransfer = useTransfer;
 exports.useWithdrawVesuUsdc = useWithdrawVesuUsdc;