@account-kit/privy-integration 4.73.0 → 4.73.1-alpha.0

package/dist/esm/Provider.d.ts

@@ -1,63 +1,6 @@
-import { type PropsWithChildren } from "react";
-import type { SmartWalletClient } from "@account-kit/wallet-client";
-import type { AlchemyProviderConfig } from "./types.js";
 /**
- * Client cache stored in React tree (similar to QueryClient in React Query)
- *
- * @internal
+ * Web-specific exports
+ * Re-exports the web provider and hooks for React applications
  */
-interface ClientCache {
-    client: SmartWalletClient | null;
-    cacheKey: string | null;
-}
-/**
- * Provider component that configures Alchemy infrastructure for transaction handling
- * Must be nested INSIDE PrivyProvider to access authentication state
- * Automatically manages client cache lifecycle and resets on logout
- *
- * @param {PropsWithChildren<AlchemyProviderConfig>} props - Component props
- * @param {React.ReactNode} props.children - React children to wrap with Alchemy configuration
- * @param {string} [props.apiKey] - Your Alchemy API key
- * @param {string} [props.jwt] - JWT token for authentication
- * @param {string} [props.rpcUrl] - Custom RPC URL for EVM chains
- * @param {string} [props.solanaRpcUrl] - Custom RPC URL for Solana
- * @param {string | string[]} [props.policyId] - Gas Manager policy ID(s) for EVM chains
- * @param {string | string[]} [props.solanaPolicyId] - Gas Manager policy ID(s) for Solana
- * @param {boolean} [props.disableSponsorship] - Set to true to disable sponsorship by default (default: false)
- * @returns {JSX.Element} Provider component
- *
- * @example
- * ```tsx
- * <PrivyProvider appId="...">
- *   <AlchemyProvider
- *     apiKey="your-alchemy-api-key"
- *     policyId="your-gas-policy-id"
- *   >
- *     <YourApp />
- *   </AlchemyProvider>
- * </PrivyProvider>
- * ```
- */
-export declare function AlchemyProvider({ children, ...config }: PropsWithChildren<AlchemyProviderConfig>): import("react/jsx-runtime").JSX.Element;
-/**
- * Hook to access Alchemy provider configuration
- * Must be used within an <AlchemyProvider> component
- *
- * @returns {AlchemyProviderConfig} The current Alchemy configuration
- * @throws {Error} If used outside of AlchemyProvider
- *
- * @example
- * ```tsx
- * const config = useAlchemyConfig();
- * console.log('Policy ID:', config.policyId);
- * ```
- */
-export declare function useAlchemyConfig(): AlchemyProviderConfig;
-/**
- * Hook to access the client cache (internal use only)
- *
- * @internal
- * @returns {ClientCache} The client cache object
- */
-export declare function useClientCache(): ClientCache;
-export {};
+export { AlchemyProvider } from "./providers/WebProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";

package/dist/esm/Provider.js

@@ -1,102 +1,7 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useRef, useEffect, } from "react";
-import { usePrivy } from "@privy-io/react-auth";
-const AlchemyContext = createContext(null);
-const ClientCacheContext = createContext(null);
 /**
- * Provider component that configures Alchemy infrastructure for transaction handling
- * Must be nested INSIDE PrivyProvider to access authentication state
- * Automatically manages client cache lifecycle and resets on logout
- *
- * @param {PropsWithChildren<AlchemyProviderConfig>} props - Component props
- * @param {React.ReactNode} props.children - React children to wrap with Alchemy configuration
- * @param {string} [props.apiKey] - Your Alchemy API key
- * @param {string} [props.jwt] - JWT token for authentication
- * @param {string} [props.rpcUrl] - Custom RPC URL for EVM chains
- * @param {string} [props.solanaRpcUrl] - Custom RPC URL for Solana
- * @param {string | string[]} [props.policyId] - Gas Manager policy ID(s) for EVM chains
- * @param {string | string[]} [props.solanaPolicyId] - Gas Manager policy ID(s) for Solana
- * @param {boolean} [props.disableSponsorship] - Set to true to disable sponsorship by default (default: false)
- * @returns {JSX.Element} Provider component
- *
- * @example
- * ```tsx
- * <PrivyProvider appId="...">
- *   <AlchemyProvider
- *     apiKey="your-alchemy-api-key"
- *     policyId="your-gas-policy-id"
- *   >
- *     <YourApp />
- *   </AlchemyProvider>
- * </PrivyProvider>
- * ```
+ * Web-specific exports
+ * Re-exports the web provider and hooks for React applications
  */
