@zerodev/sdk 4.0.0

package/dist/cjs/kernel-zerodev/paymaster/verifying-paymaster.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifyingPaymaster = void 0;
+const aa_core_1 = require("@alchemy/aa-core");
+const base_js_1 = require("./base.js");
+class VerifyingPaymaster extends base_js_1.Paymaster {
+    constructor(provider, _) {
+        super(provider);
+    }
+    async getPaymasterResponse(struct, paymasterProvider) {
+        try {
+            const hexifiedUserOp = (0, aa_core_1.deepHexlify)(await (0, aa_core_1.resolveProperties)(struct));
+            const paymasterResp = await this.signUserOp({
+                userOp: hexifiedUserOp,
+                paymasterProvider,
+            });
+            if (paymasterResp) {
+                return {
+                    ...struct,
+                    ...paymasterResp,
+                };
+            }
+        }
+        catch (error) {
+            return struct;
+        }
+        return struct;
+    }
+}
+exports.VerifyingPaymaster = VerifyingPaymaster;
+//# sourceMappingURL=verifying-paymaster.js.map

package/dist/cjs/kernel-zerodev/paymaster/verifying-paymaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifying-paymaster.js","sourceRoot":"","sources":["../../../../src/kernel-zerodev/paymaster/verifying-paymaster.ts"],"names":[],"mappings":";;;AAAA,8CAI0B;AAC1B,uCAAsC;AAItC,MAAa,kBAAmB,SAAQ,mBAAS;IAC/C,YACE,QAAyB,EACzB,CAAyC;QAEzC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,oBAAoB,CACxB,MAA2B,EAC3B,iBAAgD;QAEhD,IAAI;YACF,MAAM,cAAc,GAAG,IAAA,qBAAW,EAAC,MAAM,IAAA,2BAAiB,EAAC,MAAM,CAAC,CAAC,CAAC;YACpE,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;gBAC1C,MAAM,EAAE,cAAc;gBACtB,iBAAiB;aAClB,CAAC,CAAC;YACH,IAAI,aAAa,EAAE;gBACjB,OAAO;oBACL,GAAG,MAAM;oBACT,GAAG,aAAa;iBACjB,CAAC;aACH;SACF;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,MAAM,CAAC;SACf;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5BD,gDA4BC","sourcesContent":["import {\n  type UserOperationStruct,\n  deepHexlify,\n  resolveProperties,\n} from \"@alchemy/aa-core\";\nimport { Paymaster } from \"./base.js\";\nimport type { ZeroDevProvider } from \"../provider.js\";\nimport type { PaymasterAndBundlerProviders, PaymasterConfig } from \"./types.js\";\n\nexport class VerifyingPaymaster extends Paymaster {\n  constructor(\n    provider: ZeroDevProvider,\n    _: PaymasterConfig<\"VERIFYING_PAYMASTER\">\n  ) {\n    super(provider);\n  }\n  async getPaymasterResponse(\n    struct: UserOperationStruct,\n    paymasterProvider?: PaymasterAndBundlerProviders\n  ): Promise<UserOperationStruct> {\n    try {\n      const hexifiedUserOp = deepHexlify(await resolveProperties(struct));\n      const paymasterResp = await this.signUserOp({\n        userOp: hexifiedUserOp,\n        paymasterProvider,\n      });\n      if (paymasterResp) {\n        return {\n          ...struct,\n          ...paymasterResp,\n        };\n      }\n    } catch (error) {\n      return struct;\n    }\n    return struct;\n  }\n}\n"]}

package/dist/cjs/kernel-zerodev/provider.d.ts

@@ -0,0 +1,42 @@
+import { type Address, type Chain, type Hash, type HttpTransport, type RpcTransactionRequest } from "viem";
+import { type SmartAccountProviderOpts, type UserOperationCallData, type BatchUserOperationCallData, type SendUserOperationResult, SmartAccountProvider, type AccountMiddlewareFn, type UserOperationOverrides } from "@alchemy/aa-core";
+import { KernelSmartContractAccount } from "./account.js";
+import type { PaymasterAndBundlerProviders, PaymasterConfig, PaymasterPolicy } from "./paymaster/types.js";
+export type ZeroDevProviderConfig = {
+    projectId: string;
+    chain: Chain | number;
+    entryPointAddress?: Address;
+    rpcUrl?: string;
+    account?: KernelSmartContractAccount;
+    bundlerProvider?: PaymasterAndBundlerProviders;
+    opts?: SmartAccountProviderOpts & {
+        sendTxMaxRetries?: number;
+        sendTxRetryIntervalMs?: number;
+    };
+};
+export declare enum Operation {
+    Call = 0,
+    DelegateCall = 1
+}
+type UserOpDataOperationTypes<T> = T extends UserOperationCallData ? Operation.Call | Operation.DelegateCall : T extends BatchUserOperationCallData ? Operation.Call : never;
+export declare class ZeroDevProvider extends SmartAccountProvider<HttpTransport> {
+    protected projectId: string;
+    protected sendTxMaxRetries: number;
+    protected sendTxRetryIntervalMs: number;
+    constructor({ projectId, chain, entryPointAddress, rpcUrl, account, bundlerProvider, opts, }: ZeroDevProviderConfig);
+    getProjectId: () => string;
+    sendTransaction: (request: RpcTransactionRequest, operation?: UserOpDataOperationTypes<UserOperationCallData>) => Promise<Hash>;
+    sendUserOperation: <T extends UserOperationCallData | BatchUserOperationCallData>(data: T, overrides?: UserOperationOverrides, operation?: UserOpDataOperationTypes<T>) => Promise<SendUserOperationResult>;
+    isReplacementOpError(errorIn: any): boolean;
+    unwrapError(errorIn: any): Error;
+    getAccount: () => KernelSmartContractAccount;
+    dummyPaymasterDataMiddleware: AccountMiddlewareFn;
+    withZeroDevPaymasterAndData(config: PaymasterConfig<PaymasterPolicy>): this & SmartAccountProvider<HttpTransport> & {
+        account: import("@alchemy/aa-core").BaseSmartContractAccount<HttpTransport>;
+    };
+    request: (args: {
+        method: string;
+        params?: any[];
+    }) => Promise<any>;
+}
+export {};

