@pimlico/alto 0.0.2 → 0.0.4

package/esm/cli/instrumentation.js

@@ -0,0 +1,39 @@
+import { SpanKind } from "@opentelemetry/api";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { FastifyInstrumentation } from "@opentelemetry/instrumentation-fastify";
+import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
+import { PinoInstrumentation } from "@opentelemetry/instrumentation-pino";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { ParentBasedSampler, SamplingDecision } from "@opentelemetry/sdk-trace-base";
+import { SemanticAttributes } from "@opentelemetry/semantic-conventions";
+import { FetchInstrumentation } from "opentelemetry-instrumentation-fetch-node";
+class CustomSampler {
+    shouldSample(_context, _traceId, _spanName, spanKind, attributes) {
+        const ignoredRoutes = ["/metrics", "/health"];
+        const httpTarget = attributes[SemanticAttributes.HTTP_TARGET];
+        if (spanKind === SpanKind.SERVER &&
+            httpTarget &&
+            ignoredRoutes.includes(httpTarget.toString())) {
+            return { decision: SamplingDecision.NOT_RECORD };
+        }
+        // fallback
+        return { decision: SamplingDecision.RECORD_AND_SAMPLED };
+    }
+    toString() {
+        return "CustomSampler";
+    }
+}
+const sdk = new NodeSDK({
+    traceExporter: new OTLPTraceExporter(),
+    instrumentations: [
+        new HttpInstrumentation({
+            requireParentforOutgoingSpans: true
+        }),
+        new FetchInstrumentation({}),
+        new FastifyInstrumentation(),
+        new PinoInstrumentation()
+    ],
+    sampler: new ParentBasedSampler({ root: new CustomSampler() })
+});
+sdk.start();
+//# sourceMappingURL=instrumentation.js.map

package/esm/cli/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../cli/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EACH,kBAAkB,EAElB,gBAAgB,EACnB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAE/E,MAAM,aAAa;IACf,YAAY,CACR,QAAiB,EACjB,QAAgB,EAChB,SAAiB,EACjB,QAAkB,EAClB,UAAsB;QAEtB,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;QAE7C,MAAM,UAAU,GAAG,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAA;QAE7D,IACI,QAAQ,KAAK,QAAQ,CAAC,MAAM;YAC5B,UAAU;YACV,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAC/C,CAAC;YACC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,UAAU,EAAE,CAAA;QACpD,CAAC;QACD,WAAW;QACX,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,kBAAkB,EAAE,CAAA;IAC5D,CAAC;IACD,QAAQ;QACJ,OAAO,eAAe,CAAA;IAC1B,CAAC;CACJ;AAED,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;IACpB,aAAa,EAAE,IAAI,iBAAiB,EAAE;IACtC,gBAAgB,EAAE;QACd,IAAI,mBAAmB,CAAC;YACpB,6BAA6B,EAAE,IAAI;SACtC,CAAC;QACF,IAAI,oBAAoB,CAAC,EAAE,CAAC;QAC5B,IAAI,sBAAsB,EAAE;QAC5B,IAAI,mBAAmB,EAAE;KAC5B;IACD,OAAO,EAAE,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,EAAE,CAAC;CACjE,CAAC,CAAA;AAEF,GAAG,CAAC,KAAK,EAAE,CAAA"}

package/esm/cli/setupServer.d.ts

@@ -0,0 +1,17 @@
+import type { SenderManager } from "../executor/index.js";
+import type { GasPriceManager, Logger, Metrics } from "../utils/index.js";
+import type { Registry } from "prom-client";
+import type { Chain, PublicClient, Transport, WalletClient } from "viem";
+import type { IOptions } from "./config/index.js";
+export declare const setupServer: ({ client, walletClient, parsedArgs, logger, rootLogger, registry, metrics, senderManager, gasPriceManager }: {
+    client: PublicClient<Transport, Chain>;
+    walletClient: WalletClient<Transport, Chain>;
+    parsedArgs: IOptions;
+    logger: Logger;
+    rootLogger: Logger;
+    registry: Registry;
+    metrics: Metrics;
+    senderManager: SenderManager;
+    gasPriceManager: GasPriceManager;
+}) => Promise<void>;
+//# sourceMappingURL=setupServer.d.ts.map

package/esm/cli/setupServer.js

