@account-kit/privy-integration 4.68.0

package/dist/esm/hooks/useAlchemyClient.js

@@ -0,0 +1,119 @@
+import { useCallback } from "react";
+import { WalletClientSigner, ConnectionConfigSchema, } from "@aa-sdk/core";
+import { createWalletClient, custom, } from "viem";
+import { useSign7702Authorization } from "@privy-io/react-auth";
+import { createSmartWalletClient, } from "@account-kit/wallet-client";
+import { alchemy } from "@account-kit/infra";
+import { useAlchemyConfig, useClientCache } from "../Provider.js";
+import { getChain } from "../util/getChain.js";
+import { useEmbeddedWallet } from "./internal/useEmbeddedWallet.js";
+/**
+ * Hook to get and memoize a SmartWalletClient instance
+ * The client is cached in the AlchemyProvider context (React tree scoped)
+ * Automatically clears cache on logout via the provider
+ *
+ * @returns {{ getClient: () => Promise<SmartWalletClient> }} Object containing the smart wallet client getter
+ *
+ * @example
+ * ```tsx
+ * const { getClient } = useAlchemyClient();
+ * const smartWalletClient = await getClient();
+ * ```
+ */
+export function useAlchemyClient() {
+    const { signAuthorization } = useSign7702Authorization();
+    const config = useAlchemyConfig();
+    const cache = useClientCache();
+    const getEmbeddedWallet = useEmbeddedWallet();
+    const getEmbeddedWalletChain = useCallback(() => {
+        const embedded = getEmbeddedWallet();
+        // Handle CAIP-2 format like "eip155:1"
+        const chainIdStr = embedded.chainId?.toString();
+        if (!chainIdStr) {
+            throw new Error("Embedded wallet chainId is not set. Please ensure the wallet is connected to a network.");
+        }
+        const numericChainId = chainIdStr.includes(":")
+            ? chainIdStr.split(":")[1]
+            : chainIdStr;
+        const parsedChainId = Number(numericChainId);
+        if (isNaN(parsedChainId)) {
+            throw new Error(`Failed to parse chainId from embedded wallet. Received: ${chainIdStr}`);
+        }
+        return getChain(parsedChainId);
+    }, [getEmbeddedWallet]);
+    const getClient = useCallback(async () => {
+        const embeddedWallet = getEmbeddedWallet();
+        const chain = getEmbeddedWalletChain();
+        // Generate a cache key based on configuration and wallet address
+        const currentCacheKey = JSON.stringify({
+            address: embeddedWallet.address,
+            chainId: chain.id,
+            apiKey: config.apiKey,
+            jwt: config.jwt,
+            rpcUrl: config.rpcUrl,
+            policyId: config.policyId,
+        });
+        // Return cached client if configuration hasn't changed
+        if (cache.client && cache.cacheKey === currentCacheKey) {
+            return cache.client;
+        }
+        // Configuration changed or no cache exists, create new client
+        const provider = await embeddedWallet.getEthereumProvider();
+        // Create base signer from Privy wallet
+        const baseSigner = new WalletClientSigner(createWalletClient({
+            account: embeddedWallet.address,
+            chain,
+            transport: custom(provider),
+        }), "privy");
+        // Extend signer with EIP-7702 authorization support
+        const signer = {
+            ...baseSigner,
+            signAuthorization: async (unsignedAuth) => {
+                const signature = await signAuthorization({
+                    ...unsignedAuth,
+                    contractAddress: unsignedAuth.address ?? unsignedAuth.contractAddress,
+                });
+                return {
+                    ...unsignedAuth,
+                    ...signature,
+                };
+            },
+        };
+        // Determine transport configuration using schema validation
+        // This properly handles combinations like rpcUrl + jwt together
+        const transportConfig = ConnectionConfigSchema.parse({
+            rpcUrl: config.rpcUrl,
+            apiKey: config.apiKey,
+            jwt: config.jwt,
+        });
+        const transport = alchemy(transportConfig);
+        transport.updateHeaders({
+            "X-Alchemy-Client-Breadcrumb": "privyIntegrationSdk",
+        });
+        // Create and cache the smart wallet client in provider context
+        cache.client = createSmartWalletClient({
+            chain,
+            transport,
+            signer,
+            policyIds: config.policyId
+                ? Array.isArray(config.policyId)
+                    ? config.policyId
+                    : [config.policyId]
+                : undefined,
+        });
+        // Store the cache key
+        cache.cacheKey = currentCacheKey;
+        return cache.client;
+    }, [
+        getEmbeddedWallet,
+        getEmbeddedWalletChain,
+        signAuthorization,
+        config.apiKey,
+        config.jwt,
+        config.rpcUrl,
+        config.policyId,
+        cache,
+    ]);
+    return { getClient };
+}
+//# sourceMappingURL=useAlchemyClient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAlchemyClient.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemyClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,kBAAkB,EAElB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,MAAM,GAGP,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,uBAAuB,GAExB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,iBAAiB,EAAE,GAAG,wBAAwB,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;IAE9C,MAAM,sBAAsB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9C,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,uCAAuC;QACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;QAEhD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC7C,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC,CAAC,UAAU,CAAC;QAEf,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,2DAA2D,UAAU,EAAE,CACxE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExB,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAgC,EAAE;QACnE,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;QAEvC,iEAAiE;QACjE,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;YACrC,OAAO,EAAE,cAAc,CAAC,OAAO;YAC/B,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QAEH,uDAAuD;QACvD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QAED,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,mBAAmB,EAAE,CAAC;QAE5D,uCAAuC;QACvC,MAAM,UAAU,GAAG,IAAI,kBAAkB,CACvC,kBAAkB,CAAC;YACjB,OAAO,EAAE,cAAc,CAAC,OAAkB;YAC1C,KAAK;YACL,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC;SAC5B,CAAC,EACF,OAAO,CACR,CAAC;QAEF,oDAAoD;QACpD,MAAM,MAAM,GAAG;YACb,GAAG,UAAU;YACb,iBAAiB,EAAE,KAAK,EACtB,YAA0C,EACJ,EAAE;gBACxC,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC;oBACxC,GAAG,YAAY;oBACf,eAAe,EAAE,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,eAAe;iBACtE,CAAC,CAAC;gBAEH,OAAO;oBACL,GAAG,YAAY;oBACf,GAAG,SAAS;iBACb,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,4DAA4D;QAC5D,gEAAgE;QAChE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC;YACnD,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAE3C,SAAS,CAAC,aAAa,CAAC;YACtB,6BAA6B,EAAE,qBAAqB;SACrD,CAAC,CAAC;QAEH,+DAA+D;QAC/D,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC;YACrC,KAAK;YACL,SAAS;YACT,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,QAAQ;gBACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAC9B,CAAC,CAAC,MAAM,CAAC,QAAQ;oBACjB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACrB,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,sBAAsB;QACtB,KAAK,CAAC,QAAQ,GAAG,eAAe,CAAC;QAEjC,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC,EAAE;QACD,iBAAiB;QACjB,sBAAsB;QACtB,iBAAiB;QACjB,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,GAAG;QACV,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,QAAQ;QACf,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  WalletClientSigner,\n  type AuthorizationRequest,\n  ConnectionConfigSchema,\n} from \"@aa-sdk/core\";\nimport {\n  createWalletClient,\n  custom,\n  type Address,\n  type Authorization,\n} from \"viem\";\nimport { useSign7702Authorization } from \"@privy-io/react-auth\";\nimport {\n  createSmartWalletClient,\n  type SmartWalletClient,\n} from \"@account-kit/wallet-client\";\nimport { alchemy } from \"@account-kit/infra\";\nimport { useAlchemyConfig, useClientCache } from \"../Provider.js\";\nimport { getChain } from \"../util/getChain.js\";\nimport { useEmbeddedWallet } from \"./internal/useEmbeddedWallet.js\";\n\n/**\n * Hook to get and memoize a SmartWalletClient instance\n * The client is cached in the AlchemyProvider context (React tree scoped)\n * Automatically clears cache on logout via the provider\n *\n * @returns {{ getClient: () => Promise<SmartWalletClient> }} Object containing the smart wallet client getter\n *\n * @example\n * ```tsx\n * const { getClient } = useAlchemyClient();\n * const smartWalletClient = await getClient();\n * ```\n */\nexport function useAlchemyClient() {\n  const { signAuthorization } = useSign7702Authorization();\n  const config = useAlchemyConfig();\n  const cache = useClientCache();\n  const getEmbeddedWallet = useEmbeddedWallet();\n\n  const getEmbeddedWalletChain = useCallback(() => {\n    const embedded = getEmbeddedWallet();\n    // Handle CAIP-2 format like \"eip155:1\"\n    const chainIdStr = embedded.chainId?.toString();\n\n    if (!chainIdStr) {\n      throw new Error(\n        \"Embedded wallet chainId is not set. Please ensure the wallet is connected to a network.\",\n      );\n    }\n\n    const numericChainId = chainIdStr.includes(\":\")\n      ? chainIdStr.split(\":\")[1]\n      : chainIdStr;\n\n    const parsedChainId = Number(numericChainId);\n\n    if (isNaN(parsedChainId)) {\n      throw new Error(\n        `Failed to parse chainId from embedded wallet. Received: ${chainIdStr}`,\n      );\n    }\n\n    return getChain(parsedChainId);\n  }, [getEmbeddedWallet]);\n\n  const getClient = useCallback(async (): Promise<SmartWalletClient> => {\n    const embeddedWallet = getEmbeddedWallet();\n    const chain = getEmbeddedWalletChain();\n\n    // Generate a cache key based on configuration and wallet address\n    const currentCacheKey = JSON.stringify({\n      address: embeddedWallet.address,\n      chainId: chain.id,\n      apiKey: config.apiKey,\n      jwt: config.jwt,\n      rpcUrl: config.rpcUrl,\n      policyId: config.policyId,\n    });\n\n    // Return cached client if configuration hasn't changed\n    if (cache.client && cache.cacheKey === currentCacheKey) {\n      return cache.client;\n    }\n\n    // Configuration changed or no cache exists, create new client\n    const provider = await embeddedWallet.getEthereumProvider();\n\n    // Create base signer from Privy wallet\n    const baseSigner = new WalletClientSigner(\n      createWalletClient({\n        account: embeddedWallet.address as Address,\n        chain,\n        transport: custom(provider),\n      }),\n      \"privy\",\n    );\n\n    // Extend signer with EIP-7702 authorization support\n    const signer = {\n      ...baseSigner,\n      signAuthorization: async (\n        unsignedAuth: AuthorizationRequest<number>,\n      ): Promise<Authorization<number, true>> => {\n        const signature = await signAuthorization({\n          ...unsignedAuth,\n          contractAddress: unsignedAuth.address ?? unsignedAuth.contractAddress,\n        });\n\n        return {\n          ...unsignedAuth,\n          ...signature,\n        };\n      },\n    };\n\n    // Determine transport configuration using schema validation\n    // This properly handles combinations like rpcUrl + jwt together\n    const transportConfig = ConnectionConfigSchema.parse({\n      rpcUrl: config.rpcUrl,\n      apiKey: config.apiKey,\n      jwt: config.jwt,\n    });\n\n    const transport = alchemy(transportConfig);\n\n    transport.updateHeaders({\n      \"X-Alchemy-Client-Breadcrumb\": \"privyIntegrationSdk\",\n    });\n\n    // Create and cache the smart wallet client in provider context\n    cache.client = createSmartWalletClient({\n      chain,\n      transport,\n      signer,\n      policyIds: config.policyId\n        ? Array.isArray(config.policyId)\n          ? config.policyId\n          : [config.policyId]\n        : undefined,\n    });\n\n    // Store the cache key\n    cache.cacheKey = currentCacheKey;\n\n    return cache.client;\n  }, [\n    getEmbeddedWallet,\n    getEmbeddedWalletChain,\n    signAuthorization,\n    config.apiKey,\n    config.jwt,\n    config.rpcUrl,\n    config.policyId,\n    cache,\n  ]);\n\n  return { getClient };\n}\n"]}

