@account-kit/privy-integration 4.75.4 → 4.75.5-alpha.0

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

@@ -0,0 +1,38 @@
+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)
+ * @param {'eip7702' | 'owner'} [props.accountAuthMode] - Authorization mode for EVM smart accounts (default: 'eip7702')
+ * @param {string} [props.walletAddress] - Optional: Specify which wallet address to use (defaults to first embedded wallet)
+ * @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"
+ *     accountAuthMode="eip7702"
+ *     walletAddress="0x123..." // Optional: specify which wallet to use
+ *   >
+ *     <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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,2CAM1C"}

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

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;
+//# sourceMappingURL=WebProvider.native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.native.d.ts","sourceRoot":"","sources":["../../../src/providers/WebProvider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,SAK9B"}

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

@@ -24,6 +24,12 @@ export type AlchemyProviderConfig = z.infer<typeof ConnectionConfigSchema> & {
      * Default: false (sponsorship enabled when policyId is provided)
      */
     disableSponsorship?: boolean;
+    /**
+     * Optional: Specify which wallet address to use
+     * - If provided, will use the wallet matching this address
+     * - If not provided, defaults to the first embedded wallet (web) or first wallet in array (React Native)
+     */
+    walletAddress?: string;
 };
 /**
  * Unsigned transaction request

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.75.4";
+export declare const VERSION = "4.75.5-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.75.4",
+  "version": "4.75.5-alpha.0",
   "description": "Use Alchemy gas sponsorship, swaps and more with Privy",
   "author": "Alchemy",
   "license": "MIT",
@@ -11,9 +11,18 @@
   "types": "./dist/types/index.d.ts",
   "typings": "./dist/types/index.d.ts",
   "sideEffects": false,
+  "react-native": {
+    "main": "./dist/esm/react-native.js",
+    "./dist/esm/adapters/web.js": "./dist/esm/adapters/web.native.js",
+    "./dist/esm/providers/WebProvider.js": "./dist/esm/providers/WebProvider.native.js",
+    "./dist/esm/Provider.js": "./dist/esm/Provider.native.js",
+    "@privy-io/react-auth": false,
+    "@privy-io/react-auth/solana": false
+  },
   "files": [
     "dist",
     "src/**/*.ts",
+    "src/**/*.tsx",
     "!dist/**/*.tsbuildinfo",
     "!vitest.config.ts",
     "!.env",