-export function AlchemyProvider({ children, ...config }) {
-    const { authenticated, user } = usePrivy();
-    // Store cache in a ref - persists across renders but scoped to this component instance
-    // This makes it SSR-safe (each request gets its own cache) and React StrictMode-safe
-    const cache = useRef({
-        client: null,
-        cacheKey: null,
-    });
-    // Track previous state to detect logout and wallet changes
-    const prevAuthenticatedRef = useRef(authenticated);
-    const prevWalletAddressRef = useRef(user?.wallet?.address);
-    // Automatically reset cache when user logs out or switches wallets
-    useEffect(() => {
-        const wasAuthenticated = prevAuthenticatedRef.current;
-        const prevWalletAddress = prevWalletAddressRef.current;
-        const currentWalletAddress = user?.wallet?.address;
-        // Reset cache on logout
-        if (wasAuthenticated && !authenticated) {
-            cache.current.client = null;
-            cache.current.cacheKey = null;
-        }
-        // Reset cache on wallet address change (account switching)
-        if (authenticated &&
-            prevWalletAddress &&
-            currentWalletAddress &&
-            prevWalletAddress !== currentWalletAddress) {
-            cache.current.client = null;
-            cache.current.cacheKey = null;
-        }
-        // Update refs for next render
-        prevAuthenticatedRef.current = authenticated;
-        prevWalletAddressRef.current = currentWalletAddress;
-    }, [authenticated, user?.wallet?.address]);
-    return (_jsx(AlchemyContext.Provider, { value: config, children: _jsx(ClientCacheContext.Provider, { value: cache.current, children: children }) }));
-}
-/**
- * Hook to access Alchemy provider configuration
- * Must be used within an <AlchemyProvider> component
- *
- * @returns {AlchemyProviderConfig} The current Alchemy configuration
- * @throws {Error} If used outside of AlchemyProvider
- *
- * @example
- * ```tsx
- * const config = useAlchemyConfig();
- * console.log('Policy ID:', config.policyId);
- * ```
- */
-export function useAlchemyConfig() {
-    const context = useContext(AlchemyContext);
-    if (!context) {
-        throw new Error("useAlchemyConfig must be used within <AlchemyProvider />");
-    }
-    return context;
-}
-/**
- * Hook to access the client cache (internal use only)
- *
- * @internal
- * @returns {ClientCache} The client cache object
- */
-export function useClientCache() {
-    const context = useContext(ClientCacheContext);
-    if (!context) {
-        throw new Error("useClientCache must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.");
-    }
-    return context;
-}
+export { AlchemyProvider } from "./providers/WebProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";
 //# sourceMappingURL=Provider.js.map

package/dist/esm/Provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../../src/Provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAEL,aAAa,EACb,UAAU,EACV,MAAM,EACN,SAAS,GACV,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD,MAAM,cAAc,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAYzE,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACgC;IACzC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE3C,uFAAuF;IACvF,qFAAqF;IACrF,MAAM,KAAK,GAAG,MAAM,CAAc;QAChC,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,2DAA2D;IAC3D,MAAM,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3D,mEAAmE;IACnE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,OAAO,CAAC;QACtD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAC;QACvD,MAAM,oBAAoB,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;QAEnD,wBAAwB;QACxB,IAAI,gBAAgB,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,2DAA2D;QAC3D,IACE,aAAa;YACb,iBAAiB;YACjB,oBAAoB;YACpB,iBAAiB,KAAK,oBAAoB,EAC1C,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,8BAA8B;QAC9B,oBAAoB,CAAC,OAAO,GAAG,aAAa,CAAC;QAC7C,oBAAoB,CAAC,OAAO,GAAG,oBAAoB,CAAC;IACtD,CAAC,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3C,OAAO,CACL,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YACpC,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,YAC9C,QAAQ,GACmB,GACN,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  type PropsWithChildren,\n  createContext,\n  useContext,\n  useRef,\n  useEffect,\n} from \"react\";\nimport { usePrivy } from \"@privy-io/react-auth\";\nimport type { SmartWalletClient } from \"@account-kit/wallet-client\";\nimport type { AlchemyProviderConfig } from \"./types.js\";\n\nconst AlchemyContext = createContext<AlchemyProviderConfig | null>(null);\n\n/**\n * Client cache stored in React tree (similar to QueryClient in React Query)\n *\n * @internal\n */\ninterface ClientCache {\n  client: SmartWalletClient | null;\n  cacheKey: string | null;\n}\n\nconst ClientCacheContext = createContext<ClientCache | null>(null);\n\n/**\n * Provider component that configures Alchemy infrastructure for transaction handling\n * Must be nested INSIDE PrivyProvider to access authentication state\n * Automatically manages client cache lifecycle and resets on logout\n *\n * @param {PropsWithChildren<AlchemyProviderConfig>} props - Component props\n * @param {React.ReactNode} props.children - React children to wrap with Alchemy configuration\n * @param {string} [props.apiKey] - Your Alchemy API key\n * @param {string} [props.jwt] - JWT token for authentication\n * @param {string} [props.rpcUrl] - Custom RPC URL for EVM chains\n * @param {string} [props.solanaRpcUrl] - Custom RPC URL for Solana\n * @param {string | string[]} [props.policyId] - Gas Manager policy ID(s) for EVM chains\n * @param {string | string[]} [props.solanaPolicyId] - Gas Manager policy ID(s) for Solana\n * @param {boolean} [props.disableSponsorship] - Set to true to disable sponsorship by default (default: false)\n * @returns {JSX.Element} Provider component\n *\n * @example\n * ```tsx\n * <PrivyProvider appId=\"...\">\n *   <AlchemyProvider\n *     apiKey=\"your-alchemy-api-key\"\n *     policyId=\"your-gas-policy-id\"\n *   >\n *     <YourApp />\n *   </AlchemyProvider>\n * </PrivyProvider>\n * ```\n */\nexport function AlchemyProvider({\n  children,\n  ...config\n}: PropsWithChildren<AlchemyProviderConfig>) {\n  const { authenticated, user } = usePrivy();\n\n  // Store cache in a ref - persists across renders but scoped to this component instance\n  // This makes it SSR-safe (each request gets its own cache) and React StrictMode-safe\n  const cache = useRef<ClientCache>({\n    client: null,\n    cacheKey: null,\n  });\n\n  // Track previous state to detect logout and wallet changes\n  const prevAuthenticatedRef = useRef(authenticated);\n  const prevWalletAddressRef = useRef(user?.wallet?.address);\n\n  // Automatically reset cache when user logs out or switches wallets\n  useEffect(() => {\n    const wasAuthenticated = prevAuthenticatedRef.current;\n    const prevWalletAddress = prevWalletAddressRef.current;\n    const currentWalletAddress = user?.wallet?.address;\n\n    // Reset cache on logout\n    if (wasAuthenticated && !authenticated) {\n      cache.current.client = null;\n      cache.current.cacheKey = null;\n    }\n\n    // Reset cache on wallet address change (account switching)\n    if (\n      authenticated &&\n      prevWalletAddress &&\n      currentWalletAddress &&\n      prevWalletAddress !== currentWalletAddress\n    ) {\n      cache.current.client = null;\n      cache.current.cacheKey = null;\n    }\n\n    // Update refs for next render\n    prevAuthenticatedRef.current = authenticated;\n    prevWalletAddressRef.current = currentWalletAddress;\n  }, [authenticated, user?.wallet?.address]);\n\n  return (\n    <AlchemyContext.Provider value={config}>\n      <ClientCacheContext.Provider value={cache.current}>\n        {children}\n      </ClientCacheContext.Provider>\n    </AlchemyContext.Provider>\n  );\n}\n\n/**\n * Hook to access Alchemy provider configuration\n * Must be used within an <AlchemyProvider> component\n *\n * @returns {AlchemyProviderConfig} The current Alchemy configuration\n * @throws {Error} If used outside of AlchemyProvider\n *\n * @example\n * ```tsx\n * const config = useAlchemyConfig();\n * console.log('Policy ID:', config.policyId);\n * ```\n */\nexport function useAlchemyConfig(): AlchemyProviderConfig {\n  const context = useContext(AlchemyContext);\n  if (!context) {\n    throw new Error(\"useAlchemyConfig must be used within <AlchemyProvider />\");\n  }\n  return context;\n}\n\n/**\n * Hook to access the client cache (internal use only)\n *\n * @internal\n * @returns {ClientCache} The client cache object\n */\nexport function useClientCache(): ClientCache {\n  const context = useContext(ClientCacheContext);\n  if (!context) {\n    throw new Error(\n      \"useClientCache must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.\",\n    );\n  }\n  return context;\n}\n"]}
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../../src/Provider.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Web-specific exports\n * Re-exports the web provider and hooks for React applications\n */\nexport { AlchemyProvider } from \"./providers/WebProvider.js\";\nexport { useAlchemyConfig } from \"./context/AlchemyContext.js\";\n"]}

