@pimlico/alto 0.0.0-staging.20240606T101741 → 0.0.0-staging.20240606T103333

package/esm/executor/executorManager.d.ts

@@ -0,0 +1,34 @@
+import type { Metrics, Logger, GasPriceManager } from "../utils/index.js";
+import type { InterfaceReputationManager, MemoryMempool, Monitor } from "../mempool/index.js";
+import { type BundlingMode, type MempoolUserOperation, type TransactionInfo } from "../types/index.js";
+import type { Address, Block, Chain, Hash, PublicClient, Transport } from "viem";
+import type { Executor } from "./executor.js";
+export declare class ExecutorManager {
+    private entryPoints;
+    private executor;
+    private mempool;
+    private monitor;
+    private publicClient;
+    private pollingInterval;
+    private logger;
+    private metrics;
+    private reputationManager;
+    private unWatch;
+    private currentlyHandlingBlock;
+    private timer?;
+    private bundlerFrequency;
+    private maxGasLimitPerBundle;
+    private gasPriceManager;
+    constructor(executor: Executor, entryPoints: Address[], mempool: MemoryMempool, monitor: Monitor, reputationManager: InterfaceReputationManager, publicClient: PublicClient<Transport, Chain>, pollingInterval: number, logger: Logger, metrics: Metrics, bundleMode: BundlingMode, bundlerFrequency: number, maxGasLimitPerBundle: bigint, gasPriceManager: GasPriceManager);
+    setBundlingMode(bundleMode: BundlingMode): void;
+    bundleNow(): Promise<Hash[]>;
+    sendToExecutor(entryPoint: Address, mempoolOps: MempoolUserOperation[]): Promise<`0x${string}` | undefined>;
+    bundle(): Promise<void>;
+    startWatchingBlocks(handleBlock: (block: Block) => void): void;
+    stopWatchingBlocks(): void;
+    private refreshTransactionStatus;
+    refreshUserOperationStatuses(): Promise<void>;
+    handleBlock(block: Block): Promise<void>;
+    replaceTransaction(txInfo: TransactionInfo, reason: string): Promise<void>;
+}
+//# sourceMappingURL=executorManager.d.ts.map

package/esm/executor/executorManager.js

