@aztec/ethereum 0.0.1-commit.b655e406 → 0.0.1-commit.b8a057fa

package/dest/l1_tx_utils/l1_tx_utils.js

@@ -2,32 +2,57 @@ import { maxBigint } from '@aztec/foundation/bigint';
 import { merge, pick } from '@aztec/foundation/collection';
 import { InterruptError, TimeoutError } from '@aztec/foundation/error';
 import { createLogger } from '@aztec/foundation/log';
-import { retryUntil } from '@aztec/foundation/retry';
+import { Semaphore } from '@aztec/foundation/queue';
+import { makeBackoff, retry, retryUntil } from '@aztec/foundation/retry';
 import { sleep } from '@aztec/foundation/sleep';
 import { DateProvider } from '@aztec/foundation/timer';
 import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
 import pickBy from 'lodash.pickby';
-import { createNonceManager, formatGwei, serializeTransaction } from 'viem';
-import { jsonRpc } from 'viem/nonce';
+import { formatGwei, serializeTransaction } from 'viem';
 import { formatViemError } from '../utils.js';
 import { l1TxUtilsConfigMappings } from './config.js';
-import { LARGE_GAS_LIMIT } from './constants.js';
+import { MAX_L1_TX_LIMIT } from './constants.js';
 import { ReadOnlyL1TxUtils } from './readonly_l1_tx_utils.js';
-import { DroppedTransactionError, TerminalTxUtilsState, TxUtilsState, UnknownMinedTxError } from './types.js';
+import { createDelayer, wrapClientWithDelayer } from './tx_delayer.js';
+import { DroppedTransactionError, L1TxTimeoutError, TerminalTxUtilsState, TxUtilsState, UnknownMinedTxError } from './types.js';
 const MAX_L1_TX_STATES = 32;
+// Backoff (in seconds) for retrying the read-only RPC calls that prepare a tx cancellation. A
+// cancellation is fired in the background after a tx times out and is important (it frees the stuck
+// nonce), so a transient RPC failure while reading the pending nonce or gas price must not abandon it.
+const CANCELLATION_PREP_RETRY_BACKOFF_S = [
+    1,
+    2,
+    4,
+    8
+];
 export class L1TxUtils extends ReadOnlyL1TxUtils {
     client;
     address;
     signer;
     store;
     metrics;
-    nonceManager;
     txs;
-    constructor(client, address, signer, logger = createLogger('ethereum:publisher'), dateProvider = new DateProvider(), config, debugMaxGasLimit = false, store, metrics){
-        super(client, logger, dateProvider, config, debugMaxGasLimit), this.client = client, this.address = address, this.signer = signer, this.store = store, this.metrics = metrics, this.txs = [];
-        this.nonceManager = createNonceManager({
-            source: jsonRpc()
-        });
+    /** Last nonce successfully sent to the chain. Used as a lower bound when a fallback RPC node returns a stale count. */ lastSentNonce;
+    /** Mutex to prevent concurrent sendTransaction calls from racing on the same nonce. */ sendMutex;
+    /** Tx delayer for testing. Only set when enableDelayer config is true. */ delayer;
+    /** KZG instance for blob operations. */ kzg;
+    constructor(client, address, signer, logger = createLogger('ethereum:publisher'), dateProvider = new DateProvider(), config, debugMaxGasLimit = false, store, metrics, kzg, delayer){
+        super(client, logger, dateProvider, config, debugMaxGasLimit), this.client = client, this.address = address, this.signer = signer, this.store = store, this.metrics = metrics, this.txs = [], this.sendMutex = new Semaphore(1);
+        this.kzg = kzg;
+        // Set up delayer: use provided one or create new
+        if (config?.enableDelayer && config?.ethereumSlotDuration) {
+            this.delayer = delayer ?? this.createDelayer({
+                ethereumSlotDuration: config.ethereumSlotDuration
+            }, logger.getBindings());
+            this.client = wrapClientWithDelayer(this.client, this.delayer);
+            if (config.txDelayerMaxInclusionTimeIntoSlot !== undefined) {
+                this.delayer.setMaxInclusionTimeIntoSlot(config.txDelayerMaxInclusionTimeIntoSlot);
+            }
+        } else if (delayer) {
+            // Delayer provided but enableDelayer not set — just store it without wrapping
+            logger.warn('Delayer provided but enableDelayer config is not set; delayer will not be used');
+            this.delayer = delayer;
+        }
     }
     get state() {
         return this.txs.at(-1)?.status ?? TxUtilsState.IDLE;
@@ -46,6 +71,11 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             this.metrics?.recordMinedTx(l1TxState, new Date(l1Timestamp));
         } else if (newState === TxUtilsState.NOT_MINED) {
             this.metrics?.recordDroppedTx(l1TxState);
+            // The tx was dropped: the chain nonce reverted to l1TxState.nonce, so our lower bound is
+            // no longer valid. Clear it so the next send fetches the real nonce from the chain.
+            if (this.lastSentNonce === l1TxState.nonce) {
+                this.lastSentNonce = undefined;
+            }
         }
         // Update state in the store
         await this.store?.saveState(sender, l1TxState).catch((err)=>this.logger.error('Failed to persist L1 tx state', err));
@@ -54,6 +84,12 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
         this.config = merge(this.config, newConfig);
         this.logger.info('Updated L1TxUtils config', pickBy(newConfig, (_, key)=>key in l1TxUtilsConfigMappings));
     }
+    /**
+   * Clears the cached `lastSentNonce` so the next `sendTransaction` call fetches the real
+   * nonce from the chain. Call this after an L1 reorg to prevent stale nonce references.
+   */ resetNonce() {
+        this.lastSentNonce = undefined;
+    }
     getSenderAddress() {
         return this.address;
     }
@@ -75,11 +111,24 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             this.logger.debug(`No states to rehydrate for account ${account}`);
             return;
         }