package/dist/esm/adapters/react-native.d.ts

@@ -0,0 +1,6 @@
+import type { PrivyAdapter } from "./types.js";
+/**
+ * React Native (Expo) adapter for @privy-io/expo
+ * Implements platform-specific hooks for React Native applications
+ */
+export declare const reactNativeAdapter: PrivyAdapter;

package/dist/esm/adapters/react-native.js

@@ -0,0 +1,46 @@
+import { useCallback } from "react";
+import { usePrivy, useEmbeddedEthereumWallet, } from "@privy-io/expo";
+/**
+ * React Native (Expo) adapter for @privy-io/expo
+ * Implements platform-specific hooks for React Native applications
+ */
+export const reactNativeAdapter = {
+    useEmbeddedWallet() {
+        const { wallets } = useEmbeddedEthereumWallet();
+        const getEmbeddedWallet = useCallback(() => {
+            const wallet = wallets?.[0];
+            if (!wallet) {
+                throw new Error("Privy embedded wallet not found. Please ensure the user is authenticated and has created a wallet.");
+            }
+            return adaptExpoWallet(wallet);
+        }, [wallets]);
+        return getEmbeddedWallet;
+    },
+    usePrivyAuth() {
+        const { user } = usePrivy();
+        return { authenticated: !!user, user };
+    },
+    // EIP-7702 authorization not available on React Native
+    useAuthorizationSigner() {
+        return null;
+    },
+};
+/**
+ * Adapts an Expo wallet to the common EmbeddedWallet interface
+ *
+ * @param {ExpoEmbeddedWallet} wallet - The Expo embedded wallet to adapt
+ * @returns {EmbeddedWallet} The adapted wallet following the common interface
+ */
+function adaptExpoWallet(wallet) {
+    return {
+        address: wallet.address,
+        chainId: wallet.chainId || "1",
+        getEthereumProvider: async () => {
+            if (!wallet.getProvider) {
+                throw new Error("getProvider is not available on this wallet. Ensure you're using the embedded Ethereum wallet.");
+            }
+            return await wallet.getProvider();
+        },
+    };
+}
+//# sourceMappingURL=react-native.js.map

