permissionless 0.0.7 → 0.0.9

package/_esm/utils/observe.js

@@ -0,0 +1,42 @@
+export const listenersCache = /*#__PURE__*/ new Map();
+export const cleanupCache = /*#__PURE__*/ new Map();
+let callbackCount = 0;
+/**
+ * @description Sets up an observer for a given function. If another function
+ * is set up under the same observer id, the function will only be called once
+ * for both instances of the observer.
+ */
+export function observe(observerId, callbacks, fn) {
+    const callbackId = ++callbackCount;
+    const getListeners = () => listenersCache.get(observerId) || [];
+    const unsubscribe = () => {
+        const listeners = getListeners();
+        listenersCache.set(observerId, 
+        // biome-ignore lint/suspicious/noExplicitAny: it's a recursive function, so it's hard to type
+        listeners.filter((cb) => cb.id !== callbackId));
+    };
+    const unwatch = () => {
+        const cleanup = cleanupCache.get(observerId);
+        if (getListeners().length === 1 && cleanup)
+            cleanup();
+        unsubscribe();
+    };
+    const listeners = getListeners();
+    listenersCache.set(observerId, [...listeners, { id: callbackId, fns: callbacks }]);
+    if (listeners && listeners.length > 0)
+        return unwatch;
+    const emit = {};
+    for (const key in callbacks) {
+        emit[key] = ((...args) => {
+            const listeners = getListeners();
+            if (listeners.length === 0)
+                return;
+            listeners.forEach((listener) => listener.fns[key]?.(...args));
+        });
+    }
+    const cleanup = fn(emit);
+    if (typeof cleanup === "function")
+        cleanupCache.set(observerId, cleanup);
+    return unwatch;
+}
+//# sourceMappingURL=observe.js.map

package/_esm/utils/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../utils/observe.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,GAAG,EAA4C,CAAA;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,EAAsB,CAAA;AAIvE,IAAI,aAAa,GAAG,CAAC,CAAA;AAErB;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACnB,UAAkB,EAClB,SAAqB,EACrB,EAA4B;IAE5B,MAAM,UAAU,GAAG,EAAE,aAAa,CAAA;IAElC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAE/D,MAAM,WAAW,GAAG,GAAG,EAAE;QACrB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;QAChC,cAAc,CAAC,GAAG,CACd,UAAU;QACV,8FAA8F;QAC9F,SAAS,CAAC,MAAM,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,UAAU,CAAC,CACtD,CAAA;IACL,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC5C,IAAI,YAAY,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO;YAAE,OAAO,EAAE,CAAA;QACrD,WAAW,EAAE,CAAA;IACjB,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAChC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;IAElF,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAA;IAErD,MAAM,IAAI,GAAe,EAAgB,CAAA;IACzC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE;QACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAA2D,EAAE,EAAE;YAC5E,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;YAChC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAClC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QACjE,CAAC,CAAkD,CAAA;KACtD;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACxB,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAExE,OAAO,OAAO,CAAA;AAClB,CAAC"}

package/_types/actions/bundler/getUserOperationReceipt.d.ts

@@ -35,7 +35,7 @@ export type GetUserOperationReceiptReturnType = {
         address: Address;
         topics: Hex[];
     }[];
-} | null;
+};
 /**
  * Returns the user operation receipt from userOpHash
  *
@@ -58,36 +58,5 @@ export type GetUserOperationReceiptReturnType = {
  * getUserOperationReceipt(bundlerClient, {hash: userOpHash})
  *
  */