package/dist/esm/hooks/useAlchemyPrepareSwap.d.ts

@@ -0,0 +1,42 @@
+import type { UsePrepareSwapResult } from "../types";
+/**
+ * Hook to request swap quotes and prepare swap calls
+ * Part of the two-step swap process: prepare → submit
+ * Use with `useAlchemySubmitSwap()` to execute the prepared swap
+ *
+ * Supports two modes:
+ * 1. Specify exact amount to swap FROM (`fromAmount`)
+ * 2. Specify minimum amount to receive TO (`minimumToAmount`)
+ *
+ * @returns {UsePrepareSwapResult} Hook result with prepareSwap function and state
+ *
+ * @example Complete swap flow
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ * const { submitSwap } = useAlchemySubmitSwap();
+ *
+ * // Step 1: Prepare the swap (get quote)
+ * const preparedSwap = await prepareSwap({
+ *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+ *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   fromAmount: '0xde0b6b3a7640000', // 1 ETH in hex
+ * });
+ *
+ * // Step 2: Execute the swap
+ * const result = await submitSwap(preparedSwap);
+ * ```
+ *
+ * @example Swap for minimum amount TO
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ *
+ * // Swap ETH to get at least 100 USDC
+ * const result = await prepareSwap({
+ *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+ *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   minimumToAmount: '0x5f5e100', // 100 USDC (6 decimals) in hex
+ * });
+ * console.log('Quote expiry:', new Date(parseInt(result.quote.expiry, 16) * 1000));
+ * ```
+ */
+export declare function useAlchemyPrepareSwap(): UsePrepareSwapResult;