package/dist/esm/adapters/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../../../src/adapters/react-native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,QAAQ,EACR,yBAAyB,GAE1B,MAAM,gBAAgB,CAAC;AAaxB;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,iBAAiB;QACf,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,EAAE,CAAC;QAEhD,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAmB,EAAE;YACzD,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;YACJ,CAAC;YAED,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAEd,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,YAAY;QACV,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,uDAAuD;IACvD,sBAAsB;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAS,eAAe,CAAC,MAA0B;IACjD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAwB;QACxC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,GAAG;QAC9B,mBAAmB,EAAE,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  usePrivy,\n  useEmbeddedEthereumWallet,\n  type PrivyEmbeddedWalletProvider,\n} from \"@privy-io/expo\";\nimport type { PrivyAdapter, EmbeddedWallet, PrivyAuthState } from \"./types.js\";\n\n/**\n * Wallet type from @privy-io/expo\n * Based on the example app structure\n */\ninterface ExpoEmbeddedWallet {\n  address: string;\n  chainId?: string;\n  getProvider?: () => Promise<PrivyEmbeddedWalletProvider>;\n}\n\n/**\n * React Native (Expo) adapter for @privy-io/expo\n * Implements platform-specific hooks for React Native applications\n */\nexport const reactNativeAdapter: PrivyAdapter = {\n  useEmbeddedWallet() {\n    const { wallets } = useEmbeddedEthereumWallet();\n\n    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {\n      const wallet = wallets?.[0];\n      if (!wallet) {\n        throw new Error(\n          \"Privy embedded wallet not found. Please ensure the user is authenticated and has created a wallet.\",\n        );\n      }\n\n      return adaptExpoWallet(wallet);\n    }, [wallets]);\n\n    return getEmbeddedWallet;\n  },\n\n  usePrivyAuth(): PrivyAuthState {\n    const { user } = usePrivy();\n    return { authenticated: !!user, user };\n  },\n\n  // EIP-7702 authorization not available on React Native\n  useAuthorizationSigner() {\n    return null;\n  },\n};\n\n/**\n * Adapts an Expo wallet to the common EmbeddedWallet interface\n *\n * @param {ExpoEmbeddedWallet} wallet - The Expo embedded wallet to adapt\n * @returns {EmbeddedWallet} The adapted wallet following the common interface\n */\nfunction adaptExpoWallet(wallet: ExpoEmbeddedWallet): EmbeddedWallet {\n  return {\n    address: wallet.address as `0x${string}`,\n    chainId: wallet.chainId || \"1\",\n    getEthereumProvider: async () => {\n      if (!wallet.getProvider) {\n        throw new Error(\n          \"getProvider is not available on this wallet. Ensure you're using the embedded Ethereum wallet.\",\n        );\n      }\n      return await wallet.getProvider();\n    },\n  };\n}\n"]}

package/dist/esm/adapters/types.d.ts

@@ -0,0 +1,44 @@
+import type { Address, Authorization } from "viem";
+import type { AuthorizationRequest } from "@aa-sdk/core";
+/**
+ * Platform-agnostic embedded wallet interface
+ * Abstracts differences between @privy-io/react-auth and @privy-io/expo
+ */
+export interface EmbeddedWallet {
+    /** Wallet address */
+    address: Address;
+    /** Chain ID (may be CAIP-2 format like "eip155:1" or numeric) */
+    chainId: string | number;
+    /** Get EVM provider for the wallet */
+    getEthereumProvider(): Promise<any>;
+}
+/**
+ * Platform-agnostic Privy auth state
+ */
+export interface PrivyAuthState {
+    /** Whether user is authenticated */
+    authenticated: boolean;
+    /** User object (platform-specific, used for cache invalidation) */
+    user: any;
+}
+/**
+ * Adapter interface that each platform must implement
+ * Provides platform-specific Privy functionality
+ */
+export interface PrivyAdapter {
+    /**
+     * Hook to get embedded wallet
+     * Must be called as a React hook (follows rules of hooks)
+     */
+    useEmbeddedWallet(): () => EmbeddedWallet;
+    /**
+     * Hook to get Privy authentication state
+     * Must be called as a React hook (follows rules of hooks)
+     */
+    usePrivyAuth(): PrivyAuthState;
+    /**
+     * Hook to get EIP-7702 authorization signer (optional, web only)
+     * Must be called as a React hook (follows rules of hooks)
+     */
+    useAuthorizationSigner?(): ((auth: AuthorizationRequest<number>) => Promise<Authorization<number, true>>) | null;
+}

package/dist/esm/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Address, Authorization } from \"viem\";\nimport type { AuthorizationRequest } from \"@aa-sdk/core\";\n\n/**\n * Platform-agnostic embedded wallet interface\n * Abstracts differences between @privy-io/react-auth and @privy-io/expo\n */\nexport interface EmbeddedWallet {\n  /** Wallet address */\n  address: Address;\n\n  /** Chain ID (may be CAIP-2 format like \"eip155:1\" or numeric) */\n  chainId: string | number;\n\n  /** Get EVM provider for the wallet */\n  getEthereumProvider(): Promise<any>;\n}\n\n/**\n * Platform-agnostic Privy auth state\n */\nexport interface PrivyAuthState {\n  /** Whether user is authenticated */\n  authenticated: boolean;\n\n  /** User object (platform-specific, used for cache invalidation) */\n  user: any;\n}\n\n/**\n * Adapter interface that each platform must implement\n * Provides platform-specific Privy functionality\n */\nexport interface PrivyAdapter {\n  /**\n   * Hook to get embedded wallet\n   * Must be called as a React hook (follows rules of hooks)\n   */\n  useEmbeddedWallet(): () => EmbeddedWallet;\n\n  /**\n   * Hook to get Privy authentication state\n   * Must be called as a React hook (follows rules of hooks)\n   */\n  usePrivyAuth(): PrivyAuthState;\n\n  /**\n   * Hook to get EIP-7702 authorization signer (optional, web only)\n   * Must be called as a React hook (follows rules of hooks)\n   */\n  useAuthorizationSigner?():\n    | ((\n        auth: AuthorizationRequest<number>,\n      ) => Promise<Authorization<number, true>>)\n    | null;\n}\n"]}