-export declare const getUserOperationReceipt: (client: BundlerClient, { hash }: GetUserOperationReceiptParameters) => Promise<{
-    userOpHash: Hash;
-    sender: Address;
-    nonce: bigint;
-    actualGasUsed: bigint;
-    actualGasCost: bigint;
-    success: boolean;
-    receipt: {
-        transactionHash: Hex;
-        transactionIndex: bigint;
-        blockHash: Hash;
-        blockNumber: bigint;
-        from: Address;
-        to: Address | null;
-        cumulativeGasUsed: bigint;
-        status: TStatus;
-        gasUsed: bigint;
-        contractAddress: Address | null;
-        logsBloom: Hex;
-        effectiveGasPrice: bigint;
-    };
-    logs: {
-        data: Hex;
-        blockNumber: bigint;
-        blockHash: Hash;
-        transactionHash: Hash;
-        logIndex: bigint;
-        transactionIndex: bigint;
-        address: Address;
-        topics: Hex[];
-    }[];
-} | null>;
+export declare const getUserOperationReceipt: (client: BundlerClient, { hash }: GetUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType | null>;
 //# sourceMappingURL=getUserOperationReceipt.d.ts.map

package/_types/actions/bundler/getUserOperationReceipt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getUserOperationReceipt.d.ts","sourceRoot":"","sources":["../../../actions/bundler/getUserOperationReceipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAG3D,MAAM,MAAM,iCAAiC,GAAG;IAC5C,IAAI,EAAE,IAAI,CAAA;CACb,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC5C,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACL,eAAe,EAAE,GAAG,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,IAAI,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,OAAO,CAAA;QACb,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;QAClB,iBAAiB,EAAE,MAAM,CAAA;QACzB,MAAM,EAAE,OAAO,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,GAAG,CAAA;QACd,iBAAiB,EAAE,MAAM,CAAA;KAC5B,CAAA;IACD,IAAI,EAAE;QACF,IAAI,EAAE,GAAG,CAAA;QACT,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,IAAI,CAAA;QACf,eAAe,EAAE,IAAI,CAAA;QACrB,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,CAAA;KAChB,EAAE,CAAA;CACN,GAAG,IAAI,CAAA;AAER;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,uBAAuB,WAAkB,aAAa,YAAY,iCAAiC;gBAtDhG,IAAI;YACR,OAAO;WACR,MAAM;mBACE,MAAM;mBACN,MAAM;aACZ,OAAO;aACP;QACL,eAAe,EAAE,GAAG,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,IAAI,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,OAAO,CAAA;QACb,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;QAClB,iBAAiB,EAAE,MAAM,CAAA;QACzB,QAAQ,OAAO,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,GAAG,CAAA;QACd,iBAAiB,EAAE,MAAM,CAAA;KAC5B;UACK;QACF,IAAI,EAAE,GAAG,CAAA;QACT,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,IAAI,CAAA;QACf,eAAe,EAAE,IAAI,CAAA;QACrB,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,CAAA;KAChB,EAAE;SAqEN,CAAA"}
+{"version":3,"file":"getUserOperationReceipt.d.ts","sourceRoot":"","sources":["../../../actions/bundler/getUserOperationReceipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAG3D,MAAM,MAAM,iCAAiC,GAAG;IAC5C,IAAI,EAAE,IAAI,CAAA;CACb,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC5C,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACL,eAAe,EAAE,GAAG,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,IAAI,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,OAAO,CAAA;QACb,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;QAClB,iBAAiB,EAAE,MAAM,CAAA;QACzB,MAAM,EAAE,OAAO,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,GAAG,CAAA;QACd,iBAAiB,EAAE,MAAM,CAAA;KAC5B,CAAA;IACD,IAAI,EAAE;QACF,IAAI,EAAE,GAAG,CAAA;QACT,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,IAAI,CAAA;QACf,eAAe,EAAE,IAAI,CAAA;QACrB,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,CAAA;KAChB,EAAE,CAAA;CACN,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,uBAAuB,WACxB,aAAa,YACX,iCAAiC,KAC5C,QAAQ,iCAAiC,GAAG,IAAI,CA4ClD,CAAA"}

package/_types/actions/bundler/waitForUserOperationReceipt.d.ts

@@ -0,0 +1,43 @@
+import { BaseError, type Chain, type Hash } from "viem";
+import type { BundlerClient } from "../../clients/bundler.js";
+import { type GetUserOperationReceiptReturnType } from "./getUserOperationReceipt.js";
+export declare class WaitForUserOperationReceiptTimeoutError extends BaseError {
+    name: string;
+    constructor({ hash }: {
+        hash: Hash;
+    });
+}
+export type WaitForUserOperationReceiptParameters = {
+    /** The hash of the transaction. */
+    hash: Hash;
+    /**
+     * Polling frequency (in ms). Defaults to the client's pollingInterval config.
+     * @default client.pollingInterval
+     */
+    pollingInterval?: number;
+    /** Optional timeout (in milliseconds) to wait before stopping polling. */
+    timeout?: number;
+};
+/**
+ * Waits for the User Operation to be included on a [Block](https://viem.sh/docs/glossary/terms.html#block) (one confirmation), and then returns the [User Operation Receipt](https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt).
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/waitForUserOperationReceipt
+ *
+ * @param client - Bundler Client to use
+ * @param parameters - {@link WaitForUserOperationReceiptParameters}
+ * @returns The transaction receipt. {@link GetUserOperationReceiptReturnType}
+ *
+ * @example
+ * import { createBundlerClient, waitForUserOperationReceipt, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createBundlerClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const userOperationReceipt = await waitForUserOperationReceipt(client, {
+ *   hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d',
+ * })
+ */
+export declare const waitForUserOperationReceipt: <TChain extends Chain | undefined>(bundlerClient: BundlerClient<TChain>, { hash, pollingInterval, timeout }: WaitForUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType>;
+//# sourceMappingURL=waitForUserOperationReceipt.d.ts.map

package/_types/actions/bundler/waitForUserOperationReceipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForUserOperationReceipt.d.ts","sourceRoot":"","sources":["../../../actions/bundler/waitForUserOperationReceipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,IAAI,EAAa,MAAM,MAAM,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAAE,KAAK,iCAAiC,EAA2B,MAAM,8BAA8B,CAAA;AAE9G,qBAAa,uCAAwC,SAAQ,SAAS;IACzD,IAAI,SAA4C;gBAC7C,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE;CAGvC;AAED,MAAM,MAAM,qCAAqC,GAAG;IAChD,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAA;IACV;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,2BAA2B,+GAEgC,qCAAqC,KAC1G,QAAQ,iCAAiC,CA+B3C,CAAA"}

package/_types/actions/index.d.ts

@@ -11,8 +11,10 @@ import { getUserOperationByHash } from "./bundler/getUserOperationByHash.js";
 import { getUserOperationReceipt } from "./bundler/getUserOperationReceipt.js";
 import { sendUserOperation } from "./bundler/sendUserOperation.js";
 import { supportedEntryPoints } from "./bundler/supportedEntryPoints.js";
+import { waitForUserOperationReceipt } from "./bundler/waitForUserOperationReceipt.js";
+import { type WaitForUserOperationReceiptParameters, WaitForUserOperationReceiptTimeoutError } from "./bundler/waitForUserOperationReceipt.js";
 import type { GetAccountNonceParams } from "./public/getAccountNonce.js";
 import { getAccountNonce } from "./public/getAccountNonce.js";
-export type { SendUserOperationParameters, EstimateUserOperationGasParameters, EstimateUserOperationGasReturnType, GetUserOperationByHashParameters, GetUserOperationByHashReturnType, GetUserOperationReceiptParameters, GetUserOperationReceiptReturnType, GetSenderAddressParams, GetAccountNonceParams };
-export { sendUserOperation, estimateUserOperationGas, supportedEntryPoints, chainId, getUserOperationByHash, getUserOperationReceipt, getSenderAddress, getAccountNonce, InvalidEntryPointError };
+export type { SendUserOperationParameters, EstimateUserOperationGasParameters, EstimateUserOperationGasReturnType, GetUserOperationByHashParameters, GetUserOperationByHashReturnType, GetUserOperationReceiptParameters, GetUserOperationReceiptReturnType, GetSenderAddressParams, GetAccountNonceParams, WaitForUserOperationReceiptParameters };
+export { sendUserOperation, estimateUserOperationGas, supportedEntryPoints, chainId, getUserOperationByHash, getUserOperationReceipt, getSenderAddress, getAccountNonce, InvalidEntryPointError, waitForUserOperationReceipt, WaitForUserOperationReceiptTimeoutError };
 //# sourceMappingURL=index.d.ts.map

package/_types/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AAC3F,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AAC3F,OAAO,KAAK,EACR,iCAAiC,EACjC,iCAAiC,EACpC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AAEjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,YAAY,EACR,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,sBAAsB,EACtB,qBAAqB,EACxB,CAAA;AAED,OAAO,EACH,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,OAAO,EACP,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACzB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AAC3F,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AAC3F,OAAO,KAAK,EACR,iCAAiC,EACjC,iCAAiC,EACpC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AAEjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAA;AACtF,OAAO,EACH,KAAK,qCAAqC,EAC1C,uCAAuC,EAC1C,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,YAAY,EACR,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,sBAAsB,EACtB,qBAAqB,EACrB,qCAAqC,EACxC,CAAA;AAED,OAAO,EACH,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,OAAO,EACP,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,uCAAuC,EAC1C,CAAA"}

package/_types/clients/bundler.d.ts

@@ -1,7 +1,7 @@
 import type { Account, Chain, Client, PublicClientConfig, Transport } from "viem";
 import type { BundlerRpcSchema } from "../types/bundler.js";
 import { type BundlerActions } from "./decorators/bundler.js";
-export type BundlerClient = Client<Transport, Chain | undefined, Account | undefined, BundlerRpcSchema, BundlerActions>;
+export type BundlerClient<TChain extends Chain | undefined = Chain | undefined> = Client<Transport, TChain, Account | undefined, BundlerRpcSchema, BundlerActions>;
 /**
  * Creates a EIP-4337 compliant Bundler Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
  *

package/_types/clients/bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../clients/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,yBAAyB,CAAA;AAE7E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAA;AACvH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;MAE7B,aASF,CAAA"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../clients/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,yBAAyB,CAAA;AAE7E,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,IAAI,MAAM,CACpF,SAAS,EACT,MAAM,EACN,OAAO,GAAG,SAAS,EACnB,gBAAgB,EAChB,cAAc,CACjB,CAAA;AACD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;MAE7B,aASF,CAAA"}

package/_types/clients/decorators/bundler.d.ts

@@ -4,6 +4,7 @@ import { type EstimateUserOperationGasParameters, type EstimateUserOperationGasR
 import { type GetUserOperationByHashParameters, type GetUserOperationByHashReturnType } from "../../actions/bundler/getUserOperationByHash.js";
 import { type GetUserOperationReceiptParameters, type GetUserOperationReceiptReturnType } from "../../actions/bundler/getUserOperationReceipt.js";
 import { type SendUserOperationParameters } from "../../actions/bundler/sendUserOperation.js";
+import { type WaitForUserOperationReceiptParameters } from "../../actions/bundler/waitForUserOperationReceipt.js";
 export type BundlerActions = {
     /**
      *
@@ -143,7 +144,29 @@ export type BundlerActions = {
      * await bundlerClient.getUserOperationReceipt({hash: userOpHash})
      *
      */
-    getUserOperationReceipt: (args: GetUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType>;
+    getUserOperationReceipt: (args: GetUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType | null>;
+    /**
+     * Waits for the User Operation to be included on a [Block](https://viem.sh/docs/glossary/terms.html#block) (one confirmation), and then returns the [User Operation Receipt](https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt).
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/waitForUserOperationReceipt
+     *
+     * @param client - Bundler Client to use
+     * @param parameters - {@link WaitForUserOperationReceiptParameters}
+     * @returns The transaction receipt. {@link GetUserOperationReceiptReturnType}
+     *
+     * @example
+     * import { createBundlerClient, waitForUserOperationReceipt, http } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const bundlerClient = createBundlerClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const userOperationReceipt = await bundlerClient.waitForUserOperationReceipt({
+     *   hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d',
+     * })
+     */
+    waitForUserOperationReceipt: (args: WaitForUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType>;
 };
 declare const bundlerActions: (client: Client) => BundlerActions;
 export { bundlerActions };

package/_types/clients/decorators/bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../clients/decorators/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,EACH,KAAK,kCAAkC,EACvC,KAAK,kCAAkC,EAE1C,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAExC,MAAM,iDAAiD,CAAA;AACxD,OAAO,EACH,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EAEzC,MAAM,kDAAkD,CAAA;AACzD,OAAO,EAAE,KAAK,2BAA2B,EAAqB,MAAM,4CAA4C,CAAA;AAIhH,MAAM,MAAM,cAAc,GAAG;IACzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,wBAAwB,EAAE,CAAC,IAAI,EAAE,kCAAkC,KAAK,OAAO,CAAC,kCAAkC,CAAC,CAAA;IACnH;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,sBAAsB,EAAE,CAAC,IAAI,EAAE,gCAAgC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;IAC7G;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,uBAAuB,EAAE,CAAC,IAAI,EAAE,iCAAiC,KAAK,OAAO,CAAC,iCAAiC,CAAC,CAAA;CACnH,CAAA;AAED,QAAA,MAAM,cAAc,WAAY,MAAM,KAAG,cAWvC,CAAA;AAEF,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../clients/decorators/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,EACH,KAAK,kCAAkC,EACvC,KAAK,kCAAkC,EAE1C,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EACH,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAExC,MAAM,iDAAiD,CAAA;AACxD,OAAO,EACH,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EAEzC,MAAM,kDAAkD,CAAA;AACzD,OAAO,EAAE,KAAK,2BAA2B,EAAqB,MAAM,4CAA4C,CAAA;AAEhH,OAAO,EACH,KAAK,qCAAqC,EAE7C,MAAM,sDAAsD,CAAA;AAG7D,MAAM,MAAM,cAAc,GAAG;IACzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,wBAAwB,EAAE,CAAC,IAAI,EAAE,kCAAkC,KAAK,OAAO,CAAC,kCAAkC,CAAC,CAAA;IACnH;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,sBAAsB,EAAE,CAAC,IAAI,EAAE,gCAAgC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;IAC7G;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,uBAAuB,EAAE,CACrB,IAAI,EAAE,iCAAiC,KACtC,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC,CAAA;IAEtD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,2BAA2B,EAAE,CACzB,IAAI,EAAE,qCAAqC,KAC1C,OAAO,CAAC,iCAAiC,CAAC,CAAA;CAClD,CAAA;AAED,QAAA,MAAM,cAAc,WAAY,MAAM,KAAG,cAavC,CAAA;AAEF,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/_types/index.d.ts

@@ -11,13 +11,15 @@ import { getUserOperationByHash } from "./actions/bundler/getUserOperationByHash
 import { getUserOperationReceipt } from "./actions/bundler/getUserOperationReceipt.js";
 import { sendUserOperation } from "./actions/bundler/sendUserOperation.js";
 import { supportedEntryPoints } from "./actions/bundler/supportedEntryPoints.js";
+import { waitForUserOperationReceipt } from "./actions/bundler/waitForUserOperationReceipt.js";
+import { type WaitForUserOperationReceiptParameters, WaitForUserOperationReceiptTimeoutError } from "./actions/bundler/waitForUserOperationReceipt.js";
 import type { GetAccountNonceParams } from "./actions/public/getAccountNonce.js";
 import { getAccountNonce } from "./actions/public/getAccountNonce.js";
 import { type BundlerClient, createBundlerClient } from "./clients/bundler.js";
 import type { BundlerActions } from "./clients/decorators/bundler.js";
 import { bundlerActions } from "./clients/decorators/bundler.js";
-export type { SendUserOperationParameters, EstimateUserOperationGasParameters, EstimateUserOperationGasReturnType, GetUserOperationByHashParameters, GetUserOperationByHashReturnType, GetUserOperationReceiptParameters, GetUserOperationReceiptReturnType, GetSenderAddressParams, GetAccountNonceParams, BundlerClient, BundlerActions };
-export { sendUserOperation, estimateUserOperationGas, supportedEntryPoints, chainId, getUserOperationByHash, getUserOperationReceipt, getSenderAddress, getAccountNonce, createBundlerClient, bundlerActions };
+export type { SendUserOperationParameters, EstimateUserOperationGasParameters, EstimateUserOperationGasReturnType, GetUserOperationByHashParameters, GetUserOperationByHashReturnType, GetUserOperationReceiptParameters, GetUserOperationReceiptReturnType, GetSenderAddressParams, GetAccountNonceParams, BundlerClient, BundlerActions, WaitForUserOperationReceiptParameters };
+export { sendUserOperation, estimateUserOperationGas, supportedEntryPoints, chainId, getUserOperationByHash, getUserOperationReceipt, getSenderAddress, getAccountNonce, waitForUserOperationReceipt, createBundlerClient, bundlerActions, WaitForUserOperationReceiptTimeoutError };
 import type { UserOperation } from "./types/userOperation.js";
 export { type UserOperation };
 import type { GetUserOperationHashParams } from "./utils/getUserOperationHash.js";

package/_types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,+CAA+C,CAAA;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAA;AACnG,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAA;AACnG,OAAO,KAAK,EACR,iCAAiC,EACjC,iCAAiC,EACpC,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA;AAEzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAA;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAEhE,YAAY,EACR,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACjB,CAAA;AAED,OAAO,EACH,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,OAAO,EACP,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACjB,CAAA;AACD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAAE,KAAK,aAAa,EAAE,CAAA;AAE7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,CAAA;AAChE,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,+CAA+C,CAAA;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAA;AACnG,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAA;AACnG,OAAO,KAAK,EACR,iCAAiC,EACjC,iCAAiC,EACpC,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA;AAEzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAA;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAA;AAC9F,OAAO,EACH,KAAK,qCAAqC,EAC1C,uCAAuC,EAC1C,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAEhE,YAAY,EACR,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,qCAAqC,EACxC,CAAA;AAED,OAAO,EACH,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,OAAO,EACP,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,EACd,uCAAuC,EAC1C,CAAA;AACD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAAE,KAAK,aAAa,EAAE,CAAA;AAE7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,CAAA;AAChE,cAAc,kBAAkB,CAAA"}

package/_types/{actions/utils.d.ts → utils/deepHexlify.d.ts}

@@ -3,4 +3,4 @@ export declare const transactionReceiptStatus: {
     readonly "0x1": "success";
 };
 export declare function deepHexlify(obj: any): any;
-//# sourceMappingURL=utils.d.ts.map
+//# sourceMappingURL=deepHexlify.d.ts.map

package/_types/utils/deepHexlify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepHexlify.d.ts","sourceRoot":"","sources":["../../utils/deepHexlify.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB;;;CAG3B,CAAA;AAGV,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAqBzC"}

package/_types/utils/observe.d.ts

@@ -0,0 +1,17 @@
+import type { MaybePromise } from "viem/types/utils";
+type Callback = ((...args: any[]) => any) | undefined;
+type Callbacks = Record<string, Callback>;
+export declare const listenersCache: Map<string, {
+    id: number;
+    fns: Callbacks;
+}[]>;
+export declare const cleanupCache: Map<string, () => void>;
+type EmitFunction<TCallbacks extends Callbacks> = (emit: TCallbacks) => MaybePromise<void | (() => void)>;
+/**
+ * @description Sets up an observer for a given function. If another function
+ * is set up under the same observer id, the function will only be called once
+ * for both instances of the observer.
+ */
+export declare function observe<TCallbacks extends Callbacks>(observerId: string, callbacks: TCallbacks, fn: EmitFunction<TCallbacks>): () => void;
+export {};
+//# sourceMappingURL=observe.d.ts.map

package/_types/utils/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../utils/observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAGpD,KAAK,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS,CAAA;AACrD,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAEzC,eAAO,MAAM,cAAc;QAAuC,MAAM;SAAO,SAAS;IAAO,CAAA;AAC/F,eAAO,MAAM,YAAY,oBAAuC,IAAI,CAAG,CAAA;AAEvE,KAAK,YAAY,CAAC,UAAU,SAAS,SAAS,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK,YAAY,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAA;AAIzG;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,UAAU,SAAS,SAAS,EAChD,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,YAAY,CAAC,UAAU,CAAC,cAuC/B"}

package/actions/bundler/estimateUserOperationGas.ts

@@ -3,7 +3,7 @@ import type { PartialBy } from "viem/types/utils"
 import type { BundlerClient } from "../../clients/bundler.js"
 import type { UserOperation } from "../../types/userOperation.js"
 import type { UserOperationWithBigIntAsHex } from "../../types/userOperation.js"
-import { deepHexlify } from "../utils.js"
+import { deepHexlify } from "../../utils/deepHexlify.js"
 
 export type EstimateUserOperationGasParameters = {
     userOperation: PartialBy<UserOperation, "callGasLimit" | "preVerificationGas" | "verificationGasLimit">

package/actions/bundler/getUserOperationReceipt.ts

@@ -1,7 +1,7 @@
 import type { Address, Hash, Hex } from "viem"
 import type { BundlerClient } from "../../clients/bundler.js"
 import type { TStatus } from "../../types/userOperation.js"
-import { transactionReceiptStatus } from "../utils.js"
+import { transactionReceiptStatus } from "../../utils/deepHexlify.js"
 
 export type GetUserOperationReceiptParameters = {
     hash: Hash
@@ -38,7 +38,7 @@ export type GetUserOperationReceiptReturnType = {
         address: Address
         topics: Hex[]
     }[]
-} | null
+}
 
 /**
  * Returns the user operation receipt from userOpHash
@@ -62,7 +62,10 @@ export type GetUserOperationReceiptReturnType = {
  * getUserOperationReceipt(bundlerClient, {hash: userOpHash})
  *
  */
-export const getUserOperationReceipt = async (client: BundlerClient, { hash }: GetUserOperationReceiptParameters) => {
+export const getUserOperationReceipt = async (
+    client: BundlerClient,
+    { hash }: GetUserOperationReceiptParameters
+): Promise<GetUserOperationReceiptReturnType | null> => {
     const params: [Hash] = [hash]
 
     const response = await client.request({

package/actions/bundler/sendUserOperation.ts

@@ -1,7 +1,7 @@
 import type { Address, Hash } from "viem"
 import type { BundlerClient } from "../../clients/bundler.js"
 import type { UserOperation, UserOperationWithBigIntAsHex } from "../../types/userOperation.js"
-import { deepHexlify } from "../utils.js"
+import { deepHexlify } from "../../utils/deepHexlify.js"
 
 export type SendUserOperationParameters = {
     userOperation: UserOperation

package/actions/bundler/waitForUserOperationReceipt.ts

@@ -0,0 +1,80 @@
+import { BaseError, type Chain, type Hash, stringify } from "viem"
+import type { BundlerClient } from "../../clients/bundler.js"
+import { observe } from "../../utils/observe.js"
+import { type GetUserOperationReceiptReturnType, getUserOperationReceipt } from "./getUserOperationReceipt.js"
+
+export class WaitForUserOperationReceiptTimeoutError extends BaseError {
+    override name = "WaitForUserOperationReceiptTimeoutError"
+    constructor({ hash }: { hash: Hash }) {
+        super(`Timed out while waiting for transaction with hash "${hash}" to be confirmed.`)
+    }
+}
+
+export type WaitForUserOperationReceiptParameters = {
+    /** The hash of the transaction. */
+    hash: Hash
+    /**
+     * Polling frequency (in ms). Defaults to the client's pollingInterval config.
+     * @default client.pollingInterval
+     */
+    pollingInterval?: number
+    /** Optional timeout (in milliseconds) to wait before stopping polling. */
+    timeout?: number
+}
+
+/**
+ * Waits for the User Operation to be included on a [Block](https://viem.sh/docs/glossary/terms.html#block) (one confirmation), and then returns the [User Operation Receipt](https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt).
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/waitForUserOperationReceipt
+ *
+ * @param client - Bundler Client to use
+ * @param parameters - {@link WaitForUserOperationReceiptParameters}
+ * @returns The transaction receipt. {@link GetUserOperationReceiptReturnType}
+ *
+ * @example
+ * import { createBundlerClient, waitForUserOperationReceipt, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createBundlerClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const userOperationReceipt = await waitForUserOperationReceipt(client, {
+ *   hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d',
+ * })
+ */
+export const waitForUserOperationReceipt = <TChain extends Chain | undefined>(
+    bundlerClient: BundlerClient<TChain>,
+    { hash, pollingInterval = bundlerClient.pollingInterval, timeout }: WaitForUserOperationReceiptParameters
+): Promise<GetUserOperationReceiptReturnType> => {
+    const observerId = stringify(["waitForUserOperationReceipt", bundlerClient.uid, hash])
+
+    let userOperationReceipt: GetUserOperationReceiptReturnType
+
+    return new Promise((resolve, reject) => {
+        if (timeout) {
+            setTimeout(() => reject(new WaitForUserOperationReceiptTimeoutError({ hash })), timeout)
+        }
+
+        const _unobserve = observe(observerId, { resolve, reject }, async (emit) => {
+            const _removeInterval = setInterval(async () => {
+                const done = (fn: () => void) => {
+                    clearInterval(_removeInterval)
+                    fn()
+                    _unobserve()
+                }
+
+                const _userOperationReceipt = await getUserOperationReceipt(bundlerClient, { hash })
+
+                if (_userOperationReceipt !== null) {
+                    userOperationReceipt = _userOperationReceipt
+                }
+
+                if (userOperationReceipt) {
+                    done(() => emit.resolve(userOperationReceipt))
+                    return
+                }
+            }, pollingInterval)
+        })
+    })
+}

package/actions/index.ts

@@ -19,6 +19,11 @@ import { getUserOperationByHash } from "./bundler/getUserOperationByHash.js"
 import { getUserOperationReceipt } from "./bundler/getUserOperationReceipt.js"
 import { sendUserOperation } from "./bundler/sendUserOperation.js"
 import { supportedEntryPoints } from "./bundler/supportedEntryPoints.js"
+import { waitForUserOperationReceipt } from "./bundler/waitForUserOperationReceipt.js"
+import {
+    type WaitForUserOperationReceiptParameters,
+    WaitForUserOperationReceiptTimeoutError
+} from "./bundler/waitForUserOperationReceipt.js"
 import type { GetAccountNonceParams } from "./public/getAccountNonce.js"
 import { getAccountNonce } from "./public/getAccountNonce.js"
 
@@ -31,7 +36,8 @@ export type {
     GetUserOperationReceiptParameters,
     GetUserOperationReceiptReturnType,
     GetSenderAddressParams,
-    GetAccountNonceParams
+    GetAccountNonceParams,
+    WaitForUserOperationReceiptParameters
 }
 
 export {
@@ -43,5 +49,7 @@ export {
     getUserOperationReceipt,
     getSenderAddress,
     getAccountNonce,
-    InvalidEntryPointError
+    InvalidEntryPointError,
+    waitForUserOperationReceipt,
+    WaitForUserOperationReceiptTimeoutError
 }

package/actions/pimlico/sponsorUserOperation.ts

@@ -2,7 +2,7 @@ import type { Address, Hex } from "viem"
 import type { PartialBy } from "viem/types/utils"
 import type { PimlicoPaymasterClient } from "../../clients/pimlico.js"
 import type { UserOperation, UserOperationWithBigIntAsHex } from "../../types/userOperation.js"
-import { deepHexlify } from "../utils.js"
+import { deepHexlify } from "../../utils/deepHexlify.js"
 
 export type SponsorUserOperationParameters = {
     userOperation: PartialBy<

package/actions/stackup/sponsorUserOperation.ts

@@ -3,7 +3,7 @@ import type { PartialBy } from "viem/types/utils"
 import { type StackupPaymasterClient } from "../../clients/stackup.js"
 import type { StackupPaymasterContext } from "../../types/stackup.js"
 import type { UserOperation, UserOperationWithBigIntAsHex } from "../../types/userOperation.js"
-import { deepHexlify } from "../utils.js"
+import { deepHexlify } from "../../utils/deepHexlify.js"
 
 export type SponsorUserOperationParameters = {
     userOperation: PartialBy<

package/clients/bundler.ts

@@ -3,7 +3,13 @@ import { createClient } from "viem"
 import type { BundlerRpcSchema } from "../types/bundler.js"
 import { type BundlerActions, bundlerActions } from "./decorators/bundler.js"
 
-export type BundlerClient = Client<Transport, Chain | undefined, Account | undefined, BundlerRpcSchema, BundlerActions>
+export type BundlerClient<TChain extends Chain | undefined = Chain | undefined> = Client<
+    Transport,
+    TChain,
+    Account | undefined,
+    BundlerRpcSchema,
+    BundlerActions
+>
 /**
  * Creates a EIP-4337 compliant Bundler Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
  *

package/clients/decorators/bundler.ts

@@ -18,6 +18,10 @@ import {
 } from "../../actions/bundler/getUserOperationReceipt.js"
 import { type SendUserOperationParameters, sendUserOperation } from "../../actions/bundler/sendUserOperation.js"
 import { supportedEntryPoints } from "../../actions/bundler/supportedEntryPoints.js"
+import {
+    type WaitForUserOperationReceiptParameters,
+    waitForUserOperationReceipt
+} from "../../actions/bundler/waitForUserOperationReceipt.js"
 import type { BundlerClient } from "../bundler.js"
 
 export type BundlerActions = {
@@ -159,7 +163,34 @@ export type BundlerActions = {
      * await bundlerClient.getUserOperationReceipt({hash: userOpHash})
      *
      */
-    getUserOperationReceipt: (args: GetUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType>
+    getUserOperationReceipt: (
+        args: GetUserOperationReceiptParameters
+    ) => Promise<GetUserOperationReceiptReturnType | null>
+
+    /**
+     * Waits for the User Operation to be included on a [Block](https://viem.sh/docs/glossary/terms.html#block) (one confirmation), and then returns the [User Operation Receipt](https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt).
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/waitForUserOperationReceipt
+     *
+     * @param client - Bundler Client to use
+     * @param parameters - {@link WaitForUserOperationReceiptParameters}
+     * @returns The transaction receipt. {@link GetUserOperationReceiptReturnType}
+     *
+     * @example
+     * import { createBundlerClient, waitForUserOperationReceipt, http } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const bundlerClient = createBundlerClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const userOperationReceipt = await bundlerClient.waitForUserOperationReceipt({
+     *   hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d',
+     * })
+     */
+    waitForUserOperationReceipt: (
+        args: WaitForUserOperationReceiptParameters
+    ) => Promise<GetUserOperationReceiptReturnType>
 }
 
 const bundlerActions = (client: Client): BundlerActions => ({
@@ -172,7 +203,9 @@ const bundlerActions = (client: Client): BundlerActions => ({
     getUserOperationByHash: (args: GetUserOperationByHashParameters) =>
         getUserOperationByHash(client as BundlerClient, args),
     getUserOperationReceipt: (args: GetUserOperationReceiptParameters) =>
-        getUserOperationReceipt(client as BundlerClient, args)
+        getUserOperationReceipt(client as BundlerClient, args),
+    waitForUserOperationReceipt: (args: WaitForUserOperationReceiptParameters) =>
+        waitForUserOperationReceipt(client as BundlerClient, args)
 })
 
 export { bundlerActions }

package/index.ts

@@ -19,6 +19,11 @@ import { getUserOperationByHash } from "./actions/bundler/getUserOperationByHash
 import { getUserOperationReceipt } from "./actions/bundler/getUserOperationReceipt.js"
 import { sendUserOperation } from "./actions/bundler/sendUserOperation.js"
 import { supportedEntryPoints } from "./actions/bundler/supportedEntryPoints.js"
+import { waitForUserOperationReceipt } from "./actions/bundler/waitForUserOperationReceipt.js"
+import {
+    type WaitForUserOperationReceiptParameters,
+    WaitForUserOperationReceiptTimeoutError
+} from "./actions/bundler/waitForUserOperationReceipt.js"
 import type { GetAccountNonceParams } from "./actions/public/getAccountNonce.js"
 import { getAccountNonce } from "./actions/public/getAccountNonce.js"
 import { type BundlerClient, createBundlerClient } from "./clients/bundler.js"
@@ -36,7 +41,8 @@ export type {
     GetSenderAddressParams,
     GetAccountNonceParams,
     BundlerClient,
-    BundlerActions
+    BundlerActions,
+    WaitForUserOperationReceiptParameters
 }
 
 export {
@@ -48,8 +54,10 @@ export {
     getUserOperationReceipt,
     getSenderAddress,
     getAccountNonce,
+    waitForUserOperationReceipt,
     createBundlerClient,
-    bundlerActions
+    bundlerActions,
+    WaitForUserOperationReceiptTimeoutError
 }
 import type { UserOperation } from "./types/userOperation.js"
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "permissionless",
-    "version": "0.0.7",
+    "version": "0.0.9",
     "author": "Pimlico",
     "main": "./_cjs/index.js",
     "module": "./_esm/index.js",