permissionless 0.0.1 → 0.0.3

package/actions/bundler.ts

@@ -0,0 +1,498 @@
+import type { Address } from "abitype"
+import type { Client, Hash, Hex } from "viem"
+import type { PartialBy } from "viem/types/utils"
+import type { BundlerClient } from "../clients/bundler"
+import type { UserOperation } from "../types"
+import type { TStatus, UserOperationWithBigIntAsHex } from "../types/userOperation"
+import { deepHexlify, transactionReceiptStatus } from "./utils"
+
+export type SendUserOperationParameters = {
+    userOperation: UserOperation
+    entryPoint: Address
+}
+
+export type EstimateUserOperationGasParameters = {
+    userOperation: PartialBy<UserOperation, "callGasLimit" | "preVerificationGas" | "verificationGasLimit">
+    entryPoint: Address
+}
+
+export type EstimateUserOperationGasReturnType = {
+    preVerificationGas: bigint
+    verificationGasLimit: bigint
+    callGasLimit: bigint
+}
+
+export type GetUserOperationByHashParameters = {
+    hash: Hash
+}
+
+export type GetUserOperationByHashReturnType = {
+    userOperation: UserOperation
+    entryPoint: Address
+    transactionHash: Hash
+    blockHash: Hash
+    blockNumber: bigint
+} | null
+
+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
+
+/**
+ * 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]
+    })
+}
+
+/**
+ * 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 || 0n),
+        verificationGasLimit: BigInt(response.verificationGasLimit || 0n),
+        callGasLimit: BigInt(response.callGasLimit || 0n)
+    }
+}
+
+/**
+ * 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: []
+    })
+}
+
+/**
+ * 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 BigInt(
+        await client.request({
+            method: "eth_chainId",
+            params: []
+        })
+    )
+}
+
+/**
+ * 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<{
+    userOperation: UserOperation
+    entryPoint: Address
+    transactionHash: Hash
+    blockHash: Hash
+    blockNumber: bigint
+} | null> => {
+    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)
+    }
+}
+
+/**
+ * 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
+}
+
+export type BundlerActions = {
+    /**
+     *
+     * Sends user operation to the bundler
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/sendUserOperation
+     *
+     * @param args {@link SendUserOperationParameters}.
+     * @returns UserOpHash that you can use to track user operation as {@link Hash}.
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http("https://api.pimlico.io/v1/goerli/rpc?apikey=YOUR_API_KEY_HERE")
+     * }).extend(bundlerActions)
+     *
+     * const userOpHash = await bundlerClient.sendUserOperation({
+     *      userOperation: signedUserOperation,
+     *      entryPoint: entryPoint
+     * })
+     *
+     * // Return '0xe9fad2cd67f9ca1d0b7a6513b2a42066784c8df938518da2b51bb8cc9a89ea34'
+     */
+    sendUserOperation: (args: SendUserOperationParameters) => Promise<Hash>
+    /**
+     *
+     * Estimates preVerificationGas, verificationGasLimit and callGasLimit for user operation
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/estimateUserOperationGas
+     *
+     * @param args {@link EstimateUserOperationGasParameters}
+     * @returns preVerificationGas, verificationGasLimit and callGasLimit as {@link EstimateUserOperationGasReturnType}
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http(BUNDLER_URL)
+     * }).extend(bundlerActions)
+     *
+     * const gasParameters = await bundlerClient.estimateUserOperationGas({
+     *     userOperation: signedUserOperation,
+     *    entryPoint: entryPoint
+     * })
+     *
+     * // Return {preVerificationGas: 43492n, verificationGasLimit: 59436n, callGasLimit: 9000n}
+     */
+    estimateUserOperationGas: (args: EstimateUserOperationGasParameters) => Promise<EstimateUserOperationGasReturnType>
+    /**
+     *
+     * Returns the supported entrypoints by the bundler service
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/supportedEntryPoints
+     *
+     * @returns Supported entryPoints
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http(BUNDLER_URL)
+     * }).extend(bundlerActions)
+     *
+     * const supportedEntryPoints = await bundlerClient.supportedEntryPoints()
+     *
+     * // Return ['0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789']
+     */
+    supportedEntryPoints: () => Promise<Address[]>
+    /**
+     *
+     * Returns the supported chain id by the bundler service
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/chainId
+     *
+     * @returns Supported chain id
+     *
+     * @example
+     * import { createClient } from "viem"
+     * import { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http(BUNDLER_URL)
+     * }).extend(bundlerActions)
+     *
+     * const chainId = await bundlerClient.chainId()
+     * // Return 5n for Goerli
+     */
+    chainId: () => Promise<bigint>
+    /**
+     *
+     * Returns the user operation from userOpHash
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationByHash
+     *
+     * @param args {@link GetUserOperationByHash} 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 { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http(BUNDLER_URL)
+     * }).extend(bundlerActions)
+     *
+     * await bundlerClient.getUserOperationByHash(userOpHash)
+     *
+     */
+    getUserOperationByHash: (args: GetUserOperationByHashParameters) => Promise<GetUserOperationByHashReturnType>
+    /**
+     *
+     * Returns the user operation receipt from userOpHash
+     *
+     * - Docs: https://docs.pimlico.io/permissionless/reference/bundler-actions/getUserOperationReceipt
+     *
+     * @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 { bundlerActions } from "permissionless"
+     *
+     * const bundlerClient = createClient({
+     *      chain: goerli,
+     *      transport: http(BUNDLER_URL)
+     * }).extend(bundlerActions)
+     *
+     * await bundlerClient.getUserOperationReceipt({hash: userOpHash})
+     *
+     */
+    getUserOperationReceipt: (args: GetUserOperationReceiptParameters) => Promise<GetUserOperationReceiptReturnType>
+}
+
+const bundlerActions = (client: Client): BundlerActions => ({
+    sendUserOperation: async (args: SendUserOperationParameters): Promise<Hash> =>
+        sendUserOperation(client as BundlerClient, args),
+    estimateUserOperationGas: (args: EstimateUserOperationGasParameters) =>
+        estimateUserOperationGas(client as BundlerClient, args),
+    supportedEntryPoints: (): Promise<Address[]> => supportedEntryPoints(client as BundlerClient),
+    chainId: () => chainId(client as BundlerClient),
+    getUserOperationByHash: (args: GetUserOperationByHashParameters) =>
+        getUserOperationByHash(client as BundlerClient, args),
+    getUserOperationReceipt: (args: GetUserOperationReceiptParameters) =>
+        getUserOperationReceipt(client as BundlerClient, args)
+})
+
+export default bundlerActions