package/dist/esm/adapters/web.d.ts

@@ -0,0 +1,6 @@
+import type { PrivyAdapter } from "./types.js";
+/**
+ * Web adapter for @privy-io/react-auth
+ * Implements platform-specific hooks for React web applications
+ */
+export declare const webAdapter: PrivyAdapter;

package/dist/esm/adapters/web.js

@@ -0,0 +1,50 @@
+import { useCallback } from "react";
+import { useWallets, usePrivy, useSign7702Authorization, } from "@privy-io/react-auth";
+/**
+ * Web adapter for @privy-io/react-auth
+ * Implements platform-specific hooks for React web applications
+ */
+export const webAdapter = {
+    useEmbeddedWallet() {
+        const { wallets } = useWallets();
+        const getEmbeddedWallet = useCallback(() => {
+            const embedded = wallets.find((w) => w.walletClientType === "privy");
+            if (!embedded) {
+                throw new Error("Privy embedded wallet not found. Please ensure the user is authenticated.");
+            }
+            return adaptWebWallet(embedded);
+        }, [wallets]);
+        return getEmbeddedWallet;
+    },
+    usePrivyAuth() {
+        const { user } = usePrivy();
+        return { authenticated: !!user, user };
+    },
+    useAuthorizationSigner() {
+        const { signAuthorization } = useSign7702Authorization();
+        return useCallback(async (unsignedAuth) => {
+            const signature = await signAuthorization({
+                ...unsignedAuth,
+                contractAddress: unsignedAuth.address ?? unsignedAuth.contractAddress,
+            });
+            return {
+                ...unsignedAuth,
+                ...signature,
+            };
+        }, [signAuthorization]);
+    },
+};
+/**
+ * Adapts a Privy web wallet to the common EmbeddedWallet interface
+ *
+ * @param {PrivyWallet} wallet - The Privy web wallet to adapt
+ * @returns {EmbeddedWallet} The adapted wallet following the common interface
+ */
+function adaptWebWallet(wallet) {
+    return {
+        address: wallet.address,
+        chainId: wallet.chainId || "1",
+        getEthereumProvider: () => wallet.getEthereumProvider(),
+    };
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/adapters/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/adapters/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,wBAAwB,GAEzB,MAAM,sBAAsB,CAAC;AAK9B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAiB;IACtC,iBAAiB;QACf,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;QAEjC,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAmB,EAAE;YACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,OAAO,CAAC,CAAC;YACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;YACJ,CAAC;YAED,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAEd,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,YAAY;QACV,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,sBAAsB;QACpB,MAAM,EAAE,iBAAiB,EAAE,GAAG,wBAAwB,EAAE,CAAC;QAEzD,OAAO,WAAW,CAChB,KAAK,EACH,YAA0C,EACJ,EAAE;YACxC,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC;gBACxC,GAAG,YAAY;gBACf,eAAe,EAAE,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,eAAe;aACtE,CAAC,CAAC;YAEH,OAAO;gBACL,GAAG,YAAY;gBACf,GAAG,SAAS;aACb,CAAC;QACJ,CAAC,EACD,CAAC,iBAAiB,CAAC,CACpB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAAmB;IACzC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAwB;QACxC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,GAAG;QAC9B,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE;KACxD,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  useWallets,\n  usePrivy,\n  useSign7702Authorization,\n  type ConnectedWallet as PrivyWallet,\n} from \"@privy-io/react-auth\";\nimport type { Authorization } from \"viem\";\nimport type { AuthorizationRequest } from \"@aa-sdk/core\";\nimport type { PrivyAdapter, EmbeddedWallet, PrivyAuthState } from \"./types.js\";\n\n/**\n * Web adapter for @privy-io/react-auth\n * Implements platform-specific hooks for React web applications\n */\nexport const webAdapter: PrivyAdapter = {\n  useEmbeddedWallet() {\n    const { wallets } = useWallets();\n\n    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {\n      const embedded = wallets.find((w) => w.walletClientType === \"privy\");\n      if (!embedded) {\n        throw new Error(\n          \"Privy embedded wallet not found. Please ensure the user is authenticated.\",\n        );\n      }\n\n      return adaptWebWallet(embedded);\n    }, [wallets]);\n\n    return getEmbeddedWallet;\n  },\n\n  usePrivyAuth(): PrivyAuthState {\n    const { user } = usePrivy();\n    return { authenticated: !!user, user };\n  },\n\n  useAuthorizationSigner() {\n    const { signAuthorization } = useSign7702Authorization();\n\n    return useCallback(\n      async (\n        unsignedAuth: AuthorizationRequest<number>,\n      ): Promise<Authorization<number, true>> => {\n        const signature = await signAuthorization({\n          ...unsignedAuth,\n          contractAddress: unsignedAuth.address ?? unsignedAuth.contractAddress,\n        });\n\n        return {\n          ...unsignedAuth,\n          ...signature,\n        };\n      },\n      [signAuthorization],\n    );\n  },\n};\n\n/**\n * Adapts a Privy web wallet to the common EmbeddedWallet interface\n *\n * @param {PrivyWallet} wallet - The Privy web wallet to adapt\n * @returns {EmbeddedWallet} The adapted wallet following the common interface\n */\nfunction adaptWebWallet(wallet: PrivyWallet): EmbeddedWallet {\n  return {\n    address: wallet.address as `0x${string}`,\n    chainId: wallet.chainId || \"1\",\n    getEthereumProvider: () => wallet.getEthereumProvider(),\n  };\n}\n"]}

