permissionless 0.0.6 → 0.0.7

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

@@ -0,0 +1,54 @@
+import type { Address, Client } from "viem";
+import { type AccountsParameters } from "../../actions/stackup/accounts.js";
+import { type SponsorUserOperationParameters, type SponsorUserOperationReturnType } from "../../actions/stackup/sponsorUserOperation.js";
+export type StackupPaymasterClientActions = {
+    /**
+     * Returns paymasterAndData & updated gas parameters required to sponsor a userOperation.
+     *
+     * https://docs.stackup.sh/docs/paymaster-api-rpc-methods#pm_sponsoruseroperation
+     *
+     * @param args {@link SponsorUserOperationParameters} UserOperation you want to sponsor & entryPoint.
+     * @returns paymasterAndData & updated gas parameters, see {@link SponsorUserOperationReturnType}
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { stackupPaymasterActions } from "permissionless/actions/stackup"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http("https://api.stackup.sh/v1/paymaster/YOUR_API_KEY_HERE")
+     * }).extend(stackupPaymasterActions)
+     *
+     * await bundlerClient.sponsorUserOperation(bundlerClient, {
+     *      userOperation: userOperationWithDummySignature,
+     *      entryPoint: entryPoint
+     * }})
+     *
+     */
+    sponsorUserOperation: (args: SponsorUserOperationParameters) => Promise<SponsorUserOperationReturnType>;
+    /**
+     * Returns all the Paymaster addresses associated with an EntryPoint that’s owned by this service.
+     *
+     * https://docs.stackup.sh/docs/paymaster-api-rpc-methods#pm_accounts
+     *
+     * @param args {@link AccountsParameters} entryPoint for which you want to get list of supported paymasters.
+     * @returns paymaster addresses
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { stackupPaymasterActions } from "permissionless/actions/stackup"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http("https://api.stackup.sh/v1/paymaster/YOUR_API_KEY_HERE")
+     * }).extend(stackupPaymasterActions)
+     *
+     * await bundlerClient.accounts(bundlerClient, {
+     *      entryPoint: entryPoint
+     * }})
+     *
+     */
+    accounts: (args: AccountsParameters) => Promise<Address[]>;
+};
+export declare const stackupPaymasterActions: (client: Client) => StackupPaymasterClientActions;
+//# sourceMappingURL=stackup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stackup.d.ts","sourceRoot":"","sources":["../../../clients/decorators/stackup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAC3C,OAAO,EAAE,KAAK,kBAAkB,EAAY,MAAM,mCAAmC,CAAA;AACrF,OAAO,EACH,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EAEtC,MAAM,+CAA+C,CAAA;AAGtD,MAAM,MAAM,6BAA6B,GAAG;IACxC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,oBAAoB,EAAE,CAAC,IAAI,EAAE,8BAA8B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAA;IAEvG;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CAC7D,CAAA;AAED,eAAO,MAAM,uBAAuB,WAAY,MAAM,KAAG,6BAIvD,CAAA"}

package/_types/clients/pimlico.d.ts

@@ -1,7 +1,7 @@
 import type { Account, Chain, Client, PublicClientConfig, Transport } from "viem";
-import type { BundlerActions } from "../actions/bundler";
-import { type PimlicoBundlerActions, type PimlicoPaymasterClientActions } from "../actions/pimlico";
-import type { PimlicoBundlerRpcSchema, PimlicoPaymasterRpcSchema } from "../types/pimlico";
+import type { PimlicoBundlerRpcSchema, PimlicoPaymasterRpcSchema } from "../types/pimlico.js";
+import { type BundlerActions } from "./decorators/bundler.js";
+import { type PimlicoBundlerActions, type PimlicoPaymasterClientActions } from "./decorators/pimlico.js";
 export type PimlicoBundlerClient = Client<Transport, Chain | undefined, Account | undefined, PimlicoBundlerRpcSchema, PimlicoBundlerActions & BundlerActions>;
 export type PimlicoPaymasterClient = Client<Transport, Chain | undefined, Account | undefined, PimlicoPaymasterRpcSchema, PimlicoPaymasterClientActions>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../clients/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAGjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAGrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAE1F,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACrC,SAAS,EACT,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,SAAS,EACnB,uBAAuB,EACvB,qBAAqB,GAAG,cAAc,CACzC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACvC,SAAS,EACT,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,SAAS,EACnB,yBAAyB,EACzB,6BAA6B,CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;MAEpC,oBASF,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;MAEtC,sBASF,CAAA"}
