@account-kit/privy-integration 4.75.4 → 4.76.0

package/dist/esm/hooks/useAlchemySendTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAlchemySendTransaction.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemySendTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAY,KAAK,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQlD;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,KAA+B;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,wBAAwB;IACxB,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,EAAE,SAAS,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAElC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA+B,IAAI,CAAC,CAAC;IAErE,MAAM,eAAe,GAAG,WAAW,CACjC,KAAK,EACH,KAAgE,EAChE,OAAgC,EACA,EAAE;QAClC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;YAE9C,+CAA+C;YAC/C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;YACtC,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC;YACrD,MAAM,aAAa,GACjB,OAAO,EAAE,kBAAkB,KAAK,SAAS;gBACvC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB;gBAC7B,CAAC,CAAC,WAAW,IAAI,iBAAiB,CAAC;YAEvC,iCAAiC;YACjC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1C,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;aACzD,CAAC,CAAC,CAAC;YAEJ,wDAAwD;YACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAC7C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;YAKpB,MAAM,YAAY,GAChB,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAEpE,IAAI,aAAa,IAAI,QAAQ,EAAE,CAAC;gBAC9B,YAAY,CAAC,gBAAgB,GAAG,EAAE,QAAQ,EAAE,CAAC;YAC/C,CAAC;YAED,yDAAyD;YACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;gBACpC,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,KAAK,EAAE,cAAc;gBACrB,YAAY;aACb,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;gBAC/C,EAAE,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC7B,OAAO,EAAE,KAAM;aAChB,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC;YACxD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,QAAQ,GAA0B,EAAE,OAAO,EAAE,CAAC;YACpD,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GACZ,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC/D,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnB,MAAM,QAAQ,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD;QACE,SAAS;QACT,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,kBAAkB;QACzB,MAAM,CAAC,eAAe;KACvB,CACF,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,eAAe;QACf,SAAS;QACT,KAAK;QACL,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { type Hex, isHex } from \"viem\";\nimport { useAlchemyClient } from \"./useAlchemyClient.js\";\nimport { useAlchemyConfig } from \"../Provider.js\";\nimport type {\n  UnsignedTransactionRequest,\n  SendTransactionOptions,\n  SendTransactionResult,\n  UseSendTransactionResult,\n} from \"../types\";\n\n/**\n * Normalize value to hex format\n * Accepts bigint, number, decimal string, or hex string\n *\n * @param {string | number | bigint} value - Value to normalize\n * @returns {Hex} Hex string representation of the value\n */\nfunction normalizeValue(value: string | number | bigint): Hex {\n  if (typeof value === \"bigint\") {\n    return `0x${value.toString(16)}`;\n  }\n  if (typeof value === \"number\") {\n    return `0x${BigInt(value).toString(16)}`;\n  }\n  if (isHex(value)) {\n    return value;\n  }\n  // Assume decimal string\n  return `0x${BigInt(value).toString(16)}`;\n}\n\n/**\n * Hook to send transactions with optional gas sponsorship via Alchemy\n * Supports both single transactions and batch transactions\n * Drop-in alternative to Privy's useSendTransaction hook\n *\n * @returns {UseSendTransactionResult} Hook result with sendTransaction function and state\n *\n * @example Single transaction\n * ```tsx\n * const { sendTransaction, isLoading, error, data } = useAlchemySendTransaction();\n *\n * const handleSend = async () => {\n *   try {\n *     const result = await sendTransaction({\n *       to: '0x...',\n *       data: '0x...',\n *       value: '1000000000000000000', // 1 ETH\n *     });\n *     console.log('Transaction hash:', result.txnHash);\n *   } catch (err) {\n *     console.error('Transaction failed:', err);\n *   }\n * };\n * ```\n *\n * @example Batch transactions\n * ```tsx\n * const { sendTransaction } = useAlchemySendTransaction();\n *\n * const result = await sendTransaction([\n *   { to: '0x...', data: '0x...', value: '1000000000000000000' },\n *   { to: '0x...', data: '0x...' },\n * ]);\n * ```\n */\nexport function useAlchemySendTransaction(): UseSendTransactionResult {\n  const { getClient } = useAlchemyClient();\n  const config = useAlchemyConfig();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<SendTransactionResult | null>(null);\n\n  const sendTransaction = useCallback(\n    async (\n      input: UnsignedTransactionRequest | UnsignedTransactionRequest[],\n      options?: SendTransactionOptions,\n    ): Promise<SendTransactionResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const { client, account } = await getClient();\n\n        // Determine if transaction should be sponsored\n        const hasPolicyId = !!config.policyId;\n        const enableSponsorship = !config.disableSponsorship;\n        const shouldSponsor =\n          options?.disableSponsorship !== undefined\n            ? !options.disableSponsorship\n            : hasPolicyId && enableSponsorship;\n\n        // Format the transaction call(s)\n        const inputs = Array.isArray(input) ? input : [input];\n        const formattedCalls = inputs.map((txn) => ({\n          to: txn.to,\n          data: txn.data,\n          value: txn.value ? normalizeValue(txn.value) : undefined,\n        }));\n\n        // Build capabilities based on sponsorship and auth mode\n        const policyId = Array.isArray(config.policyId)\n          ? config.policyId[0]\n          : config.policyId;\n\n        type Capabilities =\n          | { eip7702Auth: true; paymasterService?: { policyId: string } }\n          | { paymasterService?: { policyId: string } };\n        const capabilities: Capabilities =\n          config.accountAuthMode === \"eip7702\" ? { eip7702Auth: true } : {};\n\n        if (shouldSponsor && policyId) {\n          capabilities.paymasterService = { policyId };\n        }\n\n        // Send the transaction(s) from the smart account address\n        const result = await client.sendCalls({\n          from: account.address,\n          calls: formattedCalls,\n          capabilities,\n        });\n\n        if (!result.preparedCallIds || result.preparedCallIds.length === 0) {\n          throw new Error(\n            \"No prepared call IDs returned from transaction submission\",\n          );\n        }\n\n        // Wait for the transaction to be confirmed\n        const txStatus = await client.waitForCallsStatus({\n          id: result.preparedCallIds[0],\n          timeout: 60_000,\n        });\n\n        const txnHash = txStatus.receipts?.[0]?.transactionHash;\n        if (!txnHash) {\n          throw new Error(\"Transaction hash not found in receipt\");\n        }\n\n        const txResult: SendTransactionResult = { txnHash };\n        setData(txResult);\n        return txResult;\n      } catch (err) {\n        const errorObj =\n          err instanceof Error ? err : new Error(\"Transaction failed\");\n        setError(errorObj);\n        throw errorObj;\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [\n      getClient,\n      config.policyId,\n      config.disableSponsorship,\n      config.accountAuthMode,\n    ],\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    setData(null);\n    setIsLoading(false);\n  }, []);\n\n  return {\n    sendTransaction,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n"]}
+{"version":3,"file":"useAlchemySendTransaction.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemySendTransaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { type Hex, isHex } from \"viem\";\nimport { useAlchemyClient } from \"./useAlchemyClient.js\";\nimport { useAlchemyConfig } from \"../context/AlchemyContext.js\";\nimport type {\n  UnsignedTransactionRequest,\n  SendTransactionOptions,\n  SendTransactionResult,\n  UseSendTransactionResult,\n} from \"../types\";\n\n/**\n * Normalize value to hex format\n * Accepts bigint, number, decimal string, or hex string\n *\n * @param {string | number | bigint} value - Value to normalize\n * @returns {Hex} Hex string representation of the value\n */\nfunction normalizeValue(value: string | number | bigint): Hex {\n  if (typeof value === \"bigint\") {\n    return `0x${value.toString(16)}`;\n  }\n  if (typeof value === \"number\") {\n    return `0x${BigInt(value).toString(16)}`;\n  }\n  if (isHex(value)) {\n    return value;\n  }\n  // Assume decimal string\n  return `0x${BigInt(value).toString(16)}`;\n}\n\n/**\n * Hook to send transactions with optional gas sponsorship via Alchemy\n * Supports both single transactions and batch transactions\n * Drop-in alternative to Privy's useSendTransaction hook\n *\n * @returns {UseSendTransactionResult} Hook result with sendTransaction function and state\n *\n * @example Single transaction\n * ```tsx\n * const { sendTransaction, isLoading, error, data } = useAlchemySendTransaction();\n *\n * const handleSend = async () => {\n *   try {\n *     const result = await sendTransaction({\n *       to: '0x...',\n *       data: '0x...',\n *       value: '1000000000000000000', // 1 ETH\n *     });\n *     console.log('Transaction hash:', result.txnHash);\n *   } catch (err) {\n *     console.error('Transaction failed:', err);\n *   }\n * };\n * ```\n *\n * @example Batch transactions\n * ```tsx\n * const { sendTransaction } = useAlchemySendTransaction();\n *\n * const result = await sendTransaction([\n *   { to: '0x...', data: '0x...', value: '1000000000000000000' },\n *   { to: '0x...', data: '0x...' },\n * ]);\n * ```\n */\nexport function useAlchemySendTransaction(): UseSendTransactionResult {\n  const { getClient } = useAlchemyClient();\n  const config = useAlchemyConfig();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<SendTransactionResult | null>(null);\n\n  const sendTransaction = useCallback(\n    async (\n      input: UnsignedTransactionRequest | UnsignedTransactionRequest[],\n      options?: SendTransactionOptions,\n    ): Promise<SendTransactionResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const { client, account } = await getClient();\n\n        // Determine if transaction should be sponsored\n        const hasPolicyId = !!config.policyId;\n        const enableSponsorship = !config.disableSponsorship;\n        const shouldSponsor =\n          options?.disableSponsorship !== undefined\n            ? !options.disableSponsorship\n            : hasPolicyId && enableSponsorship;\n\n        // Format the transaction call(s)\n        const inputs = Array.isArray(input) ? input : [input];\n        const formattedCalls = inputs.map((txn) => ({\n          to: txn.to,\n          data: txn.data,\n          value: txn.value ? normalizeValue(txn.value) : undefined,\n        }));\n\n        // Build capabilities based on sponsorship and auth mode\n        const policyId = Array.isArray(config.policyId)\n          ? config.policyId[0]\n          : config.policyId;\n\n        type Capabilities =\n          | { eip7702Auth: true; paymasterService?: { policyId: string } }\n          | { paymasterService?: { policyId: string } };\n        const capabilities: Capabilities =\n          config.accountAuthMode === \"eip7702\" ? { eip7702Auth: true } : {};\n\n        if (shouldSponsor && policyId) {\n          capabilities.paymasterService = { policyId };\n        }\n\n        // Send the transaction(s) from the smart account address\n        const result = await client.sendCalls({\n          from: account.address,\n          calls: formattedCalls,\n          capabilities,\n        });\n\n        if (!result.preparedCallIds || result.preparedCallIds.length === 0) {\n          throw new Error(\n            \"No prepared call IDs returned from transaction submission\",\n          );\n        }\n\n        // Wait for the transaction to be confirmed\n        const txStatus = await client.waitForCallsStatus({\n          id: result.preparedCallIds[0],\n          timeout: 60_000,\n        });\n\n        const txnHash = txStatus.receipts?.[0]?.transactionHash;\n        if (!txnHash) {\n          throw new Error(\"Transaction hash not found in receipt\");\n        }\n\n        const txResult: SendTransactionResult = { txnHash };\n        setData(txResult);\n        return txResult;\n      } catch (err) {\n        const errorObj =\n          err instanceof Error ? err : new Error(\"Transaction failed\");\n        setError(errorObj);\n        throw errorObj;\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [\n      getClient,\n      config.policyId,\n      config.disableSponsorship,\n      config.accountAuthMode,\n    ],\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    setData(null);\n    setIsLoading(false);\n  }, []);\n\n  return {\n    sendTransaction,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n"]}