package/dist/cjs/kernel-zerodev/provider.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZeroDevProvider = exports.Operation = void 0;
+const viem_1 = require("viem");
+const aa_core_1 = require("@alchemy/aa-core");
+const constants_js_1 = require("./constants.js");
+const account_js_1 = require("./account.js");
+const gas_estimator_js_1 = require("./middleware/gas-estimator.js");
+const ERC4337_utils_js_1 = require("./utils/ERC4337-utils.js");
+const errors_js_1 = require("./errors.js");
+const paymaster_js_1 = require("./middleware/paymaster.js");
+const create_client_js_1 = require("./client/create-client.js");
+var Operation;
+(function (Operation) {
+    Operation[Operation["Call"] = 0] = "Call";
+    Operation[Operation["DelegateCall"] = 1] = "DelegateCall";
+})(Operation || (exports.Operation = Operation = {}));
+class ZeroDevProvider extends aa_core_1.SmartAccountProvider {
+    constructor({ projectId, chain, entryPointAddress = constants_js_1.ENTRYPOINT_ADDRESS, rpcUrl = constants_js_1.BUNDLER_URL, account, bundlerProvider, opts, }) {
+        const _chain = typeof chain === "number" ? (0, aa_core_1.getChain)(chain) : chain;
+        const rpcClient = (0, create_client_js_1.createZeroDevPublicErc4337Client)({
+            chain: _chain,
+            rpcUrl,
+            projectId,
+            bundlerProvider,
+        });
+        super(rpcClient, entryPointAddress, _chain, account, {
+            ...opts,
+            txMaxRetries: opts?.txMaxRetries ?? 10,
+            txRetryIntervalMs: opts?.txRetryIntervalMs ?? 10000,
+            minPriorityFeePerBid: opts?.minPriorityFeePerBid ??
+                constants_js_1.minPriorityFeePerBidDefaults.get(_chain.id),
+        });
+        Object.defineProperty(this, "projectId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sendTxMaxRetries", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sendTxRetryIntervalMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "getProjectId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => this.projectId
+        });
+        Object.defineProperty(this, "sendTransaction", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (request, operation = Operation.Call) => {
+                if (!request.to) {
+                    throw new Error("transaction is missing to address");
+                }
+                const overrides = {};
+                if (request.maxFeePerGas) {
+                    overrides.maxFeePerGas = request.maxFeePerGas;
+                }
+                if (request.maxPriorityFeePerGas) {
+                    overrides.maxPriorityFeePerGas = request.maxPriorityFeePerGas;
+                }
+                const { hash } = await this.sendUserOperation({
+                    target: request.to,
+                    data: request.data ?? "0x",
+                    value: request.value ? (0, viem_1.fromHex)(request.value, "bigint") : 0n,
+                }, overrides, operation);
+                return await this.waitForUserOperationTransaction(hash);
+            }
+        });
+        Object.defineProperty(this, "sendUserOperation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (data, overrides, operation = Operation.Call) => {
+                if (!(0, account_js_1.isKernelAccount)(this.account)) {
+                    throw new Error("account not connected!");
+                }
+                if (!this.account.validator) {
+                    throw new Error("validator not connected!");
+                }
+                let callData = "0x";
+                if (Array.isArray(data)) {
+                    if (operation === Operation.Call) {
+                        callData = await this.account.encodeBatchExecute(data);
+                    }
+                    else {
+                        throw errors_js_1.InvalidOperation;
+                    }
+                }
+                else if ((0, account_js_1.isKernelAccount)(this.account)) {
+                    if (operation === Operation.DelegateCall) {
+                        callData = await this.account.encodeExecuteDelegate(data.target, data.value ?? 0n, data.data);
+                    }
+                    else if (operation === Operation.Call) {
+                        callData = await this.account.encodeExecute(data.target, data.value ?? 0n, data.data);
+                    }
+                    else {
+                        throw errors_js_1.InvalidOperation;
+                    }
+                }
+                else {
+                    throw errors_js_1.InvalidOperation;
+                }
+                const initCode = await this.account.getInitCode();
+                let hash = "";
+                let i = 0;
+                let maxFeePerGas = 0n;
+                let maxPriorityFeePerGas = 0n;
+                let request;
+                const nonce = await this.account.getNonce();
+                do {
+                    const uoStruct = await (0, aa_core_1.asyncPipe)(this.dummyPaymasterDataMiddleware, this.feeDataGetter, this.paymasterDataMiddleware, this.gasEstimator, this.customMiddleware ?? aa_core_1.noOpMiddleware, async (struct) => ({ ...struct, ...overrides }))({
+                        initCode,
+                        sender: this.getAddress(),
+                        nonce,
+                        callData,
+                        signature: await this.account
+                            .getValidator()
+                            .getDynamicDummySignature(await this.getAddress(), callData),
+                        maxFeePerGas,
+                        maxPriorityFeePerGas,
+                    });
+                    request = (0, aa_core_1.deepHexlify)(await (0, aa_core_1.resolveProperties)(uoStruct));
+                    if (!(0, ERC4337_utils_js_1.isValidRequest)(request)) {
+                        throw new Error(`Request is missing parameters. All properties on UserOperationStruct must be set. uo: ${JSON.stringify(request, null, 2)}`);
+                    }
+                    request.signature = await this.account.validator.getSignature(request);
+                    try {
+                        hash = await this.rpcClient.sendUserOperation(request, this.entryPointAddress);
+                    }
+                    catch (error) {
+                        if (this.isReplacementOpError(error) && i++ < this.sendTxMaxRetries) {
+                            maxFeePerGas = (BigInt(request.maxFeePerGas) * 113n) / 100n;
+                            maxPriorityFeePerGas =
+                                (BigInt(request.maxPriorityFeePerGas) * 113n) / 100n;
+                            console.log(`After ${this.sendTxRetryIntervalMs / 60000} minutes, resending tx with Increased Gas fees: maxFeePerGas: ${maxFeePerGas}, maxPriorityFeePerGas: ${maxPriorityFeePerGas}`);
+                            await new Promise((resolve) => setTimeout(resolve, this.sendTxRetryIntervalMs));
+                            continue;
+                        }
+                        throw this.unwrapError(error);
+                    }
+                } while (hash === "");
+                return {
+                    hash,
+                    request,
+                };
+            }
+        });
+        Object.defineProperty(this, "getAccount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                if (!(0, account_js_1.isKernelAccount)(this.account)) {
+                    throw new Error("account not connected!");
+                }
+                return this.account;
+            }
+        });
+        Object.defineProperty(this, "dummyPaymasterDataMiddleware", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (struct) => {
+                struct.paymasterAndData =
+                    "0xfe7dbcab8aaee4eb67943c1e6be95b1d065985c6000000000000000000000000000000000000000000000000000001869aa31cf400000000000000000000000000000000000000000000000000000000000000007dfe2190f34af27b265bae608717cdc9368b471fc0c097ab7b4088f255b4961e57b039e7e571b15221081c5dce7bcb93459b27a3ab65d2f8a889f4a40b4022801b";
+                return struct;
+            }
+        });
+        Object.defineProperty(this, "request", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (args) => {
+                const { method, params } = args;
+                switch (method) {
+                    case "eth_chainId":
+                        return this.chain.id;
+                    case "eth_sendTransaction":
+                        const [tx] = params;
+                        return this.sendTransaction(tx);
+                    case "personal_sign":
+                        if (!this.account) {
+                            throw new Error("account not connected!");
+                        }
+                        const [data, address] = params;
+                        if (address !== (await this.getAddress())) {
+                            throw new Error("cannot sign for address that is not the current account");
+                        }
+                        return this.account.signWithEip6492(data);
+                    default:
+                        return this.rpcClient.request(args);
+                }
+            }
+        });
+        this.projectId = projectId;
+        this.sendTxMaxRetries =
+            opts?.sendTxMaxRetries ?? constants_js_1.DEFAULT_SEND_TX_MAX_RETRIES;
+        this.sendTxRetryIntervalMs =
+            opts?.sendTxRetryIntervalMs ?? constants_js_1.DEFAULT_SEND_TX_RETRY_INTERVAL_MS;
+        (0, gas_estimator_js_1.withZeroDevGasEstimator)(this);
+    }
+    isReplacementOpError(errorIn) {
+        if (errorIn.cause != null) {
+            const failedOpMessage = errorIn?.cause?.message;
+            return ((failedOpMessage?.includes("replacement op must increase maxFeePerGas and MaxPriorityFeePerGas") ||
+                failedOpMessage?.match(/.*replacement.*underpriced.*/) !== null) ??
+                false);
+        }
+        return false;
+    }
+    unwrapError(errorIn) {
+        if (errorIn?.cause != null) {
+            let paymasterInfo = "";
+            let failedOpMessage = errorIn?.cause?.message;
+            if (failedOpMessage?.includes("FailedOp") === true) {
+                const matched = failedOpMessage.match(/FailedOp\((.*)\)/);
+                if (matched != null) {
+                    const split = matched[1].split(",");
+                    paymasterInfo = `(paymaster address: ${split[1]})`;
+                    failedOpMessage = split[2];
+                }
+            }
+            const error = new Error(`The bundler has failed to include UserOperation in a batch: ${failedOpMessage} ${paymasterInfo}`);
+            error.stack = errorIn.stack;
+            return error;
+        }
+        return errorIn;
+    }
+    withZeroDevPaymasterAndData(config) {
+        if (!this.isConnected()) {
+            throw new Error("ZeroDevProvider: account is not set, did you call `connect` first?");
+        }
+        return (0, paymaster_js_1.withZeroDevPaymasterAndData)(this, config);
+    }
+}
+exports.ZeroDevProvider = ZeroDevProvider;
+//# sourceMappingURL=provider.js.map

