@naculus/connect-appkit-react 0.1.9 → 0.2.0

package/src/hooks/useSiwxAuthSession.ts

@@ -1,163 +0,0 @@
-import { useState, useCallback, useEffect, useRef } from "react";
-import { useSignInWithX } from "./useSignInWithX";
-import type { UseSignInWithXOptions } from "./useSignInWithX";
-import { LocalStorageAdapter, logger } from "@naculus/connect-core";
-import type { SiwxResult } from "@naculus/siwx";
-
-// ── Types ────────────────────────────────────────────────────────
-
-export interface UseSiwxAuthSessionOptions {
-  /** Storage key prefix (default: "naculus_") */
-  storagePrefix?: string;
-  /** Auto-restore auth from storage on mount (default: true) */
-  autoRestore?: boolean;
-}
-
-export interface UseSiwxAuthSessionReturn {
-  /** Whether a valid SIWx auth session exists */
-  isSignedIn: boolean;
-  /** Whether we're still checking persisted auth on mount */
-  isRestoring: boolean;
-  /** The persisted SIWx result, or null if not signed in */
-  siwxResult: SiwxResult | null;
-  /** Whether a sign-in is in progress */
-  isSigningIn: boolean;
-  /** Last sign-in error */
-  error: Error | null;
-  /** Sign in with optional overrides. Persists result to storage on success. */
-  signIn: (options?: UseSignInWithXOptions) => Promise<SiwxResult>;
-  /** Sign out: clears persisted auth and resets state */
-  signOut: () => void;
-  /** Clear the last error */
-  clearError: () => void;
-}
-
-// ── Constants ────────────────────────────────────────────────────
-
-const SIWX_AUTH_KEY = "siwx_auth";
-
-// ── Helpers ──────────────────────────────────────────────────────
-
-function getStorage(prefix: string): LocalStorageAdapter {
-  return new LocalStorageAdapter(prefix);
-}
-
-function isExpired(siwxResult: SiwxResult, now: Date): boolean {
-  if (!siwxResult.message.expirationTime) return false;
-  return new Date(siwxResult.message.expirationTime).getTime() <= now.getTime();
-}
-
-function isNotBeforeValid(siwxResult: SiwxResult, now: Date): boolean {
-  if (!siwxResult.message.notBefore) return true;
-  return new Date(siwxResult.message.notBefore).getTime() <= now.getTime();
-}
-
-// ── Hook ─────────────────────────────────────────────────────────
-
-export function useSiwxAuthSession(
-  options?: UseSiwxAuthSessionOptions
-): UseSiwxAuthSessionReturn {
-  const { storagePrefix = "naculus_", autoRestore = true } = options ?? {};
-
-  const [siwxResult, setSiwxResult] = useState<SiwxResult | null>(null);
-  const [isRestoring, setIsRestoring] = useState(autoRestore);
-  const [isSigningIn, setIsSigningIn] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-
-  // Use the generic SIWx hook for the underlying signing flow.
-  const signInWithX = useSignInWithX();
-  const storageRef = useRef(getStorage(storagePrefix));
-
-  const clearError = useCallback(() => setError(null), []);
-
-  // ── Restore persisted auth on mount ────────────────────────────
-
-  useEffect(() => {
-    if (!autoRestore) {
-      setIsRestoring(false);
-      return;
-    }
-
-    let cancelled = false;
-
-    (async () => {
-      try {
-        const storage = storageRef.current;
-        const saved = await storage.get<SiwxResult>(SIWX_AUTH_KEY);
-
-        if (cancelled) return;
-
-        if (saved && !isExpired(saved, new Date()) && isNotBeforeValid(saved, new Date())) {
-          logger.info("react/useSiwxAuthSession", "Restored persisted SIWx auth session");
-          setSiwxResult(saved);
-          setError(null);
-        } else if (saved) {
-          // Expired or not-yet-valid — clean up stale entry
-          logger.info("react/useSiwxAuthSession", "Persisted SIWx auth expired, clearing");
-          await storage.remove(SIWX_AUTH_KEY);
-        }
-      } catch (err) {
-        logger.warn("react/useSiwxAuthSession", "Failed to restore SIWx auth:", err);
-      } finally {
-        if (!cancelled) setIsRestoring(false);
-      }
-    })();
-
-    return () => {
-      cancelled = true;
-    };
-  }, [autoRestore]);
-
-  // ── Sign In ────────────────────────────────────────────────────
-
-  const signIn = useCallback(
-    async (signOptions?: UseSignInWithXOptions): Promise<SiwxResult> => {
-      setIsSigningIn(true);
-      setError(null);
-
-      try {
-        const result = await signInWithX.signIn(signOptions);
-
-        // Persist to storage
-        const storage = storageRef.current;
-        await storage.set(SIWX_AUTH_KEY, result);
-
-        setSiwxResult(result);
-        setIsSigningIn(false);
-        return result;
-      } catch (err) {
-        const wrapped = err instanceof Error ? err : new Error("SIWx sign-in failed");
-        setError(wrapped);
-        setIsSigningIn(false);
-        throw wrapped;
-      }
-    },
-    [signInWithX]
-  );
-
-  // ── Sign Out ───────────────────────────────────────────────────
-
-  const signOut = useCallback(async () => {
-    try {
-      const storage = storageRef.current;
-      await storage.remove(SIWX_AUTH_KEY);
-    } catch (err) {
-      logger.warn("react/useSiwxAuthSession", "Failed to clear SIWx auth:", err);
-    }
-    setSiwxResult(null);
-    setError(null);
-  }, []);
-
-  // ── Result ─────────────────────────────────────────────────────
-
-  return {
-    isSignedIn: siwxResult !== null,
-    isRestoring,
-    siwxResult,
-    isSigningIn,
-    error,
-    signIn,
-    signOut,
-    clearError,
-  };
-}