@@ -23,10 +32,16 @@
   ],
   "exports": {
     ".": {
+      "react-native": "./dist/esm/react-native.js",
       "types": "./dist/types/index.d.ts",
       "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 +59,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.75.4",
-    "@account-kit/wallet-client": "^4.75.4"
+    "@account-kit/infra": "^4.75.5-alpha.0",
+    "@account-kit/wallet-client": "^4.75.5-alpha.0"
   },
   "peerDependencies": {
+    "@privy-io/expo": "^0.58.1",
     "@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 +95,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "39e31ecafce693ec77aa323ad534510727f2acfd"
+  "gitHead": "9d26a842cfa9082ea7f303974276b8fc8d9f8f2f"
 }

package/src/Provider.native.tsx

@@ -0,0 +1,18 @@
+/**
+ * React Native stub for web Provider
+ * This file prevents Metro from importing web-specific code
+ */
+
+export function AlchemyProvider() {
+  throw new Error(
+    "This module requires @privy-io/react-auth which is not available in React Native. " +
+      'Import from "@account-kit/privy-integration/react-native" instead.',
+  );
+}
+
+export function useAlchemyConfig() {
+  throw new Error(
+    "This module requires @privy-io/react-auth which is not available in React Native. " +
+      'Import from "@account-kit/privy-integration/react-native" instead.',
+  );
+}

package/src/Provider.tsx

@@ -0,0 +1,6 @@
+/**
+ * Web-specific exports
+ * Re-exports the web provider and hooks for React applications
+ */
+export { AlchemyProvider } from "./providers/WebProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";

package/src/adapters/react-native.ts

@@ -0,0 +1,202 @@
+import { useCallback } from "react";
+import {
+  usePrivy,
+  useEmbeddedEthereumWallet,
+  type PrivyEmbeddedWalletProvider,
+} from "@privy-io/expo";
+import type { Authorization } from "viem";
+import { hashAuthorization } from "viem/utils";
+import { parseSignature } 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(preferredAddress?: string) {
+    const { wallets } = useEmbeddedEthereumWallet();
+
+    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {
+      if (!wallets || wallets.length === 0) {
+        throw new Error(
+          "Privy embedded wallet not found. Please ensure the user is authenticated and has created a wallet.",
+        );
+      }
+
+      // If a preferred address is specified, find that wallet
+      const wallet = preferredAddress
+        ? wallets.find(
+            (w) => w.address.toLowerCase() === preferredAddress.toLowerCase(),
+          )
+        : wallets[0];
+
+      if (!wallet) {
+        throw new Error(
+          preferredAddress
+            ? `Privy embedded wallet with address ${preferredAddress} not found.`
+            : "Privy embedded wallet not found. Please ensure the user is authenticated and has created a wallet.",
+        );
+      }
+
+      return adaptExpoWallet(wallet);
+    }, [wallets, preferredAddress]);
+
+    return getEmbeddedWallet;
+  },
+
+  usePrivyAuth(): PrivyAuthState {
+    const { user } = usePrivy();
+    return { authenticated: !!user, user };
+  },
+
+  useWalletAddress(preferredAddress?: string): string | undefined {
+    const { wallets } = useEmbeddedEthereumWallet();
+
+    if (!wallets || wallets.length === 0) {
+      return undefined;
+    }
+
+    // If a preferred address is specified, find that wallet
+    if (preferredAddress) {
+      const wallet = wallets.find(
+        (w) => w.address.toLowerCase() === preferredAddress.toLowerCase(),
+      );
+      return wallet?.address;
+    }
+
+    // Otherwise return the first wallet
+    return wallets[0]?.address;
+  },
+
+  useAuthorizationSigner(preferredAddress?: string) {
+    const { wallets } = useEmbeddedEthereumWallet();
+
+    const signAuthorization = useCallback(
+      async (
+        unsignedAuth: AuthorizationRequest<number>,
+      ): Promise<Authorization<number, true>> => {
+        if (!wallets || wallets.length === 0) {
+          throw new Error(
+            "Privy embedded wallet not found. Please ensure the user is authenticated and has created a wallet.",
+          );
+        }
+
+        // If a preferred address is specified, find that wallet
+        const wallet = preferredAddress
+          ? wallets.find(
+              (w) => w.address.toLowerCase() === preferredAddress.toLowerCase(),
+            )
+          : wallets[0];
+
+        if (!wallet) {
+          throw new Error(
+            preferredAddress
+              ? `Privy embedded wallet with address ${preferredAddress} not found.`
+              : "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",
+          );
+        }
+
+        // Create the authorization structure (matches Privy's implementation)
+        const authorization = {
+          chainId: unsignedAuth.chainId,
+          address: implementationAddress,
+          nonce: unsignedAuth.nonce,
+        };
+
+        // Hash the authorization using viem (same as Privy does)
+        const authorizationHash = hashAuthorization(authorization);
+
+        // Sign the hash directly with secp256k1_sign (same as Privy)
+        const signature = (await provider.request({
+          method: "secp256k1_sign",
+          params: [authorizationHash],
+        })) as `0x${string}`;
+
+        // Parse the signature using viem (same as Privy)
+        const parsedSignature = parseSignature(signature);
+
+        return {
+          chainId: unsignedAuth.chainId,
+          address: implementationAddress,
+          nonce: unsignedAuth.nonce,
+          ...parsedSignature,
+        };
+      },
+      [wallets, preferredAddress],
+    );
+
+    return signAuthorization;
+  },
+};
+
+/**
+ * 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 {
+  // Use closure to maintain up-to-date chain ID across chain switches
+  let cachedChainId = wallet.chainId || "1";
+
+  return {
+    address: wallet.address as `0x${string}`,
+    get chainId() {
+      return cachedChainId;
+    },
+    getEthereumProvider: async () => {
+      if (!wallet.getProvider) {
+        throw new Error(
+          "getProvider is not available on this wallet. Ensure you're using the embedded Ethereum wallet.",
+        );
+      }
+      const provider = await wallet.getProvider();
+
+      // Always fetch current chain ID when provider is accessed
+      // This ensures we have the latest chain after wallet_switchEthereumChain calls
+      try {
+        const currentChainId = (await provider.request({
+          method: "eth_chainId",
+          params: [],
+        })) as string;
+
+        // Convert hex to decimal string format (e.g., "0x1" -> "1")
+        cachedChainId = parseInt(currentChainId, 16).toString();
+      } catch {
+        // Fall back to cached value if fetch fails
+        // Chain ID fetch errors are non-critical and can happen during initialization
+      }
+
+      return provider;
+    },
+  };
+}

package/src/adapters/types.ts

@@ -0,0 +1,71 @@
+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 as a string (may be CAIP-2 format like "eip155:1" or numeric string like "1") */
+  chainId: string;
+
+  /** 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)
+   *
+   * @param preferredAddress - Optional address to find a specific wallet
+   */
+  useEmbeddedWallet(preferredAddress?: string): () => EmbeddedWallet;
+
+  /**
+   * Hook to get Privy authentication state
+   * Must be called as a React hook (follows rules of hooks)
+   */
+  usePrivyAuth(): PrivyAuthState;
+
+  /**
+   * Hook to get current wallet address (for cache invalidation)
+   * Returns undefined if no wallet is available
+   * Must be called as a React hook (follows rules of hooks)
+   *
+   * @param preferredAddress - Optional address to find a specific wallet
+   */
+  useWalletAddress(preferredAddress?: string): string | undefined;
+
+  /**
+   * Hook to get EIP-7702 authorization signer (optional, web only)
+   * Must be called as a React hook (follows rules of hooks)
+   *
+   * @param preferredAddress - Optional address to find a specific wallet
+   */
+  useAuthorizationSigner?(
+    preferredAddress?: string,
+  ):
+    | ((
+        auth: AuthorizationRequest<number>,
+      ) => Promise<Authorization<number, true>>)
+    | null;
+}