package/dist/esm/hooks/useAlchemySolanaTransaction.js

@@ -1,6 +1,6 @@
 import { useCallback, useMemo, useState } from "react";
 import { Connection, PublicKey, SystemProgram, Transaction, TransactionInstruction, VersionedTransaction, } from "@solana/web3.js";
-import { useAlchemyConfig } from "../Provider.js";
+import { useAlchemyConfig } from "../context/AlchemyContext.js";
 import { createSolanaSponsoredTransaction } from "../util/createSolanaSponsoredTransaction.js";
 import { useSignTransaction, useWallets } from "@privy-io/react-auth/solana";
 import { createSolanaTransaction } from "../util/createSolanaTransaction.js";

package/dist/esm/hooks/useAlchemySolanaTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAlchemySolanaTransaction.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemySolanaTransaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  TransactionInstruction,\n  VersionedTransaction,\n} from \"@solana/web3.js\";\nimport { useAlchemyConfig } from \"../Provider.js\";\nimport { createSolanaSponsoredTransaction } from \"../util/createSolanaSponsoredTransaction.js\";\nimport { useSignTransaction, useWallets } from \"@privy-io/react-auth/solana\";\nimport { createSolanaTransaction } from \"../util/createSolanaTransaction.js\";\n\n/**\n * Type helper for values that can be synchronous or asynchronous\n *\n * @template T - The value type\n */\nexport type PromiseOrValue<T> = T | Promise<T>;\n\n/**\n * Callback to modify a transaction before it's signed\n * Useful for adding additional signatures or metadata\n *\n * @param transaction - The unsigned transaction to modify\n * @returns The modified transaction\n */\nexport type PreSend = (\n  this: void,\n  transaction: VersionedTransaction | Transaction,\n) => PromiseOrValue<VersionedTransaction | Transaction>;\n\n/**\n * Callback to transform instructions into a custom transaction\n * Useful for advanced transaction construction (e.g., multi-sig, custom versioning)\n *\n * @param instructions - Array of Solana transaction instructions\n * @returns Constructed transaction (legacy or versioned)\n */\nexport type TransformInstruction = (\n  this: void,\n  instructions: TransactionInstruction[],\n) => PromiseOrValue<Transaction | VersionedTransaction>;\n\n/**\n * Optional transaction lifecycle hooks for advanced use cases\n */\nexport type SolanaTransactionParamOptions = {\n  /** Hook called before signing the transaction */\n  preSend?: PreSend;\n  /** Custom transaction builder from instructions */\n  transformInstruction?: TransformInstruction;\n};\n\n/**\n * Parameters for sending a Solana transaction\n * Supports either a simple transfer or custom instructions\n */\nexport type SolanaTransactionParams =\n  | {\n      /** Simple SOL transfer parameters */\n      transfer: {\n        /** Amount in lamports (accepts number or bigint) */\n        amount: number | bigint;\n        /** Recipient's base58-encoded address */\n        toAddress: string;\n      };\n      /** Optional transaction lifecycle hooks */\n      transactionComponents?: SolanaTransactionParamOptions;\n      /** Options for confirming the transaction on-chain */\n      confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n    }\n  | {\n      /** Custom Solana transaction instructions */\n      instructions: TransactionInstruction[];\n      /** Optional transaction lifecycle hooks */\n      transactionComponents?: SolanaTransactionParamOptions;\n      /** Options for confirming the transaction on-chain */\n      confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n    };\n\n/**\n * Result of a successful Solana transaction\n */\nexport interface SolanaTransactionResult {\n  /** Base58-encoded transaction signature (hash) */\n  hash: string;\n}\n\n/**\n * Configuration options for useAlchemySolanaTransaction hook\n */\nexport interface UseAlchemySolanaTransactionOptions {\n  /** Solana RPC URL (overrides provider config) */\n  rpcUrl?: string;\n  /** Gas sponsorship policy ID (overrides provider config) */\n  policyId?: string | void;\n  /** Transaction confirmation options */\n  confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n  /** Specific wallet address to use (defaults to first available wallet) */\n  walletAddress?: string;\n}\n\n/**\n * Return type of useAlchemySolanaTransaction hook\n */\nexport interface UseAlchemySolanaTransactionResult {\n  /** Active Solana connection instance */\n  readonly connection: Connection | null;\n  /** Transaction result if successful */\n  readonly data: void | SolanaTransactionResult;\n  /** Whether a transaction is currently being sent */\n  readonly isPending: boolean;\n  /** Error if transaction failed */\n  readonly error: Error | null;\n  /** Reset hook state (clears error, data, isPending) */\n  reset(): void;\n  /** Send transaction (fire-and-forget, errors caught internally) */\n  sendTransaction(params: SolanaTransactionParams): void;\n  /** Send transaction and await result (throws on error) */\n  sendTransactionAsync(\n    params: SolanaTransactionParams,\n  ): Promise<SolanaTransactionResult>;\n}\n\n/**\n * Hook to send Solana transactions with optional gas sponsorship via Alchemy\n * Works with Privy's Solana wallet integration for signing transactions\n * Supports both simple transfers and custom instruction sets\n *\n * @param {UseAlchemySolanaTransactionOptions} [opts] - Configuration options\n * @param {string} [opts.rpcUrl] - Solana RPC URL (overrides provider config)\n * @param {string} [opts.policyId] - Gas sponsorship policy ID (overrides provider config)\n * @param {string} [opts.walletAddress] - Specific wallet address to use (defaults to first wallet)\n * @param {Parameters<Connection[\"confirmTransaction\"]>[1]} [opts.confirmationOptions] - Transaction confirmation options\n * @returns {UseAlchemySolanaTransactionResult} Hook result with transaction functions and state\n *\n * @example Simple SOL transfer\n * ```tsx\n * const { sendTransactionAsync, isPending, error, data } = useAlchemySolanaTransaction({\n *   rpcUrl: 'https://solana-mainnet.g.alchemy.com/v2/your-api-key',\n *   policyId: 'your-policy-id', // Optional: for gas sponsorship\n * });\n *\n * const handleTransfer = async () => {\n *   try {\n *     const result = await sendTransactionAsync({\n *       transfer: {\n *         amount: 1_000_000_000, // 1 SOL in lamports\n *         toAddress: 'recipient-address',\n *       },\n *     });\n *     console.log('Transaction hash:', result.hash);\n *   } catch (err) {\n *     console.error('Transaction failed:', err);\n *   }\n * };\n * ```\n *\n * @example Custom instructions\n * ```tsx\n * import { SystemProgram, PublicKey } from '@solana/web3.js';\n *\n * const { sendTransactionAsync } = useAlchemySolanaTransaction();\n *\n * // Build your custom instructions\n * const transferIx = SystemProgram.transfer({\n *   fromPubkey: new PublicKey(walletAddress),\n *   toPubkey: new PublicKey(recipientAddress),\n *   lamports: 1_000_000,\n * });\n *\n * // Pass instructions array to the hook\n * const result = await sendTransactionAsync({\n *   instructions: [transferIx],\n * });\n * ```\n *\n * @example With provider configuration\n * ```tsx\n * // In your provider setup\n * <AlchemyProvider\n *   solanaRpcUrl=\"https://solana-mainnet.g.alchemy.com/v2/...\"\n *   solanaPolicyId=\"your-solana-policy-id\"\n * >\n *   <YourApp />\n * </AlchemyProvider>\n *\n * // In your component - uses provider config automatically\n * const { sendTransactionAsync } = useAlchemySolanaTransaction();\n * ```\n */\nexport function useAlchemySolanaTransaction(\n  opts: UseAlchemySolanaTransactionOptions = {},\n): UseAlchemySolanaTransactionResult {\n  const config = useAlchemyConfig();\n  const { wallets } = useWallets();\n  const { signTransaction } = useSignTransaction();\n\n  // Resolve the Privy Solana wallet to use\n  const embeddedWallet = useMemo(() => {\n    if (opts.walletAddress) {\n      const w = wallets.find((w) => w.address === opts.walletAddress);\n      if (!w) throw new Error(\"Specified Solana wallet not found\");\n      return w;\n    }\n    return wallets[0];\n  }, [wallets, opts.walletAddress]);\n\n  // Build Solana connection from rpcUrl (hook override or provider default)\n  const connection = useMemo(() => {\n    const url = opts.rpcUrl || config.solanaRpcUrl;\n    return url ? new Connection(url) : null;\n  }, [opts.rpcUrl, config.solanaRpcUrl]);\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<void | SolanaTransactionResult>(undefined);\n\n  const resolvedPolicyId = useMemo(() => {\n    if (opts.policyId != null) return opts.policyId || undefined;\n    // Use solanaPolicyId from config, fallback to policyId for backwards compat\n    const configPolicy = config.solanaPolicyId || config.policyId;\n    return Array.isArray(configPolicy) ? configPolicy[0] : configPolicy;\n  }, [opts.policyId, config.solanaPolicyId, config.policyId]);\n\n  const mapTransformInstructions = useMemo(() => {\n    const addSponsorship: TransformInstruction = async (instructions) => {\n      const policyId = resolvedPolicyId;\n      if (!policyId)\n        throw new Error(\n          \"Gas sponsorship requires a policyId (see provider or hook options).\",\n        );\n      const localConnection = connection || missing(\"connection\");\n      const fromAddress = embeddedWallet?.address;\n      if (!fromAddress) throw new Error(\"No embedded Solana wallet connected\");\n      return createSolanaSponsoredTransaction(\n        instructions,\n        localConnection,\n        policyId,\n        fromAddress,\n      );\n    };\n    const createTx: TransformInstruction = async (instructions) => {\n      const localConnection = connection || missing(\"connection\");\n      const fromAddress = embeddedWallet?.address;\n      if (!fromAddress) throw new Error(\"No embedded Solana wallet connected\");\n      return createSolanaTransaction(\n        instructions,\n        localConnection,\n        fromAddress,\n      );\n    };\n    const defaultTransform =\n      !!resolvedPolicyId && !config.disableSponsorship\n        ? addSponsorship\n        : createTx;\n    return {\n      addSponsorship,\n      createTransaction: createTx,\n      default: defaultTransform,\n    } as const;\n  }, [\n    resolvedPolicyId,\n    config.disableSponsorship,\n    connection,\n    embeddedWallet?.address,\n  ]);\n\n  const buildInstructions = useCallback(\n    (\n      params: SolanaTransactionParams,\n      fromAddress: string,\n    ): TransactionInstruction[] => {\n      if (\"instructions\" in params) return params.instructions;\n      return [\n        SystemProgram.transfer({\n          fromPubkey: new PublicKey(fromAddress),\n          toPubkey: new PublicKey(params.transfer.toAddress),\n          lamports:\n            typeof params.transfer.amount === \"bigint\"\n              ? Number(params.transfer.amount) // web3.js currently expects number; callers can pass bigint safely\n              : params.transfer.amount,\n        }),\n      ];\n    },\n    [],\n  );\n\n  function toUnsignedBytes(tx: VersionedTransaction | Transaction): Uint8Array {\n    // Serialize the full transaction structure (with placeholder signatures)\n    // Privy expects the complete transaction format, not just the message\n    if (tx instanceof VersionedTransaction) {\n      // VersionedTransaction.serialize() includes signature slots\n      return tx.serialize();\n    }\n    // Legacy Transaction: serialize without requiring all signatures\n    const buf = tx.serialize({\n      requireAllSignatures: false,\n      verifySignatures: false,\n    });\n    return buf instanceof Uint8Array ? buf : new Uint8Array(buf);\n  }\n\n  const sendTransactionAsync = useCallback(\n    async (\n      params: SolanaTransactionParams,\n    ): Promise<SolanaTransactionResult> => {\n      setIsPending(true);\n      setError(null);\n      try {\n        const localConnection = connection || missing(\"connection\");\n        if (!embeddedWallet?.address) {\n          throw new Error(\"No Solana wallet connected via Privy\");\n        }\n\n        const fromAddress = embeddedWallet.address;\n        const {\n          transactionComponents: { preSend, transformInstruction } = {},\n          confirmationOptions,\n        } = params;\n\n        const instructions = buildInstructions(params, fromAddress);\n\n        let transaction: VersionedTransaction | Transaction;\n        if (transformInstruction) {\n          transaction = await transformInstruction(instructions);\n        } else {\n          transaction = await mapTransformInstructions.default(instructions);\n        }\n\n        transaction = (await preSend?.(transaction)) || transaction;\n\n        // Sign the transaction using Privy's useSignTransaction hook\n        const unsignedBytes = toUnsignedBytes(transaction);\n        const { signedTransaction } = await signTransaction({\n          transaction: unsignedBytes,\n          wallet: embeddedWallet,\n        });\n\n        // Broadcast the signed transaction\n        const hash = await localConnection.sendRawTransaction(\n          signedTransaction,\n          { skipPreflight: false },\n        );\n\n        if (confirmationOptions || opts.confirmationOptions) {\n          await localConnection.confirmTransaction(\n            hash,\n            confirmationOptions || opts.confirmationOptions,\n          );\n        }\n\n        setData({ hash });\n        return { hash };\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        throw e;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [\n      embeddedWallet,\n      connection,\n      buildInstructions,\n      mapTransformInstructions,\n      opts.confirmationOptions,\n      signTransaction,\n    ],\n  );\n\n  const sendTransaction = useCallback(\n    (params: SolanaTransactionParams) => {\n      // Prevent unhandled rejection warnings; error state is already set in sendTransactionAsync\n      sendTransactionAsync(params).catch(() => {});\n    },\n    [sendTransactionAsync],\n  );\n\n  const reset = useCallback(() => {\n    setIsPending(false);\n    setError(null);\n    setData(undefined);\n  }, []);\n\n  return {\n    connection,\n    data,\n    isPending,\n    error,\n    reset,\n    sendTransaction,\n    sendTransactionAsync,\n  };\n}\n\nfunction missing(message: string): never {\n  throw new Error(message);\n}\n"]}
+{"version":3,"file":"useAlchemySolanaTransaction.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemySolanaTransaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  TransactionInstruction,\n  VersionedTransaction,\n} from \"@solana/web3.js\";\nimport { useAlchemyConfig } from \"../context/AlchemyContext.js\";\nimport { createSolanaSponsoredTransaction } from \"../util/createSolanaSponsoredTransaction.js\";\nimport { useSignTransaction, useWallets } from \"@privy-io/react-auth/solana\";\nimport { createSolanaTransaction } from \"../util/createSolanaTransaction.js\";\n\n/**\n * Type helper for values that can be synchronous or asynchronous\n *\n * @template T - The value type\n */\nexport type PromiseOrValue<T> = T | Promise<T>;\n\n/**\n * Callback to modify a transaction before it's signed\n * Useful for adding additional signatures or metadata\n *\n * @param transaction - The unsigned transaction to modify\n * @returns The modified transaction\n */\nexport type PreSend = (\n  this: void,\n  transaction: VersionedTransaction | Transaction,\n) => PromiseOrValue<VersionedTransaction | Transaction>;\n\n/**\n * Callback to transform instructions into a custom transaction\n * Useful for advanced transaction construction (e.g., multi-sig, custom versioning)\n *\n * @param instructions - Array of Solana transaction instructions\n * @returns Constructed transaction (legacy or versioned)\n */\nexport type TransformInstruction = (\n  this: void,\n  instructions: TransactionInstruction[],\n) => PromiseOrValue<Transaction | VersionedTransaction>;\n\n/**\n * Optional transaction lifecycle hooks for advanced use cases\n */\nexport type SolanaTransactionParamOptions = {\n  /** Hook called before signing the transaction */\n  preSend?: PreSend;\n  /** Custom transaction builder from instructions */\n  transformInstruction?: TransformInstruction;\n};\n\n/**\n * Parameters for sending a Solana transaction\n * Supports either a simple transfer or custom instructions\n */\nexport type SolanaTransactionParams =\n  | {\n      /** Simple SOL transfer parameters */\n      transfer: {\n        /** Amount in lamports (accepts number or bigint) */\n        amount: number | bigint;\n        /** Recipient's base58-encoded address */\n        toAddress: string;\n      };\n      /** Optional transaction lifecycle hooks */\n      transactionComponents?: SolanaTransactionParamOptions;\n      /** Options for confirming the transaction on-chain */\n      confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n    }\n  | {\n      /** Custom Solana transaction instructions */\n      instructions: TransactionInstruction[];\n      /** Optional transaction lifecycle hooks */\n      transactionComponents?: SolanaTransactionParamOptions;\n      /** Options for confirming the transaction on-chain */\n      confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n    };\n\n/**\n * Result of a successful Solana transaction\n */\nexport interface SolanaTransactionResult {\n  /** Base58-encoded transaction signature (hash) */\n  hash: string;\n}\n\n/**\n * Configuration options for useAlchemySolanaTransaction hook\n */\nexport interface UseAlchemySolanaTransactionOptions {\n  /** Solana RPC URL (overrides provider config) */\n  rpcUrl?: string;\n  /** Gas sponsorship policy ID (overrides provider config) */\n  policyId?: string | void;\n  /** Transaction confirmation options */\n  confirmationOptions?: Parameters<Connection[\"confirmTransaction\"]>[1];\n  /** Specific wallet address to use (defaults to first available wallet) */\n  walletAddress?: string;\n}\n\n/**\n * Return type of useAlchemySolanaTransaction hook\n */\nexport interface UseAlchemySolanaTransactionResult {\n  /** Active Solana connection instance */\n  readonly connection: Connection | null;\n  /** Transaction result if successful */\n  readonly data: void | SolanaTransactionResult;\n  /** Whether a transaction is currently being sent */\n  readonly isPending: boolean;\n  /** Error if transaction failed */\n  readonly error: Error | null;\n  /** Reset hook state (clears error, data, isPending) */\n  reset(): void;\n  /** Send transaction (fire-and-forget, errors caught internally) */\n  sendTransaction(params: SolanaTransactionParams): void;\n  /** Send transaction and await result (throws on error) */\n  sendTransactionAsync(\n    params: SolanaTransactionParams,\n  ): Promise<SolanaTransactionResult>;\n}\n\n/**\n * Hook to send Solana transactions with optional gas sponsorship via Alchemy\n * Works with Privy's Solana wallet integration for signing transactions\n * Supports both simple transfers and custom instruction sets\n *\n * @param {UseAlchemySolanaTransactionOptions} [opts] - Configuration options\n * @param {string} [opts.rpcUrl] - Solana RPC URL (overrides provider config)\n * @param {string} [opts.policyId] - Gas sponsorship policy ID (overrides provider config)\n * @param {string} [opts.walletAddress] - Specific wallet address to use (defaults to first wallet)\n * @param {Parameters<Connection[\"confirmTransaction\"]>[1]} [opts.confirmationOptions] - Transaction confirmation options\n * @returns {UseAlchemySolanaTransactionResult} Hook result with transaction functions and state\n *\n * @example Simple SOL transfer\n * ```tsx\n * const { sendTransactionAsync, isPending, error, data } = useAlchemySolanaTransaction({\n *   rpcUrl: 'https://solana-mainnet.g.alchemy.com/v2/your-api-key',\n *   policyId: 'your-policy-id', // Optional: for gas sponsorship\n * });\n *\n * const handleTransfer = async () => {\n *   try {\n *     const result = await sendTransactionAsync({\n *       transfer: {\n *         amount: 1_000_000_000, // 1 SOL in lamports\n *         toAddress: 'recipient-address',\n *       },\n *     });\n *     console.log('Transaction hash:', result.hash);\n *   } catch (err) {\n *     console.error('Transaction failed:', err);\n *   }\n * };\n * ```\n *\n * @example Custom instructions\n * ```tsx\n * import { SystemProgram, PublicKey } from '@solana/web3.js';\n *\n * const { sendTransactionAsync } = useAlchemySolanaTransaction();\n *\n * // Build your custom instructions\n * const transferIx = SystemProgram.transfer({\n *   fromPubkey: new PublicKey(walletAddress),\n *   toPubkey: new PublicKey(recipientAddress),\n *   lamports: 1_000_000,\n * });\n *\n * // Pass instructions array to the hook\n * const result = await sendTransactionAsync({\n *   instructions: [transferIx],\n * });\n * ```\n *\n * @example With provider configuration\n * ```tsx\n * // In your provider setup\n * <AlchemyProvider\n *   solanaRpcUrl=\"https://solana-mainnet.g.alchemy.com/v2/...\"\n *   solanaPolicyId=\"your-solana-policy-id\"\n * >\n *   <YourApp />\n * </AlchemyProvider>\n *\n * // In your component - uses provider config automatically\n * const { sendTransactionAsync } = useAlchemySolanaTransaction();\n * ```\n */\nexport function useAlchemySolanaTransaction(\n  opts: UseAlchemySolanaTransactionOptions = {},\n): UseAlchemySolanaTransactionResult {\n  const config = useAlchemyConfig();\n  const { wallets } = useWallets();\n  const { signTransaction } = useSignTransaction();\n\n  // Resolve the Privy Solana wallet to use\n  const embeddedWallet = useMemo(() => {\n    if (opts.walletAddress) {\n      const w = wallets.find((w) => w.address === opts.walletAddress);\n      if (!w) throw new Error(\"Specified Solana wallet not found\");\n      return w;\n    }\n    return wallets[0];\n  }, [wallets, opts.walletAddress]);\n\n  // Build Solana connection from rpcUrl (hook override or provider default)\n  const connection = useMemo(() => {\n    const url = opts.rpcUrl || config.solanaRpcUrl;\n    return url ? new Connection(url) : null;\n  }, [opts.rpcUrl, config.solanaRpcUrl]);\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<void | SolanaTransactionResult>(undefined);\n\n  const resolvedPolicyId = useMemo(() => {\n    if (opts.policyId != null) return opts.policyId || undefined;\n    // Use solanaPolicyId from config, fallback to policyId for backwards compat\n    const configPolicy = config.solanaPolicyId || config.policyId;\n    return Array.isArray(configPolicy) ? configPolicy[0] : configPolicy;\n  }, [opts.policyId, config.solanaPolicyId, config.policyId]);\n\n  const mapTransformInstructions = useMemo(() => {\n    const addSponsorship: TransformInstruction = async (instructions) => {\n      const policyId = resolvedPolicyId;\n      if (!policyId)\n        throw new Error(\n          \"Gas sponsorship requires a policyId (see provider or hook options).\",\n        );\n      const localConnection = connection || missing(\"connection\");\n      const fromAddress = embeddedWallet?.address;\n      if (!fromAddress) throw new Error(\"No embedded Solana wallet connected\");\n      return createSolanaSponsoredTransaction(\n        instructions,\n        localConnection,\n        policyId,\n        fromAddress,\n      );\n    };\n    const createTx: TransformInstruction = async (instructions) => {\n      const localConnection = connection || missing(\"connection\");\n      const fromAddress = embeddedWallet?.address;\n      if (!fromAddress) throw new Error(\"No embedded Solana wallet connected\");\n      return createSolanaTransaction(\n        instructions,\n        localConnection,\n        fromAddress,\n      );\n    };\n    const defaultTransform =\n      !!resolvedPolicyId && !config.disableSponsorship\n        ? addSponsorship\n        : createTx;\n    return {\n      addSponsorship,\n      createTransaction: createTx,\n      default: defaultTransform,\n    } as const;\n  }, [\n    resolvedPolicyId,\n    config.disableSponsorship,\n    connection,\n    embeddedWallet?.address,\n  ]);\n\n  const buildInstructions = useCallback(\n    (\n      params: SolanaTransactionParams,\n      fromAddress: string,\n    ): TransactionInstruction[] => {\n      if (\"instructions\" in params) return params.instructions;\n      return [\n        SystemProgram.transfer({\n          fromPubkey: new PublicKey(fromAddress),\n          toPubkey: new PublicKey(params.transfer.toAddress),\n          lamports:\n            typeof params.transfer.amount === \"bigint\"\n              ? Number(params.transfer.amount) // web3.js currently expects number; callers can pass bigint safely\n              : params.transfer.amount,\n        }),\n      ];\n    },\n    [],\n  );\n\n  function toUnsignedBytes(tx: VersionedTransaction | Transaction): Uint8Array {\n    // Serialize the full transaction structure (with placeholder signatures)\n    // Privy expects the complete transaction format, not just the message\n    if (tx instanceof VersionedTransaction) {\n      // VersionedTransaction.serialize() includes signature slots\n      return tx.serialize();\n    }\n    // Legacy Transaction: serialize without requiring all signatures\n    const buf = tx.serialize({\n      requireAllSignatures: false,\n      verifySignatures: false,\n    });\n    return buf instanceof Uint8Array ? buf : new Uint8Array(buf);\n  }\n\n  const sendTransactionAsync = useCallback(\n    async (\n      params: SolanaTransactionParams,\n    ): Promise<SolanaTransactionResult> => {\n      setIsPending(true);\n      setError(null);\n      try {\n        const localConnection = connection || missing(\"connection\");\n        if (!embeddedWallet?.address) {\n          throw new Error(\"No Solana wallet connected via Privy\");\n        }\n\n        const fromAddress = embeddedWallet.address;\n        const {\n          transactionComponents: { preSend, transformInstruction } = {},\n          confirmationOptions,\n        } = params;\n\n        const instructions = buildInstructions(params, fromAddress);\n\n        let transaction: VersionedTransaction | Transaction;\n        if (transformInstruction) {\n          transaction = await transformInstruction(instructions);\n        } else {\n          transaction = await mapTransformInstructions.default(instructions);\n        }\n\n        transaction = (await preSend?.(transaction)) || transaction;\n\n        // Sign the transaction using Privy's useSignTransaction hook\n        const unsignedBytes = toUnsignedBytes(transaction);\n        const { signedTransaction } = await signTransaction({\n          transaction: unsignedBytes,\n          wallet: embeddedWallet,\n        });\n\n        // Broadcast the signed transaction\n        const hash = await localConnection.sendRawTransaction(\n          signedTransaction,\n          { skipPreflight: false },\n        );\n\n        if (confirmationOptions || opts.confirmationOptions) {\n          await localConnection.confirmTransaction(\n            hash,\n            confirmationOptions || opts.confirmationOptions,\n          );\n        }\n\n        setData({ hash });\n        return { hash };\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        throw e;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [\n      embeddedWallet,\n      connection,\n      buildInstructions,\n      mapTransformInstructions,\n      opts.confirmationOptions,\n      signTransaction,\n    ],\n  );\n\n  const sendTransaction = useCallback(\n    (params: SolanaTransactionParams) => {\n      // Prevent unhandled rejection warnings; error state is already set in sendTransactionAsync\n      sendTransactionAsync(params).catch(() => {});\n    },\n    [sendTransactionAsync],\n  );\n\n  const reset = useCallback(() => {\n    setIsPending(false);\n    setError(null);\n    setData(undefined);\n  }, []);\n\n  return {\n    connection,\n    data,\n    isPending,\n    error,\n    reset,\n    sendTransaction,\n    sendTransactionAsync,\n  };\n}\n\nfunction missing(message: string): never {\n  throw new Error(message);\n}\n"]}

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