package/actions/index.ts

@@ -0,0 +1,38 @@
+import type {
+    EstimateUserOperationGasParameters,
+    EstimateUserOperationGasReturnType,
+    GetUserOperationByHashParameters,
+    GetUserOperationByHashReturnType,
+    GetUserOperationReceiptParameters,
+    GetUserOperationReceiptReturnType,
+    SendUserOperationParameters
+} from "./bundler"
+
+import bundlerActions, {
+    chainId,
+    estimateUserOperationGas,
+    getUserOperationByHash,
+    getUserOperationReceipt,
+    sendUserOperation,
+    supportedEntryPoints
+} from "./bundler"
+
+export type {
+    SendUserOperationParameters,
+    EstimateUserOperationGasParameters,
+    EstimateUserOperationGasReturnType,
+    GetUserOperationByHashParameters,
+    GetUserOperationByHashReturnType,
+    GetUserOperationReceiptParameters,
+    GetUserOperationReceiptReturnType
+}
+
+export {
+    bundlerActions,
+    sendUserOperation,
+    estimateUserOperationGas,
+    supportedEntryPoints,
+    chainId,
+    getUserOperationByHash,
+    getUserOperationReceipt
+}

package/actions/package.json

@@ -0,0 +1,6 @@
+{
+    "type": "module",
+    "types": "../_types/actions/index.d.ts",
+    "module": "../_esm/actions/index.js",
+    "main": "../_cjs/actions/index.js"
+}