@aztec/ethereum 3.0.0-nightly.20251214 → 3.0.0-nightly.20251217

package/dest/l1_tx_utils/fee-strategies/p75_competitive.js

@@ -0,0 +1,111 @@
+import { median } from '@aztec/foundation/collection';
+import { formatGwei } from 'viem';
+import { calculatePercentile } from '../../utils.js';
+import { WEI_CONST } from '../constants.js';
+import { HISTORICAL_BLOCK_COUNT } from './types.js';
+/**
+ * Our current competitive priority fee strategy.
+ * Analyzes p75 of pending transactions and 5-block fee history to determine a competitive priority fee.
+ * Falls back to network estimate if data is unavailable.
+ */ export const P75AllTxsPriorityFeeStrategy = {
+    name: 'Competitive (P75 + History) - CURRENT',
+    id: 'p75_pending_txs_and_history_all_txs',
+    getRequiredPromises (client) {
+        return {
+            networkEstimate: client.estimateMaxPriorityFeePerGas().catch(()=>0n),
+            pendingBlock: client.getBlock({
+                blockTag: 'pending',
+                includeTransactions: true
+            }).catch(()=>null),
+            feeHistory: client.getFeeHistory({
+                blockCount: HISTORICAL_BLOCK_COUNT,
+                rewardPercentiles: [
+                    75
+                ],
+                blockTag: 'latest'
+            }).catch(()=>null)
+        };
+    },
+    calculate (results, context) {
+        const { logger } = context;
+        // Extract network estimate from settled result
+        const networkEstimate = results.networkEstimate.status === 'fulfilled' && typeof results.networkEstimate.value === 'bigint' ? results.networkEstimate.value : 0n;
+        let competitiveFee = networkEstimate;
+        const debugInfo = {
+            networkEstimateGwei: formatGwei(networkEstimate)
+        };
+        // Extract pending block from settled result
+        const pendingBlock = results.pendingBlock.status === 'fulfilled' ? results.pendingBlock.value : null;
+        // Analyze pending block transactions
+        if (pendingBlock?.transactions && pendingBlock.transactions.length > 0) {
+            const pendingFees = pendingBlock.transactions.map((tx)=>{
+                if (typeof tx === 'string') {
+                    return 0n;
+                }
+                const fee = tx.maxPriorityFeePerGas || 0n;
+                return fee;
+            }).filter((fee)=>fee > 0n);
+            if (pendingFees.length > 0) {
+                // Use 75th percentile of pending fees to be competitive
+                const pendingCompetitiveFee = calculatePercentile(pendingFees, 75);
+                if (pendingCompetitiveFee > competitiveFee) {
+                    competitiveFee = pendingCompetitiveFee;
+                }
+                debugInfo.pendingTxCount = pendingFees.length;
+                debugInfo.pendingP75Gwei = formatGwei(pendingCompetitiveFee);
+                logger?.debug('Analyzed pending transactions for competitive pricing', {
+                    pendingTxCount: pendingFees.length,
+                    pendingP75: formatGwei(pendingCompetitiveFee)
+                });
+            }
+        }
+        // Extract fee history from settled result
+        const feeHistory = results.feeHistory.status === 'fulfilled' ? results.feeHistory.value : null;
+        // Analyze fee history
+        if (feeHistory?.reward && feeHistory.reward.length > 0) {
+            // Extract 75th percentile fees from each block
+            const percentile75Fees = feeHistory.reward.map((rewards)=>rewards[0] || 0n).filter((fee)=>fee > 0n);
+            if (percentile75Fees.length > 0) {
+                // Calculate median of the 75th percentile fees across blocks
+                const medianHistoricalFee = median(percentile75Fees) ?? 0n;
+                // Debug: Log suspicious fees from history
+                if (medianHistoricalFee > 100n * WEI_CONST) {
+                    logger?.warn('Suspicious high fee in history', {
+                        historicalMedian: formatGwei(medianHistoricalFee),
+                        allP75Fees: percentile75Fees.map((f)=>formatGwei(f))
+                    });
+                }
+                if (medianHistoricalFee > competitiveFee) {
+                    competitiveFee = medianHistoricalFee;
+                }
+                debugInfo.historicalMedianGwei = formatGwei(medianHistoricalFee);
+                logger?.debug('Analyzed fee history for competitive pricing', {
+                    historicalMedian: formatGwei(medianHistoricalFee)
+                });
+            }
+        }
+        // Sanity check: cap competitive fee at 100x network estimate to avoid using unrealistic fees
+        const maxReasonableFee = networkEstimate * 100n;
+        if (competitiveFee > maxReasonableFee && networkEstimate > 0n) {
+            logger?.warn('Competitive fee exceeds sanity cap, using capped value', {
+                competitiveFee: formatGwei(competitiveFee),
+                networkEstimate: formatGwei(networkEstimate),
+                cappedTo: formatGwei(maxReasonableFee)
+            });
+            competitiveFee = maxReasonableFee;
+            debugInfo.cappedToGwei = formatGwei(maxReasonableFee);
+        }
+        // Log final decision
+        if (competitiveFee > networkEstimate) {
+            logger?.debug('Using competitive fee from market analysis', {
+                networkEstimate: formatGwei(networkEstimate),
+                competitive: formatGwei(competitiveFee)
+            });
+        }
+        debugInfo.finalFeeGwei = formatGwei(competitiveFee);
+        return {
+            priorityFee: competitiveFee,
+            debugInfo
+        };
+    }
+};