@@ -0,0 +1,37 @@
+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)
+ * @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 wallet in array)
+ * @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"
+ *     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;

package/dist/esm/providers/ReactNativeProvider.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AlchemyContextProvider } from "../context/AlchemyContext.js";
+import { reactNativeAdapter } from "../adapters/react-native.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)
+ * @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 wallet in array)
+ * @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"
+ *     accountAuthMode="eip7702"
+ *     walletAddress="0x123..." // Optional: specify which wallet to use
+ *   >
+ *     <YourApp />
+ *   </AlchemyProvider>
+ * </PrivyProvider>
+ * ```
+ */
+export function AlchemyProvider({ children, ...config }) {
+    return (_jsx(AlchemyContextProvider, { config: config, adapter: reactNativeAdapter, children: children }));
+}
+//# sourceMappingURL=ReactNativeProvider.js.map

package/dist/esm/providers/ReactNativeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeProvider.js","sourceRoot":"","sources":["../../../src/providers/ReactNativeProvider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACgC;IACzC,OAAO,CACL,KAAC,sBAAsB,IAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,YAChE,QAAQ,GACc,CAC1B,CAAC;AACJ,CAAC","sourcesContent":["import type { PropsWithChildren } from \"react\";\nimport { AlchemyContextProvider } from \"../context/AlchemyContext.js\";\nimport { reactNativeAdapter } from \"../adapters/react-native.js\";\nimport type { AlchemyProviderConfig } from \"../types.js\";\n\n/**\n * Provider component for React Native (Expo) applications\n * Must be nested INSIDE PrivyProvider from @privy-io/expo\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 * @param {'eip7702' | 'owner'} [props.accountAuthMode] - Authorization mode for EVM smart accounts (default: 'eip7702')\n * @param {string} [props.walletAddress] - Optional: Specify which wallet address to use (defaults to first wallet in array)\n * @returns {JSX.Element} Provider component\n *\n * @example\n * ```tsx\n * import { PrivyProvider } from '@privy-io/expo';\n * import { AlchemyProvider } from '@account-kit/privy-integration/react-native';\n *\n * <PrivyProvider appId=\"...\" clientId=\"...\">\n *   <AlchemyProvider\n *     apiKey=\"your-alchemy-api-key\"\n *     policyId=\"your-gas-policy-id\"\n *     accountAuthMode=\"eip7702\"\n *     walletAddress=\"0x123...\" // Optional: specify which wallet to use\n *   >\n *     <YourApp />\n *   </AlchemyProvider>\n * </PrivyProvider>\n * ```\n */\nexport function AlchemyProvider({\n  children,\n  ...config\n}: PropsWithChildren<AlchemyProviderConfig>) {\n  return (\n    <AlchemyContextProvider config={config} adapter={reactNativeAdapter}>\n      {children}\n    </AlchemyContextProvider>\n  );\n}\n"]}

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

