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

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

@@ -1,11 +1,10 @@
-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;
 //# sourceMappingURL=useEmbeddedWallet.d.ts.map

package/dist/types/hooks/internal/useEmbeddedWallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEmbeddedWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useEmbeddedWallet.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,IAAI,WAAW,EACpC,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,UAGW,WAAW,CAWtD"}
+{"version":3,"file":"useEmbeddedWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useEmbeddedWallet.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,2DAGhC"}

package/dist/types/hooks/useAlchemyClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAlchemyClient.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAlchemyClient.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB;qBAgCU,OAAO,CAAC,iBAAiB,CAAC;EA4FnE"}
+{"version":3,"file":"useAlchemyClient.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAlchemyClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAUpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB;qBAiCU,OAAO,CAAC,iBAAiB,CAAC;EAkFnE"}

package/dist/types/index.d.ts

@@ -3,6 +3,5 @@ export { useAlchemyClient } from "./hooks/useAlchemyClient.js";
 export { useAlchemySendTransaction } from "./hooks/useAlchemySendTransaction.js";
 export { useAlchemyPrepareSwap } from "./hooks/useAlchemyPrepareSwap.js";
 export { useAlchemySubmitSwap } from "./hooks/useAlchemySubmitSwap.js";
-export { useAlchemySolanaTransaction } from "./hooks/useAlchemySolanaTransaction.js";
 export type { AlchemyProviderConfig, UnsignedTransactionRequest, SendTransactionOptions, SendTransactionResult, UseSendTransactionResult, PrepareSwapRequest, PrepareSwapResult, UsePrepareSwapResult, SubmitSwapResult, UseSubmitSwapResult, SwapQuote, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAGrF,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/types/providers/ReactNativeProvider.d.ts

@@ -0,0 +1,34 @@
+import type { PropsWithChildren } from "react";
+import type { AlchemyProviderConfig } from "../types.js";
+/**
+ * Provider component for React Native (Expo) applications
+ * Must be nested INSIDE PrivyProvider from @privy-io/expo
+ *
+ * @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
+ * import { PrivyProvider } from '@privy-io/expo';
+ * import { AlchemyProvider } from '@account-kit/privy-integration/react-native';
+ *
+ * <PrivyProvider appId="..." clientId="...">
+ *   <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;
+//# sourceMappingURL=ReactNativeProvider.d.ts.map

package/dist/types/providers/ReactNativeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/ReactNativeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,2CAM1C"}

package/dist/types/providers/WebProvider.d.ts

@@ -0,0 +1,34 @@
+import type { PropsWithChildren } from "react";
+import type { AlchemyProviderConfig } from "../types.js";
+/**
+ * Provider component for React web applications
+ * Must be nested INSIDE PrivyProvider from @privy-io/react-auth
+ *
+ * @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
+ * import { PrivyProvider } from '@privy-io/react-auth';
+ * import { AlchemyProvider } from '@account-kit/privy-integration';
+ *
+ * <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;
+//# sourceMappingURL=WebProvider.d.ts.map

package/dist/types/providers/WebProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/WebProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,2CAM1C"}

package/dist/types/react-native.d.ts

@@ -0,0 +1,12 @@
+/**
+ * React Native (Expo) entry point
+ * Import from '@account-kit/privy-integration/react-native' in Expo apps
+ */
+export { AlchemyProvider } from "./providers/ReactNativeProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";
+export { useAlchemyClient } from "./hooks/useAlchemyClient.js";
+export { useAlchemySendTransaction } from "./hooks/useAlchemySendTransaction.js";
+export { useAlchemyPrepareSwap } from "./hooks/useAlchemyPrepareSwap.js";
+export { useAlchemySubmitSwap } from "./hooks/useAlchemySubmitSwap.js";
+export type { AlchemyProviderConfig, UnsignedTransactionRequest, SendTransactionOptions, SendTransactionResult, UseSendTransactionResult, PrepareSwapRequest, PrepareSwapResult, UsePrepareSwapResult, SubmitSwapResult, UseSubmitSwapResult, SwapQuote, } from "./types.js";
+//# sourceMappingURL=react-native.d.ts.map

package/dist/types/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../src/react-native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/types/solana.d.ts

@@ -0,0 +1,3 @@
+export { useAlchemySolanaTransaction } from "./hooks/useAlchemySolanaTransaction.js";
+export type { PromiseOrValue, PreSend, TransformInstruction, SolanaTransactionParamOptions, SolanaTransactionParams, SolanaTransactionResult, UseAlchemySolanaTransactionOptions, UseAlchemySolanaTransactionResult, } from "./hooks/useAlchemySolanaTransaction.js";
+//# sourceMappingURL=solana.d.ts.map

package/dist/types/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/solana.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,YAAY,EACV,cAAc,EACd,OAAO,EACP,oBAAoB,EACpB,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,wCAAwC,CAAC"}

package/dist/types/util/createSolanaSponsoredTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSolanaSponsoredTransaction.d.ts","sourceRoot":"","sources":["../../../src/util/createSolanaSponsoredTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,UAAU,EAGV,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CA+C/B"}
+{"version":3,"file":"createSolanaSponsoredTransaction.d.ts","sourceRoot":"","sources":["../../../src/util/createSolanaSponsoredTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,UAAU,EAGV,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAgD/B"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.72.0";
+export declare const VERSION = "4.73.1-alpha.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@account-kit/privy-integration",
-  "version": "4.72.0",
+  "version": "4.73.1-alpha.0",
   "description": "Use Alchemy gas sponsorship, swaps and more with Privy",
   "author": "Alchemy",
   "license": "MIT",
@@ -27,6 +27,16 @@
       "import": "./dist/esm/index.js",
       "default": "./dist/esm/index.js"
     },
+    "./react-native": {
+      "types": "./dist/types/react-native.d.ts",
+      "import": "./dist/esm/react-native.js",
+      "default": "./dist/esm/react-native.js"
+    },
+    "./solana": {
+      "types": "./dist/types/solana.d.ts",
+      "import": "./dist/esm/solana.js",
+      "default": "./dist/esm/solana.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -39,17 +49,30 @@
     "test:run": "vitest run --passWithNoTests"
   },
   "devDependencies": {
+    "@privy-io/expo": "0.58.1",
     "@privy-io/react-auth": "3.3.0",
     "typescript-template": "*"
   },
   "dependencies": {
-    "@account-kit/infra": "^4.72.0",
-    "@account-kit/wallet-client": "^4.72.0"
+    "@account-kit/infra": "^4.73.1-alpha.0",
+    "@account-kit/wallet-client": "^4.73.1-alpha.0"
   },
   "peerDependencies": {
+    "@privy-io/expo": "^0.58.0",
     "@privy-io/react-auth": "^2.3.1 || ^3.0.0",
     "viem": "^2.29.2"
   },
+  "peerDependenciesMeta": {
+    "@privy-io/react-auth": {
+      "optional": true
+    },
+    "@privy-io/expo": {
+      "optional": true
+    },
+    "@solana/web3.js": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -62,5 +85,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "e5efee1de2bb143287c3da604d0a7f545612a309"
+  "gitHead": "30a05bddab1215d0ba101fcdcdec63894d14c04d"
 }

package/src/adapters/react-native.ts

@@ -0,0 +1,71 @@
+import { useCallback } from "react";
+import {
+  usePrivy,
+  useEmbeddedEthereumWallet,
+  type PrivyEmbeddedWalletProvider,
+} from "@privy-io/expo";
+import type { PrivyAdapter, EmbeddedWallet, PrivyAuthState } from "./types.js";
+
+/**
+ * Wallet type from @privy-io/expo
+ * Based on the example app structure
+ */
+interface ExpoEmbeddedWallet {
+  address: string;
+  chainId?: string;
+  getProvider?: () => Promise<PrivyEmbeddedWalletProvider>;
+}
+
+/**
+ * React Native (Expo) adapter for @privy-io/expo
+ * Implements platform-specific hooks for React Native applications
+ */
+export const reactNativeAdapter: PrivyAdapter = {
+  useEmbeddedWallet() {
+    const { wallets } = useEmbeddedEthereumWallet();
+
+    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {
+      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(): PrivyAuthState {
+    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: ExpoEmbeddedWallet): EmbeddedWallet {
+  return {
+    address: wallet.address as `0x${string}`,
+    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();
+    },
+  };
+}

package/src/adapters/types.ts

@@ -0,0 +1,56 @@
+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/src/adapters/web.ts

@@ -0,0 +1,73 @@
+import { useCallback } from "react";
+import {
+  useWallets,
+  usePrivy,
+  useSign7702Authorization,
+  type ConnectedWallet as PrivyWallet,
+} from "@privy-io/react-auth";
+import type { Authorization } from "viem";
+import type { AuthorizationRequest } from "@aa-sdk/core";
+import type { PrivyAdapter, EmbeddedWallet, PrivyAuthState } from "./types.js";
+
+/**
+ * Web adapter for @privy-io/react-auth
+ * Implements platform-specific hooks for React web applications
+ */
+export const webAdapter: PrivyAdapter = {
+  useEmbeddedWallet() {
+    const { wallets } = useWallets();
+
+    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {
+      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(): PrivyAuthState {
+    const { user } = usePrivy();
+    return { authenticated: !!user, user };
+  },
+
+  useAuthorizationSigner() {
+    const { signAuthorization } = useSign7702Authorization();
+
+    return useCallback(
+      async (
+        unsignedAuth: AuthorizationRequest<number>,
+      ): Promise<Authorization<number, true>> => {
+        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: PrivyWallet): EmbeddedWallet {
+  return {
+    address: wallet.address as `0x${string}`,
+    chainId: wallet.chainId || "1",
+    getEthereumProvider: () => wallet.getEthereumProvider(),
+  };
+}

package/src/hooks/internal/useEmbeddedWallet.ts

@@ -1,29 +1,14 @@
-import { useCallback } from "react";
-import {
-  useWallets,
-  type ConnectedWallet as PrivyWallet,
-} 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((): PrivyWallet => {
-    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();
 }

package/src/hooks/useAlchemyClient.ts

@@ -1,22 +1,16 @@
 import { useCallback } from "react";
-import {
-  WalletClientSigner,
-  type AuthorizationRequest,
-  ConnectionConfigSchema,
-} from "@aa-sdk/core";
-import {
-  createWalletClient,
-  custom,
-  type Address,
-  type Authorization,
-} from "viem";
-import { useSign7702Authorization } from "@privy-io/react-auth";
+import { WalletClientSigner, ConnectionConfigSchema } from "@aa-sdk/core";
+import { createWalletClient, custom, type Address } from "viem";
 import {
   createSmartWalletClient,
   type SmartWalletClient,
 } from "@account-kit/wallet-client";
 import { alchemy } from "@account-kit/infra";
-import { useAlchemyConfig, useClientCache } from "../Provider.js";
+import {
+  useAlchemyConfig,
+  useClientCache,
+  useAdapter,
+} from "../context/AlchemyContext.js";
 import { getChain } from "../util/getChain.js";
 import { useEmbeddedWallet } from "./internal/useEmbeddedWallet.js";
 
@@ -34,7 +28,8 @@ import { useEmbeddedWallet } from "./internal/useEmbeddedWallet.js";
  * ```
  */
 export function useAlchemyClient() {
-  const { signAuthorization } = useSign7702Authorization();
+  const adapter = useAdapter();
+  const signAuthorizationFn = adapter.useAuthorizationSigner?.() || null;
   const config = useAlchemyConfig();
   const cache = useClientCache();
   const getEmbeddedWallet = useEmbeddedWallet();
@@ -97,23 +92,13 @@ export function useAlchemyClient() {
       "privy",
     );
 
-    // Extend signer with EIP-7702 authorization support
-    const signer = {
-      ...baseSigner,
-      signAuthorization: async (
-        unsignedAuth: AuthorizationRequest<number>,
-      ): Promise<Authorization<number, true>> => {
-        const signature = await signAuthorization({
-          ...unsignedAuth,
-          contractAddress: unsignedAuth.address ?? unsignedAuth.contractAddress,
-        });
-
-        return {
-          ...unsignedAuth,
-          ...signature,
-        };
-      },
-    };
+    // Extend signer with EIP-7702 authorization support (if available)
+    const signer = signAuthorizationFn
+      ? {
+          ...baseSigner,
+          signAuthorization: signAuthorizationFn,
+        }
+      : baseSigner;
 
     // Determine transport configuration using schema validation
     // This properly handles combinations like rpcUrl + jwt together
@@ -148,7 +133,7 @@ export function useAlchemyClient() {
   }, [
     getEmbeddedWallet,
     getEmbeddedWalletChain,
-    signAuthorization,
+    signAuthorizationFn,
     config.apiKey,
     config.jwt,
     config.rpcUrl,

package/src/index.ts

@@ -6,7 +6,6 @@ export { useAlchemyClient } from "./hooks/useAlchemyClient.js";
 export { useAlchemySendTransaction } from "./hooks/useAlchemySendTransaction.js";
 export { useAlchemyPrepareSwap } from "./hooks/useAlchemyPrepareSwap.js";
 export { useAlchemySubmitSwap } from "./hooks/useAlchemySubmitSwap.js";
-export { useAlchemySolanaTransaction } from "./hooks/useAlchemySolanaTransaction.js";
 
 // Types
 export type {

package/src/react-native.ts

@@ -0,0 +1,29 @@
+/**
+ * React Native (Expo) entry point
+ * Import from '@account-kit/privy-integration/react-native' in Expo apps
+ */
+
+// Provider
+export { AlchemyProvider } from "./providers/ReactNativeProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";
+
+// Hooks
+export { useAlchemyClient } from "./hooks/useAlchemyClient.js";
+export { useAlchemySendTransaction } from "./hooks/useAlchemySendTransaction.js";
+export { useAlchemyPrepareSwap } from "./hooks/useAlchemyPrepareSwap.js";
+export { useAlchemySubmitSwap } from "./hooks/useAlchemySubmitSwap.js";
+
+// Types
+export type {
+  AlchemyProviderConfig,
+  UnsignedTransactionRequest,
+  SendTransactionOptions,
+  SendTransactionResult,
+  UseSendTransactionResult,
+  PrepareSwapRequest,
+  PrepareSwapResult,
+  UsePrepareSwapResult,
+  SubmitSwapResult,
+  UseSubmitSwapResult,
+  SwapQuote,
+} from "./types.js";

package/src/solana.ts

@@ -0,0 +1,16 @@
+// Solana-specific exports
+// Import from '@account-kit/privy-integration/solana' to use Solana functionality
+// This ensures @solana/web3.js is only loaded when explicitly needed
+
+export { useAlchemySolanaTransaction } from "./hooks/useAlchemySolanaTransaction.js";
+
+export type {
+  PromiseOrValue,
+  PreSend,
+  TransformInstruction,
+  SolanaTransactionParamOptions,
+  SolanaTransactionParams,
+  SolanaTransactionResult,
+  UseAlchemySolanaTransactionOptions,
+  UseAlchemySolanaTransactionResult,
+} from "./hooks/useAlchemySolanaTransaction.js";

package/src/util/createSolanaSponsoredTransaction.ts

@@ -52,6 +52,7 @@ export async function createSolanaSponsoredTransaction(
     headers: {
       accept: "application/json",
       "content-type": "application/json",
+      "X-Alchemy-Client-Breadcrumb": "privyIntegrationSdk",
     },
     body,
   };

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "4.72.0";
+export const VERSION = "4.73.1-alpha.0";