package/dist/cjs/kernel-zerodev/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/kernel-zerodev/provider.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  fromHex,\n  type Address,\n  type Chain,\n  type Hash,\n  type Hex,\n  type HttpTransport,\n  type RpcTransactionRequest,\n} from \"viem\";\nimport {\n  deepHexlify,\n  resolveProperties,\n  type SmartAccountProviderOpts,\n  getChain,\n  type UserOperationCallData,\n  type BatchUserOperationCallData,\n  type SendUserOperationResult,\n  asyncPipe,\n  noOpMiddleware,\n  type UserOperationStruct,\n  type BytesLike,\n  SmartAccountProvider,\n  type AccountMiddlewareFn,\n  type UserOperationOverrides,\n} from \"@alchemy/aa-core\";\nimport {\n  BUNDLER_URL,\n  DEFAULT_SEND_TX_MAX_RETRIES,\n  DEFAULT_SEND_TX_RETRY_INTERVAL_MS,\n  ENTRYPOINT_ADDRESS,\n  minPriorityFeePerBidDefaults,\n} from \"./constants.js\";\nimport { KernelSmartContractAccount, isKernelAccount } from \"./account.js\";\nimport { withZeroDevGasEstimator } from \"./middleware/gas-estimator.js\";\nimport { isValidRequest } from \"./utils/ERC4337-utils.js\";\nimport { InvalidOperation } from \"./errors.js\";\nimport { withZeroDevPaymasterAndData } from \"./middleware/paymaster.js\";\nimport { createZeroDevPublicErc4337Client } from \"./client/create-client.js\";\nimport type {\n  PaymasterAndBundlerProviders,\n  PaymasterConfig,\n  PaymasterPolicy,\n} from \"./paymaster/types.js\";\n\nexport type ZeroDevProviderConfig = {\n  projectId: string;\n  chain: Chain | number;\n  entryPointAddress?: Address;\n  rpcUrl?: string;\n  account?: KernelSmartContractAccount;\n  bundlerProvider?: PaymasterAndBundlerProviders;\n  opts?: SmartAccountProviderOpts & {\n    sendTxMaxRetries?: number;\n    sendTxRetryIntervalMs?: number;\n  };\n};\n\nexport enum Operation {\n  Call,\n  DelegateCall,\n}\n\ntype UserOpDataOperationTypes<T> = T extends UserOperationCallData\n  ? Operation.Call | Operation.DelegateCall\n  : T extends BatchUserOperationCallData\n  ? Operation.Call\n  : never;\n\nexport class ZeroDevProvider extends SmartAccountProvider<HttpTransport> {\n  protected projectId: string;\n  protected sendTxMaxRetries: number;\n  protected sendTxRetryIntervalMs: number;\n\n  constructor({\n    projectId,\n    chain,\n    entryPointAddress = ENTRYPOINT_ADDRESS,\n    rpcUrl = BUNDLER_URL,\n    account,\n    bundlerProvider,\n    opts,\n  }: ZeroDevProviderConfig) {\n    const _chain = typeof chain === \"number\" ? getChain(chain) : chain;\n    const rpcClient = createZeroDevPublicErc4337Client({\n      chain: _chain,\n      rpcUrl,\n      projectId,\n      bundlerProvider,\n    });\n\n    super(rpcClient, entryPointAddress, _chain, account, {\n      ...opts,\n      txMaxRetries: opts?.txMaxRetries ?? 10,\n      txRetryIntervalMs: opts?.txRetryIntervalMs ?? 10000,\n      minPriorityFeePerBid:\n        opts?.minPriorityFeePerBid ??\n        minPriorityFeePerBidDefaults.get(_chain.id),\n    });\n\n    this.projectId = projectId;\n    this.sendTxMaxRetries =\n      opts?.sendTxMaxRetries ?? DEFAULT_SEND_TX_MAX_RETRIES;\n    this.sendTxRetryIntervalMs =\n      opts?.sendTxRetryIntervalMs ?? DEFAULT_SEND_TX_RETRY_INTERVAL_MS;\n\n    withZeroDevGasEstimator(this);\n  }\n\n  getProjectId = (): string => this.projectId;\n\n  sendTransaction = async (\n    request: RpcTransactionRequest,\n    operation: UserOpDataOperationTypes<UserOperationCallData> = Operation.Call\n  ): Promise<Hash> => {\n    if (!request.to) {\n      throw new Error(\"transaction is missing to address\");\n    }\n\n    const overrides: UserOperationOverrides = {};\n    if (request.maxFeePerGas) {\n      overrides.maxFeePerGas = request.maxFeePerGas;\n    }\n    if (request.maxPriorityFeePerGas) {\n      overrides.maxPriorityFeePerGas = request.maxPriorityFeePerGas;\n    }\n\n    const { hash } = await this.sendUserOperation(\n      {\n        target: request.to,\n        data: request.data ?? \"0x\",\n        value: request.value ? fromHex(request.value, \"bigint\") : 0n,\n      },\n      overrides,\n      operation\n    );\n\n    return await this.waitForUserOperationTransaction(hash as Hash);\n  };\n\n  sendUserOperation = async <\n    T extends UserOperationCallData | BatchUserOperationCallData\n  >(\n    data: T,\n    overrides?: UserOperationOverrides,\n    operation: UserOpDataOperationTypes<T> = Operation.Call as UserOpDataOperationTypes<T>\n  ): Promise<SendUserOperationResult> => {\n    if (!isKernelAccount(this.account)) {\n      throw new Error(\"account not connected!\");\n    }\n    if (!this.account.validator) {\n      throw new Error(\"validator not connected!\");\n    }\n\n    let callData: BytesLike = \"0x\";\n\n    if (Array.isArray(data)) {\n      if (operation === Operation.Call) {\n        callData = await this.account.encodeBatchExecute(data);\n      } else {\n        throw InvalidOperation;\n      }\n    } else if (isKernelAccount(this.account)) {\n      if (operation === Operation.DelegateCall) {\n        callData = await this.account.encodeExecuteDelegate(\n          data.target,\n          data.value ?? 0n,\n          data.data\n        );\n      } else if (operation === Operation.Call) {\n        callData = await this.account.encodeExecute(\n          data.target,\n          data.value ?? 0n,\n          data.data\n        );\n      } else {\n        throw InvalidOperation;\n      }\n    } else {\n      throw InvalidOperation;\n    }\n\n    const initCode = await this.account.getInitCode();\n    let hash: string = \"\";\n    let i = 0;\n    let maxFeePerGas = 0n;\n    let maxPriorityFeePerGas = 0n;\n    let request: UserOperationStruct;\n\n    const nonce = await this.account.getNonce();\n    do {\n      const uoStruct = await asyncPipe(\n        this.dummyPaymasterDataMiddleware,\n        this.feeDataGetter,\n        this.paymasterDataMiddleware,\n        this.gasEstimator,\n        this.customMiddleware ?? noOpMiddleware,\n        async (struct) => ({ ...struct, ...overrides })\n      )({\n        initCode,\n        sender: this.getAddress(),\n        nonce,\n        callData,\n        signature: await this.account\n          .getValidator()\n          .getDynamicDummySignature(await this.getAddress(), callData as Hex),\n        maxFeePerGas,\n        maxPriorityFeePerGas,\n      } as UserOperationStruct);\n      request = deepHexlify(await resolveProperties(uoStruct));\n\n      if (!isValidRequest(request)) {\n        // this pretty prints the uo\n        throw new Error(\n          `Request is missing parameters. All properties on UserOperationStruct must be set. uo: ${JSON.stringify(\n            request,\n            null,\n            2\n          )}`\n        );\n      }\n\n      request.signature = await this.account.validator.getSignature(request);\n      try {\n        hash = await this.rpcClient.sendUserOperation(\n          request,\n          this.entryPointAddress\n        );\n      } catch (error: any) {\n        if (this.isReplacementOpError(error) && i++ < this.sendTxMaxRetries) {\n          maxFeePerGas = (BigInt(request.maxFeePerGas) * 113n) / 100n;\n          maxPriorityFeePerGas =\n            (BigInt(request.maxPriorityFeePerGas) * 113n) / 100n;\n          console.log(\n            `After ${\n              this.sendTxRetryIntervalMs / 60000\n            } minutes, resending tx with Increased Gas fees: maxFeePerGas: ${maxFeePerGas}, maxPriorityFeePerGas: ${maxPriorityFeePerGas}`\n          );\n          await new Promise((resolve) =>\n            setTimeout(resolve, this.sendTxRetryIntervalMs)\n          );\n          continue;\n        }\n        throw this.unwrapError(error);\n      }\n    } while (hash === \"\");\n\n    return {\n      hash,\n      request,\n    };\n  };\n\n  isReplacementOpError(errorIn: any): boolean {\n    if (errorIn.cause != null) {\n      const failedOpMessage: string | undefined = errorIn?.cause?.message;\n      return (\n        (failedOpMessage?.includes(\n          \"replacement op must increase maxFeePerGas and MaxPriorityFeePerGas\"\n        ) ||\n          failedOpMessage?.match(/.*replacement.*underpriced.*/) !== null) ??\n        false\n      );\n    }\n    return false;\n  }\n\n  unwrapError(errorIn: any): Error {\n    if (errorIn?.cause != null) {\n      let paymasterInfo: string = \"\";\n      let failedOpMessage: string | undefined = errorIn?.cause?.message;\n      if (failedOpMessage?.includes(\"FailedOp\") === true) {\n        // TODO: better error extraction methods will be needed\n        const matched = failedOpMessage.match(/FailedOp\\((.*)\\)/);\n        if (matched != null) {\n          const split = matched[1].split(\",\");\n          paymasterInfo = `(paymaster address: ${split[1]})`;\n          failedOpMessage = split[2];\n        }\n      }\n      const error = new Error(\n        `The bundler has failed to include UserOperation in a batch: ${failedOpMessage} ${paymasterInfo}`\n      );\n      error.stack = errorIn.stack;\n      return error;\n    }\n    return errorIn;\n  }\n\n  getAccount: () => KernelSmartContractAccount = () => {\n    if (!isKernelAccount(this.account)) {\n      throw new Error(\"account not connected!\");\n    }\n    return this.account;\n  };\n\n  dummyPaymasterDataMiddleware: AccountMiddlewareFn = async (\n    struct: UserOperationStruct\n  ): Promise<UserOperationStruct> => {\n    struct.paymasterAndData =\n      \"0xfe7dbcab8aaee4eb67943c1e6be95b1d065985c6000000000000000000000000000000000000000000000000000001869aa31cf400000000000000000000000000000000000000000000000000000000000000007dfe2190f34af27b265bae608717cdc9368b471fc0c097ab7b4088f255b4961e57b039e7e571b15221081c5dce7bcb93459b27a3ab65d2f8a889f4a40b4022801b\";\n    return struct;\n  };\n\n  withZeroDevPaymasterAndData(config: PaymasterConfig<PaymasterPolicy>) {\n    if (!this.isConnected()) {\n      throw new Error(\n        \"ZeroDevProvider: account is not set, did you call `connect` first?\"\n      );\n    }\n\n    return withZeroDevPaymasterAndData(this, config);\n  }\n\n  request: (args: { method: string; params?: any[] }) => Promise<any> = async (\n    args\n  ) => {\n    const { method, params } = args;\n    switch (method) {\n      case \"eth_chainId\":\n        return this.chain.id;\n      case \"eth_sendTransaction\":\n        const [tx] = params as [RpcTransactionRequest];\n        return this.sendTransaction(tx);\n      case \"personal_sign\":\n        if (!this.account) {\n          throw new Error(\"account not connected!\");\n        }\n        const [data, address] = params!;\n        if (address !== (await this.getAddress())) {\n          throw new Error(\n            \"cannot sign for address that is not the current account\"\n          );\n        }\n        // @ts-ignore\n        return this.account.signWithEip6492(data);\n      default:\n        // @ts-ignore\n        return this.rpcClient.request(args);\n    }\n  };\n}\n"]}