+{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../clients/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC7F,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAGrC,MAAM,yBAAyB,CAAA;AAEhC,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACrC,SAAS,EACT,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,SAAS,EACnB,uBAAuB,EACvB,qBAAqB,GAAG,cAAc,CACzC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACvC,SAAS,EACT,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,SAAS,EACnB,yBAAyB,EACzB,6BAA6B,CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;MAEpC,oBASF,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;MAEtC,sBASF,CAAA"}

package/_types/clients/stackup.d.ts

@@ -0,0 +1,39 @@
+import { type Account, type Chain, type Client, type PublicClientConfig, type Transport } from "viem";
+import type { StackupPaymasterRpcSchema } from "../types/stackup.js";
+import { type BundlerActions } from "./decorators/bundler.js";
+import { type StackupPaymasterClientActions } from "./decorators/stackup.js";
+export type StackupPaymasterClient = Client<Transport, Chain | undefined, Account | undefined, StackupPaymasterRpcSchema, StackupPaymasterClientActions & BundlerActions>;
+/**
+ * Creates a Stackup specific Paymaster Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/clients/stackupPaymasterClient
+ *
+ * A Stackup Paymaster Client is an interface to "stackup paymaster endpoints" [JSON-RPC API](https://docs.stackup.sh/docs/paymaster-api-rpc-methods) methods such as sponsoring user operation, etc through Stackup Paymaster Actions.
+ *
+ * @param config - {@link PublicClientConfig}
+ * @returns A Stackup Paymaster Client. {@link StackupPaymasterClient}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const stackupPaymasterClient = createStackupPaymasterClient({
+ *   chain: mainnet,
+ *   transport: http("https://api.stackup.sh/v1/paymaster/YOUR_API_KEY_HERE"),
+ * })
+ */
+export declare const createStackupPaymasterClient: <transport extends Transport, chain extends Chain | undefined = undefined>(parameters: {
+    batch?: {
+        multicall?: boolean | {
+            batchSize?: number | undefined;
+            wait?: number | undefined;
+        } | undefined;
+    } | undefined;
+    cacheTime?: number | undefined;
+    chain?: Chain | chain | undefined;
+    key?: string | undefined;
+    name?: string | undefined;
+    pollingInterval?: number | undefined;
+    transport: transport;
+}) => StackupPaymasterClient;
+//# sourceMappingURL=stackup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stackup.d.ts","sourceRoot":"","sources":["../../clients/stackup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAgB,MAAM,MAAM,CAAA;AACnH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EAAE,KAAK,6BAA6B,EAA2B,MAAM,yBAAyB,CAAA;AAErG,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACvC,SAAS,EACT,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,SAAS,EACnB,yBAAyB,EACzB,6BAA6B,GAAG,cAAc,CACjD,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;MAEtC,sBASF,CAAA"}

package/_types/index.d.ts

@@ -1,5 +1,27 @@
-export * from "./actions";
-export * from "./clients";
-export * from "./types";
-export * from "./utils";
+import type { EstimateUserOperationGasParameters, EstimateUserOperationGasReturnType } from "./actions/bundler/estimateUserOperationGas.js";
+import type { GetUserOperationByHashParameters } from "./actions/bundler/getUserOperationByHash.js";
+import type { GetUserOperationByHashReturnType } from "./actions/bundler/getUserOperationByHash.js";
+import type { GetUserOperationReceiptParameters, GetUserOperationReceiptReturnType } from "./actions/bundler/getUserOperationReceipt.js";
+import type { SendUserOperationParameters } from "./actions/bundler/sendUserOperation.js";
+import type { GetSenderAddressParams } from "./actions/public/getSenderAddress.js";
+import { getSenderAddress } from "./actions/public/getSenderAddress.js";
+import { chainId } from "./actions/bundler/chainId.js";
+import { estimateUserOperationGas } from "./actions/bundler/estimateUserOperationGas.js";
+import { getUserOperationByHash } from "./actions/bundler/getUserOperationByHash.js";
+import { getUserOperationReceipt } from "./actions/bundler/getUserOperationReceipt.js";
+import { sendUserOperation } from "./actions/bundler/sendUserOperation.js";
+import { supportedEntryPoints } from "./actions/bundler/supportedEntryPoints.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 };
+import type { UserOperation } from "./types/userOperation.js";
+export { type UserOperation };
+import type { GetUserOperationHashParams } from "./utils/getUserOperationHash.js";
+import { getUserOperationHash } from "./utils/getUserOperationHash.js";
+export { getUserOperationHash, type GetUserOperationHashParams };
+export * from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/_types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,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,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"}

package/_types/types/bundler.d.ts

@@ -1,6 +1,6 @@
 import type { Address, Hash, Hex } from "viem";
 import type { PartialBy } from "viem/types/utils";
-import type { UserOperationWithBigIntAsHex } from "./userOperation";
+import type { UserOperationWithBigIntAsHex } from "./userOperation.js";
 export type BundlerRpcSchema = [
     {
         Method: "eth_sendUserOperation";

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

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../types/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC3B;QACI,MAAM,EAAE,uBAAuB,CAAA;QAC/B,UAAU,EAAE,CAAC,aAAa,EAAE,4BAA4B,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9E,UAAU,EAAE,IAAI,CAAA;KACnB;IACD;QACI,MAAM,EAAE,8BAA8B,CAAA;QACtC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC5B,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CACjE;YACD,UAAU,EAAE,OAAO;SACtB,CAAA;QACD,UAAU,EAAE;YACR,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,0BAA0B,CAAA;QAClC,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,OAAO,EAAE,CAAA;KACxB;IACD;QACI,MAAM,EAAE,aAAa,CAAA;QACrB,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,GAAG,CAAA;KAClB;IACD;QACI,MAAM,EAAE,4BAA4B,CAAA;QACpC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE;YACR,aAAa,EAAE,4BAA4B,CAAA;YAC3C,UAAU,EAAE,OAAO,CAAA;YACnB,eAAe,EAAE,IAAI,CAAA;YACrB,SAAS,EAAE,IAAI,CAAA;YACf,WAAW,EAAE,GAAG,CAAA;SACnB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,6BAA6B,CAAA;QACrC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,mCAAmC,CAAA;KAClD;CACJ,CAAA;AAED,KAAK,mCAAmC,GAAG;IACvC,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,GAAG,CAAA;IACV,aAAa,EAAE,GAAG,CAAA;IAClB,aAAa,EAAE,GAAG,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACL,eAAe,EAAE,GAAG,CAAA;QACpB,gBAAgB,EAAE,GAAG,CAAA;QACrB,SAAS,EAAE,IAAI,CAAA;QACf,WAAW,EAAE,GAAG,CAAA;QAChB,IAAI,EAAE,OAAO,CAAA;QACb,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;QAClB,iBAAiB,EAAE,GAAG,CAAA;QACtB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;QACrB,OAAO,EAAE,GAAG,CAAA;QACZ,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,GAAG,CAAA;QACd,iBAAiB,EAAE,GAAG,CAAA;KACzB,CAAA;IACD,IAAI,EAAE;QACF,IAAI,EAAE,GAAG,CAAA;QACT,WAAW,EAAE,GAAG,CAAA;QAChB,SAAS,EAAE,IAAI,CAAA;QACf,eAAe,EAAE,IAAI,CAAA;QACrB,QAAQ,EAAE,GAAG,CAAA;QACb,gBAAgB,EAAE,GAAG,CAAA;QACrB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,CAAA;KAChB,EAAE,CAAA;CACN,CAAA"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../types/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC3B;QACI,MAAM,EAAE,uBAAuB,CAAA;QAC/B,UAAU,EAAE,CAAC,aAAa,EAAE,4BAA4B,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9E,UAAU,EAAE,IAAI,CAAA;KACnB;IACD;QACI,MAAM,EAAE,8BAA8B,CAAA;QACtC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC5B,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CACjE;YACD,UAAU,EAAE,OAAO;SACtB,CAAA;QACD,UAAU,EAAE;YACR,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,0BAA0B,CAAA;QAClC,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,OAAO,EAAE,CAAA;KACxB;IACD;QACI,MAAM,EAAE,aAAa,CAAA;QACrB,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,GAAG,CAAA;KAClB;IACD;QACI,MAAM,EAAE,4BAA4B,CAAA;QACpC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE;YACR,aAAa,EAAE,4BAA4B,CAAA;YAC3C,UAAU,EAAE,OAAO,CAAA;YACnB,eAAe,EAAE,IAAI,CAAA;YACrB,SAAS,EAAE,IAAI,CAAA;YACf,WAAW,EAAE,GAAG,CAAA;SACnB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,6BAA6B,CAAA;QACrC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,mCAAmC,CAAA;KAClD;CACJ,CAAA;AAED,KAAK,mCAAmC,GAAG;IACvC,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,GAAG,CAAA;IACV,aAAa,EAAE,GAAG,CAAA;IAClB,aAAa,EAAE,GAAG,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACL,eAAe,EAAE,GAAG,CAAA;QACpB,gBAAgB,EAAE,GAAG,CAAA;QACrB,SAAS,EAAE,IAAI,CAAA;QACf,WAAW,EAAE,GAAG,CAAA;QAChB,IAAI,EAAE,OAAO,CAAA;QACb,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;QAClB,iBAAiB,EAAE,GAAG,CAAA;QACtB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;QACrB,OAAO,EAAE,GAAG,CAAA;QACZ,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,GAAG,CAAA;QACd,iBAAiB,EAAE,GAAG,CAAA;KACzB,CAAA;IACD,IAAI,EAAE;QACF,IAAI,EAAE,GAAG,CAAA;QACT,WAAW,EAAE,GAAG,CAAA;QAChB,SAAS,EAAE,IAAI,CAAA;QACf,eAAe,EAAE,IAAI,CAAA;QACrB,QAAQ,EAAE,GAAG,CAAA;QACb,gBAAgB,EAAE,GAAG,CAAA;QACrB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,CAAA;KAChB,EAAE,CAAA;CACN,CAAA"}

package/_types/types/index.d.ts

@@ -1,3 +1,3 @@
-import type { UserOperation } from "./userOperation";
+import type { UserOperation } from "./userOperation.js";
 export type { UserOperation };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,YAAY,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/_types/types/pimlico.d.ts

@@ -1,6 +1,6 @@
 import type { Address, Hash, Hex } from "viem";
 import type { PartialBy } from "viem/types/utils";
-import type { UserOperationWithBigIntAsHex } from "./userOperation";
+import type { UserOperationWithBigIntAsHex } from "./userOperation.js";
 type PimlicoUserOperationGasPriceWithBigIntAsHex = {
     slow: {
         maxFeePerGas: Hex;

package/_types/types/pimlico.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../types/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAEnE,KAAK,2CAA2C,GAAG;IAC/C,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,QAAQ,EAAE;QACN,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAA;IACrG,eAAe,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC;QACI,MAAM,EAAE,kCAAkC,CAAA;QAC1C,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,2CAA2C,CAAA;KAC1D;IACD;QACI,MAAM,EAAE,gCAAgC,CAAA;QACxC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,0BAA0B,CAAA;KACzC;CACJ,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC5B,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,kBAAkB,CACtF;YACD,UAAU,EAAE,OAAO;SACtB,CAAA;QACD,UAAU,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;CACJ,CAAA"}
+{"version":3,"file":"pimlico.d.ts","sourceRoot":"","sources":["../../types/pimlico.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,KAAK,2CAA2C,GAAG;IAC/C,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,QAAQ,EAAE;QACN,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;IACD,IAAI,EAAE;QACF,YAAY,EAAE,GAAG,CAAA;QACjB,oBAAoB,EAAE,GAAG,CAAA;KAC5B,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAA;IACrG,eAAe,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC;QACI,MAAM,EAAE,kCAAkC,CAAA;QAC1C,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,EAAE,2CAA2C,CAAA;KAC1D;IACD;QACI,MAAM,EAAE,gCAAgC,CAAA;QACxC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxB,UAAU,EAAE,0BAA0B,CAAA;KACzC;CACJ,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC5B,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,kBAAkB,CACtF;YACD,UAAU,EAAE,OAAO;SACtB,CAAA;QACD,UAAU,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;CACJ,CAAA"}

package/_types/types/stackup.d.ts

@@ -0,0 +1,35 @@
+import type { Address, Hex } from "viem";
+import type { PartialBy } from "viem/types/utils";
+import type { UserOperationWithBigIntAsHex } from "./userOperation.js";
+interface StackupPaymasterContextType {
+    type: "erc20token" | "payg";
+}
+export type StackupPaymasterContext = (StackupPaymasterContextType & {
+    type: "erc20token";
+    token: string;
+}) | (StackupPaymasterContextType & {
+    type: "payg";
+});
+export type StackupPaymasterRpcSchema = [
+    {
+        Method: "pm_sponsorUserOperation";
+        Parameters: [
+            userOperation: PartialBy<UserOperationWithBigIntAsHex, "callGasLimit" | "preVerificationGas" | "verificationGasLimit" | "paymasterAndData">,
+            entryPoint: Address,
+            context: StackupPaymasterContext
+        ];
+        ReturnType: {
+            paymasterAndData: Hex;
+            preVerificationGas: Hex;
+            verificationGasLimit: Hex;
+            callGasLimit: Hex;
+        };
+    },
+    {
+        Method: "pm_accounts";
+        Parameters: [entryPoint: Address];
+        ReturnType: Address[];
+    }
+];
+export {};
+//# sourceMappingURL=stackup.d.ts.map

package/_types/types/stackup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackup.d.ts","sourceRoot":"","sources":["../../types/stackup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,UAAU,2BAA2B;IACjC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAA;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAC7B,CAAC,2BAA2B,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,CAAC,2BAA2B,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEtD,MAAM,MAAM,yBAAyB,GAAG;IACpC;QACI,MAAM,EAAE,yBAAyB,CAAA;QACjC,UAAU,EAAE;YACR,aAAa,EAAE,SAAS,CACpB,4BAA4B,EAC5B,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,kBAAkB,CACtF;YACD,UAAU,EAAE,OAAO;YACnB,OAAO,EAAE,uBAAuB;SACnC,CAAA;QACD,UAAU,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAA;YACrB,kBAAkB,EAAE,GAAG,CAAA;YACvB,oBAAoB,EAAE,GAAG,CAAA;YACzB,YAAY,EAAE,GAAG,CAAA;SACpB,CAAA;KACJ;IACD;QACI,MAAM,EAAE,aAAa,CAAA;QACrB,UAAU,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACjC,UAAU,EAAE,OAAO,EAAE,CAAA;KACxB;CACJ,CAAA"}

package/_types/utils/getUserOperationHash.d.ts

@@ -0,0 +1,30 @@
+import type { Address, Hash } from "viem";
+import type { UserOperation } from "../types/userOperation.js";
+export type GetUserOperationHashParams = {
+    userOperation: UserOperation;
+    entryPoint: Address;
+    chainId: number;
+};
+/**
+ *
+ * Returns user operation hash that is a unique identifier of the user operation.
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/utils/getUserOperationHash
+ *
+ * @param args: userOperation, entryPoint, chainId as {@link GetUserOperationHashParams}
+ * @returns userOperationHash as {@link Hash}
+ *
+ * @example
+ * import { getUserOperationHash } from "permissionless/utils"
+ *
+ * const userOperationHash = getUserOperationHash({
+ *      userOperation,
+ *      entryPoint,
+ *      chainId
+ * })
+ *
+ * // Returns "0xe9fad2cd67f9ca1d0b7a6513b2a42066784c8df938518da2b51bb8cc9a89ea34"
+ *
+ */
+export declare const getUserOperationHash: ({ userOperation, entryPoint, chainId }: GetUserOperationHashParams) => Hash;
+//# sourceMappingURL=getUserOperationHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getUserOperationHash.d.ts","sourceRoot":"","sources":["../../utils/getUserOperationHash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAO,MAAM,MAAM,CAAA;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAmC9D,MAAM,MAAM,0BAA0B,GAAG;IAAE,aAAa,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,2CAA4C,0BAA0B,KAAG,IAOzG,CAAA"}

package/_types/utils/index.d.ts

@@ -1,31 +1,3 @@
-import type { Address, Hash } from "viem";
-import type { UserOperation } from "../types";
-export type GetUserOperationHashParams = {
-    userOperation: UserOperation;
-    entryPoint: Address;
-    chainId: number;
-};
-/**
- *
- * Returns user operation hash that is a unique identifier of the user operation.
- *
- * - Docs: https://docs.pimlico.io/permissionless/reference/utils/getUserOperationHash
- *
- * @param args: userOperation, entryPoint, chainId as {@link GetUserOperationHashParams}
- * @returns userOperationHash as {@link Hash}
- *
- * @example
- * import { getUserOperationHash } from "permissionless/utils"
- *
- * const userOperationHash = getUserOperationHash({
- *      userOperation,
- *      entryPoint,
- *      chainId
- * })
- *
- * // Returns "0xe9fad2cd67f9ca1d0b7a6513b2a42066784c8df938518da2b51bb8cc9a89ea34"
- *
- */
-declare const getUserOperationHash: ({ userOperation, entryPoint, chainId }: GetUserOperationHashParams) => Hash;
-export { getUserOperationHash };
+import { type GetUserOperationHashParams, getUserOperationHash } from "./getUserOperationHash.js";
+export { getUserOperationHash, type GetUserOperationHashParams };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAO,MAAM,MAAM,CAAA;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAmC7C,MAAM,MAAM,0BAA0B,GAAG;IAAE,aAAa,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,oBAAoB,2CAA4C,0BAA0B,KAAG,IAOlG,CAAA;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEjG,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,CAAA"}

package/actions/bundler/chainId.ts

@@ -0,0 +1,32 @@
+import type { BundlerClient } from "../../clients/bundler.js"
+
+/**
+ * Returns the supported chain id by the bundler service
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/chainId
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @returns Supported chain id
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { chainId } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * const bundlerChainId = chainId(bundlerClient)
+ * // Return 5n for Goerli
+ *
+ */
+export const chainId = async (client: BundlerClient) => {
+    return Number(
+        await client.request({
+            method: "eth_chainId",
+            params: []
+        })
+    )
+}

package/actions/bundler/estimateUserOperationGas.ts

@@ -0,0 +1,62 @@
+import type { Address } from "viem"
+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"
+
+export type EstimateUserOperationGasParameters = {
+    userOperation: PartialBy<UserOperation, "callGasLimit" | "preVerificationGas" | "verificationGasLimit">
+    entryPoint: Address
+}
+
+export type EstimateUserOperationGasReturnType = {
+    preVerificationGas: bigint
+    verificationGasLimit: bigint
+    callGasLimit: bigint
+}
+
+/**
+ * Estimates preVerificationGas, verificationGasLimit and callGasLimit for user operation
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/estimateUserOperationGas
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @param args {@link EstimateUserOperationGasParameters}
+ * @returns preVerificationGas, verificationGasLimit and callGasLimit as {@link EstimateUserOperationGasReturnType}
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { estimateUserOperationGas } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * const gasParameters = estimateUserOperationGas(bundlerClient, {
+ *      serOperation: signedUserOperation,
+ *      entryPoint: entryPoint
+ * })
+ *
+ * // Return {preVerificationGas: 43492n, verificationGasLimit: 59436n, callGasLimit: 9000n}
+ *
+ */
+export const estimateUserOperationGas = async (
+    client: BundlerClient,
+    args: EstimateUserOperationGasParameters
+): Promise<EstimateUserOperationGasReturnType> => {
+    const { userOperation, entryPoint } = args
+
+    const response = await client.request({
+        method: "eth_estimateUserOperationGas",
+        params: [deepHexlify(userOperation) as UserOperationWithBigIntAsHex, entryPoint as Address]
+    })
+
+    return {
+        preVerificationGas: BigInt(response.preVerificationGas || 0),
+        verificationGasLimit: BigInt(response.verificationGasLimit || 0),
+        callGasLimit: BigInt(response.callGasLimit || 0)
+    }
+}

package/actions/bundler/getUserOperationByHash.ts

@@ -0,0 +1,69 @@
+import type { Address, Hash } from "viem"
+import type { BundlerClient } from "../../clients/bundler.js"
+import type { UserOperation } from "../../types/userOperation.js"
+
+export type GetUserOperationByHashParameters = {
+    hash: Hash
+}
+
+export type GetUserOperationByHashReturnType = {
+    userOperation: UserOperation
+    entryPoint: Address
+    transactionHash: Hash
+    blockHash: Hash
+    blockNumber: bigint
+} | null
+
+/**
+ * Returns the user operation from userOpHash
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationByHash
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @param args {@link GetUserOperationByHashParameters} UserOpHash that was returned by {@link sendUserOperation}
+ * @returns userOperation along with entryPoint, transactionHash, blockHash, blockNumber if found or null
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { getUserOperationByHash } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * getUserOperationByHash(bundlerClient, {hash: userOpHash})
+ *
+ */
+export const getUserOperationByHash = async (
+    client: BundlerClient,
+    { hash }: GetUserOperationByHashParameters
+): Promise<GetUserOperationByHashReturnType> => {
+    const params: [Hash] = [hash]
+
+    const response = await client.request({
+        method: "eth_getUserOperationByHash",
+        params
+    })
+
+    if (!response) return null
+
+    const { userOperation, entryPoint, transactionHash, blockHash, blockNumber } = response
+
+    return {
+        userOperation: {
+            ...userOperation,
+            nonce: BigInt(userOperation.nonce),
+            callGasLimit: BigInt(userOperation.callGasLimit),
+            verificationGasLimit: BigInt(userOperation.verificationGasLimit),
+            preVerificationGas: BigInt(userOperation.preVerificationGas),
+            maxFeePerGas: BigInt(userOperation.maxFeePerGas),
+            maxPriorityFeePerGas: BigInt(userOperation.maxPriorityFeePerGas)
+        } as UserOperation,
+        entryPoint: entryPoint,
+        transactionHash: transactionHash,
+        blockHash: blockHash,
+        blockNumber: BigInt(blockNumber)
+    }
+}

package/actions/bundler/getUserOperationReceipt.ts

@@ -0,0 +1,109 @@
+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"
+
+export type GetUserOperationReceiptParameters = {
+    hash: Hash
+}
+
+export type GetUserOperationReceiptReturnType = {
+    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
+
+/**
+ * Returns the user operation receipt from userOpHash
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @param args {@link GetUserOperationReceiptParameters} UserOpHash that was returned by {@link sendUserOperation}
+ * @returns user operation receipt {@link GetUserOperationReceiptReturnType} if found or null
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { getUserOperationReceipt } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * getUserOperationReceipt(bundlerClient, {hash: userOpHash})
+ *
+ */
+export const getUserOperationReceipt = async (client: BundlerClient, { hash }: GetUserOperationReceiptParameters) => {
+    const params: [Hash] = [hash]
+
+    const response = await client.request({
+        method: "eth_getUserOperationReceipt",
+        params
+    })
+
+    if (!response) return null
+
+    const userOperationReceipt: GetUserOperationReceiptReturnType = {
+        userOpHash: response.userOpHash,
+        sender: response.sender,
+        nonce: BigInt(response.nonce),
+        actualGasUsed: BigInt(response.actualGasUsed),
+        actualGasCost: BigInt(response.actualGasCost),
+        success: response.success,
+        receipt: {
+            transactionHash: response.receipt.transactionHash,
+            transactionIndex: BigInt(response.receipt.transactionIndex),
+            blockHash: response.receipt.blockHash,
+            blockNumber: BigInt(response.receipt.blockNumber),
+            from: response.receipt.from,
+            to: response.receipt.to,
+            cumulativeGasUsed: BigInt(response.receipt.cumulativeGasUsed),
+            status: transactionReceiptStatus[response.receipt.status],
+            gasUsed: BigInt(response.receipt.gasUsed),
+            contractAddress: response.receipt.contractAddress,
+            logsBloom: response.receipt.logsBloom,
+            effectiveGasPrice: BigInt(response.receipt.effectiveGasPrice)
+        },
+        logs: response.logs.map((log) => ({
+            data: log.data,
+            blockNumber: BigInt(log.blockNumber),
+            blockHash: log.blockHash,
+            transactionHash: log.transactionHash,
+            logIndex: BigInt(log.logIndex),
+            transactionIndex: BigInt(log.transactionIndex),
+            address: log.address,
+            topics: log.topics
+        }))
+    }
+
+    return userOperationReceipt
+}