@@ -0,0 +1,401 @@
+import { deriveUserOperation, isCompressedType } from "../types/index.js";
+import { transactionIncluded } from "../utils/index.js";
+function getTransactionsFromUserOperationEntries(entries) {
+    return Array.from(new Set(entries.map((entry) => {
+        return entry.transactionInfo;
+    })));
+}
+export class ExecutorManager {
+    entryPoints;
+    executor;
+    mempool;
+    monitor;
+    publicClient;
+    pollingInterval;
+    logger;
+    metrics;
+    reputationManager;
+    unWatch;
+    currentlyHandlingBlock = false;
+    timer;
+    bundlerFrequency;
+    maxGasLimitPerBundle;
+    gasPriceManager;
+    constructor(executor, entryPoints, mempool, monitor, reputationManager, publicClient, pollingInterval, logger, metrics, bundleMode, bundlerFrequency, maxGasLimitPerBundle, gasPriceManager) {
+        this.entryPoints = entryPoints;
+        this.reputationManager = reputationManager;
+        this.executor = executor;
+        this.mempool = mempool;
+        this.monitor = monitor;
+        this.publicClient = publicClient;
+        this.pollingInterval = pollingInterval;
+        this.logger = logger;
+        this.metrics = metrics;
+        this.bundlerFrequency = bundlerFrequency;
+        this.maxGasLimitPerBundle = maxGasLimitPerBundle;
+        this.gasPriceManager = gasPriceManager;
+        if (bundleMode === "auto") {
+            this.timer = setInterval(async () => {
+                await this.bundle();
+            }, bundlerFrequency);
+        }
+    }
+    setBundlingMode(bundleMode) {
+        if (bundleMode === "auto" && !this.timer) {
+            this.timer = setInterval(async () => {
+                await this.bundle();
+            }, this.bundlerFrequency);
+        }
+        else if (bundleMode === "manual" && this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    async bundleNow() {
+        const ops = await this.mempool.process(this.maxGasLimitPerBundle, 1);
+        if (ops.length === 0) {
+            throw new Error("no ops to bundle");
+        }
+        const opEntryPointMap = new Map();
+        for (const op of ops) {
+            if (!opEntryPointMap.has(op.entryPoint)) {
+                opEntryPointMap.set(op.entryPoint, []);
+            }
+            opEntryPointMap.get(op.entryPoint)?.push(op.mempoolUserOperation);
+        }
+        const txHashes = [];
+        await Promise.all(this.entryPoints.map(async (entryPoint) => {
+            const ops = opEntryPointMap.get(entryPoint);
+            if (ops) {
+                const txHash = await this.sendToExecutor(entryPoint, ops);
+                if (!txHash) {
+                    throw new Error("no tx hash");
+                }
+                txHashes.push(txHash);
+            }
+            else {
+                this.logger.warn({ entryPoint }, "no user operations for entry point");
+            }
+        }));
+        return txHashes;
+    }
+    async sendToExecutor(entryPoint, mempoolOps) {
+        const ops = mempoolOps
+            .filter((op) => !isCompressedType(op))
+            .map((op) => op);
+        const compressedOps = mempoolOps
+            .filter((op) => isCompressedType(op))
+            .map((op) => op);
+        const bundles = [];
+        if (ops.length > 0) {
+            bundles.push(await this.executor.bundle(entryPoint, ops));
+        }
+        if (compressedOps.length > 0) {
+            bundles.push(await this.executor.bundleCompressed(entryPoint, compressedOps));
+        }
+        for (const bundle of bundles) {
+            const isBundleSuccess = bundle.every((result) => result.status === "success");
+            if (isBundleSuccess) {
+                this.metrics.bundlesSubmitted
+                    .labels({ status: "success" })
+                    .inc();
+            }
+            else {
+                this.metrics.bundlesSubmitted.labels({ status: "failed" }).inc();
+            }
+        }
+        const results = bundles.flat();
+        const filteredOutOps = mempoolOps.length - results.length;
+        if (filteredOutOps > 0) {
+            this.logger.debug({ filteredOutOps }, "user operations filtered out");
+            this.metrics.userOperationsSubmitted
+                .labels({ status: "filtered" })
+                .inc(filteredOutOps);
+        }
+        let txHash = undefined;
+        for (const result of results) {
+            if (result.status === "success") {
+                const res = result.value;
+                this.mempool.markSubmitted(res.userOperation.userOperationHash, res.transactionInfo);
+                // this.monitoredTransactions.set(result.transactionInfo.transactionHash, result.transactionInfo)
+                this.monitor.setUserOperationStatus(res.userOperation.userOperationHash, {
+                    status: "submitted",
+                    transactionHash: res.transactionInfo.transactionHash
+                });
+                txHash = res.transactionInfo.transactionHash;
+                this.startWatchingBlocks(this.handleBlock.bind(this));
+                this.metrics.userOperationsSubmitted
+                    .labels({ status: "success" })
+                    .inc();
+            }
+            if (result.status === "failure") {
+                this.mempool.removeProcessing(result.error.userOpHash);
+                this.monitor.setUserOperationStatus(result.error.userOpHash, {
+                    status: "rejected",
+                    transactionHash: null
+                });
+                this.logger.warn({
+                    userOpHash: result.error.userOpHash,
+                    reason: result.error.reason
+                }, "user operation rejected");
+                this.metrics.userOperationsSubmitted
+                    .labels({ status: "failed" })
+                    .inc();
+            }
+            if (result.status === "resubmit") {
+                this.logger.info({
+                    userOpHash: result.info.userOpHash,
+                    reason: result.info.reason
+                }, "resubmitting user operation");
+                this.mempool.removeProcessing(result.info.userOpHash);
+                this.mempool.add(result.info.userOperation, result.info.entryPoint);
+                this.metrics.userOperationsResubmitted.inc();
+            }
+        }
+        return txHash;
+    }
+    async bundle() {
+        const opsToBundle = [];
+        while (true) {
+            const ops = await this.mempool.process(5000000n, 1);
+            if (ops?.length > 0) {
+                opsToBundle.push(ops);
+            }
+            else {
+                break;
+            }
+        }
+        if (opsToBundle.length === 0) {
+            return;
+        }
+        await Promise.all(opsToBundle.map(async (ops) => {
+            const opEntryPointMap = new Map();
+            for (const op of ops) {
+                if (!opEntryPointMap.has(op.entryPoint)) {
+                    opEntryPointMap.set(op.entryPoint, []);
+                }
+                opEntryPointMap
+                    .get(op.entryPoint)
+                    ?.push(op.mempoolUserOperation);
+            }
+            await Promise.all(this.entryPoints.map(async (entryPoint) => {
+                const userOperations = opEntryPointMap.get(entryPoint);
+                if (userOperations) {
+                    await this.sendToExecutor(entryPoint, userOperations);
+                }
+                else {
+                    this.logger.warn({ entryPoint }, "no user operations for entry point");
+                }
+            }));
+        }));
+    }
+    startWatchingBlocks(handleBlock) {
+        if (this.unWatch) {
+            return;
+        }
+        this.unWatch = this.publicClient.watchBlocks({
+            onBlock: handleBlock,
+            // onBlock: async (block) => {
+            //     // Use an arrow function to ensure correct binding of `this`
+            //     this.checkAndReplaceTransactions(block)
+            //         .then(() => {
+            //             this.logger.trace("block handled")
+            //             // Handle the resolution of the promise here, if needed
+            //         })
+            //         .catch((error) => {
+            //             // Handle any errors that occur during the execution of the promise
+            //             this.logger.error({ error }, "error while handling block")
+            //         })
+            // },
+            onError: (error) => {
+                this.logger.error({ error }, "error while watching blocks");
+            },
+            emitMissed: false,
+            includeTransactions: false,
+            pollingInterval: this.pollingInterval
+        });
+        this.logger.debug("started watching blocks");
+    }
+    stopWatchingBlocks() {
+        if (this.unWatch) {
+            this.logger.debug("stopped watching blocks");
+            this.unWatch();
+            this.unWatch = undefined;
+        }
+    }
+    async refreshTransactionStatus(entryPoint, transactionInfo) {
+        const hashesToCheck = [
+            transactionInfo.transactionHash,
+            ...transactionInfo.previousTransactionHashes
+        ];
+        const opInfos = transactionInfo.userOperationInfos;
+        // const opHashes = transactionInfo.userOperationInfos.map((opInfo) => opInfo.userOperationHash)
+        const transactionStatuses = await Promise.all(hashesToCheck.map(async (hash) => {
+            return {
+                hash: hash,
+                transactionStatuses: await transactionIncluded(transactionInfo.isVersion06, hash, this.publicClient, entryPoint)
+            };
+        }));
+        const status = transactionStatuses.find((status) => status.transactionStatuses.status === "included" ||
+            status.transactionStatuses.status === "failed" ||
+            status.transactionStatuses.status === "reverted");
+        if (!status) {
+            opInfos.map((info) => {
+                this.logger.trace({
+                    userOpHash: info.userOperationHash,
+                    transactionHash: transactionInfo.transactionHash
+                }, "user op still pending");
+            });
+            return;
+        }
+        this.metrics.userOperationsOnChain
+            .labels({ status: status.transactionStatuses.status })
+            .inc(opInfos.length);
+        if (status.transactionStatuses.status === "included") {
+            opInfos.map((info) => {
+                this.metrics.userOperationInclusionDuration.observe((Date.now() - info.firstSubmitted) / 1000);
+                this.reputationManager.updateUserOperationIncludedStatus(deriveUserOperation(info.mempoolUserOperation), info.entryPoint, status.transactionStatuses[info.userOperationHash]
+                    .accountDeployed);
+                this.mempool.removeSubmitted(info.userOperationHash);
+                this.monitor.setUserOperationStatus(info.userOperationHash, {
+                    status: "included",
+                    transactionHash: status.hash
+                });
+                this.logger.info({
+                    userOpHash: info.userOperationHash,
+                    transactionHash: status.hash
+                }, "user op included");
+            });
+            this.executor.markWalletProcessed(transactionInfo.executor);
+        }
+        else if (status.transactionStatuses.status === "failed" ||
+            status.transactionStatuses.status === "reverted") {
+            opInfos.map((info) => {
+                this.mempool.removeSubmitted(info.userOperationHash);
+                this.monitor.setUserOperationStatus(info.userOperationHash, {
+                    status: "rejected",
+                    transactionHash: status.hash
+                });
+                this.logger.info({
+                    userOpHash: info.userOperationHash,
+                    transactionHash: status.hash
+                }, "user op rejected");
+            });
+            this.executor.markWalletProcessed(transactionInfo.executor);
+        }
+    }
+    async refreshUserOperationStatuses() {
+        const ops = this.mempool.dumpSubmittedOps();
+        const opEntryPointMap = new Map();
+        for (const op of ops) {
+            if (!opEntryPointMap.has(op.userOperation.entryPoint)) {
+                opEntryPointMap.set(op.userOperation.entryPoint, []);
+            }
+            opEntryPointMap.get(op.userOperation.entryPoint)?.push(op);
+        }
+        await Promise.all(this.entryPoints.map(async (entryPoint) => {
+            const ops = opEntryPointMap.get(entryPoint);
+            if (ops) {
+                const txs = getTransactionsFromUserOperationEntries(ops);
+                await Promise.all(txs.map(async (txInfo) => {
+                    await this.refreshTransactionStatus(entryPoint, txInfo);
+                }));
+            }
+            else {
+                this.logger.warn({ entryPoint }, "no user operations for entry point");
+            }
+        }));
+    }
+    async handleBlock(block) {
+        if (this.currentlyHandlingBlock) {
+            return;
+        }
+        this.currentlyHandlingBlock = true;
+        this.logger.debug({ blockNumber: block.number }, "handling block");
+        const submittedEntries = this.mempool.dumpSubmittedOps();
+        if (submittedEntries.length === 0) {
+            this.stopWatchingBlocks();
+            this.currentlyHandlingBlock = false;
+            return;
+        }
+        // refresh op statuses
+        await this.refreshUserOperationStatuses();
+        // for all still not included check if needs to be replaced (based on gas price)
+        const gasPriceParameters = await this.gasPriceManager.getGasPrice();
+        this.logger.trace({ gasPriceParameters }, "fetched gas price parameters");
+        const transactionInfos = getTransactionsFromUserOperationEntries(this.mempool.dumpSubmittedOps());
+        await Promise.all(transactionInfos.map(async (txInfo) => {
+            if (txInfo.transactionRequest.maxFeePerGas >=
+                gasPriceParameters.maxFeePerGas &&
+                txInfo.transactionRequest.maxPriorityFeePerGas >=
+                    gasPriceParameters.maxPriorityFeePerGas) {
+                return;
+            }
+            await this.replaceTransaction(txInfo, "gas_price");
+        }));
+        // for any left check if enough time has passed, if so replace
+        const transactionInfos2 = getTransactionsFromUserOperationEntries(this.mempool.dumpSubmittedOps());
+        await Promise.all(transactionInfos2.map(async (txInfo) => {
+            if (Date.now() - txInfo.lastReplaced < 5 * 60 * 1000) {
+                return;
+            }
+            await this.replaceTransaction(txInfo, "stuck");
+        }));
+        this.currentlyHandlingBlock = false;
+    }
+    async replaceTransaction(txInfo, reason) {
+        let replaceResult = undefined;
+        try {
+            replaceResult = await this.executor.replaceTransaction(txInfo);
+        }
+        finally {
+            this.metrics.replacedTransactions
+                .labels({ reason, status: replaceResult?.status || "failed" })
+                .inc();
+        }
+        if (replaceResult.status === "failed") {
+            txInfo.userOperationInfos.map((opInfo) => {
+                this.mempool.removeSubmitted(opInfo.userOperationHash);
+            });
+            this.logger.warn({ oldTxHash: txInfo.transactionHash, reason }, "failed to replace transaction");
+            return;
+        }
+        if (replaceResult.status === "potentially_already_included") {
+            this.logger.info({ oldTxHash: txInfo.transactionHash, reason }, "transaction potentially already included");
+            txInfo.timesPotentiallyIncluded += 1;
+            if (txInfo.timesPotentiallyIncluded >= 3) {
+                txInfo.userOperationInfos.map((opInfo) => {
+                    this.mempool.removeSubmitted(opInfo.userOperationHash);
+                });
+                this.executor.markWalletProcessed(txInfo.executor);
+                this.logger.warn({ oldTxHash: txInfo.transactionHash, reason }, "transaction potentially already included too many times, removing");
+            }
+            return;
+        }
+        const newTxInfo = replaceResult.transactionInfo;
+        const missingOps = txInfo.userOperationInfos.filter((info) => !newTxInfo.userOperationInfos
+            .map((ni) => ni.userOperationHash)
+            .includes(info.userOperationHash));
+        const matchingOps = txInfo.userOperationInfos.filter((info) => newTxInfo.userOperationInfos
+            .map((ni) => ni.userOperationHash)
+            .includes(info.userOperationHash));
+        matchingOps.map((opInfo) => {
+            this.mempool.replaceSubmitted(opInfo, newTxInfo);
+        });
+        missingOps.map((opInfo) => {
+            this.mempool.removeSubmitted(opInfo.userOperationHash);
+            this.logger.warn({
+                oldTxHash: txInfo.transactionHash,
+                newTxHash: newTxInfo.transactionHash,
+                reason
+            }, "missing op in new tx");
+        });
+        this.logger.info({
+            oldTxHash: txInfo.transactionHash,
+            newTxHash: newTxInfo.transactionHash,
+            reason
+        }, "replaced transaction");
+        return;
+    }
+}
+//# sourceMappingURL=executorManager.js.map

package/esm/executor/executorManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executorManager.js","sourceRoot":"","sources":["../../executor/executorManager.ts"],"names":[],"mappings":"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"}

package/esm/executor/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./senderManager.js";
+export * from "./executor.js";
+export * from "./executorManager.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/executor/index.js

@@ -0,0 +1,5 @@
+export * from "./senderManager.js";
+export * from "./executor.js";
+export * from "./executorManager.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/esm/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../executor/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA"}

package/esm/executor/senderManager.d.ts

@@ -0,0 +1,17 @@
+import type { GasPriceManager, Logger, Metrics } from "../utils/index.js";
+import { type Account, type Chain, type PublicClient, type Transport, type WalletClient } from "viem";
+export declare class SenderManager {
+    wallets: Account[];
+    utilityAccount: Account | undefined;
+    availableWallets: Account[];
+    private logger;
+    private metrics;
+    private legacyTransactions;
+    private semaphore;
+    private gasPriceManager;
+    constructor(wallets: Account[], utilityAccount: Account | undefined, logger: Logger, metrics: Metrics, legacyTransactions: boolean, gasPriceManager: GasPriceManager, maxSigners?: number);
+    validateAndRefillWallets(publicClient: PublicClient, walletClient: WalletClient<Transport, Chain>, minBalance?: bigint): Promise<void>;
+    getWallet(): Promise<Account>;
+    pushWallet(wallet: Account): void;
+}
+//# sourceMappingURL=senderManager.d.ts.map

package/esm/executor/senderManager.js

@@ -0,0 +1,160 @@
+import { CallEngineAbi } from "../types/index.js";
+import { Semaphore } from "async-mutex";
+import { formatEther, getContract } from "viem";
+const waitForTransactionReceipt = async (publicClient, tx) => {
+    try {
+        return await publicClient.waitForTransactionReceipt({ hash: tx });
+    }
+    catch {
+        return await waitForTransactionReceipt(publicClient, tx);
+    }
+};
+export class SenderManager {
+    wallets;
+    utilityAccount;
+    availableWallets;
+    logger;
+    metrics;
+    legacyTransactions;
+    semaphore;
+    gasPriceManager;
+    constructor(wallets, utilityAccount, logger, metrics, legacyTransactions, gasPriceManager, maxSigners) {
+        if (maxSigners !== undefined && wallets.length > maxSigners) {
+            this.wallets = wallets.slice(0, maxSigners);
+            this.availableWallets = wallets.slice(0, maxSigners);
+        }
+        else {
+            this.wallets = wallets;
+            this.availableWallets = wallets;
+        }
+        this.utilityAccount = utilityAccount;
+        this.logger = logger;
+        this.metrics = metrics;
+        this.legacyTransactions = legacyTransactions;
+        metrics.walletsAvailable.set(this.availableWallets.length);
+        metrics.walletsTotal.set(this.wallets.length);
+        this.semaphore = new Semaphore(this.availableWallets.length);
+        this.gasPriceManager = gasPriceManager;
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>
+    async validateAndRefillWallets(publicClient, walletClient, minBalance) {
+        if (!(minBalance && this.utilityAccount)) {
+            return;
+        }
+        const utilityWalletBalance = await publicClient.getBalance({
+            address: this.utilityAccount.address
+        });
+        const balancesMissing = {};
+        const balanceRequestPromises = this.availableWallets.map(async (wallet) => {
+            const balance = await publicClient.getBalance({
+                address: wallet.address
+            });
+            if (balance < minBalance) {
+                const missingBalance = (minBalance * 6n) / 5n - balance;
+                balancesMissing[wallet.address] = missingBalance;
+            }
+        });
+        await Promise.all(balanceRequestPromises);
+        const totalBalanceMissing = Object.values(balancesMissing).reduce((a, b) => a + b, 0n);
+        if (utilityWalletBalance < (totalBalanceMissing * 11n) / 10n) {
+            this.logger.info({ balancesMissing, totalBalanceMissing }, "balances missing");
+            this.logger.error({
+                minBalance,
+                utilityWalletBalance,
+                totalBalanceMissing,
+                utilityAccount: this.utilityAccount.address
+            }, "utility wallet has insufficient balance to refill wallets");
+            throw new Error(`utility wallet ${this.utilityAccount.address} has insufficient balance ${formatEther(utilityWalletBalance)} < ${formatEther(totalBalanceMissing)}`);
+        }
+        if (Object.keys(balancesMissing).length > 0) {
+            const { maxFeePerGas, maxPriorityFeePerGas } = await this.gasPriceManager.getGasPrice();
+            if (walletClient.chain.id === 59140 ||
+                walletClient.chain.id === 137 ||
+                walletClient.chain.id === 10) {
+                const instructions = [];
+                for (const [address, missingBalance] of Object.entries(balancesMissing)) {
+                    instructions.push({
+                        to: address,
+                        value: missingBalance,
+                        data: "0x"
+                    });
+                }
+                let refillAddress;
+                if (walletClient.chain.id === 59140) {
+                    refillAddress = "0xEad1aC3DF6F96b91491d6396F4d1610C5638B4Db";
+                }
+                else if (walletClient.chain.id === 137) {
+                    refillAddress = "0x3402DB43152dAB9ab72fa805fdD5f391cD3E3822";
+                }
+                else {
+                    refillAddress = "0x3402DB43152dAB9ab72fa805fdD5f391cD3E3822";
+                }
+                const callEngine = getContract({
+                    abi: CallEngineAbi,
+                    address: refillAddress,
+                    client: {
+                        public: publicClient,
+                        wallet: walletClient
+                    }
+                });
+                const tx = await callEngine.write.execute([instructions], {
+                    account: this.utilityAccount,
+                    value: totalBalanceMissing,
+                    maxFeePerGas: maxFeePerGas * 2n,
+                    maxPriorityFeePerGas: maxPriorityFeePerGas * 2n
+                });
+                await waitForTransactionReceipt(publicClient, tx);
+                for (const [address, missingBalance] of Object.entries(balancesMissing)) {
+                    this.logger.info({ tx, executor: address, missingBalance }, "refilled wallet");
+                }
+            }
+            else {
+                for (const [address, missingBalance] of Object.entries(balancesMissing)) {
+                    const tx = await walletClient.sendTransaction({
+                        account: this.utilityAccount,
+                        // @ts-ignore
+                        to: address,
+                        value: missingBalance,
+                        maxFeePerGas: this.legacyTransactions
+                            ? undefined
+                            : maxFeePerGas,
+                        maxPriorityFeePerGas: this.legacyTransactions
+                            ? undefined
+                            : maxPriorityFeePerGas,
+                        gasPrice: this.legacyTransactions
+                            ? maxFeePerGas
+                            : undefined
+                    });
+                    await waitForTransactionReceipt(publicClient, tx);
+                    this.logger.info({ tx, executor: address, missingBalance }, "refilled wallet");
+                }
+            }
+        }
+        else {
+            this.logger.info("no wallets need to be refilled");
+        }
+    }
+    async getWallet() {
+        this.logger.trace(`waiting for semaphore with count ${this.semaphore.getValue()}`);
+        await this.semaphore.waitForUnlock();
+        await this.semaphore.acquire();
+        const wallet = this.availableWallets.shift();
+        // should never happen because of semaphore
+        if (!wallet) {
+            this.semaphore.release();
+            this.logger.error("no more wallets");
+            throw new Error("no more wallets");
+        }
+        this.logger.trace({ executor: wallet.address }, "got wallet from sender manager");
+        this.metrics.walletsAvailable.set(this.availableWallets.length);
+        return wallet;
+    }
+    pushWallet(wallet) {
+        this.availableWallets.push(wallet);
+        this.semaphore.release();
+        this.logger.trace({ executor: wallet.address }, "pushed wallet to sender manager");
+        this.metrics.walletsAvailable.set(this.availableWallets.length);
+        return;
+    }
+}
+//# sourceMappingURL=senderManager.js.map