package/src/hooks/useSmartAccount.ts

@@ -1,194 +0,0 @@
-/**
- * useSmartAccount
- *
- * React hook for ERC-4337 Smart Account lifecycle management.
- * Provides create, deploy, and address lookup for smart contract wallets.
- *
- * @example
- * ```tsx
- * const { address, isDeployed, createWallet, deployWallet, isLoading } = useSmartAccount({
- *   rpcUrl: "https://eth.llamarpc.com",
- *   bundlerUrl: "https://api.pimlico.io/v2/1/rpc?apikey=...",
- * });
- * ```
- */
-
-import { useState, useCallback, useEffect, useRef } from "react";
-import { useAccount } from "./useAccount";
-import type {
-  SmartAccountInfo,
-  SmartAccountConfig,
-  Address,
-} from "@naculus/connect-core";
-
-export interface UseSmartAccountOptions {
-  /** RPC URL for the target chain */
-  rpcUrl?: string;
-  /** Bundler RPC URL */
-  bundlerUrl?: string;
-  /** Chain ID (CAIP-2 format) */
-  chainId?: string;
-  /** Account type (default: "simple") */
-  accountType?: "simple" | "light" | "kernel" | "safe";
-  /** Optional salt for deterministic address */
-  salt?: bigint;
-}
-
-export interface UseSmartAccountReturn {
-  /** Smart account address (null if not created) */
-  address: Address | null;
-  /** Whether the account is deployed on-chain */
-  isDeployed: boolean;
-  /** Smart account info object */
-  accountInfo: SmartAccountInfo | null;
-  /** Loading state */
-  isLoading: boolean;
-  /** Error state */
-  error: Error | null;
-  /** Create a new smart account (compute address) */
-  createWallet: () => Promise<SmartAccountInfo | null>;
-  /** Deploy the smart account to chain */
-  deployWallet: () => Promise<Address | null>;
-  /** Get the counterfactual address without creating */
-  getAddress: () => Promise<Address | null>;
-}
-
-/**
- * Hook for managing a ERC-4337 Smart Contract Wallet lifecycle.
- *
- * @param options - Smart account configuration options
- * @returns Smart account state and actions
- */
-export function useSmartAccount(options?: UseSmartAccountOptions): UseSmartAccountReturn {
-  const { evmAccount } = useAccount();
-  const [address, setAddress] = useState<Address | null>(null);
-  const [isDeployed, setIsDeployed] = useState(false);
-  const [accountInfo, setAccountInfo] = useState<SmartAccountInfo | null>(null);
-  const [isLoading, setIsLoading] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-  const managerRef = useRef<import("@naculus/connect-core").SmartAccountManager | null>(null);
-
-  // Initialize SmartAccountManager on config change (with cleanup to prevent race conditions)
-  useEffect(() => {
-    if (!options?.rpcUrl) {
-      managerRef.current = null;
-      return;
-    }
-
-    let cancelled = false;
-
-    import("@naculus/connect-core").then(({ SmartAccountManager }) => {
-      if (cancelled) return; // prevent stale state update
-      managerRef.current = new SmartAccountManager({
-        rpcUrl: options.rpcUrl!,
-        chainId: options.chainId ?? "eip155:1",
-        bundlerClient: {
-          url: options.bundlerUrl ?? "",
-        },
-      });
-    }).catch((err) => {
-      if (cancelled) return; // prevent stale state update
-      setError(err instanceof Error ? err : new Error("Failed to load account-abstraction module"));
-    });
-
-    return () => { cancelled = true; };
-  }, [options?.rpcUrl, options?.bundlerUrl, options?.chainId]);
-
-  // Get account config from options + connected EOA
-  const getConfig = useCallback((): SmartAccountConfig | null => {
-    const owner = evmAccount;
-    if (!owner || !managerRef.current) return null;
-
-    const address = owner.includes(":") ? owner.split(":").pop()! as Address : owner as Address;
-
-    return {
-      owner: address,
-      accountType: options?.accountType ?? "simple",
-      entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032" as Address, // v0.7
-      chainId: options?.chainId ?? "eip155:1",
-      salt: options?.salt,
-    };
-  }, [evmAccount, options?.accountType, options?.chainId, options?.salt]);
-
-  // Create wallet (compute counterfactual address)
-  const createWallet = useCallback(async (): Promise<SmartAccountInfo | null> => {
-    const config = getConfig();
-    if (!config || !managerRef.current) {
-      setError(new Error("Smart account not configured"));
-      return null;
-    }
-
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const info = await managerRef.current.createAccount(config);
-      setAddress(info.address);
-      setIsDeployed(info.isDeployed);
-      setAccountInfo(info);
-      return info;
-    } catch (err) {
-      const e = err instanceof Error ? err : new Error("Failed to create smart account");
-      setError(e);
-      return null;
-    } finally {
-      setIsLoading(false);
-    }
-  }, [getConfig]);
-
-  // Deploy wallet
-  const deployWallet = useCallback(async (): Promise<Address | null> => {
-    const config = getConfig();
-    if (!config || !managerRef.current) {
-      setError(new Error("Smart account not configured"));
-      return null;
-    }
-
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const deployResult = await managerRef.current.deployAccount(config);
-
-      // After deploy, update state
-      if (deployResult) {
-        const info = await managerRef.current.createAccount(config);
-        setAddress(info.address);
-        setIsDeployed(true);
-        setAccountInfo(info);
-      }
-
-      return deployResult;
-    } catch (err) {
-      const e = err instanceof Error ? err : new Error("Failed to deploy smart account");
-      setError(e);
-      return null;
-    } finally {
-      setIsLoading(false);
-    }
-  }, [getConfig]);
-
-  // Get counterfactual address
-  const getAddress = useCallback(async (): Promise<Address | null> => {
-    const config = getConfig();
-    if (!config || !managerRef.current) return null;
-
-    try {
-      const addr = await managerRef.current.getAccountAddress(config);
-      return addr;
-    } catch {
-      return null;
-    }
-  }, [getConfig]);
-
-  return {
-    address,
-    isDeployed,
-    accountInfo,
-    isLoading,
-    error,
-    createWallet,
-    deployWallet,
-    getAddress,
-  };
-}