package/dist/esm/hooks/useAlchemyPrepareSwap.js

@@ -0,0 +1,95 @@
+import { useCallback, useState } from "react";
+import {} from "viem";
+import { swapActions } from "@account-kit/wallet-client/experimental";
+import { useAlchemyClient } from "./useAlchemyClient.js";
+import { useEmbeddedWallet } from "./internal/useEmbeddedWallet.js";
+/**
+ * Hook to request swap quotes and prepare swap calls
+ * Part of the two-step swap process: prepare → submit
+ * Use with `useAlchemySubmitSwap()` to execute the prepared swap
+ *
+ * Supports two modes:
+ * 1. Specify exact amount to swap FROM (`fromAmount`)
+ * 2. Specify minimum amount to receive TO (`minimumToAmount`)
+ *
+ * @returns {UsePrepareSwapResult} Hook result with prepareSwap function and state
+ *
+ * @example Complete swap flow
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ * const { submitSwap } = useAlchemySubmitSwap();
+ *
+ * // Step 1: Prepare the swap (get quote)
+ * const preparedSwap = await prepareSwap({
+ *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+ *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   fromAmount: '0xde0b6b3a7640000', // 1 ETH in hex
+ * });
+ *
+ * // Step 2: Execute the swap
+ * const result = await submitSwap(preparedSwap);
+ * ```
+ *
+ * @example Swap for minimum amount TO
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ *
+ * // Swap ETH to get at least 100 USDC
+ * const result = await prepareSwap({
+ *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+ *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   minimumToAmount: '0x5f5e100', // 100 USDC (6 decimals) in hex
+ * });
+ * console.log('Quote expiry:', new Date(parseInt(result.quote.expiry, 16) * 1000));
+ * ```
+ */
+export function useAlchemyPrepareSwap() {
+    const { getClient } = useAlchemyClient();
+    const getEmbeddedWallet = useEmbeddedWallet();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [data, setData] = useState(null);
+    const prepareSwap = useCallback(async (request) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const client = await getClient();
+            const embeddedWallet = getEmbeddedWallet();
+            // Extend client with swap actions
+            const swapClient = client.extend(swapActions);
+            // Request the swap quote
+            // Note: Gas sponsorship capabilities are configured on the client itself
+            const response = await swapClient.requestQuoteV0({
+                ...request,
+                from: request.from || embeddedWallet.address,
+            });
+            // Validate that we got prepared calls, not raw calls
+            if (response.rawCalls) {
+                throw new Error("Received raw calls instead of prepared calls. Ensure returnRawCalls is not set to true.");
+            }
+            setData(response);
+            return response;
+        }
+        catch (err) {
+            const errorObj = err instanceof Error ? err : new Error("Failed to prepare swap");
+            setError(errorObj);
+            throw errorObj;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [getClient, getEmbeddedWallet]);
+    const reset = useCallback(() => {
+        setError(null);
+        setData(null);
+        setIsLoading(false);
+    }, []);
+    return {
+        prepareSwap,
+        isLoading,
+        error,
+        data,
+        reset,
+    };
+}
+//# sourceMappingURL=useAlchemyPrepareSwap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAlchemyPrepareSwap.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemyPrepareSwap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAgB,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAOpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,SAAS,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;IAE9C,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,CAA2B,IAAI,CAAC,CAAC;IAEjE,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EAAE,OAA2B,EAA8B,EAAE;QAChE,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAE3C,kCAAkC;YAClC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAE9C,yBAAyB;YACzB,yEAAyE;YACzE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC;gBAC/C,GAAG,OAAO;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAK,cAAc,CAAC,OAAmB;aAC1D,CAAC,CAAC;YAEH,qDAAqD;YACrD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;YACJ,CAAC;YAED,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,wBAAwB,CAAC,CAAC;YACnE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnB,MAAM,QAAQ,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAC/B,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,WAAW;QACX,SAAS;QACT,KAAK;QACL,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { type Address } from \"viem\";\nimport { swapActions } from \"@account-kit/wallet-client/experimental\";\nimport { useAlchemyClient } from \"./useAlchemyClient.js\";\nimport { useEmbeddedWallet } from \"./internal/useEmbeddedWallet.js\";\nimport type {\n  PrepareSwapRequest,\n  PrepareSwapResult,\n  UsePrepareSwapResult,\n} from \"../types\";\n\n/**\n * Hook to request swap quotes and prepare swap calls\n * Part of the two-step swap process: prepare → submit\n * Use with `useAlchemySubmitSwap()` to execute the prepared swap\n *\n * Supports two modes:\n * 1. Specify exact amount to swap FROM (`fromAmount`)\n * 2. Specify minimum amount to receive TO (`minimumToAmount`)\n *\n * @returns {UsePrepareSwapResult} Hook result with prepareSwap function and state\n *\n * @example Complete swap flow\n * ```tsx\n * const { prepareSwap } = useAlchemyPrepareSwap();\n * const { submitSwap } = useAlchemySubmitSwap();\n *\n * // Step 1: Prepare the swap (get quote)\n * const preparedSwap = await prepareSwap({\n *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',\n *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n *   fromAmount: '0xde0b6b3a7640000', // 1 ETH in hex\n * });\n *\n * // Step 2: Execute the swap\n * const result = await submitSwap(preparedSwap);\n * ```\n *\n * @example Swap for minimum amount TO\n * ```tsx\n * const { prepareSwap } = useAlchemyPrepareSwap();\n *\n * // Swap ETH to get at least 100 USDC\n * const result = await prepareSwap({\n *   fromToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',\n *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n *   minimumToAmount: '0x5f5e100', // 100 USDC (6 decimals) in hex\n * });\n * console.log('Quote expiry:', new Date(parseInt(result.quote.expiry, 16) * 1000));\n * ```\n */\nexport function useAlchemyPrepareSwap(): UsePrepareSwapResult {\n  const { getClient } = useAlchemyClient();\n  const getEmbeddedWallet = useEmbeddedWallet();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<PrepareSwapResult | null>(null);\n\n  const prepareSwap = useCallback(\n    async (request: PrepareSwapRequest): Promise<PrepareSwapResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const client = await getClient();\n        const embeddedWallet = getEmbeddedWallet();\n\n        // Extend client with swap actions\n        const swapClient = client.extend(swapActions);\n\n        // Request the swap quote\n        // Note: Gas sponsorship capabilities are configured on the client itself\n        const response = await swapClient.requestQuoteV0({\n          ...request,\n          from: request.from || (embeddedWallet.address as Address),\n        });\n\n        // Validate that we got prepared calls, not raw calls\n        if (response.rawCalls) {\n          throw new Error(\n            \"Received raw calls instead of prepared calls. Ensure returnRawCalls is not set to true.\",\n          );\n        }\n\n        setData(response);\n        return response;\n      } catch (err) {\n        const errorObj =\n          err instanceof Error ? err : new Error(\"Failed to prepare swap\");\n        setError(errorObj);\n        throw errorObj;\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [getClient, getEmbeddedWallet],\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    setData(null);\n    setIsLoading(false);\n  }, []);\n\n  return {\n    prepareSwap,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n"]}

