permissionless 0.0.5 → 0.0.7

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
+}

package/actions/bundler/sendUserOperation.ts

@@ -0,0 +1,45 @@
+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"
+
+export type SendUserOperationParameters = {
+    userOperation: UserOperation
+    entryPoint: Address
+}
+
+/**
+ * Sends user operation to the bundler
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/sendUserOperation
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @param args {@link SendUserOperationParameters}.
+ * @returns UserOpHash that you can use to track user operation as {@link Hash}.
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { sendUserOperation } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * const userOpHash = sendUserOperation(bundlerClient, {
+ *      userOperation: signedUserOperation,
+ *      entryPoint: entryPoint
+ * })
+ *
+ * // Return '0xe9fad2cd67f9ca1d0b7a6513b2a42066784c8df938518da2b51bb8cc9a89ea34'
+ *
+ */
+export const sendUserOperation = async (client: BundlerClient, args: SendUserOperationParameters): Promise<Hash> => {
+    const { userOperation, entryPoint } = args
+
+    return client.request({
+        method: "eth_sendUserOperation",
+        params: [deepHexlify(userOperation) as UserOperationWithBigIntAsHex, entryPoint as Address]
+    })
+}

package/actions/bundler/supportedEntryPoints.ts

@@ -0,0 +1,31 @@
+import type { Address } from "viem"
+import type { BundlerClient } from "../../clients/bundler.js"
+
+/**
+ * Returns the supported entrypoints by the bundler service
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/supportedEntryPoints
+ *
+ * @param client {@link BundlerClient} that you created using viem's createClient and extended it with bundlerActions.
+ * @returns Supported entryPoints
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { supportedEntryPoints } from "permissionless/actions"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http(BUNDLER_URL)
+ * })
+ *
+ * const entryPointsSupported = supportedEntryPoints(bundlerClient)
+ * // Return ['0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789']
+ *
+ */
+export const supportedEntryPoints = async (client: BundlerClient): Promise<Address[]> => {
+    return client.request({
+        method: "eth_supportedEntryPoints",
+        params: []
+    })
+}

package/actions/index.ts

@@ -1,26 +1,26 @@
 import type {
     EstimateUserOperationGasParameters,
-    EstimateUserOperationGasReturnType,
-    GetUserOperationByHashParameters,
-    GetUserOperationByHashReturnType,
+    EstimateUserOperationGasReturnType
+} from "./bundler/estimateUserOperationGas.js"
+import type { GetUserOperationByHashParameters } from "./bundler/getUserOperationByHash.js"
+import type { GetUserOperationByHashReturnType } from "./bundler/getUserOperationByHash.js"
+import type {
     GetUserOperationReceiptParameters,
-    GetUserOperationReceiptReturnType,
-    SendUserOperationParameters
-} from "./bundler"
-
-import {
-    bundlerActions,
-    chainId,
-    estimateUserOperationGas,
-    getUserOperationByHash,
-    getUserOperationReceipt,
-    sendUserOperation,
-    supportedEntryPoints
-} from "./bundler"
+    GetUserOperationReceiptReturnType
+} from "./bundler/getUserOperationReceipt.js"
+import type { SendUserOperationParameters } from "./bundler/sendUserOperation.js"
 
-import type { GetSenderAddressParams } from "./public"
+import type { GetSenderAddressParams } from "./public/getSenderAddress.js"
+import { InvalidEntryPointError, getSenderAddress } from "./public/getSenderAddress.js"
 