-        // Convert loaded states (which have id) to the txs format
-        this.txs = loadedStates;
-        this.logger.info(`Rehydrated ${loadedStates.length} tx states for account ${account}`);
+        // Clean up excess states if we have more than MAX_L1_TX_STATES
+        if (loadedStates.length > MAX_L1_TX_STATES) {
+            this.logger.warn(`Found ${loadedStates.length} tx states for account ${account}, pruning to most recent ${MAX_L1_TX_STATES}`);
+            // Keep only the most recent MAX_L1_TX_STATES
+            const statesToKeep = loadedStates.slice(-MAX_L1_TX_STATES);
+            const statesToDelete = loadedStates.slice(0, -MAX_L1_TX_STATES);
+            // Batch delete old states in a transaction for efficiency
+            const idsToDelete = statesToDelete.map((s)=>s.id);
+            await this.store.deleteState(account, ...idsToDelete);
+            this.txs = statesToKeep;
+            this.logger.info(`Cleaned up ${statesToDelete.length} old tx states, kept ${statesToKeep.length} for account ${account}`);
+        } else {
+            // Convert loaded states (which have id) to the txs format
+            this.txs = loadedStates;
+            this.logger.info(`Rehydrated ${loadedStates.length} tx states for account ${account}`);
+        }
         // Find all pending states and resume monitoring
-        const pendingStates = loadedStates.filter((state)=>!TerminalTxUtilsState.includes(state.status));
+        const pendingStates = this.txs.filter((state)=>!TerminalTxUtilsState.includes(state.status));
         if (pendingStates.length === 0) {
             return;
         }
@@ -107,21 +156,32 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
         const txRequest = await this.client.prepareTransactionRequest(txData);
         return await this.signTransaction(txRequest);
     }