@@ -0,0 +1,155 @@
+import { Executor, ExecutorManager } from "../executor/index.js";
+import { MemoryMempool, Monitor, NullReputationManager, ReputationManager } from "../mempool/index.js";
+import { NonceQueuer, RpcHandler, SafeValidator, Server, UnsafeValidator } from "../rpc/index.js";
+import { CompressionHandler } from "../utils/index.js";
+const getReputationManager = ({ client, parsedArgs, logger }) => {
+    if (parsedArgs["safe-mode"]) {
+        return new ReputationManager(client, parsedArgs.entrypoints, BigInt(parsedArgs["min-entity-stake"]), BigInt(parsedArgs["min-entity-unstake-delay"]), logger.child({ module: "reputation_manager" }, {
+            level: parsedArgs["reputation-manager-log-level"] ||
+                parsedArgs["log-level"]
+        }));
+    }
+    return new NullReputationManager();
+};
+const getValidator = ({ client, parsedArgs, logger, senderManager, metrics, gasPriceManager }) => {
+    if (parsedArgs["safe-mode"]) {
+        return new SafeValidator(client, senderManager, logger.child({ module: "rpc" }, {
+            level: parsedArgs["rpc-log-level"] || parsedArgs["log-level"]
+        }), metrics, gasPriceManager, parsedArgs["chain-type"], parsedArgs["entrypoint-simulation-contract"], parsedArgs["fixed-gas-limit-for-estimation"], parsedArgs.tenderly, parsedArgs["balance-override"]);
+    }
+    return new UnsafeValidator(client, logger.child({ module: "rpc" }, { level: parsedArgs["rpc-log-level"] || parsedArgs["log-level"] }), metrics, gasPriceManager, parsedArgs["chain-type"], parsedArgs["entrypoint-simulation-contract"], parsedArgs["fixed-gas-limit-for-estimation"], parsedArgs.tenderly, parsedArgs["balance-override"], parsedArgs["expiration-check"]);
+};
+const getMonitor = () => {
+    return new Monitor();
+};
+const getMempool = ({ monitor, reputationManager, validator, client, parsedArgs, logger, metrics }) => {
+    return new MemoryMempool(monitor, reputationManager, validator, client, parsedArgs["safe-mode"], logger.child({ module: "mempool" }, {
+        level: parsedArgs["mempool-log-level"] || parsedArgs["log-level"]
+    }), metrics, parsedArgs["mempool-max-parallel-ops"], parsedArgs["mempool-max-queued-ops"], parsedArgs["enforce-unique-senders-per-bundle"]);
+};
+const getCompressionHandler = async ({ client, parsedArgs }) => {
+    let compressionHandler = null;
+    if (parsedArgs["bundle-bulker-address"] !== undefined &&
+        parsedArgs["per-op-inflator-address"] !== undefined) {
+        compressionHandler = await CompressionHandler.createAsync(parsedArgs["bundle-bulker-address"], parsedArgs["per-op-inflator-address"], client);
+    }
+    return compressionHandler;
+};
+const getExecutor = ({ client, walletClient, senderManager, reputationManager, parsedArgs, logger, metrics, compressionHandler, gasPriceManager }) => {
+    return new Executor(client, walletClient, senderManager, reputationManager, parsedArgs.entrypoints, logger.child({ module: "executor" }, {
+        level: parsedArgs["executor-log-level"] || parsedArgs["log-level"]
+    }), metrics, compressionHandler, gasPriceManager, !parsedArgs.tenderly, parsedArgs["legacy-transactions"], parsedArgs["fixed-gas-limit-for-estimation"], parsedArgs["block-tag-support-disabled"], parsedArgs["local-gas-limit-calculation"]);
+};
+const getExecutorManager = ({ executor, mempool, monitor, reputationManager, client, parsedArgs, logger, metrics, gasPriceManager }) => {
+    return new ExecutorManager(executor, parsedArgs.entrypoints, mempool, monitor, reputationManager, client, parsedArgs["polling-interval"], logger.child({ module: "executor" }, {
+        level: parsedArgs["executor-log-level"] || parsedArgs["log-level"]
+    }), metrics, parsedArgs["bundle-mode"], parsedArgs["max-bundle-wait"], parsedArgs["max-gas-per-bundle"], gasPriceManager);
+};
+const getNonceQueuer = ({ mempool, client, parsedArgs, logger }) => {
+    return new NonceQueuer(mempool, client, logger.child({ module: "nonce_queuer" }, {
+        level: parsedArgs["nonce-queuer-log-level"] ||
+            parsedArgs["log-level"]
+    }));
+};
+const getRpcHandler = ({ client, validator, mempool, executor, monitor, nonceQueuer, executorManager, reputationManager, parsedArgs, logger, metrics, compressionHandler, gasPriceManager }) => {
+    return new RpcHandler(parsedArgs.entrypoints, client, validator, mempool, executor, monitor, nonceQueuer, executorManager, reputationManager, parsedArgs.tenderly ?? false, parsedArgs["max-block-range"], logger.child({ module: "rpc" }, { level: parsedArgs["rpc-log-level"] || parsedArgs["log-level"] }), metrics, parsedArgs["enable-debug-endpoints"], compressionHandler, parsedArgs["legacy-transactions"], gasPriceManager, parsedArgs["gas-price-multipliers"], parsedArgs["chain-type"], parsedArgs["paymaster-gas-limit-multiplier"], parsedArgs["dangerous-skip-user-operation-validation"]);
+};
+const getServer = ({ rpcEndpoint, parsedArgs, logger, registry, metrics }) => {
+    return new Server(rpcEndpoint, parsedArgs["api-version"], parsedArgs["default-api-version"], parsedArgs.port, parsedArgs.timeout, parsedArgs["websocket-max-payload-size"], parsedArgs.websocket, logger.child({ module: "rpc" }, { level: parsedArgs["rpc-log-level"] || parsedArgs["log-level"] }), registry, metrics);
+};
+export const setupServer = async ({ client, walletClient, parsedArgs, logger, rootLogger, registry, metrics, senderManager, gasPriceManager }) => {
+    const validator = getValidator({
+        client,
+        logger,
+        parsedArgs,
+        senderManager,
+        metrics,
+        gasPriceManager
+    });
+    const reputationManager = getReputationManager({
+        client,
+        parsedArgs,
+        logger
+    });
+    await senderManager.validateAndRefillWallets(client, walletClient, parsedArgs["min-executor-balance"]);
+    setInterval(async () => {
+        await senderManager.validateAndRefillWallets(client, walletClient, parsedArgs["min-executor-balance"]);
+    }, parsedArgs["executor-refill-interval"] * 1000);
+    const monitor = getMonitor();
+    const mempool = getMempool({
+        monitor,
+        reputationManager,
+        validator,
+        client,
+        parsedArgs,
+        logger,
+        metrics
+    });
+    const compressionHandler = await getCompressionHandler({
+        client,
+        parsedArgs
+    });
+    const executor = getExecutor({
+        client,
+        walletClient,
+        senderManager,
+        reputationManager,
+        parsedArgs,
+        logger,
+        metrics,
+        compressionHandler,
+        gasPriceManager
+    });
+    const executorManager = getExecutorManager({
+        executor,
+        mempool,
+        monitor,
+        reputationManager,
+        client,
+        parsedArgs,
+        logger,
+        metrics,
+        gasPriceManager
+    });
+    const nonceQueuer = getNonceQueuer({ mempool, client, parsedArgs, logger });
+    const rpcEndpoint = getRpcHandler({
+        client,
+        validator,
+        mempool,
+        executor,
+        monitor,
+        nonceQueuer,
+        executorManager,
+        reputationManager,
+        parsedArgs,
+        logger,
+        metrics,
+        compressionHandler,
+        gasPriceManager
+    });
+    if (parsedArgs["flush-stuck-transactions-during-startup"]) {
+        executor.flushStuckTransactions();
+    }
+    rootLogger.info(`Initialized ${senderManager.wallets.length} executor wallets`);
+    const server = getServer({
+        rpcEndpoint,
+        parsedArgs,
+        logger,
+        registry,
+        metrics
+    });
+    server.start();
+    const gracefulShutdown = async (signal) => {
+        rootLogger.info(`${signal} received, shutting down`);
+        await server.stop();
+        rootLogger.info("server stopped");
+        const outstanding = mempool.dumpOutstanding().length;
+        const submitted = mempool.dumpSubmittedOps().length;
+        const processing = mempool.dumpProcessing().length;
+        rootLogger.info({ outstanding, submitted, processing }, "dumping mempool before shutdown");
+        process.exit(0);
+    };
+    process.on("SIGINT", gracefulShutdown);
+    process.on("SIGTERM", gracefulShutdown);
+};
+//# sourceMappingURL=setupServer.js.map