package/dist/esm/context/AlchemyContext.d.ts

@@ -0,0 +1,62 @@
+import { type PropsWithChildren } from "react";
+import type { SmartWalletClient } from "@account-kit/wallet-client";
+import type { AlchemyProviderConfig } from "../types.js";
+import type { PrivyAdapter } from "../adapters/types.js";
+/**
+ * Client cache stored in React tree (similar to QueryClient in React Query)
+ *
+ * @internal
+ */
+interface ClientCache {
+    client: SmartWalletClient | null;
+    cacheKey: string | null;
+}
+/**
+ * Props for AlchemyContextProvider
+ */
+interface AlchemyContextProviderProps extends PropsWithChildren {
+    config: AlchemyProviderConfig;
+    adapter: PrivyAdapter;
+}
+/**
+ * Internal provider component that manages Alchemy context
+ * Used by both web and React Native providers
+ *
+ * @internal
+ * @param {AlchemyContextProviderProps} props - Component props
+ * @param {React.ReactNode} props.children - React children to wrap with context
+ * @param {AlchemyProviderConfig} props.config - Alchemy configuration
+ * @param {PrivyAdapter} props.adapter - Platform adapter
+ * @returns {JSX.Element} Context provider component
+ */
+export declare function AlchemyContextProvider({ children, config, adapter, }: AlchemyContextProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access Alchemy provider configuration
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @returns {AlchemyProviderConfig} The current Alchemy configuration
+ * @throws {Error} If used outside of AlchemyProvider
+ *
+ * @example
+ * ```tsx
+ * const config = useAlchemyConfig();
+ * console.log('Policy ID:', config.policyId);
+ * ```
+ */
+export declare function useAlchemyConfig(): AlchemyProviderConfig;
+/**
+ * Hook to access the platform adapter
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @internal
+ * @returns {PrivyAdapter} The platform adapter
+ */
+export declare function useAdapter(): PrivyAdapter;
+/**
+ * Hook to access the client cache (internal use only)
+ *
+ * @internal
+ * @returns {ClientCache} The client cache object
+ */
+export declare function useClientCache(): ClientCache;
+export {};

package/dist/esm/context/AlchemyContext.js

@@ -0,0 +1,105 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useRef, useEffect, } from "react";
+/**
+ * Context for Alchemy configuration
+ */
+const AlchemyConfigContext = createContext(null);
+/**
+ * Context for the platform adapter
+ */
+const AdapterContext = createContext(null);
+const ClientCacheContext = createContext(null);
+/**
+ * Internal provider component that manages Alchemy context
+ * Used by both web and React Native providers
+ *
+ * @internal
+ * @param {AlchemyContextProviderProps} props - Component props
+ * @param {React.ReactNode} props.children - React children to wrap with context
+ * @param {AlchemyProviderConfig} props.config - Alchemy configuration
+ * @param {PrivyAdapter} props.adapter - Platform adapter
+ * @returns {JSX.Element} Context provider component
+ */
+export function AlchemyContextProvider({ children, config, adapter, }) {
+    const { authenticated, user } = adapter.usePrivyAuth();
+    // Store cache in a ref - persists across renders but scoped to this component instance
+    // This makes it SSR-safe (each request gets its own cache) and React StrictMode-safe
+    const cache = useRef({
+        client: null,
+        cacheKey: null,
+    });
+    // Track previous state to detect logout and wallet changes
+    const prevAuthenticatedRef = useRef(authenticated);
+    const prevWalletAddressRef = useRef(user?.wallet?.address);
+    // Automatically reset cache when user logs out or switches wallets
+    useEffect(() => {
+        const wasAuthenticated = prevAuthenticatedRef.current;
+        const prevWalletAddress = prevWalletAddressRef.current;
+        const currentWalletAddress = user?.wallet?.address;
+        // Reset cache on logout
+        if (wasAuthenticated && !authenticated) {
+            cache.current.client = null;
+            cache.current.cacheKey = null;
+        }
+        // Reset cache on wallet address change (account switching)
+        if (authenticated &&
+            prevWalletAddress &&
+            currentWalletAddress &&
+            prevWalletAddress !== currentWalletAddress) {
+            cache.current.client = null;
+            cache.current.cacheKey = null;
+        }
+        // Update refs for next render
+        prevAuthenticatedRef.current = authenticated;
+        prevWalletAddressRef.current = currentWalletAddress;
+    }, [authenticated, user?.wallet?.address]);
+    return (_jsx(AlchemyConfigContext.Provider, { value: config, children: _jsx(AdapterContext.Provider, { value: adapter, children: _jsx(ClientCacheContext.Provider, { value: cache.current, children: children }) }) }));
+}
+/**
+ * Hook to access Alchemy provider configuration
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @returns {AlchemyProviderConfig} The current Alchemy configuration
+ * @throws {Error} If used outside of AlchemyProvider
+ *
+ * @example
+ * ```tsx
+ * const config = useAlchemyConfig();
+ * console.log('Policy ID:', config.policyId);
+ * ```
+ */
+export function useAlchemyConfig() {
+    const context = useContext(AlchemyConfigContext);
+    if (!context) {
+        throw new Error("useAlchemyConfig must be used within <AlchemyProvider />");
+    }
+    return context;
+}
+/**
+ * Hook to access the platform adapter
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @internal
+ * @returns {PrivyAdapter} The platform adapter
+ */
+export function useAdapter() {
+    const context = useContext(AdapterContext);
+    if (!context) {
+        throw new Error("useAdapter must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.");
+    }
+    return context;
+}
+/**
+ * Hook to access the client cache (internal use only)
+ *
+ * @internal
+ * @returns {ClientCache} The client cache object
+ */
+export function useClientCache() {
+    const context = useContext(ClientCacheContext);
+    if (!context) {
+        throw new Error("useClientCache must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.");
+    }
+    return context;
+}
+//# sourceMappingURL=AlchemyContext.js.map