+    async checkInterruptedOrTimedOut(gasConfig) {
+        if (this.interrupted) {
+            throw new InterruptError(`Transaction sending is interrupted`);
+        }
+        const now = new Date(await this.getL1Timestamp());
+        if (gasConfig.txTimeoutAt && now > gasConfig.txTimeoutAt) {
+            throw new TimeoutError(`Transaction timed out before sending (now ${now.toISOString()} > timeoutAt ${gasConfig.txTimeoutAt.toISOString()})`);
+        }
+        return now;
+    }
     /**
    * Sends a transaction with gas estimation and pricing
    * @param request - The transaction request (to, data, value)
    * @param gasConfig - Optional gas configuration
    * @returns The transaction hash and parameters used
    */ async sendTransaction(request, gasConfigOverrides, blobInputs, stateChange = TxUtilsState.SENT) {
-        if (this.interrupted) {
-            throw new InterruptError(`Transaction sending is interrupted`);
-        }
         try {
             const gasConfig = merge(this.config, gasConfigOverrides);
             const account = this.getSenderAddress().toString();
+            // Fail fast before doing any work (gas estimation, balance check) if we've been interrupted
+            // or if the caller's deadline has already passed. The same check is repeated after gas
+            // estimation in case it took long enough to push us past the deadline.
+            await this.checkInterruptedOrTimedOut(gasConfig);
             let gasLimit;
             if (this.debugMaxGasLimit) {
-                gasLimit = LARGE_GAS_LIMIT;
+                gasLimit = MAX_L1_TX_LIMIT;
             } else if (gasConfig.gasLimit) {
                 gasLimit = gasConfig.gasLimit;
             } else {
@@ -132,37 +192,41 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                 ...request
             });
             const gasPrice = await this.getGasPrice(gasConfig, !!blobInputs);
-            if (this.interrupted) {
-                throw new InterruptError(`Transaction sending is interrupted`);
-            }
-            const nonce = await this.nonceManager.consume({
-                client: this.client,
-                address: account,
-                chainId: this.client.chain.id
-            });
-            const baseState = {
-                request,
-                gasLimit,
-                blobInputs,
-                gasPrice,
-                nonce
-            };
-            const txData = this.makeTxData(baseState, {
-                isCancelTx: false
-            });
-            const now = new Date(await this.getL1Timestamp());
-            if (gasConfig.txTimeoutAt && now > gasConfig.txTimeoutAt) {
-                throw new TimeoutError(`Transaction timed out before sending (now ${now.toISOString()} > timeoutAt ${gasConfig.txTimeoutAt.toISOString()})`);
+            const now = await this.checkInterruptedOrTimedOut(gasConfig);
+            let txHash;
+            let nonce;
+            let baseState;
+            await this.sendMutex.acquire();
+            try {
+                const chainNonce = await this.client.getTransactionCount({
+                    address: account,
+                    blockTag: 'pending'
+                });
+                // If a fallback RPC node returns a stale count (lower than what we last sent), use our
+                // local lower bound to avoid sending a duplicate of an already-pending transaction.
+                nonce = this.lastSentNonce !== undefined && chainNonce <= this.lastSentNonce ? this.lastSentNonce + 1 : chainNonce;
+                baseState = {
+                    request,
+                    gasLimit,
+                    blobInputs,
+                    gasPrice,
+                    nonce
+                };
+                const txData = this.makeTxData(baseState, {
+                    isCancelTx: false
+                });
+                const signedRequest = await this.prepareSignedTransaction(txData);
+                txHash = await this.client.sendRawTransaction({
+                    serializedTransaction: signedRequest
+                });
+                this.lastSentNonce = nonce;
+            } finally{
+                this.sendMutex.release();
             }
-            // Send the new tx
-            const signedRequest = await this.prepareSignedTransaction(txData);
-            const txHash = await this.client.sendRawTransaction({
-                serializedTransaction: signedRequest
-            });
             // Create the new state for monitoring
             const l1TxState = {
                 ...baseState,
-                id: await this.store?.consumeNextStateId(account) ?? Math.max(...this.txs.map((tx)=>tx.id), 0),
+                id: await this.store?.consumeNextStateId(account) ?? Math.max(...this.txs.map((tx)=>tx.id), -1) + 1,
                 txHashes: [
                     txHash
                 ],
@@ -170,7 +234,10 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                 status: TxUtilsState.IDLE,
                 txConfigOverrides: gasConfigOverrides ?? {},
                 sentAtL1Ts: now,
-                lastSentAtL1Ts: now
+                lastSentAtL1Ts: now,
+                gasPriceHistory: [
+                    baseState.gasPrice
+                ]
             };
             // And persist it
             await this.updateState(l1TxState, stateChange);
@@ -204,7 +271,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             };
         } catch (err) {
             const viemError = formatViemError(err, request.abi);
-            this.logger.error(`Failed to send L1 transaction`, viemError, {
+            this.logger.error(`Failed to send L1 transaction: ${viemError.message}`, viemError, {
                 request: pick(request, 'to', 'value')
             });
             throw viemError;
@@ -294,9 +361,25 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
         const account = this.getSenderAddress().toString();
         const initialTxHash = txHashes[0];
         let currentTxHash = txHashes.at(-1);
-        let l1Timestamp;
+        let l1Timestamp = 0;
         while(true){
-            l1Timestamp = await this.getL1Timestamp();
+            try {
+                l1Timestamp = await this.getL1Timestamp();
+            } catch (err) {
+                // A transient RPC failure here must not abort monitoring with a rejection: callers that
+                // fire this loop in the background would surface it as an unhandled rejection (e.g. when a
+                // test tears down its L1 node while a monitor iteration is in flight). Exit quietly if we
+                // are shutting down, otherwise retry on the next interval.
+                if (this.interrupted) {
+                    break;
+                }
+                this.logger.error(`Error fetching L1 timestamp while monitoring tx ${currentTxHash}`, err, {
+                    nonce,
+                    account
+                });
+                await sleep(gasConfig.checkIntervalMs);
+                continue;
+            }
             try {
                 const timePassed = l1Timestamp - state.lastSentAtL1Ts.getTime();
                 const [currentNonce, pendingNonce] = await Promise.all([
@@ -333,10 +416,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                         timePassed
                     });
                     await this.updateState(state, TxUtilsState.NOT_MINED);
-                    this.nonceManager.reset({
-                        address: account,
-                        chainId: this.client.chain.id
-                    });
                     throw new DroppedTransactionError(nonce, account);
                 }
                 // Break if the tx has timed out (ie expired)
@@ -348,6 +427,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                 if (timePassed >= stallTimeMs && attempts <= maxSpeedUpAttempts) {
                     const newGasPrice = await this.getGasPrice(gasConfig, isBlobTx, attempts, state.gasPrice);
                     state.gasPrice = newGasPrice;
+                    state.gasPriceHistory?.push(newGasPrice);
                     this.logger.debug(`Tx ${currentTxHash} with nonce ${nonce} from ${account} appears stuck. ` + `Attempting speed-up ${attempts}/${maxSpeedUpAttempts} ` + `with new priority fee ${formatGwei(newGasPrice.maxPriorityFeePerGas)} gwei.`, {
                         account,
                         nonce,
@@ -408,15 +488,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
         }
         // Oh no, the transaction has timed out!
         if (isCancelTx || !gasConfig.cancelTxOnTimeout) {
-            // If this was already a cancellation tx, or we are configured to not cancel txs, we just mark it as NOT_MINED
-            // and reset the nonce manager, so the next tx that comes along can reuse the nonce if/when this tx gets dropped.
-            // This is the nastiest scenario for us, since the new tx could acquire the next nonce, but then this tx is dropped,
-            // and the new tx would never get mined. Eventually, the new tx would also drop.
             await this.updateState(state, TxUtilsState.NOT_MINED);
-            this.nonceManager.reset({
-                address: account,
-                chainId: this.client.chain.id
-            });
         } else {
             // Otherwise we fire the cancellation without awaiting to avoid blocking the caller,
             // and monitor it in the background so we can speed it up as needed.
@@ -491,11 +563,27 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
    * @returns The receipt of the successful transaction
    */ async sendAndMonitorTransaction(request, gasConfig, blobInputs) {
         const { state } = await this.sendTransaction(request, gasConfig, blobInputs);
-        const receipt = await this.monitorTransaction(state);
-        return {
-            receipt,
-            state
-        };
+        try {
+            const receipt = await this.monitorTransaction(state);
+            return {
+                receipt,
+                state
+            };
+        } catch (err) {
+            if (err instanceof TimeoutError) {
+                // Snapshot the ladder now: the fire-and-forget cancellation mutates state.gasPrice moments later.
+                throw new L1TxTimeoutError(err.message, {
+                    gasPriceHistory: state.gasPriceHistory ? [
+                        ...state.gasPriceHistory
+                    ] : undefined,
+                    finalGasPrice: state.gasPrice,
+                    attempts: state.txHashes.length,
+                    nonce: state.nonce,
+                    gasLimit: state.gasLimit
+                });
+            }
+            throw err;
+        }
     }
     async simulate(request, _blockOverrides = {}, stateOverrides = [], abi = RollupAbi, _gasConfig) {
         const blockOverrides = {
@@ -509,11 +597,11 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             from: request.from ?? this.getSenderAddress().toString(),
             maxFeePerGas: gasPrice.maxFeePerGas,
             maxPriorityFeePerGas: gasPrice.maxPriorityFeePerGas,
-            gas: request.gas ?? LARGE_GAS_LIMIT
+            gas: request.gas ?? MAX_L1_TX_LIMIT
         };
         if (!request.gas && !gasConfig.ignoreBlockGasLimit) {
-            // LARGE_GAS_LIMIT is set as call.gas, increase block gasLimit
-            blockOverrides.gasLimit = LARGE_GAS_LIMIT * 2n;
+            // MAX_L1_TX_LIMIT is set as call.gas, ensure block gasLimit is sufficient
+            blockOverrides.gasLimit = MAX_L1_TX_LIMIT;
         }
         return this._simulate(call, blockOverrides, stateOverrides, gasConfig, abi);
     }
@@ -532,36 +620,45 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                 account
             });
             await this.updateState(state, TxUtilsState.NOT_MINED);
-            this.nonceManager.reset({
-                address: account,
-                chainId: this.client.chain.id
-            });
             return;
         }
-        // Check if the original tx is still pending
-        const currentNonce = await this.client.getTransactionCount({
-            address: account,
-            blockTag: 'pending'
-        });
-        if (currentNonce < nonce) {
+        // Resolve the pending nonce and cancellation gas price up front. These are read-only RPC calls, so
+        // they are safe to retry; a transient RPC failure here must not permanently abandon the cancellation
+        // (which would leave the nonce stuck and the tx state stranded short of CANCELLED). We retry with a
+        // real backoff before giving up, unlike getGasPrice's tight internal retry which can be exhausted by
+        // a brief node hiccup. The retried block performs no state-changing send, so retrying cannot
+        // double-send the cancellation tx.
+        const { currentNonce, cancelGasPrice } = await retry(async ()=>{
+            const currentNonce = await this.client.getTransactionCount({
+                address: account,
+                blockTag: 'pending'
+            });
+            if (currentNonce >= nonce) {
+                // Get gas price with higher priority fee for cancellation
+                const cancelGasPrice = await this.getGasPrice({
+                    ...this.config,
+                    // Use high bump for cancellation to ensure it replaces the original tx
+                    priorityFeeRetryBumpPercentage: 150
+                }, isBlobTx, state.txHashes.length, previousGasPrice);
+                return {
+                    currentNonce,
+                    cancelGasPrice
+                };
+            }
+            return {
+                currentNonce,
+                cancelGasPrice: undefined
+            };
+        }, `Preparing cancellation for L1 tx from account ${account} with nonce ${nonce}`, makeBackoff(CANCELLATION_PREP_RETRY_BACKOFF_S), this.logger);
+        if (cancelGasPrice === undefined) {
             this.logger.verbose(`Not sending cancellation for L1 tx from account ${account} with nonce ${nonce} as it is dropped`, {
                 nonce,
                 account,
                 currentNonce
             });
             await this.updateState(state, TxUtilsState.NOT_MINED);
-            this.nonceManager.reset({
-                address: account,
-                chainId: this.client.chain.id
-            });
             return;
         }
-        // Get gas price with higher priority fee for cancellation
-        const cancelGasPrice = await this.getGasPrice({
-            ...this.config,
-            // Use high bump for cancellation to ensure it replaces the original tx
-            priorityFeeRetryBumpPercentage: 150
-        }, isBlobTx, state.txHashes.length, previousGasPrice);
         const { maxFeePerGas, maxPriorityFeePerGas, maxFeePerBlobGas } = cancelGasPrice;
         this.logger.verbose(`Attempting to cancel L1 ${isBlobTx ? 'blob' : 'vanilla'} transaction from account ${account} with nonce ${nonce} after time out`, {
             maxFeePerGas: formatGwei(maxFeePerGas),
@@ -604,7 +701,20 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
         });
         return Number(timestamp) * 1000;
     }
-    /** Makes empty blob inputs for the cancellation tx. To be overridden in L1TxUtilsWithBlobs. */ makeEmptyBlobInputs(_maxFeePerBlobGas) {
-        throw new Error('Cannot make empty blob inputs for cancellation');
+    /** Makes empty blob inputs for the cancellation tx. */ makeEmptyBlobInputs(maxFeePerBlobGas) {
+        if (!this.kzg) {
+            throw new Error('Cannot make empty blob inputs for cancellation without kzg');
+        }
+        const blobData = new Uint8Array(131072).fill(0);
+        return {
+            blobs: [
+                blobData
+            ],
+            kzg: this.kzg,
+            maxFeePerBlobGas
+        };
+    }
+    /** Creates a new delayer instance. */ createDelayer(opts, bindings) {
+        return createDelayer(this.dateProvider, opts, bindings);
     }
 }

package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts

@@ -1,6 +1,7 @@
+import type { EthAddress } from '@aztec/foundation/eth-address';
 import { type Logger } from '@aztec/foundation/log';
 import { DateProvider } from '@aztec/foundation/timer';
-import { type Abi, type Account, type BlockOverrides, type Hex, type StateOverride } from 'viem';
+import { type Abi, type Account, type BlockOverrides, type GetCodeReturnType, type Hex, type StateOverride } from 'viem';
 import type { ViemClient } from '../types.js';
 import { type L1TxUtilsConfig } from './config.js';
 import type { GasPrice, L1BlobInputs, L1TxRequest, TransactionStats } from './types.js';
@@ -15,44 +16,36 @@ export declare class ReadOnlyL1TxUtils {
     interrupt(): void;
     restart(): void;
     getBlock(): Promise<{
-        number: bigint;
-        hash: `0x${string}`;
-        nonce: `0x${string}`;
-        logsBloom: `0x${string}`;
         baseFeePerGas: bigint | null;
         blobGasUsed: bigint;
         difficulty: bigint;
         excessBlobGas: bigint;
-        extraData: Hex;
+        extraData: `0x${string}`;
         gasLimit: bigint;
         gasUsed: bigint;
-        miner: import("viem").Address;
-        mixHash: import("viem").Hash;
+        hash: `0x${string}`;
+        logsBloom: `0x${string}`;
+        miner: `0x${string}`;
+        mixHash: `0x${string}`;
+        nonce: `0x${string}`;
+        number: bigint;
         parentBeaconBlockRoot?: `0x${string}` | undefined;
-        parentHash: import("viem").Hash;
-        receiptsRoot: Hex;
-        sealFields: Hex[];
-        sha3Uncles: import("viem").Hash;
+        parentHash: `0x${string}`;
+        receiptsRoot: `0x${string}`;
+        sealFields: `0x${string}`[];
+        sha3Uncles: `0x${string}`;
         size: bigint;
-        stateRoot: import("viem").Hash;
+        stateRoot: `0x${string}`;
         timestamp: bigint;
         totalDifficulty: bigint | null;
-        transactionsRoot: import("viem").Hash;
-        uncles: import("viem").Hash[];
-        withdrawals?: import("viem").Withdrawal[] | undefined | undefined;
+        transactionsRoot: `0x${string}`;
+        uncles: `0x${string}`[];
+        withdrawals?: import("viem").Withdrawal[] | undefined;
         withdrawalsRoot?: `0x${string}` | undefined;
         transactions: `0x${string}`[];
     }>;
     getBlockNumber(): Promise<bigint>;
-    /**
-     * Analyzes pending transactions and recent fee history to determine a competitive priority fee.
-     * Falls back to network estimate if data is unavailable or fails.
-     * @param networkEstimateResult - Result from estimateMaxPriorityFeePerGas RPC call
-     * @param pendingBlockResult - Result from getBlock with pending tag RPC call
-     * @param feeHistoryResult - Result from getFeeHistory RPC call
-     * @returns A competitive priority fee based on pending txs and recent block history
-     */
-    protected getCompetitivePriorityFee(networkEstimateResult: PromiseSettledResult<bigint | null>, pendingBlockResult: PromiseSettledResult<Awaited<ReturnType<ViemClient['getBlock']>> | null>, feeHistoryResult: PromiseSettledResult<Awaited<ReturnType<ViemClient['getFeeHistory']>> | null>): bigint;
+    getCode(address: EthAddress): Promise<GetCodeReturnType>;
     /**
      * Gets the current gas price with bounds checking
      */
@@ -86,9 +79,5 @@ export declare class ReadOnlyL1TxUtils {
         result: `0x${string}`;
     }>;
     bumpGasLimit(gasLimit: bigint, _gasConfig?: L1TxUtilsConfig): bigint;
-    /**
-     * Helper function to retry RPC calls twice
-     */
-    private tryTwice;
 }
-//# sourceMappingURL=readonly_l1_tx_utils.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhZG9ubHlfbDFfdHhfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sMV90eF91dGlscy9yZWFkb25seV9sMV90eF91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNoRSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFFbEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBS3ZELE9BQU8sRUFDTCxLQUFLLEdBQUcsRUFDUixLQUFLLE9BQU8sRUFFWixLQUFLLGNBQWMsRUFFbkIsS0FBSyxpQkFBaUIsRUFDdEIsS0FBSyxHQUFHLEVBR1IsS0FBSyxhQUFhLEVBS25CLE1BQU0sTUFBTSxDQUFDO0FBRWQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBbUQsTUFBTSxhQUFhLENBQUM7QUFTcEcsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFNeEYscUJBQWEsaUJBQWlCO0lBS25CLE1BQU0sRUFBRSxVQUFVO0lBQ3pCLFNBQVMsQ0FBQyxNQUFNLEVBQUUsTUFBTTthQUNSLFlBQVksRUFBRSxZQUFZO0lBRTFDLFNBQVMsQ0FBQyxnQkFBZ0IsRUFBRSxPQUFPO0lBUjlCLE1BQU0sRUFBRSxRQUFRLENBQUMsZUFBZSxDQUFDLENBQUM7SUFDekMsU0FBUyxDQUFDLFdBQVcsVUFBUztJQUU5QixZQUNTLE1BQU0sRUFBRSxVQUFVLEVBQ2YsTUFBTSxvQkFBcUQsRUFDckQsWUFBWSxFQUFFLFlBQVksRUFDMUMsTUFBTSxDQUFDLEVBQUUsT0FBTyxDQUFDLGVBQWUsQ0FBQyxFQUN2QixnQkFBZ0IsR0FBRSxPQUFlLEVBRzVDO0lBRU0sU0FBUyxTQUVmO0lBRU0sT0FBTyxTQUViO0lBRU0sUUFBUTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQUVkO0lBRU0sY0FBYyxvQkFFcEI7SUFFTSxPQUFPLENBQUMsT0FBTyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsaUJBQWlCLENBQUMsQ0FFOUQ7SUFFRDs7T0FFRztJQUNVLFdBQVcsQ0FDdEIsa0JBQWtCLENBQUMsRUFBRSxlQUFlLEVBQ3BDLFFBQVEsR0FBRSxPQUFlLEVBQ3pCLE9BQU8sR0FBRSxNQUFVLEVBQ25CLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxPQUFPLFNBQVMsQ0FBQyxHQUFHLEtBQUssR0FBRyxRQUFRLEdBQzdELE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FvSm5CO0lBRUQ7O09BRUc7SUFDVSxXQUFXLENBQ3RCLE9BQU8sRUFBRSxPQUFPLEdBQUcsR0FBRyxFQUN0QixPQUFPLEVBQUUsV0FBVyxFQUNwQixVQUFVLENBQUMsRUFBRSxlQUFlLEVBQzVCLFdBQVcsQ0FBQyxFQUFFLFlBQVksR0FDekIsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQWlDakI7SUFFSyxtQkFBbUIsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsR0FBRyxTQUFTLENBQUMsQ0FZL0U7SUFFWSx5QkFBeUIsQ0FDcEMsSUFBSSxFQUFFLEdBQUcsRUFDVCxJQUFJLEVBQUU7UUFDSixJQUFJLEVBQUUsU0FBUyxHQUFHLEVBQUUsQ0FBQztRQUNyQixZQUFZLEVBQUUsTUFBTSxDQUFDO1FBQ3JCLEdBQUcsRUFBRSxHQUFHLENBQUM7UUFDVCxPQUFPLEVBQUUsR0FBRyxDQUFDO0tBQ2QsRUFDRCxVQUFVLEVBQUUsQ0FBQyxZQUFZLEdBQUc7UUFBRSxnQkFBZ0IsRUFBRSxNQUFNLENBQUE7S0FBRSxDQUFDLEdBQUcsU0FBUyxFQUNyRSxhQUFhLEdBQUUsYUFBa0IsK0JBZ0RsQztJQUVZLFFBQVEsQ0FDbkIsT0FBTyxFQUFFLFdBQVcsR0FBRztRQUFFLEdBQUcsQ0FBQyxFQUFFLE1BQU0sQ0FBQztRQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsQ0FBQTtLQUFFLEVBQ25ELGNBQWMsR0FBRSxjQUFjLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBTSxFQUNuRCxjQUFjLEdBQUUsYUFBa0IsRUFDbEMsR0FBRyxHQUFFLEdBQWUsRUFDcEIsVUFBVSxDQUFDLEVBQUUsZUFBZSxHQUFHO1FBQUUsbUJBQW1CLENBQUMsRUFBRSxNQUFNLENBQUE7S0FBRSxHQUM5RCxPQUFPLENBQUM7UUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDO1FBQUMsTUFBTSxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUE7S0FBRSxDQUFDLENBVXJEO0lBRUQsVUFBZ0IsU0FBUyxDQUN2QixJQUFJLEVBQUUsR0FBRyxFQUNULGNBQWMsNENBQXFDLEVBQ25ELGNBQWMsMkJBQW9CLEVBQ2xDLFNBQVMsRUFBRSxlQUFlLEdBQUc7UUFBRSxtQkFBbUIsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEVBQzdELEdBQUcsRUFBRSxHQUFHOzs7T0FvQ1Q7SUFFTSxZQUFZLENBQUMsUUFBUSxFQUFFLE1BQU0sRUFBRSxVQUFVLENBQUMsRUFBRSxlQUFlLEdBQUcsTUFBTSxDQVcxRTtDQUNGIn0=

package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readonly_l1_tx_utils.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/readonly_l1_tx_utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"readonly_l1_tx_utils.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/readonly_l1_tx_utils.ts"],"names":[],"mappings":"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"}