package/esm/cli/setupServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupServer.js","sourceRoot":"","sources":["../../cli/setupServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EACH,aAAa,EACb,OAAO,EACP,qBAAqB,EACrB,iBAAiB,EAEpB,MAAM,eAAe,CAAA;AACtB,OAAO,EACH,WAAW,EACX,UAAU,EACV,aAAa,EACb,MAAM,EACN,eAAe,EAClB,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAKhD,MAAM,oBAAoB,GAAG,CAAC,EAC1B,MAAM,EACN,UAAU,EACV,MAAM,EAKT,EAA8B,EAAE;IAC7B,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,iBAAiB,CACxB,MAAM,EACN,UAAU,CAAC,WAAW,EACtB,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,EACtC,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,EAC9C,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAChC;YACI,KAAK,EACD,UAAU,CAAC,8BAA8B,CAAC;gBAC1C,UAAU,CAAC,WAAW,CAAC;SAC9B,CACJ,CACJ,CAAA;IACL,CAAC;IACD,OAAO,IAAI,qBAAqB,EAAE,CAAA;AACtC,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,EAClB,MAAM,EACN,UAAU,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,eAAe,EAQlB,EAAsB,EAAE;IACrB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,aAAa,CACpB,MAAM,EACN,aAAa,EACb,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB;YACI,KAAK,EACD,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC;SAC7D,CACJ,EACD,OAAO,EACP,eAAe,EACf,UAAU,CAAC,YAAY,CAAC,EACxB,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,kBAAkB,CAAC,CACjC,CAAA;IACL,CAAC;IACD,OAAO,IAAI,eAAe,CACtB,MAAM,EACN,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CACpE,EACD,OAAO,EACP,eAAe,EACf,UAAU,CAAC,YAAY,CAAC,EACxB,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,kBAAkB,CAAC,EAC9B,UAAU,CAAC,kBAAkB,CAAC,CACjC,CAAA;AACL,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,GAAY,EAAE;IAC7B,OAAO,IAAI,OAAO,EAAE,CAAA;AACxB,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,EAChB,OAAO,EACP,iBAAiB,EACjB,SAAS,EACT,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EASV,EAAiB,EAAE;IAChB,OAAO,IAAI,aAAa,CACpB,OAAO,EACP,iBAAiB,EACjB,SAAS,EACT,MAAM,EACN,UAAU,CAAC,WAAW,CAAC,EACvB,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,SAAS,EAAE,EACrB;QACI,KAAK,EACD,UAAU,CAAC,mBAAmB,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC;KACjE,CACJ,EACD,OAAO,EACP,UAAU,CAAC,0BAA0B,CAAC,EACtC,UAAU,CAAC,wBAAwB,CAAC,EACpC,UAAU,CAAC,mCAAmC,CAAC,CAClD,CAAA;AACL,CAAC,CAAA;AAED,MAAM,qBAAqB,GAAG,KAAK,EAAE,EACjC,MAAM,EACN,UAAU,EAIb,EAAsC,EAAE;IACrC,IAAI,kBAAkB,GAA8B,IAAI,CAAA;IACxD,IACI,UAAU,CAAC,uBAAuB,CAAC,KAAK,SAAS;QACjD,UAAU,CAAC,yBAAyB,CAAC,KAAK,SAAS,EACrD,CAAC;QACC,kBAAkB,GAAG,MAAM,kBAAkB,CAAC,WAAW,CACrD,UAAU,CAAC,uBAAuB,CAAC,EACnC,UAAU,CAAC,yBAAyB,CAAC,EACrC,MAAM,CACT,CAAA;IACL,CAAC;IACD,OAAO,kBAAkB,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,EACjB,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,eAAe,EAWlB,EAAY,EAAE;IACX,OAAO,IAAI,QAAQ,CACf,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,CAAC,WAAW,EACtB,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,UAAU,EAAE,EACtB;QACI,KAAK,EACD,UAAU,CAAC,oBAAoB,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC;KAClE,CACJ,EACD,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,CAAC,UAAU,CAAC,QAAQ,EACpB,UAAU,CAAC,qBAAqB,CAAC,EACjC,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,4BAA4B,CAAC,EACxC,UAAU,CAAC,6BAA6B,CAAC,CAC5C,CAAA;AACL,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,EACxB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,eAAe,EAWlB,EAAE,EAAE;IACD,OAAO,IAAI,eAAe,CACtB,QAAQ,EACR,UAAU,CAAC,WAAW,EACtB,OAAO,EACP,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,UAAU,CAAC,kBAAkB,CAAC,EAC9B,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,UAAU,EAAE,EACtB;QACI,KAAK,EACD,UAAU,CAAC,oBAAoB,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC;KAClE,CACJ,EACD,OAAO,EACP,UAAU,CAAC,aAAa,CAAC,EACzB,UAAU,CAAC,iBAAiB,CAAC,EAC7B,UAAU,CAAC,oBAAoB,CAAC,EAChC,eAAe,CAClB,CAAA;AACL,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,EACpB,OAAO,EACP,MAAM,EACN,UAAU,EACV,MAAM,EAMT,EAAE,EAAE;IACD,OAAO,IAAI,WAAW,CAClB,OAAO,EACP,MAAM,EACN,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,cAAc,EAAE,EAC1B;QACI,KAAK,EACD,UAAU,CAAC,wBAAwB,CAAC;YACpC,UAAU,CAAC,WAAW,CAAC;KAC9B,CACJ,CACJ,CAAA;AACL,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,EACnB,MAAM,EACN,SAAS,EACT,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,eAAe,EAelB,EAAE,EAAE;IACD,OAAO,IAAI,UAAU,CACjB,UAAU,CAAC,WAAW,EACtB,MAAM,EACN,SAAS,EACT,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,UAAU,CAAC,QAAQ,IAAI,KAAK,EAC5B,UAAU,CAAC,iBAAiB,CAAC,EAC7B,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CACpE,EACD,OAAO,EACP,UAAU,CAAC,wBAAwB,CAAC,EACpC,kBAAkB,EAClB,UAAU,CAAC,qBAAqB,CAAC,EACjC,eAAe,EACf,UAAU,CAAC,uBAAuB,CAAC,EACnC,UAAU,CAAC,YAAY,CAAC,EACxB,UAAU,CAAC,gCAAgC,CAAC,EAC5C,UAAU,CAAC,0CAA0C,CAAC,CACzD,CAAA;AACL,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,EACf,WAAW,EACX,UAAU,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EAOV,EAAE,EAAE;IACD,OAAO,IAAI,MAAM,CACb,WAAW,EACX,UAAU,CAAC,aAAa,CAAC,EACzB,UAAU,CAAC,qBAAqB,CAAC,EACjC,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,OAAO,EAClB,UAAU,CAAC,4BAA4B,CAAC,EACxC,UAAU,CAAC,SAAS,EACpB,MAAM,CAAC,KAAK,CACR,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CACpE,EACD,QAAQ,EACR,OAAO,CACV,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,EAC9B,MAAM,EACN,YAAY,EACZ,UAAU,EACV,MAAM,EACN,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EAWlB,EAAE,EAAE;IACD,MAAM,SAAS,GAAG,YAAY,CAAC;QAC3B,MAAM;QACN,MAAM;QACN,UAAU;QACV,aAAa;QACb,OAAO;QACP,eAAe;KAClB,CAAC,CAAA;IACF,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;QAC3C,MAAM;QACN,UAAU;QACV,MAAM;KACT,CAAC,CAAA;IAEF,MAAM,aAAa,CAAC,wBAAwB,CACxC,MAAM,EACN,YAAY,EACZ,UAAU,CAAC,sBAAsB,CAAC,CACrC,CAAA;IAED,WAAW,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,aAAa,CAAC,wBAAwB,CACxC,MAAM,EACN,YAAY,EACZ,UAAU,CAAC,sBAAsB,CAAC,CACrC,CAAA;IACL,CAAC,EAAE,UAAU,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC,CAAA;IAEjD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC;QACvB,OAAO;QACP,iBAAiB;QACjB,SAAS;QACT,MAAM;QACN,UAAU;QACV,MAAM;QACN,OAAO;KACV,CAAC,CAAA;IAEF,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;QACnD,MAAM;QACN,UAAU;KACb,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,WAAW,CAAC;QACzB,MAAM;QACN,YAAY;QACZ,aAAa;QACb,iBAAiB;QACjB,UAAU;QACV,MAAM;QACN,OAAO;QACP,kBAAkB;QAClB,eAAe;KAClB,CAAC,CAAA;IAEF,MAAM,eAAe,GAAG,kBAAkB,CAAC;QACvC,QAAQ;QACR,OAAO;QACP,OAAO;QACP,iBAAiB;QACjB,MAAM;QACN,UAAU;QACV,MAAM;QACN,OAAO;QACP,eAAe;KAClB,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;IAE3E,MAAM,WAAW,GAAG,aAAa,CAAC;QAC9B,MAAM;QACN,SAAS;QACT,OAAO;QACP,QAAQ;QACR,OAAO;QACP,WAAW;QACX,eAAe;QACf,iBAAiB;QACjB,UAAU;QACV,MAAM;QACN,OAAO;QACP,kBAAkB;QAClB,eAAe;KAClB,CAAC,CAAA;IAEF,IAAI,UAAU,CAAC,yCAAyC,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,sBAAsB,EAAE,CAAA;IACrC,CAAC;IAED,UAAU,CAAC,IAAI,CACX,eAAe,aAAa,CAAC,OAAO,CAAC,MAAM,mBAAmB,CACjE,CAAA;IAED,MAAM,MAAM,GAAG,SAAS,CAAC;QACrB,WAAW;QACX,UAAU;QACV,MAAM;QACN,QAAQ;QACR,OAAO;KACV,CAAC,CAAA;IAEF,MAAM,CAAC,KAAK,EAAE,CAAA;IAEd,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QAC9C,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,CAAA;QAEpD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QACnB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAEjC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,CAAA;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAA;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,CAAA;QAClD,UAAU,CAAC,IAAI,CACX,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,EACtC,iCAAiC,CACpC,CAAA;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;AAC3C,CAAC,CAAA"}