package/src/hooks/useSwitchChain.ts

@@ -1,68 +0,0 @@
-/**
- * useSwitchChain Hook
- *
- * Provides the switchChain method with loading/error state tracking.
- *
- * @see SRS-009 §7.2
- */
-
-import { useState, useCallback } from "react";
-import { useWeb3 } from "../provider/Web3ConnectProvider";
-import { WalletError } from "@naculus/connect-core";
-
-export interface UseSwitchChainReturn {
-  /** Switch the active chain for the current session */
-  switchChain: (chainId: string) => Promise<void>;
-  /** Whether a chain switch is in progress */
-  isSwitching: boolean;
-  /** The currently active chain ID */
-  currentChainId: string | null;
-  /** The last error that occurred during chain switch (if any) */
-  error: Error | null;
-  /** Clear the error state */
-  clearError: () => void;
-}
-
-export function useSwitchChain(): UseSwitchChainReturn {
-  const { switchChain: providerSwitchChain, chainId } = useWeb3();
-  const [isSwitching, setIsSwitching] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-
-  const handleSwitchChain = useCallback(
-    async (targetChainId: string) => {
-      setIsSwitching(true);
-      setError(null);
-
-      try {
-        await providerSwitchChain(targetChainId);
-      } catch (err) {
-        const walletError =
-          err instanceof WalletError
-            ? err
-            : new WalletError(
-                "chain_unsupported",
-                err instanceof Error
-                  ? err.message
-                  : "Unknown error during chain switch",
-              );
-        setError(walletError);
-        throw walletError;
-      } finally {
-        setIsSwitching(false);
-      }
-    },
-    [providerSwitchChain],
-  );
-
-  const clearError = useCallback(() => {
-    setError(null);
-  }, []);
-
-  return {
-    switchChain: handleSwitchChain,
-    isSwitching,
-    currentChainId: chainId,
-    error,
-    clearError,
-  };
-}