@@ -0,0 +1,37 @@
+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;

package/dist/esm/providers/WebProvider.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AlchemyContextProvider } from "../context/AlchemyContext.js";
+import { webAdapter } from "../adapters/web.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 function AlchemyProvider({ children, ...config }) {
+    return (_jsx(AlchemyContextProvider, { config: config, adapter: webAdapter, children: children }));
+}
+//# sourceMappingURL=WebProvider.js.map

package/dist/esm/providers/WebProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.js","sourceRoot":"","sources":["../../../src/providers/WebProvider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,GAAG,MAAM,EACgC;IACzC,OAAO,CACL,KAAC,sBAAsB,IAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,YACxD,QAAQ,GACc,CAC1B,CAAC;AACJ,CAAC","sourcesContent":["import type { PropsWithChildren } from \"react\";\nimport { AlchemyContextProvider } from \"../context/AlchemyContext.js\";\nimport { webAdapter } from \"../adapters/web.js\";\nimport type { AlchemyProviderConfig } from \"../types.js\";\n\n/**\n * Provider component for React web applications\n * Must be nested INSIDE PrivyProvider from @privy-io/react-auth\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 * @param {'eip7702' | 'owner'} [props.accountAuthMode] - Authorization mode for EVM smart accounts (default: 'eip7702')\n * @param {string} [props.walletAddress] - Optional: Specify which wallet address to use (defaults to first embedded wallet)\n * @returns {JSX.Element} Provider component\n *\n * @example\n * ```tsx\n * import { PrivyProvider } from '@privy-io/react-auth';\n * import { AlchemyProvider } from '@account-kit/privy-integration';\n *\n * <PrivyProvider appId=\"...\">\n *   <AlchemyProvider\n *     apiKey=\"your-alchemy-api-key\"\n *     policyId=\"your-gas-policy-id\"\n *     accountAuthMode=\"eip7702\"\n *     walletAddress=\"0x123...\" // Optional: specify which wallet to use\n *   >\n *     <YourApp />\n *   </AlchemyProvider>\n * </PrivyProvider>\n * ```\n */\nexport function AlchemyProvider({\n  children,\n  ...config\n}: PropsWithChildren<AlchemyProviderConfig>) {\n  return (\n    <AlchemyContextProvider config={config} adapter={webAdapter}>\n      {children}\n    </AlchemyContextProvider>\n  );\n}\n"]}

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