package/src/adapters/web.native.ts

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for web adapter
+ * This file prevents Metro from importing @privy-io/react-auth
+ */
+
+export const webAdapter = null;

package/src/adapters/web.ts

@@ -0,0 +1,107 @@
+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(preferredAddress?: string) {
+    const { wallets } = useWallets();
+
+    const getEmbeddedWallet = useCallback((): EmbeddedWallet => {
+      const privyWallets = wallets.filter(
+        (w) => w.walletClientType === "privy",
+      );
+
+      if (privyWallets.length === 0) {
+        throw new Error(
+          "Privy embedded wallet not found. Please ensure the user is authenticated.",
+        );
+      }
+
+      // If a preferred address is specified, find that wallet
+      const embedded = preferredAddress
+        ? privyWallets.find(
+            (w) => w.address.toLowerCase() === preferredAddress.toLowerCase(),
+          )
+        : privyWallets[0];
+
+      if (!embedded) {
+        throw new Error(
+          preferredAddress
+            ? `Privy embedded wallet with address ${preferredAddress} not found.`
+            : "Privy embedded wallet not found. Please ensure the user is authenticated.",
+        );
+      }
+
+      return adaptWebWallet(embedded);
+    }, [wallets, preferredAddress]);
+
+    return getEmbeddedWallet;
+  },
+
+  usePrivyAuth(): PrivyAuthState {
+    const { user } = usePrivy();
+    return { authenticated: !!user, user };
+  },
+
+  useWalletAddress(preferredAddress?: string): string | undefined {
+    const { wallets } = useWallets();
+    const privyWallets = wallets.filter((w) => w.walletClientType === "privy");
+
+    // If a preferred address is specified, find that wallet
+    if (preferredAddress) {
+      const wallet = privyWallets.find(
+        (w) => w.address.toLowerCase() === preferredAddress.toLowerCase(),
+      );
+      return wallet?.address;
+    }
+
+    // Otherwise return the first embedded wallet
+    return privyWallets[0]?.address;
+  },
+
+  useAuthorizationSigner(_preferredAddress?: string) {
+    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(),
+  };
+}