package/esm/cli/util.d.ts

@@ -0,0 +1,22 @@
+import type { Argv, Options } from "yargs";
+export type CliCommandOptions<OwnArgs> = Required<{
+    [key in keyof OwnArgs]: Options;
+}>;
+export interface CliCommand<OwnArgs = Record<never, never>, ParentArgs = Record<never, never>, R = any> {
+    command: string;
+    describe: string;
+    examples?: {
+        command: string;
+        description: string;
+    }[];
+    options?: CliCommandOptions<OwnArgs>;
+    subcommands?: CliCommand<any, OwnArgs & ParentArgs>[];
+    handler?: (args: OwnArgs & ParentArgs) => Promise<R>;
+}
+/**
+ * Register a CliCommand type to yargs. Recursively registers subcommands too.
+ * @param yargs
+ * @param cliCommand
+ */
+export declare function registerCommandToYargs(yargs: Argv<any>, cliCommand: CliCommand<any, any>): void;
+//# sourceMappingURL=util.d.ts.map

package/esm/cli/util.js

@@ -0,0 +1,30 @@
+/**
+ * Register a CliCommand type to yargs. Recursively registers subcommands too.
+ * @param yargs
+ * @param cliCommand
+ */
+export function registerCommandToYargs(
+// biome-ignore lint/suspicious/noExplicitAny: it's a generic type
+yargs, 
+// biome-ignore lint/suspicious/noExplicitAny: it's a generic type
+cliCommand) {
+    yargs.command({
+        command: cliCommand.command,
+        describe: cliCommand.describe,
+        builder: (yargsBuilder) => {
+            yargsBuilder.options(cliCommand.options || {});
+            for (const subcommand of cliCommand.subcommands || []) {
+                registerCommandToYargs(yargsBuilder, subcommand);
+            }
+            if (cliCommand.examples) {
+                for (const example of cliCommand.examples) {
+                    yargsBuilder.example(`$0 ${example.command}`, example.description);
+                }
+            }
+            return yargs;
+        },
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
+        handler: cliCommand.handler || function emptyHandler() { }
+    });
+}
+//# sourceMappingURL=util.js.map

