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

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/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.73.0";
+export declare const VERSION = "4.73.1-alpha.1";
 //# 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.73.0",
+  "version": "4.73.1-alpha.1",
   "description": "Use Alchemy gas sponsorship, swaps and more with Privy",
   "author": "Alchemy",
   "license": "MIT",
@@ -27,6 +27,11 @@
       "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",
@@ -44,18 +49,26 @@
     "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.73.0",
-    "@account-kit/wallet-client": "^4.73.0"
+    "@account-kit/infra": "^4.73.1-alpha.1",
+    "@account-kit/wallet-client": "^4.73.1-alpha.1"
   },
   "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
     }
@@ -72,5 +85,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "1471537aa2b9e8cac4661b7162aa9c702efac7f1"
+  "gitHead": "03b2f5bff3d97e39f0be09eeaa6eb1f5a51631c6"
 }

package/src/adapters/react-native.ts

@@ -0,0 +1,149 @@
+import { useCallback } from "react";
+import {
+  usePrivy,
+  useEmbeddedEthereumWallet,
+  type PrivyEmbeddedWalletProvider,
+} from "@privy-io/expo";
+import type { Authorization } from "viem";
+import type { AuthorizationRequest } from "@aa-sdk/core";
+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 };
+  },
+
+  useAuthorizationSigner() {
+    const { wallets } = useEmbeddedEthereumWallet();
+
+    return useCallback(
+      async (
+        unsignedAuth: AuthorizationRequest<number>,
+      ): Promise<Authorization<number, true>> => {
+        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.",
+          );
+        }
+
+        const provider = await wallet.getProvider?.();
+        if (!provider) {
+          throw new Error(
+            "Provider not available on this wallet. Ensure you're using the embedded Ethereum wallet.",
+          );
+        }
+
+        // Extract the implementation address (handle both 'address' and 'contractAddress' fields)
+        const implementationAddress =
+          unsignedAuth.address ?? unsignedAuth.contractAddress;
+
+        if (!implementationAddress) {
+          throw new Error(
+            "Implementation address is required for EIP-7702 authorization",
+          );
+        }
+
+        // EIP-7702 Authorization structure
+        const authorization = {
+          domain: {
+            name: "EIP-7702",
+            version: "1",
+            chainId: unsignedAuth.chainId,
+          },
+          types: {
+            Authorization: [
+              { name: "chainId", type: "uint256" },
+              { name: "address", type: "address" },
+              { name: "nonce", type: "uint256" },
+            ],
+          },
+          primaryType: "Authorization" as const,
+          message: {
+            chainId: unsignedAuth.chainId,
+            address: implementationAddress,
+            nonce: unsignedAuth.nonce,
+          },
+        };
+
+        const signature = (await provider.request({
+          method: "eth_signTypedData_v4",
+          params: [wallet.address, JSON.stringify(authorization)],
+        })) as `0x${string}`;
+
+        // Parse the signature into r, s, v components
+        // Signature format: 0x[r(64)][s(64)][v(2)]
+        const r = `0x${signature.slice(2, 66)}` as `0x${string}`;
+        const s = `0x${signature.slice(66, 130)}` as `0x${string}`;
+        const v = parseInt(signature.slice(130, 132), 16);
+
+        // Convert v to yParity (0 or 1)
+        // v can be 27/28 (legacy) or 0/1 (EIP-155)
+        const yParity = v >= 27 ? v - 27 : v;
+
+        return {
+          chainId: unsignedAuth.chainId,
+          address: implementationAddress,
+          nonce: unsignedAuth.nonce,
+          r,
+          s,
+          yParity,
+        };
+      },
+      [wallets],
+    );
+  },
+};
+
+/**
+ * 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/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/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.73.0";
+export const VERSION = "4.73.1-alpha.1";