package/dist/esm/context/AlchemyContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlchemyContext.js","sourceRoot":"","sources":["../../../src/context/AlchemyContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  type PropsWithChildren,\n  createContext,\n  useContext,\n  useRef,\n  useEffect,\n} from \"react\";\nimport type { SmartWalletClient } from \"@account-kit/wallet-client\";\nimport type { AlchemyProviderConfig } from \"../types.js\";\nimport type { PrivyAdapter } from \"../adapters/types.js\";\n\n/**\n * Context for Alchemy configuration\n */\nconst AlchemyConfigContext = createContext<AlchemyProviderConfig | null>(null);\n\n/**\n * Context for the platform adapter\n */\nconst AdapterContext = createContext<PrivyAdapter | null>(null);\n\n/**\n * Client cache stored in React tree (similar to QueryClient in React Query)\n *\n * @internal\n */\ninterface ClientCache {\n  client: SmartWalletClient | null;\n  cacheKey: string | null;\n}\n\nconst ClientCacheContext = createContext<ClientCache | null>(null);\n\n/**\n * Props for AlchemyContextProvider\n */\ninterface AlchemyContextProviderProps extends PropsWithChildren {\n  config: AlchemyProviderConfig;\n  adapter: PrivyAdapter;\n}\n\n/**\n * Internal provider component that manages Alchemy context\n * Used by both web and React Native providers\n *\n * @internal\n * @param {AlchemyContextProviderProps} props - Component props\n * @param {React.ReactNode} props.children - React children to wrap with context\n * @param {AlchemyProviderConfig} props.config - Alchemy configuration\n * @param {PrivyAdapter} props.adapter - Platform adapter\n * @returns {JSX.Element} Context provider component\n */\nexport function AlchemyContextProvider({\n  children,\n  config,\n  adapter,\n}: AlchemyContextProviderProps) {\n  const { authenticated, user } = adapter.usePrivyAuth();\n\n  // Store cache in a ref - persists across renders but scoped to this component instance\n  // This makes it SSR-safe (each request gets its own cache) and React StrictMode-safe\n  const cache = useRef<ClientCache>({\n    client: null,\n    cacheKey: null,\n  });\n\n  // Track previous state to detect logout and wallet changes\n  const prevAuthenticatedRef = useRef(authenticated);\n  const prevWalletAddressRef = useRef(user?.wallet?.address);\n\n  // Automatically reset cache when user logs out or switches wallets\n  useEffect(() => {\n    const wasAuthenticated = prevAuthenticatedRef.current;\n    const prevWalletAddress = prevWalletAddressRef.current;\n    const currentWalletAddress = user?.wallet?.address;\n\n    // Reset cache on logout\n    if (wasAuthenticated && !authenticated) {\n      cache.current.client = null;\n      cache.current.cacheKey = null;\n    }\n\n    // Reset cache on wallet address change (account switching)\n    if (\n      authenticated &&\n      prevWalletAddress &&\n      currentWalletAddress &&\n      prevWalletAddress !== currentWalletAddress\n    ) {\n      cache.current.client = null;\n      cache.current.cacheKey = null;\n    }\n\n    // Update refs for next render\n    prevAuthenticatedRef.current = authenticated;\n    prevWalletAddressRef.current = currentWalletAddress;\n  }, [authenticated, user?.wallet?.address]);\n\n  return (\n    <AlchemyConfigContext.Provider value={config}>\n      <AdapterContext.Provider value={adapter}>\n        <ClientCacheContext.Provider value={cache.current}>\n          {children}\n        </ClientCacheContext.Provider>\n      </AdapterContext.Provider>\n    </AlchemyConfigContext.Provider>\n  );\n}\n\n/**\n * Hook to access Alchemy provider configuration\n * Must be used within an <AlchemyProvider> component\n *\n * @returns {AlchemyProviderConfig} The current Alchemy configuration\n * @throws {Error} If used outside of AlchemyProvider\n *\n * @example\n * ```tsx\n * const config = useAlchemyConfig();\n * console.log('Policy ID:', config.policyId);\n * ```\n */\nexport function useAlchemyConfig(): AlchemyProviderConfig {\n  const context = useContext(AlchemyConfigContext);\n  if (!context) {\n    throw new Error(\"useAlchemyConfig must be used within <AlchemyProvider />\");\n  }\n  return context;\n}\n\n/**\n * Hook to access the platform adapter\n * Must be used within an <AlchemyProvider> component\n *\n * @internal\n * @returns {PrivyAdapter} The platform adapter\n */\nexport function useAdapter(): PrivyAdapter {\n  const context = useContext(AdapterContext);\n  if (!context) {\n    throw new Error(\n      \"useAdapter must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.\",\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to access the client cache (internal use only)\n *\n * @internal\n * @returns {ClientCache} The client cache object\n */\nexport function useClientCache(): ClientCache {\n  const context = useContext(ClientCacheContext);\n  if (!context) {\n    throw new Error(\n      \"useClientCache must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.\",\n    );\n  }\n  return context;\n}\n"]}