@@ -0,0 +1,5 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;

package/dist/esm/providers/WebProvider.native.js

@@ -0,0 +1,9 @@
+/**
+ * React Native stub for WebProvider
+ * 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.');
+}
+//# sourceMappingURL=WebProvider.native.js.map

package/dist/esm/providers/WebProvider.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.native.js","sourceRoot":"","sources":["../../../src/providers/WebProvider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,oEAAoE,CACvE,CAAC;AACJ,CAAC","sourcesContent":["/**\n * React Native stub for WebProvider\n * This file prevents Metro from importing web-specific code\n */\n\nexport function AlchemyProvider() {\n  throw new Error(\n    \"This module requires @privy-io/react-auth which is not available in React Native. \" +\n      'Import from \"@account-kit/privy-integration/react-native\" instead.',\n  );\n}\n"]}

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

@@ -0,0 +1,11 @@
+/**
+ * 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";

package/dist/esm/react-native.js

@@ -0,0 +1,13 @@
+/**
+ * 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";
+//# sourceMappingURL=react-native.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../../src/react-native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,QAAQ;AACR,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","sourcesContent":["/**\n * React Native (Expo) entry point\n * Import from '@account-kit/privy-integration/react-native' in Expo apps\n */\n\n// Provider\nexport { AlchemyProvider } from \"./providers/ReactNativeProvider.js\";\nexport { useAlchemyConfig } from \"./context/AlchemyContext.js\";\n\n// Hooks\nexport { useAlchemyClient } from \"./hooks/useAlchemyClient.js\";\nexport { useAlchemySendTransaction } from \"./hooks/useAlchemySendTransaction.js\";\nexport { useAlchemyPrepareSwap } from \"./hooks/useAlchemyPrepareSwap.js\";\nexport { useAlchemySubmitSwap } from \"./hooks/useAlchemySubmitSwap.js\";\n\n// Types\nexport type {\n  AlchemyProviderConfig,\n  UnsignedTransactionRequest,\n  SendTransactionOptions,\n  SendTransactionResult,\n  UseSendTransactionResult,\n  PrepareSwapRequest,\n  PrepareSwapResult,\n  UsePrepareSwapResult,\n  SubmitSwapResult,\n  UseSubmitSwapResult,\n  SwapQuote,\n} from \"./types.js\";\n"]}