package/dist/cjs/kernel-zerodev/types.d.ts

@@ -0,0 +1,7 @@
+export type WithOptional<T, K extends keyof T> = Pick<Partial<T>, K>;
+export type WithRequired<T, K extends keyof T> = Required<Pick<T, K>>;
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+export type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+export type RequiredProps<T> = Pick<T, RequiredKeys<T>>;

package/dist/cjs/kernel-zerodev/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/kernel-zerodev/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kernel-zerodev/types.ts"],"names":[],"mappings":"","sourcesContent":["export type WithOptional<T, K extends keyof T> = Pick<Partial<T>, K>;\nexport type WithRequired<T, K extends keyof T> = Required<Pick<T, K>>;\nexport type MakeOptional<T, K extends keyof T> = Omit<T, K> &\n  Partial<Pick<T, K>>;\nexport type RequiredKeys<T> = {\n  [K in keyof T]-?: {} extends Pick<T, K> ? never : K;\n}[keyof T];\nexport type RequiredProps<T> = Pick<T, RequiredKeys<T>>;\n"]}

package/dist/cjs/kernel-zerodev/utils/ERC4337-utils.d.ts

@@ -0,0 +1,5 @@
+import { type UserOperationRequest, type UserOperationStruct } from "@alchemy/aa-core";
+import type { NotPromise } from "./calc-pre-verification-gas.js";
+export declare function packUserOp(op: NotPromise<UserOperationStruct>, forSignature?: boolean): string;
+export declare function isValidRequest(request: UserOperationStruct): request is UserOperationRequest;
+export declare const hexifyUserOp: (resolvedUserOp: any) => {};