package/dist/esm/hooks/internal/useEmbeddedWallet.d.ts

@@ -1,10 +1,9 @@
-import { type ConnectedWallet as PrivyWallet } from "@privy-io/react-auth";
 /**
  * Internal hook to get the Privy embedded wallet
- * Shared across multiple hooks to avoid duplication
+ * Uses the platform adapter to abstract differences between web and React Native
  *
  * @internal
- * @returns {() => PrivyWallet} Function that returns the embedded wallet
+ * @returns {() => EmbeddedWallet} Function that returns the embedded wallet
  * @throws {Error} If embedded wallet is not found
  */
-export declare function useEmbeddedWallet(): () => PrivyWallet;
+export declare function useEmbeddedWallet(): () => import("../../adapters/types.js").EmbeddedWallet;

package/dist/esm/hooks/internal/useEmbeddedWallet.js

@@ -1,22 +1,14 @@
-import { useCallback } from "react";
-import { useWallets, } from "@privy-io/react-auth";
+import { useAdapter } from "../../context/AlchemyContext.js";
 /**
  * Internal hook to get the Privy embedded wallet
- * Shared across multiple hooks to avoid duplication
+ * Uses the platform adapter to abstract differences between web and React Native
  *
  * @internal
- * @returns {() => PrivyWallet} Function that returns the embedded wallet
+ * @returns {() => EmbeddedWallet} Function that returns the embedded wallet
  * @throws {Error} If embedded wallet is not found
  */
 export function useEmbeddedWallet() {
-    const { wallets } = useWallets();
-    const getEmbeddedWallet = useCallback(() => {
-        const embedded = wallets.find((w) => w.walletClientType === "privy");
-        if (!embedded) {
-            throw new Error("Privy embedded wallet not found. Please ensure the user is authenticated.");
-        }
-        return embedded;
-    }, [wallets]);
-    return getEmbeddedWallet;
+    const adapter = useAdapter();
+    return adapter.useEmbeddedWallet();
 }
 //# sourceMappingURL=useEmbeddedWallet.js.map

package/dist/esm/hooks/internal/useEmbeddedWallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEmbeddedWallet.js","sourceRoot":"","sources":["../../../../src/hooks/internal/useEmbeddedWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,UAAU,GAEX,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IAEjC,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAgB,EAAE;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,iBAAiB,CAAC;AAC3B,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  useWallets,\n  type ConnectedWallet as PrivyWallet,\n} from \"@privy-io/react-auth\";\n\n/**\n * Internal hook to get the Privy embedded wallet\n * Shared across multiple hooks to avoid duplication\n *\n * @internal\n * @returns {() => PrivyWallet} Function that returns the embedded wallet\n * @throws {Error} If embedded wallet is not found\n */\nexport function useEmbeddedWallet() {\n  const { wallets } = useWallets();\n\n  const getEmbeddedWallet = useCallback((): PrivyWallet => {\n    const embedded = wallets.find((w) => w.walletClientType === \"privy\");\n    if (!embedded) {\n      throw new Error(\n        \"Privy embedded wallet not found. Please ensure the user is authenticated.\",\n      );\n    }\n    return embedded;\n  }, [wallets]);\n\n  return getEmbeddedWallet;\n}\n"]}
+{"version":3,"file":"useEmbeddedWallet.js","sourceRoot":"","sources":["../../../../src/hooks/internal/useEmbeddedWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,iBAAiB,EAAE,CAAC;AACrC,CAAC","sourcesContent":["import { useAdapter } from \"../../context/AlchemyContext.js\";\n\n/**\n * Internal hook to get the Privy embedded wallet\n * Uses the platform adapter to abstract differences between web and React Native\n *\n * @internal\n * @returns {() => EmbeddedWallet} Function that returns the embedded wallet\n * @throws {Error} If embedded wallet is not found\n */\nexport function useEmbeddedWallet() {\n  const adapter = useAdapter();\n  return adapter.useEmbeddedWallet();\n}\n"]}