package/dist/esm/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/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import type { Address, Hash, Hex } from \"viem\";\nimport type { swapActions } from \"@account-kit/wallet-client/experimental\";\nimport { ConnectionConfigSchema } from \"@aa-sdk/core\";\nimport type { z } from \"zod\";\n\n/**\n * Configuration for the Alchemy provider\n * Uses ConnectionConfigSchema to ensure valid transport configuration\n */\nexport type AlchemyProviderConfig = z.infer<typeof ConnectionConfigSchema> & {\n  /** Policy ID(s) for EVM gas sponsorship */\n  policyId?: string | string[];\n\n  /** Policy ID(s) for Solana gas sponsorship */\n  solanaPolicyId?: string | string[];\n\n  /** Solana RPC URL (separate from EVM rpcUrl) */\n  solanaRpcUrl?: string;\n\n  /**\n   * How EVM smart account calls should be authorized.\n   * - 'eip7702' (default): delegated authorization via EIP-7702.\n   * - 'owner': sign as the account owner (Privy embedded wallet), no 7702.\n   */\n  accountAuthMode?: \"eip7702\" | \"owner\";\n\n  /**\n   * Set to true to disable gas sponsorship by default\n   * Default: false (sponsorship enabled when policyId is provided)\n   */\n  disableSponsorship?: boolean;\n};\n\n/**\n * Unsigned transaction request\n */\nexport interface UnsignedTransactionRequest {\n  /** Recipient address */\n  to: Address;\n\n  /** Transaction data (calldata) */\n  data?: Hex;\n\n  /** Transaction value - accepts string | number | bigint */\n  value?: string | number | bigint;\n}\n\n/**\n * Options for sending a transaction\n */\nexport interface SendTransactionOptions {\n  /**\n   * Set to true to disable sponsorship for this specific transaction\n   * Default: false (follows provider's disableSponsorship setting)\n   */\n  disableSponsorship?: boolean;\n}\n\n/**\n * Result of a successful transaction\n */\nexport interface SendTransactionResult {\n  /** EVM transaction hash (first receipt hash) */\n  txnHash: Hash;\n}\n\n/**\n * Hook result for sending transactions\n */\nexport interface UseSendTransactionResult {\n  /** Whether the transaction is currently being sent */\n  isLoading: boolean;\n\n  /** Error if transaction failed */\n  error: Error | null;\n\n  /** Transaction result if successful */\n  data: SendTransactionResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Send a single transaction or batch of transactions */\n  sendTransaction(\n    input: UnsignedTransactionRequest | UnsignedTransactionRequest[],\n    options?: SendTransactionOptions,\n  ): Promise<SendTransactionResult>;\n}\n\n/**\n * Request parameters for preparing a swap\n * Derived directly from the SDK to ensure type safety\n *\n * Note: Provide either `fromAmount` OR `minimumToAmount`, not both.\n * - Use `fromAmount` to specify exact amount to swap FROM\n * - Use `minimumToAmount` to specify minimum amount to receive TO\n */\nexport type PrepareSwapRequest = Parameters<\n  ReturnType<typeof swapActions>[\"requestQuoteV0\"]\n>[0];\n\n/**\n * Response from requestQuoteV0\n * Derived directly from the SDK to ensure type safety\n */\nexport type RequestQuoteV0Result = Awaited<\n  ReturnType<ReturnType<typeof swapActions>[\"requestQuoteV0\"]>\n>;\n\n/**\n * Swap quote information extracted from prepared swap calls\n * Derived directly from the SDK response\n */\nexport type SwapQuote = NonNullable<RequestQuoteV0Result[\"quote\"]>;\n\n/**\n * Result of preparing a swap (full response from requestQuoteV0)\n * Contains quote and prepared calls ready for signing\n */\nexport type PrepareSwapResult = Extract<\n  RequestQuoteV0Result,\n  { rawCalls?: false | undefined }\n>;\n\n/**\n * Hook result for preparing swaps\n */\nexport interface UsePrepareSwapResult {\n  /** Whether the swap is being prepared */\n  isLoading: boolean;\n\n  /** Error if preparation failed */\n  error: Error | null;\n\n  /** Prepared swap data if successful */\n  data: PrepareSwapResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Request a swap quote and prepare calls */\n  prepareSwap(request: PrepareSwapRequest): Promise<PrepareSwapResult>;\n}\n\n/**\n * Result of submitting a swap\n * Simplified wrapper that extracts the transaction hash\n */\nexport interface SubmitSwapResult {\n  /** Transaction hash of the swap */\n  txnHash: Hash;\n}\n\n/**\n * Hook result for submitting swaps\n */\nexport interface UseSubmitSwapResult {\n  /** Whether the swap is being submitted */\n  isLoading: boolean;\n\n  /** Error if submission failed */\n  error: Error | null;\n\n  /** Swap submission result if successful */\n  data: SubmitSwapResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Sign and submit prepared swap calls */\n  submitSwap(preparedSwap: PrepareSwapResult): Promise<SubmitSwapResult>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import type { Address, Hash, Hex } from \"viem\";\nimport type { swapActions } from \"@account-kit/wallet-client/experimental\";\nimport { ConnectionConfigSchema } from \"@aa-sdk/core\";\nimport type { z } from \"zod\";\n\n/**\n * Configuration for the Alchemy provider\n * Uses ConnectionConfigSchema to ensure valid transport configuration\n */\nexport type AlchemyProviderConfig = z.infer<typeof ConnectionConfigSchema> & {\n  /** Policy ID(s) for EVM gas sponsorship */\n  policyId?: string | string[];\n\n  /** Policy ID(s) for Solana gas sponsorship */\n  solanaPolicyId?: string | string[];\n\n  /** Solana RPC URL (separate from EVM rpcUrl) */\n  solanaRpcUrl?: string;\n\n  /**\n   * How EVM smart account calls should be authorized.\n   * - 'eip7702' (default): delegated authorization via EIP-7702.\n   * - 'owner': sign as the account owner (Privy embedded wallet), no 7702.\n   */\n  accountAuthMode?: \"eip7702\" | \"owner\";\n\n  /**\n   * Set to true to disable gas sponsorship by default\n   * Default: false (sponsorship enabled when policyId is provided)\n   */\n  disableSponsorship?: boolean;\n\n  /**\n   * Optional: Specify which wallet address to use\n   * - If provided, will use the wallet matching this address\n   * - If not provided, defaults to the first embedded wallet (web) or first wallet in array (React Native)\n   */\n  walletAddress?: string;\n};\n\n/**\n * Unsigned transaction request\n */\nexport interface UnsignedTransactionRequest {\n  /** Recipient address */\n  to: Address;\n\n  /** Transaction data (calldata) */\n  data?: Hex;\n\n  /** Transaction value - accepts string | number | bigint */\n  value?: string | number | bigint;\n}\n\n/**\n * Options for sending a transaction\n */\nexport interface SendTransactionOptions {\n  /**\n   * Set to true to disable sponsorship for this specific transaction\n   * Default: false (follows provider's disableSponsorship setting)\n   */\n  disableSponsorship?: boolean;\n}\n\n/**\n * Result of a successful transaction\n */\nexport interface SendTransactionResult {\n  /** EVM transaction hash (first receipt hash) */\n  txnHash: Hash;\n}\n\n/**\n * Hook result for sending transactions\n */\nexport interface UseSendTransactionResult {\n  /** Whether the transaction is currently being sent */\n  isLoading: boolean;\n\n  /** Error if transaction failed */\n  error: Error | null;\n\n  /** Transaction result if successful */\n  data: SendTransactionResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Send a single transaction or batch of transactions */\n  sendTransaction(\n    input: UnsignedTransactionRequest | UnsignedTransactionRequest[],\n    options?: SendTransactionOptions,\n  ): Promise<SendTransactionResult>;\n}\n\n/**\n * Request parameters for preparing a swap\n * Derived directly from the SDK to ensure type safety\n *\n * Note: Provide either `fromAmount` OR `minimumToAmount`, not both.\n * - Use `fromAmount` to specify exact amount to swap FROM\n * - Use `minimumToAmount` to specify minimum amount to receive TO\n */\nexport type PrepareSwapRequest = Parameters<\n  ReturnType<typeof swapActions>[\"requestQuoteV0\"]\n>[0];\n\n/**\n * Response from requestQuoteV0\n * Derived directly from the SDK to ensure type safety\n */\nexport type RequestQuoteV0Result = Awaited<\n  ReturnType<ReturnType<typeof swapActions>[\"requestQuoteV0\"]>\n>;\n\n/**\n * Swap quote information extracted from prepared swap calls\n * Derived directly from the SDK response\n */\nexport type SwapQuote = NonNullable<RequestQuoteV0Result[\"quote\"]>;\n\n/**\n * Result of preparing a swap (full response from requestQuoteV0)\n * Contains quote and prepared calls ready for signing\n */\nexport type PrepareSwapResult = Extract<\n  RequestQuoteV0Result,\n  { rawCalls?: false | undefined }\n>;\n\n/**\n * Hook result for preparing swaps\n */\nexport interface UsePrepareSwapResult {\n  /** Whether the swap is being prepared */\n  isLoading: boolean;\n\n  /** Error if preparation failed */\n  error: Error | null;\n\n  /** Prepared swap data if successful */\n  data: PrepareSwapResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Request a swap quote and prepare calls */\n  prepareSwap(request: PrepareSwapRequest): Promise<PrepareSwapResult>;\n}\n\n/**\n * Result of submitting a swap\n * Simplified wrapper that extracts the transaction hash\n */\nexport interface SubmitSwapResult {\n  /** Transaction hash of the swap */\n  txnHash: Hash;\n}\n\n/**\n * Hook result for submitting swaps\n */\nexport interface UseSubmitSwapResult {\n  /** Whether the swap is being submitted */\n  isLoading: boolean;\n\n  /** Error if submission failed */\n  error: Error | null;\n\n  /** Swap submission result if successful */\n  data: SubmitSwapResult | null;\n\n  /** Reset the hook state */\n  reset(): void;\n\n  /** Sign and submit prepared swap calls */\n  submitSwap(preparedSwap: PrepareSwapResult): Promise<SubmitSwapResult>;\n}\n"]}

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "4.75.4";
+export declare const VERSION = "4.76.0";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "4.75.4";
+export const VERSION = "4.76.0";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.75.4\";\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.76.0\";\n"]}