package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts

@@ -0,0 +1,32 @@
+import { type GetFeeHistoryReturnType } from 'viem';
+import type { ViemClient } from '../../types.js';
+import { type PriorityFeeStrategy } from './types.js';
+/**
+ * Type for the promises required by the competitive strategy
+ */
+type P75AllTxsStrategyPromises = {
+    networkEstimate: Promise<bigint>;
+    pendingBlock: Promise<Awaited<ReturnType<ViemClient['getBlock']>> | null>;
+    feeHistory: Promise<Awaited<ReturnType<ViemClient['getFeeHistory']>> | null>;
+};
+/**
+ * Fetches historical blocks and calculates reward percentiles for blob transactions only.
+ * Returns data in the same format as getFeeHistory for easy drop-in replacement.
+ *
+ * @param client - Viem client to use for RPC calls
+ * @param blockCount - Number of historical blocks to fetch
+ * @param rewardPercentiles - Array of percentiles to calculate (e.g., [75] for 75th percentile)
+ * @returns Object with reward field containing percentile fees for each block, similar to getFeeHistory
+ * @throws Error if fetching blocks fails
+ */
+export declare function getBlobPriorityFeeHistory(client: ViemClient, blockCount: number, rewardPercentiles: number[]): Promise<GetFeeHistoryReturnType>;
+/**
+ * Similar to our current competitive priority fee strategy, but only considers blob transactions
+ * when calculating competitive priority fee for blob transactions.
+ * This strategy also has NO cap on the competitive fee if it's much higher than the network estimate.
+ * Analyzes p75 of pending transactions and 5-block fee history to determine a competitive priority fee.
+ * Falls back to network estimate if data is unavailable.
+ */
+export declare const P75BlobTxsOnlyPriorityFeeStrategy: PriorityFeeStrategy<P75AllTxsStrategyPromises>;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicDc1X2NvbXBldGl0aXZlX2Jsb2JfdHhzX29ubHkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9sMV90eF91dGlscy9mZWUtc3RyYXRlZ2llcy9wNzVfY29tcGV0aXRpdmVfYmxvYl90eHNfb25seS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsS0FBSyx1QkFBdUIsRUFBYyxNQUFNLE1BQU0sQ0FBQztBQUVoRSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUdqRCxPQUFPLEVBRUwsS0FBSyxtQkFBbUIsRUFHekIsTUFBTSxZQUFZLENBQUM7QUFFcEI7O0dBRUc7QUFDSCxLQUFLLHlCQUF5QixHQUFHO0lBQy9CLGVBQWUsRUFBRSxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDakMsWUFBWSxFQUFFLE9BQU8sQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDMUUsVUFBVSxFQUFFLE9BQU8sQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyxlQUFlLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUM7Q0FDOUUsQ0FBQztBQUVGOzs7Ozs7Ozs7R0FTRztBQUNILHdCQUFzQix5QkFBeUIsQ0FDN0MsTUFBTSxFQUFFLFVBQVUsRUFDbEIsVUFBVSxFQUFFLE1BQU0sRUFDbEIsaUJBQWlCLEVBQUUsTUFBTSxFQUFFLEdBQzFCLE9BQU8sQ0FBQyx1QkFBdUIsQ0FBQyxDQXNFbEM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxlQUFPLE1BQU0saUNBQWlDLEVBQUUsbUJBQW1CLENBQUMseUJBQXlCLENBNEg1RixDQUFDIn0=