-import { getSenderAddress } from "./public"
+import { chainId } from "./bundler/chainId.js"
+import { estimateUserOperationGas } from "./bundler/estimateUserOperationGas.js"
+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 type { GetAccountNonceParams } from "./public/getAccountNonce.js"
+import { getAccountNonce } from "./public/getAccountNonce.js"
 
 export type {
     SendUserOperationParameters,
@@ -30,16 +30,18 @@ export type {
     GetUserOperationByHashReturnType,
     GetUserOperationReceiptParameters,
     GetUserOperationReceiptReturnType,
-    GetSenderAddressParams
+    GetSenderAddressParams,
+    GetAccountNonceParams
 }
 
 export {
-    bundlerActions,
     sendUserOperation,
     estimateUserOperationGas,
     supportedEntryPoints,
     chainId,
     getUserOperationByHash,
     getUserOperationReceipt,
-    getSenderAddress
+    getSenderAddress,
+    getAccountNonce,
+    InvalidEntryPointError
 }

package/actions/pimlico/getUserOperationGasPrice.ts

@@ -0,0 +1,61 @@
+import type { PimlicoBundlerClient } from "../../clients/pimlico.js"
+
+export type GetUserOperationGasPriceReturnType = {
+    slow: {
+        maxFeePerGas: bigint
+        maxPriorityFeePerGas: bigint
+    }
+    standard: {
+        maxFeePerGas: bigint
+        maxPriorityFeePerGas: bigint
+    }
+    fast: {
+        maxFeePerGas: bigint
+        maxPriorityFeePerGas: bigint
+    }
+}
+
+/**
+ * Returns the live gas prices that you can use to send a user operation.
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-bundler-actions/getUserOperationGasPrice
+ *
+ * @param client {@link PimlicoBundlerClient} that you created using viem's createClient whose transport url is pointing to the Pimlico's bundler.
+ * @returns slow, standard & fast values for maxFeePerGas & maxPriorityFeePerGas
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { getUserOperationGasPrice } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http("https://api.pimlico.io/v1/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * })
+ *
+ * await getUserOperationGasPrice(bundlerClient)
+ *
+ */
+export const getUserOperationGasPrice = async (
+    client: PimlicoBundlerClient
+): Promise<GetUserOperationGasPriceReturnType> => {
+    const gasPrices = await client.request({
+        method: "pimlico_getUserOperationGasPrice",
+        params: []
+    })
+
+    return {
+        slow: {
+            maxFeePerGas: BigInt(gasPrices.slow.maxFeePerGas),
+            maxPriorityFeePerGas: BigInt(gasPrices.slow.maxPriorityFeePerGas)
+        },
+        standard: {
+            maxFeePerGas: BigInt(gasPrices.standard.maxFeePerGas),
+            maxPriorityFeePerGas: BigInt(gasPrices.standard.maxPriorityFeePerGas)
+        },
+        fast: {
+            maxFeePerGas: BigInt(gasPrices.fast.maxFeePerGas),
+            maxPriorityFeePerGas: BigInt(gasPrices.fast.maxPriorityFeePerGas)
+        }
+    }
+}

package/actions/pimlico/getUserOperationStatus.ts

@@ -0,0 +1,41 @@
+import type { Hash } from "viem"
+import type { PimlicoBundlerClient } from "../../clients/pimlico.js"
+import type { PimlicoUserOperationStatus } from "../../types/pimlico.js"
+
+export type GetUserOperationStatusParameters = {
+    hash: Hash
+}
+
+export type GetUserOperationStatusReturnType = PimlicoUserOperationStatus
+
+/**
+ * Returns the status of the userOperation that is pending in the mempool.
+ *
+ * - Docs: https://docs.pimlico.io/permissionless/reference/pimlico-bundler-actions/getUserOperationStatus
+ *
+ * @param client {@link PimlicoBundlerClient} that you created using viem's createClient whose transport url is pointing to the Pimlico's bundler.
+ * @param hash {@link Hash} UserOpHash that you must have received from sendUserOperation.
+ * @returns status & transaction hash if included {@link GetUserOperationStatusReturnType}
+ *
+ *
+ * @example
+ * import { createClient } from "viem"
+ * import { getUserOperationStatus } from "permissionless/actions/pimlico"
+ *
+ * const bundlerClient = createClient({
+ *      chain: goerli,
+ *      transport: http("https://api.pimlico.io/v1/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+ * })
+ *
+ * await getUserOperationStatus(bundlerClient, { hash: userOpHash })
+ *
+ */
+export const getUserOperationStatus = async (
+    client: PimlicoBundlerClient,
+    { hash }: GetUserOperationStatusParameters
+): Promise<GetUserOperationStatusReturnType> => {
+    return client.request({
+        method: "pimlico_getUserOperationStatus",
+        params: [hash]
+    })
+}