package/dist/esm/hooks/useAlchemySendTransaction.d.ts

@@ -0,0 +1,26 @@
+import type { UseSendTransactionResult } from "../types";
+/**
+ * Hook to send transactions with optional gas sponsorship via Alchemy
+ * Drop-in alternative to Privy's useSendTransaction hook
+ *
+ * @returns {UseSendTransactionResult} Hook result with sendTransaction function and state
+ *
+ * @example
+ * ```tsx
+ * const { sendTransaction, isLoading, error, data } = useAlchemySendTransaction();
+ *
+ * const handleSend = async () => {
+ *   try {
+ *     const result = await sendTransaction({
+ *       to: '0x...',
+ *       data: '0x...',
+ *       value: '1000000000000000000', // 1 ETH
+ *     });
+ *     console.log('Transaction hash:', result.txnHash);
+ *   } catch (err) {
+ *     console.error('Transaction failed:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare function useAlchemySendTransaction(): UseSendTransactionResult;

package/dist/esm/hooks/useAlchemySendTransaction.js

@@ -0,0 +1,127 @@
+import { useCallback, useState } from "react";
+import { isHex } from "viem";
+import { useAlchemyClient } from "./useAlchemyClient.js";
+import { useAlchemyConfig } from "../Provider.js";
+import { useEmbeddedWallet } from "./internal/useEmbeddedWallet.js";
+/**
+ * Normalize value to hex format
+ * Accepts bigint, number, decimal string, or hex string
+ *
+ * @param {string | number | bigint} value - Value to normalize
+ * @returns {Hex} Hex string representation of the value
+ */
+function normalizeValue(value) {
+    if (typeof value === "bigint") {
+        return `0x${value.toString(16)}`;
+    }
+    if (typeof value === "number") {
+        return `0x${BigInt(value).toString(16)}`;
+    }
+    if (isHex(value)) {
+        return value;
+    }
+    // Assume decimal string
+    return `0x${BigInt(value).toString(16)}`;
+}
+/**
+ * Hook to send transactions with optional gas sponsorship via Alchemy
+ * Drop-in alternative to Privy's useSendTransaction hook
+ *
+ * @returns {UseSendTransactionResult} Hook result with sendTransaction function and state
+ *
+ * @example
+ * ```tsx
+ * const { sendTransaction, isLoading, error, data } = useAlchemySendTransaction();
+ *
+ * const handleSend = async () => {
+ *   try {
+ *     const result = await sendTransaction({
+ *       to: '0x...',
+ *       data: '0x...',
+ *       value: '1000000000000000000', // 1 ETH
+ *     });
+ *     console.log('Transaction hash:', result.txnHash);
+ *   } catch (err) {
+ *     console.error('Transaction failed:', err);
+ *   }
+ * };
+ * ```
+ */
+export function useAlchemySendTransaction() {
+    const { getClient } = useAlchemyClient();
+    const config = useAlchemyConfig();
+    const getEmbeddedWallet = useEmbeddedWallet();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [data, setData] = useState(null);
+    const sendTransaction = useCallback(async (input, options) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const client = await getClient();
+            const embeddedWallet = getEmbeddedWallet();
+            // Determine if transaction should be sponsored
+            const hasPolicyId = !!config.policyId;
+            const enableSponsorship = !config.disableSponsorship;
+            const shouldSponsor = options?.disableSponsorship !== undefined
+                ? !options.disableSponsorship
+                : hasPolicyId && enableSponsorship;
+            // Format the transaction call
+            const formattedCall = {
+                to: input.to,
+                data: input.data,
+                value: input.value ? normalizeValue(input.value) : undefined,
+            };
+            // Build capabilities based on sponsorship
+            const policyId = Array.isArray(config.policyId)
+                ? config.policyId[0]
+                : config.policyId;
+            const capabilities = { eip7702Auth: true };
+            if (shouldSponsor && policyId) {
+                capabilities.paymasterService = { policyId };
+            }
+            // Send the transaction
+            const result = await client.sendCalls({
+                from: embeddedWallet.address,
+                calls: [formattedCall],
+                capabilities,
+            });
+            if (!result.preparedCallIds || result.preparedCallIds.length === 0) {
+                throw new Error("No prepared call IDs returned from transaction submission");
+            }
+            // Wait for the transaction to be confirmed
+            const txStatus = await client.waitForCallsStatus({
+                id: result.preparedCallIds[0],
+                timeout: 60000,
+            });
+            const txnHash = txStatus.receipts?.[0]?.transactionHash;
+            if (!txnHash) {
+                throw new Error("Transaction hash not found in receipt");
+            }
+            const txResult = { txnHash };
+            setData(txResult);
+            return txResult;
+        }
+        catch (err) {
+            const errorObj = err instanceof Error ? err : new Error("Transaction failed");
+            setError(errorObj);
+            throw errorObj;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [getClient, getEmbeddedWallet, config.policyId, config.disableSponsorship]);
+    const reset = useCallback(() => {
+        setError(null);
+        setData(null);
+        setIsLoading(false);
+    }, []);
+    return {
+        sendTransaction,
+        isLoading,
+        error,
+        data,
+        reset,
+    };
+}
+//# sourceMappingURL=useAlchemySendTransaction.js.map

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