package/dist/cjs/kernel-zerodev/utils/ERC4337-utils.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexifyUserOp = exports.isValidRequest = exports.packUserOp = void 0;
+const aa_core_1 = require("@alchemy/aa-core");
+const viem_1 = require("viem");
+const validateUserOpMethod = "simulateValidation";
+const UserOpType = aa_core_1.EntryPointAbi.find((entry) => entry.name === validateUserOpMethod)?.inputs[0];
+function encode(typevalues, forSignature) {
+    const types = typevalues
+        .map((typevalue) => typevalue.type === "bytes" && forSignature ? "bytes32" : typevalue.type)
+        .join(", ");
+    const values = typevalues.map((typevalue) => typevalue.type === "bytes" && forSignature
+        ? (0, viem_1.keccak256)(typevalue.val)
+        : typevalue.val);
+    return (0, viem_1.encodeAbiParameters)((0, viem_1.parseAbiParameters)(types), values);
+}
+function packUserOp(op, forSignature = true) {
+    if (forSignature) {
+        const userOpType = {
+            components: [
+                {
+                    type: "address",
+                    name: "sender",
+                },
+                {
+                    type: "uint256",
+                    name: "nonce",
+                },
+                {
+                    type: "bytes",
+                    name: "initCode",
+                },
+                {
+                    type: "bytes",
+                    name: "callData",
+                },
+                {
+                    type: "uint256",
+                    name: "callGasLimit",
+                },
+                {
+                    type: "uint256",
+                    name: "verificationGasLimit",
+                },
+                {
+                    type: "uint256",
+                    name: "preVerificationGas",
+                },
+                {
+                    type: "uint256",
+                    name: "maxFeePerGas",
+                },
+                {
+                    type: "uint256",
+                    name: "maxPriorityFeePerGas",
+                },
+                {
+                    type: "bytes",
+                    name: "paymasterAndData",
+                },
+                {
+                    type: "bytes",
+                    name: "signature",
+                },
+            ],
+            name: "userOp",
+            type: "tuple",
+        };
+        let encoded = (0, viem_1.encodeAbiParameters)(userOpType.components, Object.values({
+            ...op,
+            signature: "0x",
+        }));
+        encoded = ("0x" + encoded.slice(66, encoded.length - 64));
+        return encoded;
+    }
+    const typevalues = UserOpType.components.map((c) => ({
+        type: c.type,
+        val: op[c.name],
+    }));
+    return encode(typevalues, forSignature);
+}
+exports.packUserOp = packUserOp;
+function isValidRequest(request) {
+    return (!!request.callGasLimit &&
+        !!request.maxFeePerGas &&
+        request.maxPriorityFeePerGas != null &&
+        !!request.preVerificationGas &&
+        !!request.verificationGasLimit);
+}
+exports.isValidRequest = isValidRequest;
+const hexifyUserOp = (resolvedUserOp) => {
+    return Object.keys(resolvedUserOp)
+        .map((key) => {
+        let val = resolvedUserOp[key];
+        if (typeof val !== "string" || !val.startsWith("0x")) {
+            val = (0, viem_1.toHex)(val);
+        }
+        return [key, val];
+    })
+        .reduce((set, [k, v]) => ({
+        ...set,
+        [k]: v,
+    }), {});
+};
+exports.hexifyUserOp = hexifyUserOp;
+//# sourceMappingURL=ERC4337-utils.js.map