package/dist/types/Provider.d.ts

@@ -1,74 +1,7 @@
-import { type PropsWithChildren } from "react";
-import type { SmartWalletClient } from "@account-kit/wallet-client";
-import type { SmartContractAccount } from "@aa-sdk/core";
-import type { AlchemyProviderConfig } from "./types.js";
 /**
- * Normalized config with defaults applied
- *
- * @internal
+ * Web-specific exports
+ * Re-exports the web provider and hooks for React applications
  */
-export type NormalizedAlchemyConfig = AlchemyProviderConfig & Required<Pick<AlchemyProviderConfig, "accountAuthMode">>;
-/**
- * Client cache stored in React tree (similar to QueryClient in React Query)
- *
- * @internal
- */
-interface ClientCache {
-    client: SmartWalletClient | null;
-    account: SmartContractAccount | 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)
- * @param {'eip7702' | 'owner'} [props.accountAuthMode] - Authorization mode for EVM smart accounts (default: 'eip7702')
- * @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, accountAuthMode, ...config }: PropsWithChildren<AlchemyProviderConfig>): import("react/jsx-runtime").JSX.Element;
-/**
- * Hook to access Alchemy provider configuration
- * Must be used within an <AlchemyProvider> component
- *
- * @returns {NormalizedAlchemyConfig} The current Alchemy configuration with defaults applied
- * @throws {Error} If used outside of AlchemyProvider
- *
- * @example
- * ```tsx
- * const config = useAlchemyConfig();
- * console.log('Policy ID:', config.policyId);
- * console.log('Auth Mode:', config.accountAuthMode); // Always defined
- * ```
- */
-export declare function useAlchemyConfig(): NormalizedAlchemyConfig;
-/**
- * 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";
 //# sourceMappingURL=Provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/Provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAKvB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GACzD,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAI3D;;;;GAIG;AACH,UAAU,WAAW;IACnB,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,eAA2B,EAC3B,GAAG,MAAM,EACV,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,2CA0D1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,uBAAuB,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAQ5C"}
+{"version":3,"file":"Provider.d.ts","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"}

package/dist/types/Provider.native.d.ts

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

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

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

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

@@ -0,0 +1,7 @@
+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;
+//# sourceMappingURL=react-native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../../src/adapters/react-native.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,YAAY,CAAC;AAY/E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,YA6IhC,CAAC"}

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

@@ -0,0 +1,57 @@
+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;
+}
+//# sourceMappingURL=types.d.ts.map