package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p75_competitive_blob_txs_only.d.ts","sourceRoot":"","sources":["../../../src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,uBAAuB,EAAc,MAAM,MAAM,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,KAAK,yBAAyB,GAAG;IAC/B,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1E,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAC9E,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAsElC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,mBAAmB,CAAC,yBAAyB,CA4H5F,CAAC"}

package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js

@@ -0,0 +1,173 @@
+import { median } from '@aztec/foundation/collection';
+import { formatGwei } from 'viem';
+import { calculatePercentile, isBlobTransaction } from '../../utils.js';
+import { WEI_CONST } from '../constants.js';
+import { HISTORICAL_BLOCK_COUNT } from './types.js';
+/**
+ * Fetches historical blocks and calculates reward percentiles for blob transactions only.
+ * Returns data in the same format as getFeeHistory for easy drop-in replacement.
+ *
+ * @param client - Viem client to use for RPC calls
+ * @param blockCount - Number of historical blocks to fetch
+ * @param rewardPercentiles - Array of percentiles to calculate (e.g., [75] for 75th percentile)
+ * @returns Object with reward field containing percentile fees for each block, similar to getFeeHistory
+ * @throws Error if fetching blocks fails
+ */ export async function getBlobPriorityFeeHistory(client, blockCount, rewardPercentiles) {
+    const latestBlockNumber = await client.getBlockNumber();
+    // Fetch multiple blocks in parallel
+    const blockPromises = Array.from({
+        length: blockCount
+    }, (_, i)=>client.getBlock({
+            blockNumber: latestBlockNumber - BigInt(i),
+            includeTransactions: true
+        }));
+    const blocks = await Promise.all(blockPromises);
+    // Process each block to extract blob transaction fees and other data
+    const baseFeePerGas = [];
+    const gasUsedRatio = [];
+    const reward = [];
+    for (const block of blocks){
+        // Collect base fee per gas
+        baseFeePerGas.push(block.baseFeePerGas || 0n);
+        // Calculate gas used ratio
+        const gasUsed = block.gasUsed || 0n;
+        const gasLimit = block.gasLimit || 1n; // Avoid division by zero
+        gasUsedRatio.push(Number(gasUsed) / Number(gasLimit));
+        if (!block.transactions || block.transactions.length === 0) {
+            // No transactions in this block - return zeros for each percentile
+            reward.push(rewardPercentiles.map(()=>0n));
+            continue;
+        }
+        // Extract priority fees from blob transactions only
+        const blobFees = block.transactions.map((tx)=>{
+            // Transaction can be just a hash string
+            if (typeof tx === 'string') {
+                return 0n;
+            }
+            if (!isBlobTransaction(tx)) {
+                return 0n;
+            }
+            return tx.maxPriorityFeePerGas || 0n;
+        }).filter((fee)=>fee > 0n);
+        if (blobFees.length === 0) {
+            // No blob transactions in this block - return zeros for each percentile
+            reward.push(rewardPercentiles.map(()=>0n));
+            continue;
+        }
+        // Calculate requested percentiles
+        const percentiles = rewardPercentiles.map((percentile)=>calculatePercentile(blobFees, percentile));
+        reward.push(percentiles);
+    }
+    // Calculate oldest block number (the last block in our array)
+    const oldestBlock = latestBlockNumber - BigInt(blockCount - 1);
+    // Reverse arrays to match getFeeHistory behavior (oldest first)
+    return {
+        baseFeePerGas: baseFeePerGas.reverse(),
+        gasUsedRatio: gasUsedRatio.reverse(),
+        oldestBlock,
+        reward: reward.reverse()
+    };
+}
+/**
+ * Similar to our current competitive priority fee strategy, but only considers blob transactions
+ * when calculating competitive priority fee for blob transactions.
+ * This strategy also has NO cap on the competitive fee if it's much higher than the network estimate.
+ * Analyzes p75 of pending transactions and 5-block fee history to determine a competitive priority fee.
+ * Falls back to network estimate if data is unavailable.
+ */ export const P75BlobTxsOnlyPriorityFeeStrategy = {
+    name: 'Competitive (P75 + History) - Blob Txs Only',
+    id: 'p75_pending_txs_and_history_blob_txs_only',
+    getRequiredPromises (client, opts) {
+        return {
+            networkEstimate: client.estimateMaxPriorityFeePerGas().catch(()=>0n),
+            pendingBlock: client.getBlock({
+                blockTag: 'pending',
+                includeTransactions: true
+            }).catch(()=>null),
+            feeHistory: opts.isBlobTx ? getBlobPriorityFeeHistory(client, HISTORICAL_BLOCK_COUNT, [
+                75
+            ]) : client.getFeeHistory({
+                blockCount: HISTORICAL_BLOCK_COUNT,
+                rewardPercentiles: [
+                    75
+                ],
+                blockTag: 'latest'
+            }).catch(()=>null)
+        };
+    },
+    calculate (results, context) {
+        const { logger } = context;
+        // Extract network estimate from settled result
+        const networkEstimate = results.networkEstimate.status === 'fulfilled' && typeof results.networkEstimate.value === 'bigint' ? results.networkEstimate.value : 0n;
+        let competitiveFee = networkEstimate;
+        const debugInfo = {
+            networkEstimateGwei: formatGwei(networkEstimate)
+        };
+        // Extract pending block from settled result
+        const pendingBlock = results.pendingBlock.status === 'fulfilled' ? results.pendingBlock.value : null;
+        // Analyze pending block transactions
+        if (pendingBlock?.transactions && pendingBlock.transactions.length > 0) {
+            const pendingFees = pendingBlock.transactions.map((tx)=>{
+                if (typeof tx === 'string') {
+                    return 0n;
+                }
+                if (context.isBlobTx) {
+                    if (!isBlobTransaction(tx)) {
+                        return 0n;
+                    }
+                }
+                const fee = tx.maxPriorityFeePerGas || 0n;
+                return fee;
+            }).filter((fee)=>fee > 0n);
+            if (pendingFees.length > 0) {
+                const pendingCompetitiveFee = calculatePercentile(pendingFees, 75);
+                if (pendingCompetitiveFee > competitiveFee) {
+                    competitiveFee = pendingCompetitiveFee;
+                }
+                debugInfo.pendingTxCount = pendingFees.length;
+                debugInfo.pendingP75Gwei = formatGwei(pendingCompetitiveFee);
+                logger?.debug('Analyzed pending transactions for competitive pricing', {
+                    pendingTxCount: pendingFees.length,
+                    pendingP75: formatGwei(pendingCompetitiveFee)
+                });
+            }
+        }
+        // Extract fee history from settled result
+        const feeHistory = results.feeHistory.status === 'fulfilled' ? results.feeHistory.value : null;
+        // Analyze fee history
+        if (feeHistory?.reward && feeHistory.reward.length > 0) {
+            // Extract 75th percentile fees from each block
+            const percentile75Fees = feeHistory.reward.map((rewards)=>rewards[0] || 0n).filter((fee)=>fee > 0n);
+            if (percentile75Fees.length > 0) {
+                // Calculate median of the 75th percentile fees across blocks
+                const medianHistoricalFee = median(percentile75Fees) ?? 0n;
+                // Debug: Log suspicious fees from history
+                if (medianHistoricalFee > 100n * WEI_CONST) {
+                    logger?.warn('Suspicious high fee in history', {
+                        historicalMedian: formatGwei(medianHistoricalFee),
+                        allP75Fees: percentile75Fees.map((f)=>formatGwei(f))
+                    });
+                }
+                if (medianHistoricalFee > competitiveFee) {
+                    competitiveFee = medianHistoricalFee;
+                }
+                debugInfo.historicalMedianGwei = formatGwei(medianHistoricalFee);
+                logger?.debug('Analyzed fee history for competitive pricing', {
+                    historicalMedian: formatGwei(medianHistoricalFee)
+                });
+            }
+        }
+        // Log final decision
+        if (competitiveFee > networkEstimate) {
+            logger?.debug('Using competitive fee from market analysis', {
+                networkEstimate: formatGwei(networkEstimate),
+                competitive: formatGwei(competitiveFee)
+            });
+        }
+        debugInfo.finalFeeGwei = formatGwei(competitiveFee);
+        return {
+            priorityFee: competitiveFee,
+            debugInfo
+        };
+    }
+};