package/esm/cli/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../cli/util.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;AAClC,kEAAkE;AAClE,KAAgB;AAChB,kEAAkE;AAClE,UAAgC;IAEhC,KAAK,CAAC,OAAO,CAAC;QACV,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE;YACtB,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;YAC9C,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBACpD,sBAAsB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;YACpD,CAAC;YACD,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACtB,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACxC,YAAY,CAAC,OAAO,CAChB,MAAM,OAAO,CAAC,OAAO,EAAE,EACvB,OAAO,CAAC,WAAW,CACtB,CAAA;gBACL,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAA;QAChB,CAAC;QACD,gEAAgE;QAChE,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,SAAS,YAAY,KAAU,CAAC;KAClE,CAAC,CAAA;AACN,CAAC"}

package/esm/executor/executor.d.ts

@@ -0,0 +1,55 @@
+import type { SenderManager } from "./index.js";
+import type { InterfaceReputationManager } from "../mempool/index.js";
+import { type Address, type BundleResult, type CompressedUserOperation, type HexData32, type TransactionInfo, type UserOperation } from "../types/index.js";
+import type { GasPriceManager, Logger, Metrics } from "../utils/index.js";
+import { type CompressionHandler } from "../utils/index.js";
+import { Mutex } from "async-mutex";
+import { type Account, type Chain, type PublicClient, type Transport, type WalletClient } from "viem";
+export interface GasEstimateResult {
+    preverificationGas: bigint;
+    verificationGasLimit: bigint;
+    callGasLimit: bigint;
+}
+export type ReplaceTransactionResult = {
+    status: "replaced";
+    transactionInfo: TransactionInfo;
+} | {
+    status: "potentially_already_included";
+} | {
+    status: "failed";
+};
+export declare class NullExecutor {
+    bundle(_entryPoint: Address, _ops: UserOperation[]): Promise<BundleResult[]>;
+    bundleCompressed(_entryPoint: Address, _compressedOps: CompressedUserOperation[]): Promise<BundleResult[]>;
+    replaceTransaction(_entryPoint: Address, _transactionInfo: TransactionInfo): Promise<ReplaceTransactionResult>;
+    replaceOps(_opHashes: HexData32[]): Promise<void>;
+    cancelOps(_entryPoint: Address, _ops: UserOperation[]): Promise<void>;
+    markWalletProcessed(_executor: Account): Promise<void>;
+    flushStuckTransactions(): Promise<void>;
+}
+export declare class Executor {
+    publicClient: PublicClient;
+    walletClient: WalletClient<Transport, Chain, Account | undefined>;
+    entryPoints: Address[];
+    senderManager: SenderManager;
+    logger: Logger;
+    metrics: Metrics;
+    simulateTransaction: boolean;
+    legacyTransactions: boolean;
+    fixedGasLimitForEstimation?: bigint;
+    localGasLimitCalculation: boolean;
+    reputationManager: InterfaceReputationManager;
+    compressionHandler: CompressionHandler | null;
+    gasPriceManager: GasPriceManager;
+    disableBlockTagSupport: boolean;
+    mutex: Mutex;
+    constructor(publicClient: PublicClient, walletClient: WalletClient<Transport, Chain, Account | undefined>, senderManager: SenderManager, reputationManager: InterfaceReputationManager, entryPoints: Address[], logger: Logger, metrics: Metrics, compressionHandler: CompressionHandler | null, gasPriceManager: GasPriceManager, simulateTransaction?: boolean, legacyTransactions?: boolean, fixedGasLimitForEstimation?: bigint, disableBlockTagSupport?: boolean, localGasLimitCalculation?: boolean);
+    getCompressionHandler(): CompressionHandler;
+    cancelOps(_entryPoint: Address, _ops: UserOperation[]): Promise<void>;
+    markWalletProcessed(executor: Account): Promise<void>;
+    replaceTransaction(transactionInfo: TransactionInfo): Promise<ReplaceTransactionResult>;
+    flushStuckTransactions(): Promise<void>;
+    bundle(entryPoint: Address, ops: UserOperation[]): Promise<BundleResult[]>;
+    bundleCompressed(entryPoint: Address, compressedOps: CompressedUserOperation[]): Promise<BundleResult[]>;
+}
+//# sourceMappingURL=executor.d.ts.map