smart-multisig-engine 0.1.0 → 0.1.1

package/README.md

@@ -12,6 +12,8 @@ pnpm add smart-multisig-engine
 
 Peer dependencies: `@wagmi/core`, `viem`.
 
+Optional peer dependencies for React hooks: `react`, `@tanstack/react-query`.
+
 ## Quick Start
 
 Use `submitTx` with the generic adapter interface to submit transactions to any supported multisig:
@@ -392,6 +394,196 @@ const result = await safe.waitForExecution({
 console.log("Executed:", result.transactionHash);
 ```
 
+## React Hooks
+
+The library provides React Query hooks via a separate entry point. These hooks wrap the adapter functions and provide a familiar React Query interface.
+
+```bash
+# Requires these peer dependencies
+pnpm add react @tanstack/react-query
+```
+
+```typescript
+import {
+  useSubmitTx,
+  useWaitForExecution,
+  useWaitForExecutionReceipt,
+  useFetchPendingTxs,
+  useSimulate,
+  useWrite,
+} from "smart-multisig-engine/react";
+```
+
+### Hooks Overview
+
+| Hook | Type | Description |
+|------|------|-------------|
+| `useSubmitTx` | Mutation | Submit a transaction through an adapter |
+| `useWaitForExecution` | Query | Wait for a transaction to be executed |
+| `useWaitForExecutionReceipt` | Query | Wait for execution + fetch receipt with logs |
+| `useFetchPendingTxs` | Query | Fetch pending transactions for a wallet |
+| `useSimulate` | Query | Simulate a contract call |
+| `useWrite` | Mutation | Write a contract call |
+
+### `useSubmitTx`
+
+Mutation hook for submitting transactions.
+
+```typescript
+const { mutate, mutateAsync, isPending, isSuccess, data } = useSubmitTx();
+
+// Submit a transaction
+mutate({
+  adapter: "safe",
+  config,
+  walletAddress: "0xSafe...",
+  address: "0xContract...",
+  abi,
+  functionName: "transfer",
+  args: [recipient, amount],
+  chainId: 11155111n,
+});
+
+// Or with async/await
+const { txHash } = await mutateAsync({ ... });
+```
+
+### `useWaitForExecution`
+
+Query hook that waits for a Safe transaction to be executed. Maintains a stable loading state throughout polling (similar to wagmi's `useWaitForTransactionReceipt`).
+
+```typescript
+interface UseWaitForExecutionOptions {
+  adapter: "safe";
+  txHash: string;
+  chainId: bigint;
+  txServiceUrl?: string;
+  apiKey?: string;
+  enabled?: boolean;           // Default: true
+  pollingInterval?: number;    // Default: 5000ms
+  timeout?: number;            // Default: 120000ms (2 min)
+}
+```
+
+```typescript
+const { data, isLoading, isSuccess, isError } = useWaitForExecution({
+  adapter: "safe",
+  txHash: safeTxHash,
+  chainId: 11155111n,
+  timeout: 120000,  // Fail after 2 minutes
+  enabled: !!safeTxHash,
+});
+
+// States are stable throughout polling:
+// - isLoading = true while waiting
+// - isSuccess = true once executed
+// - isError = true if timeout reached
+
+if (isSuccess) {
+  console.log("Executed:", data.transactionHash);
+}
+```
+
+### `useWaitForExecutionReceipt`
+
+Query hook that waits for execution AND fetches the full transaction receipt with logs.
+
+```typescript
+interface UseWaitForExecutionReceiptOptions {
+  adapter: "safe";
+  txHash: string;
+  chainId: bigint;
+  config: Config;              // wagmi config for fetching receipt
+  txServiceUrl?: string;
+  apiKey?: string;
+  enabled?: boolean;           // Default: true
+  pollingInterval?: number;    // Default: 5000ms
+  timeout?: number;            // Default: 120000ms
+  confirmations?: number;      // Default: 1
+}
+```
+
+```typescript
+const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({
+  adapter: "safe",
+  txHash: safeTxHash,
+  chainId: 11155111n,
+  config: wagmiConfig,
+  confirmations: 1,
+});
+
+if (isSuccess) {
+  console.log("Transaction hash:", data.transactionHash);
+  console.log("Logs:", data.receipt.logs);
+  console.log("Gas used:", data.receipt.gasUsed);
+}
+```
+
+### `useFetchPendingTxs`
+
+Query hook for fetching pending transactions.
+
+```typescript
+const { data: pending, isLoading } = useFetchPendingTxs({
+  adapter: "safe",
+  walletAddress: "0xSafe...",
+  chainId: 11155111n,
+  refetchInterval: 10000,  // Optional: auto-refresh every 10s
+});
+```
+
+### Full Example
+
+```typescript
+import { useSubmitTx, useWaitForExecutionReceipt } from "smart-multisig-engine/react";
+
+function SafeTransaction() {
+  const submitTx = useSubmitTx();
+
+  const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({
+    adapter: "safe",
+    txHash: submitTx.data?.txHash,
+    chainId: 11155111n,
+    config: wagmiConfig,
+    enabled: !!submitTx.data?.txHash,
+  });
+
+  const handleSubmit = () => {
+    submitTx.mutate({
+      adapter: "safe",
+      config: wagmiConfig,
+      walletAddress: safeAddress,
+      address: contractAddress,
+      abi: contractAbi,
+      functionName: "transfer",
+      args: [recipient, amount],
+      chainId: 11155111n,
+    });
+  };
+
+  return (
+    <div>
+      <button onClick={handleSubmit} disabled={submitTx.isPending}>
+        {submitTx.isPending ? "Submitting..." : "Submit Transaction"}
+      </button>
+
+      {submitTx.isSuccess && !isSuccess && (
+        <p>Waiting for execution... {isLoading && "(polling)"}</p>
+      )}
+
+      {isSuccess && (
+        <div>
+          <p>Executed: {data.transactionHash}</p>
+          <p>Gas used: {data.receipt.gasUsed.toString()}</p>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+---
+
 ## Development
 
 ```bash

package/dist/react.cjs

@@ -34,6 +34,7 @@ __export(react_exports, {
   useSimulate: () => useSimulate,
   useSubmitTx: () => useSubmitTx,
   useWaitForExecution: () => useWaitForExecution,
+  useWaitForExecutionReceipt: () => useWaitForExecutionReceipt,
   useWrite: () => useWrite
 });
 module.exports = __toCommonJS(react_exports);
@@ -270,11 +271,59 @@ function useWaitForExecution(options) {
   });
 }
 
-// src/react/use-fetch-pending-txs.ts
+// src/react/use-wait-for-execution-receipt.ts
 var import_react_query3 = require("@tanstack/react-query");
+var import_core3 = require("@wagmi/core");
+function useWaitForExecutionReceipt(options) {
+  const {
+    config,
+    enabled = true,
+    pollingInterval = 5e3,
+    timeout = 12e4,
+    confirmations = 1,
+    ...waitOptions
+  } = options;
+  const maxAttempts = Math.ceil(timeout / pollingInterval);
+  return (0, import_react_query3.useQuery)({
+    queryKey: [
+      "adapter",
+      options.adapter,
+      "waitForExecutionReceipt",
+      options.txHash,
+      options.chainId.toString(),
+      confirmations
+    ],
+    queryFn: async () => {
+      const { transactionHash } = await waitForExecution2({
+        ...waitOptions,
+        pollingInterval,
+        maxAttempts
+      });
+      const receipt = await (0, import_core3.waitForTransactionReceipt)(config, {
+        hash: transactionHash,
+        confirmations
+      });
+      return {
+        transactionHash,
+        receipt
+      };
+    },
+    enabled: enabled && !!options.txHash,
+    refetchInterval: false,
+    refetchOnWindowFocus: false,
+    refetchOnMount: false,
+    refetchOnReconnect: false,
+    retry: false,
+    staleTime: Infinity,
+    gcTime: 1e3 * 60 * 5
+  });
+}
+
+// src/react/use-fetch-pending-txs.ts
+var import_react_query4 = require("@tanstack/react-query");
 function useFetchPendingTxs(options) {
   const { enabled = true, refetchInterval = false, ...fetchOptions } = options;
-  return (0, import_react_query3.useQuery)({
+  return (0, import_react_query4.useQuery)({
     queryKey: [
       "adapter",
       options.adapter,
@@ -289,10 +338,10 @@ function useFetchPendingTxs(options) {
 }
 
 // src/react/use-simulate.ts
-var import_react_query4 = require("@tanstack/react-query");
+var import_react_query5 = require("@tanstack/react-query");
 function useSimulate(options) {
   const { enabled = true, ...simulateOptions } = options;
-  return (0, import_react_query4.useQuery)({
+  return (0, import_react_query5.useQuery)({
     queryKey: [
       "adapter",
       options.adapter,
@@ -307,9 +356,9 @@ function useSimulate(options) {
 }
 
 // src/react/use-write.ts
-var import_react_query5 = require("@tanstack/react-query");
+var import_react_query6 = require("@tanstack/react-query");
 function useWrite() {
-  return (0, import_react_query5.useMutation)({
+  return (0, import_react_query6.useMutation)({
     mutationFn: (options) => write(options)
   });
 }
@@ -319,6 +368,7 @@ function useWrite() {
   useSimulate,
   useSubmitTx,
   useWaitForExecution,
+  useWaitForExecutionReceipt,
   useWrite
 });
 //# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/index.ts","../src/react/use-submit-tx.ts","../src/adapters/safe/simulate-contract-call.ts","../src/adapters/safe/write-contract-call.ts","../src/adapters/safe/fetch-pending-transactions.ts","../src/core/extract-call-data.ts","../src/core/match-pending-tx.ts","../src/adapters/safe/submit-and-find-safe-tx.ts","../src/adapters/safe/wait-for-execution.ts","../src/adapters/registry.ts","../src/adapters/index.ts","../src/react/use-wait-for-execution.ts","../src/react/use-fetch-pending-txs.ts","../src/react/use-simulate.ts","../src/react/use-write.ts"],"sourcesContent":["export * from \"./use-submit-tx.js\";\nexport * from \"./use-wait-for-execution.js\";\nexport * from \"./use-fetch-pending-txs.js\";\nexport * from \"./use-simulate.js\";\nexport * from \"./use-write.js\";\n","import { useMutation } from \"@tanstack/react-query\";\nimport { submitTx } from \"../adapters/index.js\";\nimport type { SubmitTxOptions, SubmitTxResult } from \"../adapters/types.js\";\n\nexport type UseSubmitTxOptions = Omit<SubmitTxOptions, \"config\"> & {\n  config: SubmitTxOptions[\"config\"];\n};\n\nexport function useSubmitTx() {\n  return useMutation<SubmitTxResult, Error, UseSubmitTxOptions>({\n    mutationFn: (options) => submitTx(options),\n  });\n}\n","import { simulateContract, type Config } from \"@wagmi/core\";\nimport type { ContractCallParams } from \"../../core/types.js\";\n\nexport async function simulateContractCall(\n  config: Config,\n  params: ContractCallParams,\n) {\n  return simulateContract(config, {\n    address: params.address,\n    abi: params.abi,\n    functionName: params.functionName,\n    args: params.args as unknown[],\n    value: params.value,\n    chainId: params.chainId,\n    account: params.account,\n  });\n}\n","import { writeContract, type Config } from \"@wagmi/core\";\nimport type { Hex } from \"viem\";\n\nexport async function writeContractCall(\n  config: Config,\n  request: Parameters<typeof writeContract>[1],\n): Promise<Hex> {\n  return writeContract(config, request);\n}\n","import SafeApiKit from \"@safe-global/api-kit\";\nimport type { SafeMultisigTransactionResponse } from \"@safe-global/types-kit\";\n\nexport interface FetchPendingTransactionsParams {\n  chainId: bigint;\n  safeAddress: string;\n  txServiceUrl?: string;\n  apiKey?: string;\n}\n\nexport async function fetchPendingTransactions(\n  params: FetchPendingTransactionsParams,\n): Promise<SafeMultisigTransactionResponse[]> {\n  const apiKit = new SafeApiKit({\n    chainId: params.chainId,\n    ...(params.txServiceUrl && { txServiceUrl: params.txServiceUrl }),\n    apiKey: params.apiKey,\n  });\n\n  const response = await apiKit.getPendingTransactions(params.safeAddress);\n  return response.results;\n}\n","import type { Abi, Address } from \"viem\";\nimport { encodeFunctionData } from \"viem\";\nimport type { EncodedCallData } from \"./types.js\";\n\nexport function extractCallData(params: {\n  abi: Abi;\n  functionName: string;\n  args?: readonly unknown[];\n  address: Address;\n  value?: bigint;\n}): EncodedCallData {\n  const data = encodeFunctionData({\n    abi: params.abi,\n    functionName: params.functionName,\n    args: params.args as unknown[],\n  });\n\n  return {\n    to: params.address,\n    data,\n    value: params.value ?? 0n,\n  };\n}\n","import type { SafeMultisigTransactionResponse } from \"@safe-global/types-kit\";\nimport type { TxMatchCriteria } from \"./types.js\";\n\nexport function matchPendingTransaction(\n  pendingTxs: SafeMultisigTransactionResponse[],\n  criteria: TxMatchCriteria,\n): SafeMultisigTransactionResponse | undefined {\n  return pendingTxs.find(\n    (tx) =>\n      tx.to.toLowerCase() === criteria.to.toLowerCase() &&\n      tx.value === String(criteria.value) &&\n      tx.data?.toLowerCase() === criteria.data.toLowerCase(),\n  );\n}\n","import { extractCallData } from \"../../core/extract-call-data.js\";\nimport { matchPendingTransaction } from \"../../core/match-pending-tx.js\";\nimport { fetchPendingTransactions } from \"./fetch-pending-transactions.js\";\nimport { simulateContractCall } from \"./simulate-contract-call.js\";\nimport { writeContractCall } from \"./write-contract-call.js\";\nimport type {\n  SubmitAndFindSafeTxOptions,\n  SubmitAndFindSafeTxResult,\n} from \"./types.js\";\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function submitAndFindSafeTx(\n  options: SubmitAndFindSafeTxOptions,\n): Promise<SubmitAndFindSafeTxResult> {\n  const {\n    config,\n    safeAddress,\n    txServiceUrl,\n    apiKey,\n    pollingInterval = 3000,\n    maxAttempts = 20,\n    ...callParams\n  } = options;\n\n  const callData = extractCallData(callParams);\n\n  const simulation = await simulateContractCall(config, callParams);\n\n  await writeContractCall(config, simulation.request as Parameters<typeof writeContractCall>[1]);\n\n  const chainId = BigInt(callParams.chainId ?? (await getChainId(config)));\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    await delay(pollingInterval);\n\n    const pendingTxs = await fetchPendingTransactions({\n      chainId,\n      safeAddress,\n      txServiceUrl,\n      apiKey,\n    });\n    const match = matchPendingTransaction(pendingTxs, callData);\n\n    if (match) {\n      return {\n        safeTxHash: match.safeTxHash,\n      };\n    }\n  }\n\n  throw new Error(\n    `Could not find matching Safe transaction after ${maxAttempts} attempts`,\n  );\n}\n\nasync function getChainId(config: Parameters<typeof simulateContractCall>[0]): Promise<number> {\n  const { getChainId: wagmiGetChainId } = await import(\"@wagmi/core\");\n  return wagmiGetChainId(config);\n}\n","import SafeApiKit from \"@safe-global/api-kit\";\nimport type {\n  WaitForExecutionOptions,\n  WaitForExecutionResult,\n} from \"./types.js\";\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function waitForExecution(\n  options: WaitForExecutionOptions,\n): Promise<WaitForExecutionResult> {\n  const {\n    safeTxHash,\n    chainId,\n    txServiceUrl,\n    apiKey,\n    pollingInterval = 5000,\n    maxAttempts = 60,\n  } = options;\n\n  const apiKit = new SafeApiKit({\n    chainId,\n    ...(txServiceUrl && { txServiceUrl }),\n    apiKey,\n  });\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    const tx = await apiKit.getTransaction(safeTxHash);\n\n    if (tx.isExecuted && tx.transactionHash) {\n      return {\n        transactionHash: tx.transactionHash,\n      };\n    }\n\n    await delay(pollingInterval);\n  }\n\n  throw new Error(\n    `Safe transaction ${safeTxHash} was not executed after ${maxAttempts} attempts`,\n  );\n}\n","import * as safe from \"./safe/index.js\";\n\nexport const adapters = {\n  safe: {\n    submitTx: safe.submitAndFindSafeTx,\n    waitForExecution: safe.waitForExecution,\n    fetchPending: safe.fetchPendingTransactions,\n    simulate: safe.simulateContractCall,\n    write: safe.writeContractCall,\n  },\n} as const;\n\nexport type AdapterRegistry = typeof adapters;\n","import { adapters } from \"./registry.js\";\nimport type {\n  AdapterType,\n  SubmitTxOptions,\n  SubmitTxResult,\n  WaitForExecutionOptions,\n  WaitForExecutionResult,\n  FetchPendingOptions,\n  SimulateOptions,\n  WriteOptions,\n} from \"./types.js\";\n\n// Re-export types\nexport * from \"./types.js\";\n\n// Re-export Safe adapter for direct access\nexport * as safe from \"./safe/index.js\";\n\n// Generic entry functions\n\nexport async function submitTx(\n  options: SubmitTxOptions,\n): Promise<SubmitTxResult> {\n  const { adapter, walletAddress, ...rest } = options;\n  assertAdapter(adapter);\n\n  const result = await adapters[adapter].submitTx({\n    safeAddress: walletAddress,\n    ...rest,\n  });\n\n  return { txHash: result.safeTxHash };\n}\n\nexport async function waitForExecution(\n  options: WaitForExecutionOptions,\n): Promise<WaitForExecutionResult> {\n  const { adapter, txHash, ...rest } = options;\n  assertAdapter(adapter);\n\n  const result = await adapters[adapter].waitForExecution({\n    safeTxHash: txHash,\n    ...rest,\n  });\n\n  return { transactionHash: result.transactionHash };\n}\n\nexport async function fetchPendingTxs(\n  options: FetchPendingOptions,\n): Promise<unknown[]> {\n  const { adapter, walletAddress, ...rest } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].fetchPending({\n    safeAddress: walletAddress,\n    ...rest,\n  });\n}\n\nexport async function simulate(\n  options: SimulateOptions,\n): Promise<unknown> {\n  const { adapter, config, ...params } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].simulate(config, params);\n}\n\nexport async function write(\n  options: WriteOptions,\n): Promise<string> {\n  const { adapter, config, request } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].write(config, request as Parameters<typeof adapters.safe.write>[1]);\n}\n\nfunction assertAdapter(adapter: AdapterType): asserts adapter is keyof typeof adapters {\n  if (!(adapter in adapters)) {\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${Object.keys(adapters).join(\", \")}`);\n  }\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions, WaitForExecutionResult } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms. After this duration, the query will fail. Defaults to 120000 (2 min). */\n  timeout?: number;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed on-chain.\n *\n * Unlike standard polling queries, this hook maintains a stable loading state\n * throughout the polling process (similar to wagmi's useWaitForTransactionReceipt):\n * - `isLoading` = true while waiting for execution\n * - `isSuccess` = true once transaction is executed\n * - `isError` = true if timeout is reached\n */\nexport function useWaitForExecution(options: UseWaitForExecutionOptions) {\n  const {\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    ...waitOptions\n  } = options;\n\n  // Calculate max attempts from timeout and polling interval\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecution\",\n      options.txHash,\n      options.chainId.toString(),\n    ],\n    queryFn: () =>\n      waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      }),\n    enabled: enabled && !!options.txHash,\n    // Don't refetch - the query handles polling internally\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    // Don't retry on error - timeout is intentional\n    retry: false,\n    // Keep data fresh\n    staleTime: Infinity,\n    // Cache result for this specific txHash\n    gcTime: 1000 * 60 * 5, // 5 minutes\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { fetchPendingTxs } from \"../adapters/index.js\";\nimport type { FetchPendingOptions } from \"../adapters/types.js\";\n\nexport interface UseFetchPendingTxsOptions extends FetchPendingOptions {\n  enabled?: boolean;\n  refetchInterval?: number | false;\n}\n\nexport function useFetchPendingTxs(options: UseFetchPendingTxsOptions) {\n  const { enabled = true, refetchInterval = false, ...fetchOptions } = options;\n\n  return useQuery<unknown[], Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"pendingTxs\",\n      options.walletAddress,\n      options.chainId.toString(),\n    ],\n    queryFn: () => fetchPendingTxs(fetchOptions),\n    enabled: enabled && !!options.walletAddress,\n    refetchInterval,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { simulate } from \"../adapters/index.js\";\nimport type { SimulateOptions } from \"../adapters/types.js\";\n\nexport interface UseSimulateOptions extends SimulateOptions {\n  enabled?: boolean;\n}\n\nexport function useSimulate(options: UseSimulateOptions) {\n  const { enabled = true, ...simulateOptions } = options;\n\n  return useQuery<unknown, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"simulate\",\n      options.address,\n      options.functionName,\n      JSON.stringify(options.args),\n    ],\n    queryFn: () => simulate(simulateOptions),\n    enabled,\n  });\n}\n","import { useMutation } from \"@tanstack/react-query\";\nimport { write } from \"../adapters/index.js\";\nimport type { WriteOptions } from \"../adapters/types.js\";\n\nexport function useWrite() {\n  return useMutation<string, Error, WriteOptions>({\n    mutationFn: (options) => write(options),\n  });\n}\n"],"mappings":"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","names":["import_core","SafeApiKit","import_api_kit","delay","SafeApiKit","waitForExecution","import_react_query","waitForExecution","import_react_query","import_react_query","import_react_query"]}
+{"version":3,"sources":["../src/react/index.ts","../src/react/use-submit-tx.ts","../src/adapters/safe/simulate-contract-call.ts","../src/adapters/safe/write-contract-call.ts","../src/adapters/safe/fetch-pending-transactions.ts","../src/core/extract-call-data.ts","../src/core/match-pending-tx.ts","../src/adapters/safe/submit-and-find-safe-tx.ts","../src/adapters/safe/wait-for-execution.ts","../src/adapters/registry.ts","../src/adapters/index.ts","../src/react/use-wait-for-execution.ts","../src/react/use-wait-for-execution-receipt.ts","../src/react/use-fetch-pending-txs.ts","../src/react/use-simulate.ts","../src/react/use-write.ts"],"sourcesContent":["export * from \"./use-submit-tx.js\";\nexport * from \"./use-wait-for-execution.js\";\nexport * from \"./use-wait-for-execution-receipt.js\";\nexport * from \"./use-fetch-pending-txs.js\";\nexport * from \"./use-simulate.js\";\nexport * from \"./use-write.js\";\n","import { useMutation } from \"@tanstack/react-query\";\nimport { submitTx } from \"../adapters/index.js\";\nimport type { SubmitTxOptions, SubmitTxResult } from \"../adapters/types.js\";\n\nexport type UseSubmitTxOptions = Omit<SubmitTxOptions, \"config\"> & {\n  config: SubmitTxOptions[\"config\"];\n};\n\nexport function useSubmitTx() {\n  return useMutation<SubmitTxResult, Error, UseSubmitTxOptions>({\n    mutationFn: (options) => submitTx(options),\n  });\n}\n","import { simulateContract, type Config } from \"@wagmi/core\";\nimport type { ContractCallParams } from \"../../core/types.js\";\n\nexport async function simulateContractCall(\n  config: Config,\n  params: ContractCallParams,\n) {\n  return simulateContract(config, {\n    address: params.address,\n    abi: params.abi,\n    functionName: params.functionName,\n    args: params.args as unknown[],\n    value: params.value,\n    chainId: params.chainId,\n    account: params.account,\n  });\n}\n","import { writeContract, type Config } from \"@wagmi/core\";\nimport type { Hex } from \"viem\";\n\nexport async function writeContractCall(\n  config: Config,\n  request: Parameters<typeof writeContract>[1],\n): Promise<Hex> {\n  return writeContract(config, request);\n}\n","import SafeApiKit from \"@safe-global/api-kit\";\nimport type { SafeMultisigTransactionResponse } from \"@safe-global/types-kit\";\n\nexport interface FetchPendingTransactionsParams {\n  chainId: bigint;\n  safeAddress: string;\n  txServiceUrl?: string;\n  apiKey?: string;\n}\n\nexport async function fetchPendingTransactions(\n  params: FetchPendingTransactionsParams,\n): Promise<SafeMultisigTransactionResponse[]> {\n  const apiKit = new SafeApiKit({\n    chainId: params.chainId,\n    ...(params.txServiceUrl && { txServiceUrl: params.txServiceUrl }),\n    apiKey: params.apiKey,\n  });\n\n  const response = await apiKit.getPendingTransactions(params.safeAddress);\n  return response.results;\n}\n","import type { Abi, Address } from \"viem\";\nimport { encodeFunctionData } from \"viem\";\nimport type { EncodedCallData } from \"./types.js\";\n\nexport function extractCallData(params: {\n  abi: Abi;\n  functionName: string;\n  args?: readonly unknown[];\n  address: Address;\n  value?: bigint;\n}): EncodedCallData {\n  const data = encodeFunctionData({\n    abi: params.abi,\n    functionName: params.functionName,\n    args: params.args as unknown[],\n  });\n\n  return {\n    to: params.address,\n    data,\n    value: params.value ?? 0n,\n  };\n}\n","import type { SafeMultisigTransactionResponse } from \"@safe-global/types-kit\";\nimport type { TxMatchCriteria } from \"./types.js\";\n\nexport function matchPendingTransaction(\n  pendingTxs: SafeMultisigTransactionResponse[],\n  criteria: TxMatchCriteria,\n): SafeMultisigTransactionResponse | undefined {\n  return pendingTxs.find(\n    (tx) =>\n      tx.to.toLowerCase() === criteria.to.toLowerCase() &&\n      tx.value === String(criteria.value) &&\n      tx.data?.toLowerCase() === criteria.data.toLowerCase(),\n  );\n}\n","import { extractCallData } from \"../../core/extract-call-data.js\";\nimport { matchPendingTransaction } from \"../../core/match-pending-tx.js\";\nimport { fetchPendingTransactions } from \"./fetch-pending-transactions.js\";\nimport { simulateContractCall } from \"./simulate-contract-call.js\";\nimport { writeContractCall } from \"./write-contract-call.js\";\nimport type {\n  SubmitAndFindSafeTxOptions,\n  SubmitAndFindSafeTxResult,\n} from \"./types.js\";\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function submitAndFindSafeTx(\n  options: SubmitAndFindSafeTxOptions,\n): Promise<SubmitAndFindSafeTxResult> {\n  const {\n    config,\n    safeAddress,\n    txServiceUrl,\n    apiKey,\n    pollingInterval = 3000,\n    maxAttempts = 20,\n    ...callParams\n  } = options;\n\n  const callData = extractCallData(callParams);\n\n  const simulation = await simulateContractCall(config, callParams);\n\n  await writeContractCall(config, simulation.request as Parameters<typeof writeContractCall>[1]);\n\n  const chainId = BigInt(callParams.chainId ?? (await getChainId(config)));\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    await delay(pollingInterval);\n\n    const pendingTxs = await fetchPendingTransactions({\n      chainId,\n      safeAddress,\n      txServiceUrl,\n      apiKey,\n    });\n    const match = matchPendingTransaction(pendingTxs, callData);\n\n    if (match) {\n      return {\n        safeTxHash: match.safeTxHash,\n      };\n    }\n  }\n\n  throw new Error(\n    `Could not find matching Safe transaction after ${maxAttempts} attempts`,\n  );\n}\n\nasync function getChainId(config: Parameters<typeof simulateContractCall>[0]): Promise<number> {\n  const { getChainId: wagmiGetChainId } = await import(\"@wagmi/core\");\n  return wagmiGetChainId(config);\n}\n","import SafeApiKit from \"@safe-global/api-kit\";\nimport type {\n  WaitForExecutionOptions,\n  WaitForExecutionResult,\n} from \"./types.js\";\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function waitForExecution(\n  options: WaitForExecutionOptions,\n): Promise<WaitForExecutionResult> {\n  const {\n    safeTxHash,\n    chainId,\n    txServiceUrl,\n    apiKey,\n    pollingInterval = 5000,\n    maxAttempts = 60,\n  } = options;\n\n  const apiKit = new SafeApiKit({\n    chainId,\n    ...(txServiceUrl && { txServiceUrl }),\n    apiKey,\n  });\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    const tx = await apiKit.getTransaction(safeTxHash);\n\n    if (tx.isExecuted && tx.transactionHash) {\n      return {\n        transactionHash: tx.transactionHash,\n      };\n    }\n\n    await delay(pollingInterval);\n  }\n\n  throw new Error(\n    `Safe transaction ${safeTxHash} was not executed after ${maxAttempts} attempts`,\n  );\n}\n","import * as safe from \"./safe/index.js\";\n\nexport const adapters = {\n  safe: {\n    submitTx: safe.submitAndFindSafeTx,\n    waitForExecution: safe.waitForExecution,\n    fetchPending: safe.fetchPendingTransactions,\n    simulate: safe.simulateContractCall,\n    write: safe.writeContractCall,\n  },\n} as const;\n\nexport type AdapterRegistry = typeof adapters;\n","import { adapters } from \"./registry.js\";\nimport type {\n  AdapterType,\n  SubmitTxOptions,\n  SubmitTxResult,\n  WaitForExecutionOptions,\n  WaitForExecutionResult,\n  FetchPendingOptions,\n  SimulateOptions,\n  WriteOptions,\n} from \"./types.js\";\n\n// Re-export types\nexport * from \"./types.js\";\n\n// Re-export Safe adapter for direct access\nexport * as safe from \"./safe/index.js\";\n\n// Generic entry functions\n\nexport async function submitTx(\n  options: SubmitTxOptions,\n): Promise<SubmitTxResult> {\n  const { adapter, walletAddress, ...rest } = options;\n  assertAdapter(adapter);\n\n  const result = await adapters[adapter].submitTx({\n    safeAddress: walletAddress,\n    ...rest,\n  });\n\n  return { txHash: result.safeTxHash };\n}\n\nexport async function waitForExecution(\n  options: WaitForExecutionOptions,\n): Promise<WaitForExecutionResult> {\n  const { adapter, txHash, ...rest } = options;\n  assertAdapter(adapter);\n\n  const result = await adapters[adapter].waitForExecution({\n    safeTxHash: txHash,\n    ...rest,\n  });\n\n  return { transactionHash: result.transactionHash };\n}\n\nexport async function fetchPendingTxs(\n  options: FetchPendingOptions,\n): Promise<unknown[]> {\n  const { adapter, walletAddress, ...rest } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].fetchPending({\n    safeAddress: walletAddress,\n    ...rest,\n  });\n}\n\nexport async function simulate(\n  options: SimulateOptions,\n): Promise<unknown> {\n  const { adapter, config, ...params } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].simulate(config, params);\n}\n\nexport async function write(\n  options: WriteOptions,\n): Promise<string> {\n  const { adapter, config, request } = options;\n  assertAdapter(adapter);\n\n  return adapters[adapter].write(config, request as Parameters<typeof adapters.safe.write>[1]);\n}\n\nfunction assertAdapter(adapter: AdapterType): asserts adapter is keyof typeof adapters {\n  if (!(adapter in adapters)) {\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${Object.keys(adapters).join(\", \")}`);\n  }\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions, WaitForExecutionResult } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms. After this duration, the query will fail. Defaults to 120000 (2 min). */\n  timeout?: number;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed on-chain.\n *\n * Unlike standard polling queries, this hook maintains a stable loading state\n * throughout the polling process (similar to wagmi's useWaitForTransactionReceipt):\n * - `isLoading` = true while waiting for execution\n * - `isSuccess` = true once transaction is executed\n * - `isError` = true if timeout is reached\n */\nexport function useWaitForExecution(options: UseWaitForExecutionOptions) {\n  const {\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    ...waitOptions\n  } = options;\n\n  // Calculate max attempts from timeout and polling interval\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecution\",\n      options.txHash,\n      options.chainId.toString(),\n    ],\n    queryFn: () =>\n      waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      }),\n    enabled: enabled && !!options.txHash,\n    // Don't refetch - the query handles polling internally\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    // Don't retry on error - timeout is intentional\n    retry: false,\n    // Keep data fresh\n    staleTime: Infinity,\n    // Cache result for this specific txHash\n    gcTime: 1000 * 60 * 5, // 5 minutes\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForTransactionReceipt } from \"@wagmi/core\";\nimport type { Config } from \"@wagmi/core\";\nimport type { TransactionReceipt } from \"viem\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionReceiptOptions\n  extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Wagmi config for fetching the receipt. */\n  config: Config;\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms for Safe tx. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms for Safe tx execution. Defaults to 120000 (2 min). */\n  timeout?: number;\n  /** Number of confirmations to wait for. Defaults to 1. */\n  confirmations?: number;\n}\n\nexport interface WaitForExecutionReceiptResult {\n  /** The on-chain transaction hash. */\n  transactionHash: string;\n  /** The full transaction receipt with logs. */\n  receipt: TransactionReceipt;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed and return the full receipt with logs.\n *\n * Combines waiting for Safe execution with fetching the transaction receipt:\n * 1. Polls Safe Transaction Service until the tx is executed\n * 2. Fetches the on-chain transaction receipt with logs\n *\n * @example\n * ```tsx\n * const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({\n *   adapter: \"safe\",\n *   txHash: safeTxHash,\n *   chainId: 11155111n,\n *   config: wagmiConfig,\n * });\n *\n * if (isSuccess) {\n *   console.log(\"Logs:\", data.receipt.logs);\n * }\n * ```\n */\nexport function useWaitForExecutionReceipt(\n  options: UseWaitForExecutionReceiptOptions\n) {\n  const {\n    config,\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    confirmations = 1,\n    ...waitOptions\n  } = options;\n\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionReceiptResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecutionReceipt\",\n      options.txHash,\n      options.chainId.toString(),\n      confirmations,\n    ],\n    queryFn: async () => {\n      // Step 1: Wait for Safe tx to be executed\n      const { transactionHash } = await waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      });\n\n      // Step 2: Get the transaction receipt with logs\n      const receipt = await waitForTransactionReceipt(config, {\n        hash: transactionHash as `0x${string}`,\n        confirmations,\n      });\n\n      return {\n        transactionHash,\n        receipt,\n      };\n    },\n    enabled: enabled && !!options.txHash,\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    retry: false,\n    staleTime: Infinity,\n    gcTime: 1000 * 60 * 5,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { fetchPendingTxs } from \"../adapters/index.js\";\nimport type { FetchPendingOptions } from \"../adapters/types.js\";\n\nexport interface UseFetchPendingTxsOptions extends FetchPendingOptions {\n  enabled?: boolean;\n  refetchInterval?: number | false;\n}\n\nexport function useFetchPendingTxs(options: UseFetchPendingTxsOptions) {\n  const { enabled = true, refetchInterval = false, ...fetchOptions } = options;\n\n  return useQuery<unknown[], Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"pendingTxs\",\n      options.walletAddress,\n      options.chainId.toString(),\n    ],\n    queryFn: () => fetchPendingTxs(fetchOptions),\n    enabled: enabled && !!options.walletAddress,\n    refetchInterval,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { simulate } from \"../adapters/index.js\";\nimport type { SimulateOptions } from \"../adapters/types.js\";\n\nexport interface UseSimulateOptions extends SimulateOptions {\n  enabled?: boolean;\n}\n\nexport function useSimulate(options: UseSimulateOptions) {\n  const { enabled = true, ...simulateOptions } = options;\n\n  return useQuery<unknown, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"simulate\",\n      options.address,\n      options.functionName,\n      JSON.stringify(options.args),\n    ],\n    queryFn: () => simulate(simulateOptions),\n    enabled,\n  });\n}\n","import { useMutation } from \"@tanstack/react-query\";\nimport { write } from \"../adapters/index.js\";\nimport type { WriteOptions } from \"../adapters/types.js\";\n\nexport function useWrite() {\n  return useMutation<string, Error, WriteOptions>({\n    mutationFn: (options) => write(options),\n  });\n}\n"],"mappings":"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","names":["import_core","SafeApiKit","import_api_kit","delay","SafeApiKit","waitForExecution","import_react_query","waitForExecution","import_react_query","import_core","waitForExecution","import_react_query","import_react_query","import_react_query"]}

package/dist/react.d.cts

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { a as SubmitTxOptions, b as SubmitTxResult, W as WaitForExecutionOptions, c as WaitForExecutionResult, F as FetchPendingOptions, S as SimulateOptions, d as WriteOptions } from './types-BJD1jdcY.cjs';
-import '@wagmi/core';
-import 'viem';
+import { Config } from '@wagmi/core';
+import { TransactionReceipt } from 'viem';
 
 type UseSubmitTxOptions = Omit<SubmitTxOptions, "config"> & {
     config: SubmitTxOptions["config"];
@@ -27,6 +27,47 @@ interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, "maxA
  */
 declare function useWaitForExecution(options: UseWaitForExecutionOptions): _tanstack_react_query.UseQueryResult<WaitForExecutionResult, Error>;
 
+interface UseWaitForExecutionReceiptOptions extends Omit<WaitForExecutionOptions, "maxAttempts"> {
+    /** Wagmi config for fetching the receipt. */
+    config: Config;
+    /** Enable/disable the query. Defaults to true. */
+    enabled?: boolean;
+    /** Polling interval in ms for Safe tx. Defaults to 5000. */
+    pollingInterval?: number;
+    /** Timeout in ms for Safe tx execution. Defaults to 120000 (2 min). */
+    timeout?: number;
+    /** Number of confirmations to wait for. Defaults to 1. */
+    confirmations?: number;
+}
+interface WaitForExecutionReceiptResult {
+    /** The on-chain transaction hash. */
+    transactionHash: string;
+    /** The full transaction receipt with logs. */
+    receipt: TransactionReceipt;
+}
+/**
+ * Hook to wait for a Safe transaction to be executed and return the full receipt with logs.
+ *
+ * Combines waiting for Safe execution with fetching the transaction receipt:
+ * 1. Polls Safe Transaction Service until the tx is executed
+ * 2. Fetches the on-chain transaction receipt with logs
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({
+ *   adapter: "safe",
+ *   txHash: safeTxHash,
+ *   chainId: 11155111n,
+ *   config: wagmiConfig,
+ * });
+ *
+ * if (isSuccess) {
+ *   console.log("Logs:", data.receipt.logs);
+ * }
+ * ```
+ */
+declare function useWaitForExecutionReceipt(options: UseWaitForExecutionReceiptOptions): _tanstack_react_query.UseQueryResult<WaitForExecutionReceiptResult, Error>;
+
 interface UseFetchPendingTxsOptions extends FetchPendingOptions {
     enabled?: boolean;
     refetchInterval?: number | false;
@@ -40,4 +81,4 @@ declare function useSimulate(options: UseSimulateOptions): _tanstack_react_query
 
 declare function useWrite(): _tanstack_react_query.UseMutationResult<string, Error, WriteOptions, unknown>;
 
-export { type UseFetchPendingTxsOptions, type UseSimulateOptions, type UseSubmitTxOptions, type UseWaitForExecutionOptions, useFetchPendingTxs, useSimulate, useSubmitTx, useWaitForExecution, useWrite };
+export { type UseFetchPendingTxsOptions, type UseSimulateOptions, type UseSubmitTxOptions, type UseWaitForExecutionOptions, type UseWaitForExecutionReceiptOptions, type WaitForExecutionReceiptResult, useFetchPendingTxs, useSimulate, useSubmitTx, useWaitForExecution, useWaitForExecutionReceipt, useWrite };

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { a as SubmitTxOptions, b as SubmitTxResult, W as WaitForExecutionOptions, c as WaitForExecutionResult, F as FetchPendingOptions, S as SimulateOptions, d as WriteOptions } from './types-BJD1jdcY.js';
-import '@wagmi/core';
-import 'viem';
+import { Config } from '@wagmi/core';
+import { TransactionReceipt } from 'viem';
 
 type UseSubmitTxOptions = Omit<SubmitTxOptions, "config"> & {
     config: SubmitTxOptions["config"];
@@ -27,6 +27,47 @@ interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, "maxA
  */
 declare function useWaitForExecution(options: UseWaitForExecutionOptions): _tanstack_react_query.UseQueryResult<WaitForExecutionResult, Error>;
 
+interface UseWaitForExecutionReceiptOptions extends Omit<WaitForExecutionOptions, "maxAttempts"> {
+    /** Wagmi config for fetching the receipt. */
+    config: Config;
+    /** Enable/disable the query. Defaults to true. */
+    enabled?: boolean;
+    /** Polling interval in ms for Safe tx. Defaults to 5000. */
+    pollingInterval?: number;
+    /** Timeout in ms for Safe tx execution. Defaults to 120000 (2 min). */
+    timeout?: number;
+    /** Number of confirmations to wait for. Defaults to 1. */
+    confirmations?: number;
+}
+interface WaitForExecutionReceiptResult {
+    /** The on-chain transaction hash. */
+    transactionHash: string;
+    /** The full transaction receipt with logs. */
+    receipt: TransactionReceipt;
+}
+/**
+ * Hook to wait for a Safe transaction to be executed and return the full receipt with logs.
+ *
+ * Combines waiting for Safe execution with fetching the transaction receipt:
+ * 1. Polls Safe Transaction Service until the tx is executed
+ * 2. Fetches the on-chain transaction receipt with logs
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({
+ *   adapter: "safe",
+ *   txHash: safeTxHash,
+ *   chainId: 11155111n,
+ *   config: wagmiConfig,
+ * });
+ *
+ * if (isSuccess) {
+ *   console.log("Logs:", data.receipt.logs);
+ * }
+ * ```
+ */
+declare function useWaitForExecutionReceipt(options: UseWaitForExecutionReceiptOptions): _tanstack_react_query.UseQueryResult<WaitForExecutionReceiptResult, Error>;
+
 interface UseFetchPendingTxsOptions extends FetchPendingOptions {
     enabled?: boolean;
     refetchInterval?: number | false;
@@ -40,4 +81,4 @@ declare function useSimulate(options: UseSimulateOptions): _tanstack_react_query
 
 declare function useWrite(): _tanstack_react_query.UseMutationResult<string, Error, WriteOptions, unknown>;
 
-export { type UseFetchPendingTxsOptions, type UseSimulateOptions, type UseSubmitTxOptions, type UseWaitForExecutionOptions, useFetchPendingTxs, useSimulate, useSubmitTx, useWaitForExecution, useWrite };
+export { type UseFetchPendingTxsOptions, type UseSimulateOptions, type UseSubmitTxOptions, type UseWaitForExecutionOptions, type UseWaitForExecutionReceiptOptions, type WaitForExecutionReceiptResult, useFetchPendingTxs, useSimulate, useSubmitTx, useWaitForExecution, useWaitForExecutionReceipt, useWrite };

package/dist/react.js

@@ -53,11 +53,59 @@ function useWaitForExecution(options) {
   });
 }
 
-// src/react/use-fetch-pending-txs.ts
+// src/react/use-wait-for-execution-receipt.ts
 import { useQuery as useQuery2 } from "@tanstack/react-query";
+import { waitForTransactionReceipt } from "@wagmi/core";
+function useWaitForExecutionReceipt(options) {
+  const {
+    config,
+    enabled = true,
+    pollingInterval = 5e3,
+    timeout = 12e4,
+    confirmations = 1,
+    ...waitOptions
+  } = options;
+  const maxAttempts = Math.ceil(timeout / pollingInterval);
+  return useQuery2({
+    queryKey: [
+      "adapter",
+      options.adapter,
+      "waitForExecutionReceipt",
+      options.txHash,
+      options.chainId.toString(),
+      confirmations
+    ],
+    queryFn: async () => {
+      const { transactionHash } = await waitForExecution({
+        ...waitOptions,
+        pollingInterval,
+        maxAttempts
+      });
+      const receipt = await waitForTransactionReceipt(config, {
+        hash: transactionHash,
+        confirmations
+      });
+      return {
+        transactionHash,
+        receipt
+      };
+    },
+    enabled: enabled && !!options.txHash,
+    refetchInterval: false,
+    refetchOnWindowFocus: false,
+    refetchOnMount: false,
+    refetchOnReconnect: false,
+    retry: false,
+    staleTime: Infinity,
+    gcTime: 1e3 * 60 * 5
+  });
+}
+
+// src/react/use-fetch-pending-txs.ts
+import { useQuery as useQuery3 } from "@tanstack/react-query";
 function useFetchPendingTxs(options) {
   const { enabled = true, refetchInterval = false, ...fetchOptions } = options;
-  return useQuery2({
+  return useQuery3({
     queryKey: [
       "adapter",
       options.adapter,
@@ -72,10 +120,10 @@ function useFetchPendingTxs(options) {
 }
 
 // src/react/use-simulate.ts
-import { useQuery as useQuery3 } from "@tanstack/react-query";
+import { useQuery as useQuery4 } from "@tanstack/react-query";
 function useSimulate(options) {
   const { enabled = true, ...simulateOptions } = options;
-  return useQuery3({
+  return useQuery4({
     queryKey: [
       "adapter",
       options.adapter,
@@ -101,6 +149,7 @@ export {
   useSimulate,
   useSubmitTx,
   useWaitForExecution,
+  useWaitForExecutionReceipt,
   useWrite
 };
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/use-submit-tx.ts","../src/react/use-wait-for-execution.ts","../src/react/use-fetch-pending-txs.ts","../src/react/use-simulate.ts","../src/react/use-write.ts"],"sourcesContent":["import { useMutation } from \"@tanstack/react-query\";\nimport { submitTx } from \"../adapters/index.js\";\nimport type { SubmitTxOptions, SubmitTxResult } from \"../adapters/types.js\";\n\nexport type UseSubmitTxOptions = Omit<SubmitTxOptions, \"config\"> & {\n  config: SubmitTxOptions[\"config\"];\n};\n\nexport function useSubmitTx() {\n  return useMutation<SubmitTxResult, Error, UseSubmitTxOptions>({\n    mutationFn: (options) => submitTx(options),\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions, WaitForExecutionResult } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms. After this duration, the query will fail. Defaults to 120000 (2 min). */\n  timeout?: number;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed on-chain.\n *\n * Unlike standard polling queries, this hook maintains a stable loading state\n * throughout the polling process (similar to wagmi's useWaitForTransactionReceipt):\n * - `isLoading` = true while waiting for execution\n * - `isSuccess` = true once transaction is executed\n * - `isError` = true if timeout is reached\n */\nexport function useWaitForExecution(options: UseWaitForExecutionOptions) {\n  const {\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    ...waitOptions\n  } = options;\n\n  // Calculate max attempts from timeout and polling interval\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecution\",\n      options.txHash,\n      options.chainId.toString(),\n    ],\n    queryFn: () =>\n      waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      }),\n    enabled: enabled && !!options.txHash,\n    // Don't refetch - the query handles polling internally\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    // Don't retry on error - timeout is intentional\n    retry: false,\n    // Keep data fresh\n    staleTime: Infinity,\n    // Cache result for this specific txHash\n    gcTime: 1000 * 60 * 5, // 5 minutes\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { fetchPendingTxs } from \"../adapters/index.js\";\nimport type { FetchPendingOptions } from \"../adapters/types.js\";\n\nexport interface UseFetchPendingTxsOptions extends FetchPendingOptions {\n  enabled?: boolean;\n  refetchInterval?: number | false;\n}\n\nexport function useFetchPendingTxs(options: UseFetchPendingTxsOptions) {\n  const { enabled = true, refetchInterval = false, ...fetchOptions } = options;\n\n  return useQuery<unknown[], Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"pendingTxs\",\n      options.walletAddress,\n      options.chainId.toString(),\n    ],\n    queryFn: () => fetchPendingTxs(fetchOptions),\n    enabled: enabled && !!options.walletAddress,\n    refetchInterval,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { simulate } from \"../adapters/index.js\";\nimport type { SimulateOptions } from \"../adapters/types.js\";\n\nexport interface UseSimulateOptions extends SimulateOptions {\n  enabled?: boolean;\n}\n\nexport function useSimulate(options: UseSimulateOptions) {\n  const { enabled = true, ...simulateOptions } = options;\n\n  return useQuery<unknown, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"simulate\",\n      options.address,\n      options.functionName,\n      JSON.stringify(options.args),\n    ],\n    queryFn: () => simulate(simulateOptions),\n    enabled,\n  });\n}\n","import { useMutation } from \"@tanstack/react-query\";\nimport { write } from \"../adapters/index.js\";\nimport type { WriteOptions } from \"../adapters/types.js\";\n\nexport function useWrite() {\n  return useMutation<string, Error, WriteOptions>({\n    mutationFn: (options) => write(options),\n  });\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,mBAAmB;AAQrB,SAAS,cAAc;AAC5B,SAAO,YAAuD;AAAA,IAC5D,YAAY,CAAC,YAAY,SAAS,OAAO;AAAA,EAC3C,CAAC;AACH;;;ACZA,SAAS,gBAAgB;AAsBlB,SAAS,oBAAoB,SAAqC;AACvE,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,kBAAkB;AAAA,IAClB,UAAU;AAAA,IACV,GAAG;AAAA,EACL,IAAI;AAGJ,QAAM,cAAc,KAAK,KAAK,UAAU,eAAe;AAEvD,SAAO,SAAwC;AAAA,IAC7C,UAAU;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,QAAQ,QAAQ,SAAS;AAAA,IAC3B;AAAA,IACA,SAAS,MACP,iBAAiB;AAAA,MACf,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACF,CAAC;AAAA,IACH,SAAS,WAAW,CAAC,CAAC,QAAQ;AAAA;AAAA,IAE9B,iBAAiB;AAAA,IACjB,sBAAsB;AAAA,IACtB,gBAAgB;AAAA,IAChB,oBAAoB;AAAA;AAAA,IAEpB,OAAO;AAAA;AAAA,IAEP,WAAW;AAAA;AAAA,IAEX,QAAQ,MAAO,KAAK;AAAA;AAAA,EACtB,CAAC;AACH;;;AC5DA,SAAS,YAAAA,iBAAgB;AASlB,SAAS,mBAAmB,SAAoC;AACrE,QAAM,EAAE,UAAU,MAAM,kBAAkB,OAAO,GAAG,aAAa,IAAI;AAErE,SAAOC,UAA2B;AAAA,IAChC,UAAU;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,QAAQ,QAAQ,SAAS;AAAA,IAC3B;AAAA,IACA,SAAS,MAAM,gBAAgB,YAAY;AAAA,IAC3C,SAAS,WAAW,CAAC,CAAC,QAAQ;AAAA,IAC9B;AAAA,EACF,CAAC;AACH;;;ACxBA,SAAS,YAAAC,iBAAgB;AAQlB,SAAS,YAAY,SAA6B;AACvD,QAAM,EAAE,UAAU,MAAM,GAAG,gBAAgB,IAAI;AAE/C,SAAOC,UAAyB;AAAA,IAC9B,UAAU;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,KAAK,UAAU,QAAQ,IAAI;AAAA,IAC7B;AAAA,IACA,SAAS,MAAM,SAAS,eAAe;AAAA,IACvC;AAAA,EACF,CAAC;AACH;;;ACvBA,SAAS,eAAAC,oBAAmB;AAIrB,SAAS,WAAW;AACzB,SAAOC,aAAyC;AAAA,IAC9C,YAAY,CAAC,YAAY,MAAM,OAAO;AAAA,EACxC,CAAC;AACH;","names":["useQuery","useQuery","useQuery","useQuery","useMutation","useMutation"]}
+{"version":3,"sources":["../src/react/use-submit-tx.ts","../src/react/use-wait-for-execution.ts","../src/react/use-wait-for-execution-receipt.ts","../src/react/use-fetch-pending-txs.ts","../src/react/use-simulate.ts","../src/react/use-write.ts"],"sourcesContent":["import { useMutation } from \"@tanstack/react-query\";\nimport { submitTx } from \"../adapters/index.js\";\nimport type { SubmitTxOptions, SubmitTxResult } from \"../adapters/types.js\";\n\nexport type UseSubmitTxOptions = Omit<SubmitTxOptions, \"config\"> & {\n  config: SubmitTxOptions[\"config\"];\n};\n\nexport function useSubmitTx() {\n  return useMutation<SubmitTxResult, Error, UseSubmitTxOptions>({\n    mutationFn: (options) => submitTx(options),\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions, WaitForExecutionResult } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionOptions extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms. After this duration, the query will fail. Defaults to 120000 (2 min). */\n  timeout?: number;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed on-chain.\n *\n * Unlike standard polling queries, this hook maintains a stable loading state\n * throughout the polling process (similar to wagmi's useWaitForTransactionReceipt):\n * - `isLoading` = true while waiting for execution\n * - `isSuccess` = true once transaction is executed\n * - `isError` = true if timeout is reached\n */\nexport function useWaitForExecution(options: UseWaitForExecutionOptions) {\n  const {\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    ...waitOptions\n  } = options;\n\n  // Calculate max attempts from timeout and polling interval\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecution\",\n      options.txHash,\n      options.chainId.toString(),\n    ],\n    queryFn: () =>\n      waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      }),\n    enabled: enabled && !!options.txHash,\n    // Don't refetch - the query handles polling internally\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    // Don't retry on error - timeout is intentional\n    retry: false,\n    // Keep data fresh\n    staleTime: Infinity,\n    // Cache result for this specific txHash\n    gcTime: 1000 * 60 * 5, // 5 minutes\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { waitForTransactionReceipt } from \"@wagmi/core\";\nimport type { Config } from \"@wagmi/core\";\nimport type { TransactionReceipt } from \"viem\";\nimport { waitForExecution } from \"../adapters/index.js\";\nimport type { WaitForExecutionOptions } from \"../adapters/types.js\";\n\nexport interface UseWaitForExecutionReceiptOptions\n  extends Omit<WaitForExecutionOptions, \"maxAttempts\"> {\n  /** Wagmi config for fetching the receipt. */\n  config: Config;\n  /** Enable/disable the query. Defaults to true. */\n  enabled?: boolean;\n  /** Polling interval in ms for Safe tx. Defaults to 5000. */\n  pollingInterval?: number;\n  /** Timeout in ms for Safe tx execution. Defaults to 120000 (2 min). */\n  timeout?: number;\n  /** Number of confirmations to wait for. Defaults to 1. */\n  confirmations?: number;\n}\n\nexport interface WaitForExecutionReceiptResult {\n  /** The on-chain transaction hash. */\n  transactionHash: string;\n  /** The full transaction receipt with logs. */\n  receipt: TransactionReceipt;\n}\n\n/**\n * Hook to wait for a Safe transaction to be executed and return the full receipt with logs.\n *\n * Combines waiting for Safe execution with fetching the transaction receipt:\n * 1. Polls Safe Transaction Service until the tx is executed\n * 2. Fetches the on-chain transaction receipt with logs\n *\n * @example\n * ```tsx\n * const { data, isLoading, isSuccess } = useWaitForExecutionReceipt({\n *   adapter: \"safe\",\n *   txHash: safeTxHash,\n *   chainId: 11155111n,\n *   config: wagmiConfig,\n * });\n *\n * if (isSuccess) {\n *   console.log(\"Logs:\", data.receipt.logs);\n * }\n * ```\n */\nexport function useWaitForExecutionReceipt(\n  options: UseWaitForExecutionReceiptOptions\n) {\n  const {\n    config,\n    enabled = true,\n    pollingInterval = 5000,\n    timeout = 120000,\n    confirmations = 1,\n    ...waitOptions\n  } = options;\n\n  const maxAttempts = Math.ceil(timeout / pollingInterval);\n\n  return useQuery<WaitForExecutionReceiptResult, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"waitForExecutionReceipt\",\n      options.txHash,\n      options.chainId.toString(),\n      confirmations,\n    ],\n    queryFn: async () => {\n      // Step 1: Wait for Safe tx to be executed\n      const { transactionHash } = await waitForExecution({\n        ...waitOptions,\n        pollingInterval,\n        maxAttempts,\n      });\n\n      // Step 2: Get the transaction receipt with logs\n      const receipt = await waitForTransactionReceipt(config, {\n        hash: transactionHash as `0x${string}`,\n        confirmations,\n      });\n\n      return {\n        transactionHash,\n        receipt,\n      };\n    },\n    enabled: enabled && !!options.txHash,\n    refetchInterval: false,\n    refetchOnWindowFocus: false,\n    refetchOnMount: false,\n    refetchOnReconnect: false,\n    retry: false,\n    staleTime: Infinity,\n    gcTime: 1000 * 60 * 5,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { fetchPendingTxs } from \"../adapters/index.js\";\nimport type { FetchPendingOptions } from \"../adapters/types.js\";\n\nexport interface UseFetchPendingTxsOptions extends FetchPendingOptions {\n  enabled?: boolean;\n  refetchInterval?: number | false;\n}\n\nexport function useFetchPendingTxs(options: UseFetchPendingTxsOptions) {\n  const { enabled = true, refetchInterval = false, ...fetchOptions } = options;\n\n  return useQuery<unknown[], Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"pendingTxs\",\n      options.walletAddress,\n      options.chainId.toString(),\n    ],\n    queryFn: () => fetchPendingTxs(fetchOptions),\n    enabled: enabled && !!options.walletAddress,\n    refetchInterval,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { simulate } from \"../adapters/index.js\";\nimport type { SimulateOptions } from \"../adapters/types.js\";\n\nexport interface UseSimulateOptions extends SimulateOptions {\n  enabled?: boolean;\n}\n\nexport function useSimulate(options: UseSimulateOptions) {\n  const { enabled = true, ...simulateOptions } = options;\n\n  return useQuery<unknown, Error>({\n    queryKey: [\n      \"adapter\",\n      options.adapter,\n      \"simulate\",\n      options.address,\n      options.functionName,\n      JSON.stringify(options.args),\n    ],\n    queryFn: () => simulate(simulateOptions),\n    enabled,\n  });\n}\n","import { useMutation } from \"@tanstack/react-query\";\nimport { write } from \"../adapters/index.js\";\nimport type { WriteOptions } from \"../adapters/types.js\";\n\nexport function useWrite() {\n  return useMutation<string, Error, WriteOptions>({\n    mutationFn: (options) => write(options),\n  });\n}\n"],"mappings":"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","names":["useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useMutation","useMutation"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-multisig-engine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "",
   "type": "module",
   "main": "./dist/index.cjs",