@@ -0,0 +1 @@
+{"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 Address, type Hex, isHex } from \"viem\";\nimport { useAlchemyClient } from \"./useAlchemyClient.js\";\nimport { useAlchemyConfig } from \"../Provider.js\";\nimport { useEmbeddedWallet } from \"./internal/useEmbeddedWallet.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 * Drop-in alternative to Privy's useSendTransaction hook\n *\n * @returns {UseSendTransactionResult} Hook result with sendTransaction function and state\n *\n * @example\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 */\nexport function useAlchemySendTransaction(): UseSendTransactionResult {\n  const { getClient } = useAlchemyClient();\n  const config = useAlchemyConfig();\n  const getEmbeddedWallet = useEmbeddedWallet();\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,\n      options?: SendTransactionOptions,\n    ): Promise<SendTransactionResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const client = await getClient();\n        const embeddedWallet = getEmbeddedWallet();\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\n        const formattedCall = {\n          to: input.to,\n          data: input.data,\n          value: input.value ? normalizeValue(input.value) : undefined,\n        };\n\n        // Build capabilities based on sponsorship\n        const policyId = Array.isArray(config.policyId)\n          ? config.policyId[0]\n          : config.policyId;\n\n        const capabilities: {\n          eip7702Auth: true;\n          paymasterService?: { policyId: string };\n        } = { eip7702Auth: true };\n\n        if (shouldSponsor && policyId) {\n          capabilities.paymasterService = { policyId };\n        }\n\n        // Send the transaction\n        const result = await client.sendCalls({\n          from: embeddedWallet.address as Address,\n          calls: [formattedCall],\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    [getClient, getEmbeddedWallet, config.policyId, config.disableSponsorship],\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/useAlchemySubmitSwap.d.ts

@@ -0,0 +1,31 @@
+import type { UseSubmitSwapResult } from "../types.js";
+/**
+ * Hook to sign and submit prepared swap calls
+ * Part of the two-step swap process: prepare → submit
+ *
+ * @returns {UseSubmitSwapResult} Hook result with submitSwap function and state
+ *
+ * @example
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ * const { submitSwap, isLoading, error, data } = useAlchemySubmitSwap();
+ *
+ * const handleSwap = async () => {
+ *   try {
+ *     // Step 1: Prepare the swap
+ *     const preparedSwap = await prepareSwap({
+ *       fromToken: '0x...',
+ *       toToken: '0x...',
+ *       fromAmount: '0x...',
+ *     });
+ *
+ *     // Step 2: Submit the swap
+ *     const result = await submitSwap(preparedSwap);
+ *     console.log('Swap confirmed:', result.txnHash);
+ *   } catch (err) {
+ *     console.error('Swap failed:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare function useAlchemySubmitSwap(): UseSubmitSwapResult;

package/dist/esm/hooks/useAlchemySubmitSwap.js

@@ -0,0 +1,93 @@
+import { useCallback, useState } from "react";
+import { swapActions } from "@account-kit/wallet-client/experimental";
+import { useAlchemyClient } from "./useAlchemyClient.js";
+/**
+ * Hook to sign and submit prepared swap calls
+ * Part of the two-step swap process: prepare → submit
+ *
+ * @returns {UseSubmitSwapResult} Hook result with submitSwap function and state
+ *
+ * @example
+ * ```tsx
+ * const { prepareSwap } = useAlchemyPrepareSwap();
+ * const { submitSwap, isLoading, error, data } = useAlchemySubmitSwap();
+ *
+ * const handleSwap = async () => {
+ *   try {
+ *     // Step 1: Prepare the swap
+ *     const preparedSwap = await prepareSwap({
+ *       fromToken: '0x...',
+ *       toToken: '0x...',
+ *       fromAmount: '0x...',
+ *     });
+ *
+ *     // Step 2: Submit the swap
+ *     const result = await submitSwap(preparedSwap);
+ *     console.log('Swap confirmed:', result.txnHash);
+ *   } catch (err) {
+ *     console.error('Swap failed:', err);
+ *   }
+ * };
+ * ```
+ */
+export function useAlchemySubmitSwap() {
+    const { getClient } = useAlchemyClient();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [data, setData] = useState(null);
+    const submitSwap = useCallback(async (preparedSwap) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const client = await getClient();
+            // Extend client with swap actions
+            const swapClient = client.extend(swapActions);
+            // Sign the prepared calls
+            const signedCalls = await swapClient.signPreparedCalls(preparedSwap);
+            // Send the signed calls
+            const { preparedCallIds } = await swapClient.sendPreparedCalls(signedCalls);
+            if (!preparedCallIds || preparedCallIds.length === 0) {
+                throw new Error("No prepared call IDs returned from swap submission");
+            }
+            // Wait for the swap to be confirmed
+            const callStatusResult = await swapClient.waitForCallsStatus({
+                id: preparedCallIds[0],
+                timeout: 60000,
+            });
+            // Validate the transaction was successful
+            if (callStatusResult.status !== "success" ||
+                !callStatusResult.receipts ||
+                !callStatusResult.receipts[0]) {
+                throw new Error(`Swap failed with status ${callStatusResult.status}. Full receipt:\n${JSON.stringify(callStatusResult, null, 2)}`);
+            }
+            const txnHash = callStatusResult.receipts[0].transactionHash;
+            if (!txnHash) {
+                throw new Error("Transaction hash not found in receipt");
+            }
+            const result = { txnHash };
+            setData(result);
+            return result;
+        }
+        catch (err) {
+            const errorObj = err instanceof Error ? err : new Error("Failed to submit swap");
+            setError(errorObj);
+            throw errorObj;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [getClient]);
+    const reset = useCallback(() => {
+        setError(null);
+        setData(null);
+        setIsLoading(false);
+    }, []);
+    return {
+        submitSwap,
+        isLoading,
+        error,
+        data,
+        reset,
+    };
+}
+//# sourceMappingURL=useAlchemySubmitSwap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAlchemySubmitSwap.js","sourceRoot":"","sources":["../../../src/hooks/useAlchemySubmitSwap.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { swapActions } from \"@account-kit/wallet-client/experimental\";\nimport { useAlchemyClient } from \"./useAlchemyClient.js\";\nimport type {\n  PrepareSwapResult,\n  SubmitSwapResult,\n  UseSubmitSwapResult,\n} from \"../types.js\";\n\n/**\n * Hook to sign and submit prepared swap calls\n * Part of the two-step swap process: prepare → submit\n *\n * @returns {UseSubmitSwapResult} Hook result with submitSwap function and state\n *\n * @example\n * ```tsx\n * const { prepareSwap } = useAlchemyPrepareSwap();\n * const { submitSwap, isLoading, error, data } = useAlchemySubmitSwap();\n *\n * const handleSwap = async () => {\n *   try {\n *     // Step 1: Prepare the swap\n *     const preparedSwap = await prepareSwap({\n *       fromToken: '0x...',\n *       toToken: '0x...',\n *       fromAmount: '0x...',\n *     });\n *\n *     // Step 2: Submit the swap\n *     const result = await submitSwap(preparedSwap);\n *     console.log('Swap confirmed:', result.txnHash);\n *   } catch (err) {\n *     console.error('Swap failed:', err);\n *   }\n * };\n * ```\n */\nexport function useAlchemySubmitSwap(): UseSubmitSwapResult {\n  const { getClient } = useAlchemyClient();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<SubmitSwapResult | null>(null);\n\n  const submitSwap = useCallback(\n    async (preparedSwap: PrepareSwapResult): Promise<SubmitSwapResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const client = await getClient();\n\n        // Extend client with swap actions\n        const swapClient = client.extend(swapActions);\n\n        // Sign the prepared calls\n        const signedCalls = await swapClient.signPreparedCalls(preparedSwap);\n\n        // Send the signed calls\n        const { preparedCallIds } =\n          await swapClient.sendPreparedCalls(signedCalls);\n\n        if (!preparedCallIds || preparedCallIds.length === 0) {\n          throw new Error(\"No prepared call IDs returned from swap submission\");\n        }\n\n        // Wait for the swap to be confirmed\n        const callStatusResult = await swapClient.waitForCallsStatus({\n          id: preparedCallIds[0],\n          timeout: 60_000,\n        });\n\n        // Validate the transaction was successful\n        if (\n          callStatusResult.status !== \"success\" ||\n          !callStatusResult.receipts ||\n          !callStatusResult.receipts[0]\n        ) {\n          throw new Error(\n            `Swap failed with status ${\n              callStatusResult.status\n            }. Full receipt:\\n${JSON.stringify(callStatusResult, null, 2)}`,\n          );\n        }\n\n        const txnHash = callStatusResult.receipts[0].transactionHash;\n        if (!txnHash) {\n          throw new Error(\"Transaction hash not found in receipt\");\n        }\n\n        const result: SubmitSwapResult = { txnHash };\n        setData(result);\n        return result;\n      } catch (err) {\n        const errorObj =\n          err instanceof Error ? err : new Error(\"Failed to submit swap\");\n        setError(errorObj);\n        throw errorObj;\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [getClient],\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    setData(null);\n    setIsLoading(false);\n  }, []);\n\n  return {\n    submitSwap,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export { AlchemyProvider, useAlchemyConfig } from "./Provider.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/index.js

@@ -0,0 +1,8 @@
+// Provider
+export { AlchemyProvider, useAlchemyConfig } from "./Provider.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=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElE,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":["// Provider\nexport { AlchemyProvider, useAlchemyConfig } from \"./Provider.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"]}