package/dist/cjs/kernel-zerodev/utils/ERC4337-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ERC4337-utils.js","sourceRoot":"","sources":["../../../../src/kernel-zerodev/utils/ERC4337-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EntryPointAbi,\n  type UserOperationRequest,\n  type UserOperationStruct,\n} from \"@alchemy/aa-core\";\nimport type { NotPromise } from \"./calc-pre-verification-gas.js\";\nimport {\n  encodeAbiParameters,\n  parseAbiParameters,\n  type Hex,\n  keccak256,\n  toHex,\n} from \"viem\";\n\n// UserOperation is the first parameter of validateUseOp\nconst validateUserOpMethod = \"simulateValidation\";\n\nconst UserOpType = EntryPointAbi.find(\n  // @ts-ignore\n  (entry) => entry.name === validateUserOpMethod\n  // @ts-ignore\n)?.inputs[0];\n\nfunction encode(\n  typevalues: Array<{ type: string; val: any }>,\n  forSignature: boolean\n): string {\n  const types = typevalues\n    .map((typevalue) =>\n      typevalue.type === \"bytes\" && forSignature ? \"bytes32\" : typevalue.type\n    )\n    .join(\", \");\n  const values = typevalues.map((typevalue) =>\n    typevalue.type === \"bytes\" && forSignature\n      ? keccak256(typevalue.val)\n      : typevalue.val\n  );\n  return encodeAbiParameters(parseAbiParameters(types), values);\n}\n\n/**\n * pack the userOperation\n * @param op\n * @param forSignature \"true\" if the hash is needed to calculate the getUserOpHash()\n *  \"false\" to pack entire UserOp, for calculating the calldata cost of putting it on-chain.\n */\nexport function packUserOp(\n  op: NotPromise<UserOperationStruct>,\n  forSignature = true\n): string {\n  if (forSignature) {\n    // lighter signature scheme (must match UserOperation#pack): do encode a zero-length signature, but strip afterwards the appended zero-length value\n    const userOpType = {\n      components: [\n        {\n          type: \"address\",\n          name: \"sender\",\n        },\n        {\n          type: \"uint256\",\n          name: \"nonce\",\n        },\n        {\n          type: \"bytes\",\n          name: \"initCode\",\n        },\n        {\n          type: \"bytes\",\n          name: \"callData\",\n        },\n        {\n          type: \"uint256\",\n          name: \"callGasLimit\",\n        },\n        {\n          type: \"uint256\",\n          name: \"verificationGasLimit\",\n        },\n        {\n          type: \"uint256\",\n          name: \"preVerificationGas\",\n        },\n        {\n          type: \"uint256\",\n          name: \"maxFeePerGas\",\n        },\n        {\n          type: \"uint256\",\n          name: \"maxPriorityFeePerGas\",\n        },\n        {\n          type: \"bytes\",\n          name: \"paymasterAndData\",\n        },\n        {\n          type: \"bytes\",\n          name: \"signature\",\n        },\n      ],\n      name: \"userOp\",\n      type: \"tuple\",\n    };\n    // console.log('hard-coded userOpType', userOpType)\n    // console.log('from ABI userOpType', UserOpType)\n    let encoded = encodeAbiParameters(\n      userOpType.components,\n      Object.values({\n        ...op,\n        signature: \"0x\",\n      })\n    );\n    // remove leading word (total length) and trailing word (zero-length signature)\n    encoded = (\"0x\" + encoded.slice(66, encoded.length - 64)) as Hex;\n    return encoded;\n  }\n\n  const typevalues = (UserOpType as any).components.map(\n    (c: { name: keyof typeof op; type: string }) => ({\n      type: c.type,\n      val: op[c.name],\n    })\n  );\n  return encode(typevalues, forSignature);\n}\n\n/**\n * Utility method for asserting a {@link UserOperationStruct} is a {@link UserOperationRequest}\n *\n * @param request a {@link UserOperationStruct} to validate\n * @returns a type guard that asserts the {@link UserOperationStruct} is a {@link UserOperationRequest}\n */\nexport function isValidRequest(\n  request: UserOperationStruct\n): request is UserOperationRequest {\n  // These are the only ones marked as optional in the interface above\n  return (\n    !!request.callGasLimit &&\n    !!request.maxFeePerGas &&\n    request.maxPriorityFeePerGas != null &&\n    !!request.preVerificationGas &&\n    !!request.verificationGasLimit\n  );\n}\n\nexport const hexifyUserOp = (resolvedUserOp: any) => {\n  return Object.keys(resolvedUserOp)\n    .map((key) => {\n      let val = resolvedUserOp[key];\n      if (typeof val !== \"string\" || !val.startsWith(\"0x\")) {\n        val = toHex(val);\n      }\n      return [key, val];\n    })\n    .reduce(\n      (set, [k, v]) => ({\n        ...set,\n        [k]: v,\n      }),\n      {}\n    );\n};\n"]}