package/dest/l1_tx_utils/fee-strategies/types.d.ts

@@ -0,0 +1,64 @@
+import type { Logger } from '@aztec/foundation/log';
+import type { ViemClient } from '../../types.js';
+import type { L1TxUtilsConfig } from '../config.js';
+/**
+ * Historical block count for fee history queries
+ */
+export declare const HISTORICAL_BLOCK_COUNT = 5;
+/**
+ * Result from a priority fee strategy calculation
+ */
+export interface PriorityFeeStrategyResult {
+    /** The calculated priority fee in wei */
+    priorityFee: bigint;
+    /** Optional debug info about how the fee was calculated */
+    debugInfo?: Record<string, string | number>;
+}
+/**
+ * Context passed to the strategy calculation function (excluding promise results)
+ */
+export interface PriorityFeeStrategyContext {
+    /** Gas configuration */
+    gasConfig: L1TxUtilsConfig;
+    /** Whether this is for a blob transaction */
+    isBlobTx: boolean;
+    /** Logger for debugging */
+    logger?: Logger;
+}
+/**
+ * A strategy for calculating the priority fee for L1 transactions.
+ * Each strategy defines what promises it needs and how to calculate the fee from their results.
+ * This design allows strategies to be plugged into both L1FeeAnalyzer and ReadOnlyL1TxUtils.
+ */
+export interface PriorityFeeStrategy<TPromises extends Record<string, Promise<any>> = Record<string, Promise<any>>> {
+    /** Human-readable name for logging */
+    name: string;
+    /** Unique identifier for metrics */
+    id: string;
+    /**
+     * Returns the promises that need to be executed for this strategy.
+     * These will be run in parallel with Promise.allSettled.
+     * @param client - The viem client to use for RPC calls
+     * @returns An object of promises keyed by name
+     */
+    getRequiredPromises(client: ViemClient, opts: Partial<PriorityFeeStrategyContext>): TPromises;
+    /**
+     * Calculate the priority fee based on the settled promise results.
+     * @param results - The settled results of the promises from getRequiredPromises
+     * @param context - Contains gas config, whether it's a blob tx, and logger
+     * @returns The calculated priority fee result
+     */
+    calculate(results: {
+        [K in keyof TPromises]: PromiseSettledResult<Awaited<TPromises[K]>>;
+    }, context: PriorityFeeStrategyContext): PriorityFeeStrategyResult;
+}
+/**
+ * Helper function to execute a strategy's promises and calculate the result.
+ * This can be used by both L1FeeAnalyzer and ReadOnlyL1TxUtils.
+ * @param strategy - The strategy to execute
+ * @param client - The viem client to use for RPC calls
+ * @param context - The context for calculation
+ * @returns The strategy result
+ */
+export declare function executeStrategy<TPromises extends Record<string, Promise<any>>>(strategy: PriorityFeeStrategy<TPromises>, client: ViemClient, context: PriorityFeeStrategyContext): Promise<PriorityFeeStrategyResult>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9sMV90eF91dGlscy9mZWUtc3RyYXRlZ2llcy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVwRCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNqRCxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFcEQ7O0dBRUc7QUFDSCxlQUFPLE1BQU0sc0JBQXNCLElBQUksQ0FBQztBQUV4Qzs7R0FFRztBQUNILE1BQU0sV0FBVyx5QkFBeUI7SUFDeEMseUNBQXlDO0lBQ3pDLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsMkRBQTJEO0lBQzNELFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FBQyxDQUFDO0NBQzdDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsMEJBQTBCO0lBQ3pDLHdCQUF3QjtJQUN4QixTQUFTLEVBQUUsZUFBZSxDQUFDO0lBQzNCLDZDQUE2QztJQUM3QyxRQUFRLEVBQUUsT0FBTyxDQUFDO0lBQ2xCLDJCQUEyQjtJQUMzQixNQUFNLENBQUMsRUFBRSxNQUFNLENBQUM7Q0FDakI7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxXQUFXLG1CQUFtQixDQUFDLFNBQVMsU0FBUyxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2hILHNDQUFzQztJQUN0QyxJQUFJLEVBQUUsTUFBTSxDQUFDO0lBQ2Isb0NBQW9DO0lBQ3BDLEVBQUUsRUFBRSxNQUFNLENBQUM7SUFDWDs7Ozs7T0FLRztJQUNILG1CQUFtQixDQUFDLE1BQU0sRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQywwQkFBMEIsQ0FBQyxHQUFHLFNBQVMsQ0FBQztJQUM5Rjs7Ozs7T0FLRztJQUNILFNBQVMsQ0FDUCxPQUFPLEVBQUU7U0FBRyxDQUFDLElBQUksTUFBTSxTQUFTLEdBQUcsb0JBQW9CLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0tBQUUsRUFDaEYsT0FBTyxFQUFFLDBCQUEwQixHQUNsQyx5QkFBeUIsQ0FBQztDQUM5QjtBQUVEOzs7Ozs7O0dBT0c7QUFDSCx3QkFBc0IsZUFBZSxDQUFDLFNBQVMsU0FBUyxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUNsRixRQUFRLEVBQUUsbUJBQW1CLENBQUMsU0FBUyxDQUFDLEVBQ3hDLE1BQU0sRUFBRSxVQUFVLEVBQ2xCLE9BQU8sRUFBRSwwQkFBMEIsR0FDbEMsT0FBTyxDQUFDLHlCQUF5QixDQUFDLENBY3BDIn0=