package/dist/cjs/kernel-zerodev/utils/calc-pre-verification-gas.d.ts

@@ -0,0 +1,15 @@
+import type { UserOperationStruct } from "@alchemy/aa-core";
+export interface GasOverheads {
+    fixed: number;
+    perUserOp: number;
+    perUserOpWord: number;
+    zeroByte: number;
+    nonZeroByte: number;
+    bundleSize: number;
+    sigSize: number;
+}
+export declare const DefaultGasOverheads: GasOverheads;
+export type NotPromise<T> = {
+    [P in keyof T]: Exclude<T[P], Promise<any>>;
+};
+export declare function calcPreVerificationGas(userOp: Partial<NotPromise<UserOperationStruct>>, overheads?: Partial<GasOverheads>): number;

package/dist/cjs/kernel-zerodev/utils/calc-pre-verification-gas.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcPreVerificationGas = exports.DefaultGasOverheads = void 0;
+const viem_1 = require("viem");
+const ERC4337_utils_js_1 = require("./ERC4337-utils.js");
+exports.DefaultGasOverheads = {
+    fixed: 21000,
+    perUserOp: 18300,
+    perUserOpWord: 4,
+    zeroByte: 4,
+    nonZeroByte: 16,
+    bundleSize: 1,
+    sigSize: 65,
+};
+function calcPreVerificationGas(userOp, overheads) {
+    const ov = { ...exports.DefaultGasOverheads, ...(overheads ?? {}) };
+    const p = {
+        preVerificationGas: 21000,
+        signature: (0, viem_1.toHex)(Buffer.alloc(ov.sigSize, 1)),
+        ...userOp,
+    };
+    const packed = (0, viem_1.toBytes)((0, ERC4337_utils_js_1.packUserOp)(p, false));
+    const callDataCost = packed
+        .map((x) => (x === 0 ? ov.zeroByte : ov.nonZeroByte))
+        .reduce((sum, x) => sum + x);
+    const ret = Math.round(callDataCost +
+        ov.fixed / ov.bundleSize +
+        ov.perUserOp +
+        ov.perUserOpWord * packed.length);
+    return ret;
+}
+exports.calcPreVerificationGas = calcPreVerificationGas;
+//# sourceMappingURL=calc-pre-verification-gas.js.map

package/dist/cjs/kernel-zerodev/utils/calc-pre-verification-gas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calc-pre-verification-gas.js","sourceRoot":"","sources":["../../../../src/kernel-zerodev/utils/calc-pre-verification-gas.ts"],"names":[],"mappings":";;;AACA,+BAAsC;AACtC,yDAAgD;AAyCnC,QAAA,mBAAmB,GAAiB;IAC/C,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,CAAC;IAChB,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,EAAE;CACZ,CAAC;AAaF,SAAgB,sBAAsB,CACpC,MAAgD,EAChD,SAAiC;IAEjC,MAAM,EAAE,GAAG,EAAE,GAAG,2BAAmB,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5D,MAAM,CAAC,GAAoC;QAEzC,kBAAkB,EAAE,KAAK;QACzB,SAAS,EAAE,IAAA,YAAK,EAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7C,GAAG,MAAM;KACH,CAAC;IAET,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,IAAA,6BAAU,EAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY;QACV,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,UAAU;QACxB,EAAE,CAAC,SAAS;QACZ,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CACnC,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAvBD,wDAuBC","sourcesContent":["import type { UserOperationStruct } from \"@alchemy/aa-core\";\nimport { toBytes, toHex } from \"viem\";\nimport { packUserOp } from \"./ERC4337-utils.js\";\n\nexport interface GasOverheads {\n  /**\n   * fixed overhead for entire handleOp bundle.\n   */\n  fixed: number;\n\n  /**\n   * per userOp overhead, added on top of the above fixed per-bundle.\n   */\n  perUserOp: number;\n\n  /**\n   * overhead for userOp word (32 bytes) block\n   */\n  perUserOpWord: number;\n\n  // perCallDataWord: number\n\n  /**\n   * zero byte cost, for calldata gas cost calculations\n   */\n  zeroByte: number;\n\n  /**\n   * non-zero byte cost, for calldata gas cost calculations\n   */\n  nonZeroByte: number;\n\n  /**\n   * expected bundle size, to split per-bundle overhead between all ops.\n   */\n  bundleSize: number;\n\n  /**\n   * expected length of the userOp signature.\n   */\n  sigSize: number;\n}\n\nexport const DefaultGasOverheads: GasOverheads = {\n  fixed: 21000,\n  perUserOp: 18300,\n  perUserOpWord: 4,\n  zeroByte: 4,\n  nonZeroByte: 16,\n  bundleSize: 1,\n  sigSize: 65,\n};\n\nexport type NotPromise<T> = {\n  [P in keyof T]: Exclude<T[P], Promise<any>>;\n};\n\n/**\n * calculate the preVerificationGas of the given UserOperation\n * preVerificationGas (by definition) is the cost overhead that can't be calculated on-chain.\n * it is based on parameters that are defined by the Ethereum protocol for external transactions.\n * @param userOp filled userOp to calculate. The only possible missing fields can be the signature and preVerificationGas itself\n * @param overheads gas overheads to use, to override the default values\n */\nexport function calcPreVerificationGas(\n  userOp: Partial<NotPromise<UserOperationStruct>>,\n  overheads?: Partial<GasOverheads>\n): number {\n  const ov = { ...DefaultGasOverheads, ...(overheads ?? {}) };\n  const p: NotPromise<UserOperationStruct> = {\n    // dummy values, in case the UserOp is incomplete.\n    preVerificationGas: 21000, // dummy value, just for calldata cost\n    signature: toHex(Buffer.alloc(ov.sigSize, 1)), // dummy signature\n    ...userOp,\n  } as any;\n\n  const packed = toBytes(packUserOp(p, false));\n  const callDataCost = packed\n    .map((x) => (x === 0 ? ov.zeroByte : ov.nonZeroByte))\n    .reduce((sum, x) => sum + x);\n  const ret = Math.round(\n    callDataCost +\n      ov.fixed / ov.bundleSize +\n      ov.perUserOp +\n      ov.perUserOpWord * packed.length\n  );\n  return ret;\n}\n"]}

package/dist/cjs/kernel-zerodev/utils.d.ts

@@ -0,0 +1,15 @@
+import { type Hex, type WalletClient } from "viem";
+import type { SmartAccountSigner, UserOperationCallData } from "@alchemy/aa-core";
+import { Signer } from "@ethersproject/abstract-signer";
+import { Wallet } from "@ethersproject/wallet";
+import type { SupportedGasToken } from "./paymaster/types.js";
+export type UserOperationCallDataWithDelegate = UserOperationCallData & {
+    delegateCall?: boolean;
+};
+export type BatchUserOperationCallDataWithDelegate = UserOperationCallDataWithDelegate[];
+export declare const encodeMultiSend: (_txs: BatchUserOperationCallDataWithDelegate) => Hex;
+export declare function getGasTokenAddress(gasToken: SupportedGasToken, chainId: number): Hex | undefined;
+export declare const convertWalletClientToAccountSigner: (client: WalletClient) => SmartAccountSigner;
+export declare const isWallet: (signer: any) => signer is Wallet;
+export declare const convertEthersSignerToAccountSigner: (signer: Signer | Wallet) => SmartAccountSigner;
+export declare const randomHexString: (length: number) => Hex;