package/dest/l1_tx_utils/fee-strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/l1_tx_utils/fee-strategies/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wBAAwB;IACxB,SAAS,EAAE,eAAe,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAChH,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,SAAS,CAAC;IAC9F;;;;;OAKG;IACH,SAAS,CACP,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAChF,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAClF,QAAQ,EAAE,mBAAmB,CAAC,SAAS,CAAC,EACxC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAcpC"}

package/dest/l1_tx_utils/fee-strategies/types.js

@@ -0,0 +1,24 @@
+/**
+ * Historical block count for fee history queries
+ */ export const HISTORICAL_BLOCK_COUNT = 5;
+/**
+ * Helper function to execute a strategy's promises and calculate the result.
+ * This can be used by both L1FeeAnalyzer and ReadOnlyL1TxUtils.
+ * @param strategy - The strategy to execute
+ * @param client - The viem client to use for RPC calls
+ * @param context - The context for calculation
+ * @returns The strategy result
+ */ export async function executeStrategy(strategy, client, context) {
+    const promises = strategy.getRequiredPromises(client, {
+        isBlobTx: context.isBlobTx
+    });
+    const keys = Object.keys(promises);
+    const promiseArray = keys.map((k)=>promises[k]);
+    const settledResults = await Promise.allSettled(promiseArray);
+    // Reconstruct the results object with the same keys, preserving the type mapping
+    const results = {};
+    keys.forEach((key, index)=>{
+        results[key] = settledResults[index];
+    });
+    return strategy.calculate(results, context);
+}

package/dest/l1_tx_utils/index.d.ts

@@ -1,10 +1,12 @@
 export * from './config.js';
 export * from './constants.js';
 export * from './factory.js';
+export * from './fee-strategies/index.js';
 export * from './interfaces.js';
+export * from './l1_fee_analyzer.js';
 export * from './l1_tx_utils.js';
 export * from './readonly_l1_tx_utils.js';
 export * from './signer.js';
 export * from './types.js';
 export * from './utils.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sMV90eF91dGlscy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLDJCQUEyQixDQUFDO0FBQzFDLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsWUFBWSxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sMV90eF91dGlscy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLFlBQVksQ0FBQyJ9

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dest/l1_tx_utils/index.js

@@ -1,7 +1,9 @@
 export * from './config.js';
 export * from './constants.js';
 export * from './factory.js';
+export * from './fee-strategies/index.js';
 export * from './interfaces.js';
+export * from './l1_fee_analyzer.js';
 export * from './l1_tx_utils.js';
 export * from './readonly_l1_tx_utils.js';
 export * from './signer.js';