@aztec-labs/ethereum 6.0.0-rc.3 → 6.0.0

package/dest/l1_tx_utils/l1_tx_utils.js

@@ -7,12 +7,14 @@ import { Semaphore } from '@aztec-labs/foundation/queue';
 import { makeBackoff, retry, retryUntil } from '@aztec-labs/foundation/retry';
 import { sleep } from '@aztec-labs/foundation/sleep';
 import { DateProvider } from '@aztec-labs/foundation/timer';
+import { getErrorCause } from '@aztec-labs/foundation/types';
 import pickBy from 'lodash.pickby';
-import { formatGwei, serializeTransaction } from 'viem';
+import { InsufficientFundsError, formatGwei } from 'viem';
+import { serializeSignedTransaction } from '../blob_tx.js';
 import { formatViemError } from '../utils.js';
 import { l1TxUtilsConfigMappings } from './config.js';
-import { MAX_L1_TX_LIMIT } from './constants.js';
-import { ReadOnlyL1TxUtils } from './readonly_l1_tx_utils.js';
+import { INSUFFICIENT_FUNDS_BACKOFF_MS, MAX_L1_TX_LIMIT } from './constants.js';
+import { ReadOnlyL1TxUtils, isInsufficientFundsRpcError } from './readonly_l1_tx_utils.js';
 import { createDelayer, wrapClientWithDelayer } from './tx_delayer.js';
 import { DroppedTransactionError, L1TxTimeoutError, TerminalTxUtilsState, TxUtilsState, UnknownMinedTxError } from './types.js';
 import { summarizeTransactionReceipt } from './utils.js';
@@ -37,6 +39,10 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
     /** 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;
+    /**
+   * Sender balance and time when a send was last rejected for insufficient funds. Cleared once the balance rises above
+   * the recorded one or the backoff expires.
+   */ insufficientFunds;
     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;
@@ -99,6 +105,41 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             address: this.getSenderAddress().toString()
         });
     }
+    /** Returns the sender balance recorded when a send was last rejected for insufficient funds, if any. */ getInsufficientFundsAtBalance() {
+        return this.insufficientFunds?.balance;
+    }
+    /**
+   * Returns whether this sender should be skipped because a previous send was rejected for insufficient funds and its
+   * balance has not increased since. Clears the mark once the given current balance is above the recorded one, or once
+   * INSUFFICIENT_FUNDS_BACKOFF_MS have elapsed since the rejection: a rejection can come from a send whose gas limit was
+   * far above what later sends need, so a balance that did not move is not proof the publisher cannot afford them.
+   */ isBackedOffForInsufficientFunds(currentBalance) {
+        if (this.insufficientFunds === undefined) {
+            return false;
+        }
+        if (this.hasActiveInsufficientFundsBackoff(currentBalance)) {
+            return true;
+        }
+        const { balance } = this.insufficientFunds;
+        this.logger.info(`Clearing insufficient funds backoff for publisher`, {
+            account: this.getSenderAddress().toString(),
+            balance: currentBalance,
+            insufficientFundsAtBalance: balance,
+            reason: currentBalance > balance ? 'balance-increased' : 'expired'
+        });
+        this.insufficientFunds = undefined;
+        return false;
+    }
+    /**
+   * Same check as {@link isBackedOffForInsufficientFunds}, but without clearing a lifted backoff or logging, so it can be
+   * used for reporting without affecting publisher selection.
+   */ hasActiveInsufficientFundsBackoff(currentBalance) {
+        if (this.insufficientFunds === undefined) {
+            return false;
+        }
+        const { balance, atMs } = this.insufficientFunds;
+        return currentBalance <= balance && this.dateProvider.now() - atMs < INSUFFICIENT_FUNDS_BACKOFF_MS;
+    }
     /**
    * Rehydrates transaction states from the store and resumes monitoring for pending transactions.
    * This should be called on startup to restore state and resume monitoring of any in-flight transactions.
@@ -151,10 +192,14 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
     }
     async signTransaction(txRequest) {
         const signature = await this.signer(txRequest, this.getSenderAddress());
-        return serializeTransaction(txRequest, signature);
+        return serializeSignedTransaction(txRequest, signature);
     }
     async prepareSignedTransaction(txData) {
-        const txRequest = await this.client.prepareTransactionRequest(txData);
+        // Passing the chain id keeps viem from routing a fully specified request through eth_fillTransaction.
+        const txRequest = await this.client.prepareTransactionRequest({
+            chainId: this.client.chain.id,
+            ...txData
+        });
         return await this.signTransaction(txRequest);
     }
     async checkInterruptedOrTimedOut(gasConfig) {
@@ -271,6 +316,9 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
                 state: l1TxState
             };
         } catch (err) {
+            if (isInsufficientFundsRpcError(err) || getErrorCause(err, InsufficientFundsError)) {
+                await this.recordInsufficientFunds();
+            }
             const viemError = formatViemError(err, request.abi);
             this.logger.error(`Failed to send L1 transaction: ${viemError.message}`, viemError, {
                 request: pick(request, 'to', 'value')
@@ -278,6 +326,24 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
             throw viemError;
         }
     }
+    /** Records the current sender balance as one that cannot afford a send, so selection skips it for a while. */ async recordInsufficientFunds() {
+        try {
+            const balance = await this.getSenderBalance();
+            this.insufficientFunds = {
+                balance,
+                atMs: this.dateProvider.now()
+            };
+            this.logger.warn(`L1 send rejected for insufficient funds, backing off publisher until its balance increases`, {
+                account: this.getSenderAddress().toString(),
+                balance,
+                backoffMs: INSUFFICIENT_FUNDS_BACKOFF_MS
+            });
+        } catch (err) {
+            this.logger.warn(`Failed to read balance after an insufficient funds rejection`, {
+                err
+            });
+        }
+    }
     async tryGetTxReceipt(txHashes, nonce, isCancelTx) {
         for (const hash of txHashes){
             try {

package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts

@@ -5,6 +5,13 @@ import { type Abi, type Account, type BlockOverrides, type GetCodeReturnType, ty
 import type { ViemClient } from '../types.js';
 import { type L1TxUtilsConfig } from './config.js';
 import type { FeesPerGas, L1BlobInputs, L1TxRequest, TransactionStats } from './types.js';
+/**
+ * Returns true when an RPC transport error reports the node's upfront funds check
+ * (sender balance >= gasLimit * maxFeePerGas) rejecting the request. Matches on the message as well as on the
+ * error code, since RPC gateways differ in how they wrap node errors. Apply this only to transport errors: an
+ * execution revert string can mention insufficient funds without being this kind of rejection.
+ */
+export declare function isInsufficientFundsRpcError(err: unknown): boolean;
 /** Outcome of simulating a single top-level L1 transaction. */
 export type L1SimulationResult = {
     /** Gas used by the simulated transaction, as reported for the top-level call (not for the enclosing block). */
@@ -87,4 +94,4 @@ export declare class ReadOnlyL1TxUtils {
     }, abi: Abi): Promise<L1SimulationResult>;
     bumpGasLimit(gasLimit: bigint, _gasConfig?: L1TxUtilsConfig): bigint;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhZG9ubHlfbDFfdHhfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sMV90eF91dGlscy9yZWFkb25seV9sMV90eF91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUNyRSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFFdkUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRzVELE9BQU8sRUFDTCxLQUFLLEdBQUcsRUFDUixLQUFLLE9BQU8sRUFFWixLQUFLLGNBQWMsRUFFbkIsS0FBSyxpQkFBaUIsRUFDdEIsS0FBSyxHQUFHLEVBSVIsS0FBSyxhQUFhLEVBS25CLE1BQU0sTUFBTSxDQUFDO0FBR2QsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBbUQsTUFBTSxhQUFhLENBQUM7QUFTcEcsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUF1QjFGLCtEQUErRDtBQUMvRCxNQUFNLE1BQU0sa0JBQWtCLEdBQUc7SUFDL0IsK0dBQStHO0lBQy9HLE9BQU8sRUFBRSxNQUFNLENBQUM7SUFDaEI7Ozs7T0FJRztJQUNILFVBQVUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNwQix5Q0FBeUM7SUFDekMsTUFBTSxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUM7Q0FDdkIsQ0FBQztBQUVGLHFCQUFhLGlCQUFpQjtJQUtuQixNQUFNLEVBQUUsVUFBVTtJQUN6QixTQUFTLENBQUMsTUFBTSxFQUFFLE1BQU07YUFDUixZQUFZLEVBQUUsWUFBWTtJQUUxQyxTQUFTLENBQUMsZ0JBQWdCLEVBQUUsT0FBTztJQVI5QixNQUFN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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhZG9ubHlfbDFfdHhfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sMV90eF91dGlscy9yZWFkb25seV9sMV90eF91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUNyRSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFFdkUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRzVELE9BQU8sRUFDTCxLQUFLLEdBQUcsRUFDUixLQUFLLE9BQU8sRUFFWixLQUFLLGNBQWMsRUFFbkIsS0FBSyxpQkFBaUIsRUFDdEIsS0FBSyxHQUFHLEVBSVIsS0FBSyxhQUFhLEVBS25CLE1BQU0sTUFBTSxDQUFDO0FBR2QsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBbUQsTUFBTSxhQUFhLENBQUM7QUFTcEcsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFTMUY7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsMkJBQTJCLENBQUMsR0FBRyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBTWpFO0FBRUQsK0RBQStEO0FBQy9ELE1BQU0sTUFBTSxrQkFBa0IsR0FBRztJQUMvQiwrR0FBK0c7SUFDL0csT0FBTyxFQUFFLE1BQU0sQ0FBQztJQUNoQjs7OztPQUlHO0lBQ0gsVUFBVSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3BCLHlDQUF5QztJQUN6QyxNQUFNLEVBQUUsS0FBSyxNQUFNLEVBQUUsQ0FBQztDQUN2QixDQUFDO0FBRUYscUJBQWEsaUJBQWlCO0lBS25CLE1BQU0sRUFBRSxVQUFVO0lBQ3pCLFNBQVMsQ0FBQyxNQUFNLEVBQUUs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

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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"}

package/dest/l1_tx_utils/readonly_l1_tx_utils.js

@@ -18,7 +18,7 @@ const CurrentStrategy = P75AllTxsPriorityFeeStrategy;
  * (sender balance >= gasLimit * maxFeePerGas) rejecting the request. Matches on the message as well as on the
  * error code, since RPC gateways differ in how they wrap node errors. Apply this only to transport errors: an
  * execution revert string can mention insufficient funds without being this kind of rejection.
- */ function isInsufficientFundsRpcError(err) {
+ */ export function isInsufficientFundsRpcError(err) {
     if (getL1RpcErrorCode(err) === INSUFFICIENT_FUNDS_RPC_ERROR_CODE) {
         return true;
     }

package/dest/l1_tx_utils/send_cost.d.ts

@@ -0,0 +1,15 @@
+import type { FeesPerGas } from './types.js';
+/** Gas limit and blob count of an L1 send, used to bound the ETH a sender must hold to submit it. */
+export type SendCostRequirement = {
+    /** Gas limit the tx will be sent with. */
+    gasLimit: bigint;
+    /** Number of blobs attached to the tx. */
+    blobCount: number;
+};
+/**
+ * Upper bound on the ETH a send needs up front: `gasLimit * maxFeePerGas + blobCount * GAS_PER_BLOB * maxFeePerBlobGas`.
+ * This is what the node checks against the sender balance before accepting the tx, so a sender holding less than this
+ * gets the tx rejected with an insufficient funds error.
+ */
+export declare function computeSendCost(fees: FeesPerGas, req: SendCostRequirement): bigint;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VuZF9jb3N0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbDFfdHhfdXRpbHMvc2VuZF9jb3N0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUU3QyxxR0FBcUc7QUFDckcsTUFBTSxNQUFNLG1CQUFtQixHQUFHO0lBQ2hDLDBDQUEwQztJQUMxQyxRQUFRLEVBQUUsTUFBTSxDQUFDO0lBQ2pCLDBDQUEwQztJQUMxQyxTQUFTLEVBQUUsTUFBTSxDQUFDO0NBQ25CLENBQUM7QUFFRjs7OztHQUlHO0FBQ0gsd0JBQWdCLGVBQWUsQ0FBQyxJQUFJLEVBQUUsVUFBVSxFQUFFLEdBQUcsRUFBRSxtQkFBbUIsR0FBRyxNQUFNLENBSWxGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"send_cost.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/send_cost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qGAAqG;AACrG,MAAM,MAAM,mBAAmB,GAAG;IAChC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAIlF"}

package/dest/l1_tx_utils/send_cost.js

@@ -0,0 +1,10 @@
+import { GAS_PER_BLOB } from './constants.js';
+/**
+ * Upper bound on the ETH a send needs up front: `gasLimit * maxFeePerGas + blobCount * GAS_PER_BLOB * maxFeePerBlobGas`.
+ * This is what the node checks against the sender balance before accepting the tx, so a sender holding less than this
+ * gets the tx rejected with an insufficient funds error.
+ */ export function computeSendCost(fees, req) {
+    const executionCost = req.gasLimit * fees.maxFeePerGas;
+    const blobCost = BigInt(req.blobCount) * GAS_PER_BLOB * (fees.maxFeePerBlobGas ?? 0n);
+    return executionCost + blobCost;
+}

package/dest/l1_tx_utils/signer.d.ts

@@ -1,4 +1,4 @@
-import { type WalletClient } from 'viem';
+import type { WalletClient } from 'viem';
 import type { SigningCallback } from './types.js';
 export declare function createViemSigner(client: WalletClient): SigningCallback;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2lnbmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbDFfdHhfdXRpbHMvc2lnbmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBZ0MsS0FBSyxZQUFZLEVBQW9CLE1BQU0sTUFBTSxDQUFDO0FBRXpGLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUVsRCx3QkFBZ0IsZ0JBQWdCLENBQUMsTUFBTSxFQUFFLFlBQVksbUJBb0JwRCJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2lnbmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbDFfdHhfdXRpbHMvc2lnbmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUEyQixZQUFZLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFHbEUsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRWxELHdCQUFnQixnQkFBZ0IsQ0FBQyxNQUFNLEVBQUUsWUFBWSxtQkFvQnBEIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/signer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,YAAY,EAAoB,MAAM,MAAM,CAAC;AAEzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,mBAoBpD"}
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/signer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,MAAM,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,mBAoBpD"}

package/dest/l1_tx_utils/signer.js

@@ -1,8 +1,8 @@
-import { parseTransaction } from 'viem';
+import { parseSignedTransaction } from '../blob_tx.js';
 export function createViemSigner(client) {
     const signer = async (tx, _address)=>{
         const signedTx = await client.signTransaction(tx);
-        const parsed = parseTransaction(signedTx);
+        const parsed = parseSignedTransaction(signedTx);
         if (!parsed.r || !parsed.s || parsed.yParity !== 0 && parsed.yParity !== 1) {
             throw new Error('Failed to extract signature from viem signed transaction');
         }

package/dest/l1_tx_utils/tx_delayer.d.ts

@@ -55,4 +55,4 @@ export declare function createDelayer(dateProvider: DateProvider, opts: {
  * The delayer intercepts sendRawTransaction calls and delays them based on the delayer's state.
  */
 export declare function wrapClientWithDelayer<T extends ViemClient>(client: T, delayer: Delayer): T;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfZGVsYXllci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2wxX3R4X3V0aWxzL3R4X2RlbGF5ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFFLEtBQUssY0FBYyxFQUFnQixNQUFNLDRCQUE0QixDQUFDO0FBRTVGLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRWpFLE9BQU8sRUFDTCxLQUFLLE1BQU0sRUFDWCxLQUFLLEdBQUcsRUFVVCxNQUFNLE1BQU0sQ0FBQztBQUVkLE9BQU8sS0FBSyxFQUE0QixVQUFVLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFJeEUsd0JBQWdCLGNBQWMsQ0FBQyxDQUFDLFNBQVMsTUFBTSxFQUM3QyxNQUFNLEVBQUUsQ0FBQyxFQUNULFdBQVcsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUM1QixNQUFNLENBQUMsRUFBRSxNQUFNLEVBQ2YsT0FBTyxDQUFDLEVBQUUsTUFBTSxvQkFpQmpCO0FBRUQsd0JBQWdCLG9CQUFvQixDQUFDLENBQUMsU0FBUyxNQUFNLEVBQ25ELE1BQU0sRUFBRSxDQUFDLEVBQ1QsU0FBUyxFQUFFLE1BQU0sR0FBRyxNQUFNLEVBQzFCLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFDZixPQUFPLENBQUMsRUFBRSxNQUFNLG9CQXdCakI7QUFFRCxzR0FBc0c7QUFDdEcscUJBQWEsT0FBTztJQWNULFlBQVksRUFBRSxZQUFZO0lBYm5DLE9BQU8sQ0FBQyxNQUFNLENBQVM7SUFFaEIsd0JBQXdCLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBYTtJQUN6RCxvQkFBb0IsRUFBRSxNQUFNLENBQUM7SUFDN0IsUUFBUSxFQUNYO1FBQUUsV0FBVyxFQUFFLE1BQU0sQ0FBQztRQUFDLGNBQWMsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEdBQ2hEO1FBQUUsYUFBYSxFQUFFLE1BQU0sQ0FBQztRQUFDLGNBQWMsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEdBQ2xEO1FBQUUsWUFBWSxFQUFFLElBQUksQ0FBQTtLQUFFLEdBQ3RCLFNBQVMsQ0FBYTtJQUNuQixZQUFZLEVBQUUsR0FBRyxFQUFFLENBQU07SUFDekIsWUFBWSxFQUFFLEdBQUcsRUFBRSxDQUFNO0lBRWhDLFlBQ1MsWUFBWSxFQUFFLFlBQVksRUFDakMsSUFBSSxFQUFFO1FBQUUsb0JBQW9CLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FBQTtLQUFFLEVBQy9DLFFBQVEsRUFBRSxjQUFjLEVBSXpCO0lBRUQsd0RBQXdEO0lBQ3hELFNBQVMsSUFBSSxNQUFNLENBRWxCO0lBRUQsc0RBQXNEO0lBQ3RELGVBQWUsb0JBRWQ7SUFFRCxpREFBaUQ7SUFDakQsZUFBZSxJQUFJLEdBQUcsRUFBRSxDQUV2QjtJQUVELDhFQUE4RTtJQUM5RSxxQkFBcUIsQ0FBQyxhQUFhLEVBQUUsTUFBTSxHQUFHLE1BQU0sRUFBRSxjQUFjLENBQUMsRUFBRSxNQUFNLFFBRTVFO0lBRUQsd0VBQXdFO0lBQ3hFLHlCQUF5QixDQUFDLFdBQVcsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUFFLGNBQWMsQ0FBQyxFQUFFLE1BQU0sUUFFOUU7SUFFRCxrREFBa0Q7SUFDbEQsWUFBWSxTQUVYO0lBRUQ7Ozs7T0FJRztJQUNILDJCQUEyQixDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsU0FBUyxRQUV0RDtDQUNGO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQWdCLGFBQWEsQ0FDM0IsWUFBWSxFQUFFLFlBQVksRUFDMUIsSUFBSSxFQUFFO0lBQUUsb0JBQW9CLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FBQTtDQUFFLEVBQy9DLFFBQVEsRUFBRSxjQUFjLEdBQ3ZCLE9BQU8sQ0FFVDtBQWFEOzs7R0FHRztBQUNILHdCQUFnQixxQkFBcUIsQ0FBQyxDQUFDLFNBQVMsVUFBVSxFQUFFLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLE9BQU8sR0FBRyxDQUFDLENBdUgxRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfZGVsYXllci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2wxX3R4X3V0aWxzL3R4X2RlbGF5ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFFLEtBQUssY0FBYyxFQUFnQixNQUFNLDRCQUE0QixDQUFDO0FBRTVGLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBRSxLQUFLLEdBQUcsRUFBbUQsTUFBTSxNQUFNLENBQUM7QUFHOUYsT0FBTyxLQUFLLEVBQTRCLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUl4RSx3QkFBZ0IsY0FBYyxDQUFDLENBQUMsU0FBUyxNQUFNLEVBQzdDLE1BQU0sRUFBRSxDQUFDLEVBQ1QsV0FBVyxFQUFFLE1BQU0sR0FBRyxNQUFNLEVBQzVCLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFDZixPQUFPLENBQUMsRUFBRSxNQUFNLG9CQWlCakI7QUFFRCx3QkFBZ0Isb0JBQW9CLENBQUMsQ0FBQyxTQUFTLE1BQU0sRUFDbkQsTUFBTSxFQUFFLENBQUMsRUFDVCxTQUFTLEVBQUUsTUFBTSxHQUFHLE1BQU0sRUFDMUIsTUFBTSxDQUFDLEVBQUUsTUFBTSxFQUNmLE9BQU8sQ0FBQyxFQUFFLE1BQU0sb0JBd0JqQjtBQUVELHNHQUFzRztBQUN0RyxxQkFBYSxPQUFPO0lBY1QsWUFBWSxFQUFFLFlBQVk7SUFibkMsT0FBTyxDQUFDLE1BQU0sQ0FBUztJQUVoQix3QkFBd0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFhO0lBQ3pELG9CQUFvQixFQUFFLE1BQU0sQ0FBQztJQUM3QixRQUFRLEVBQ1g7UUFBRSxXQUFXLEVBQUUsTUFBTSxDQUFDO1FBQUMsY0FBYyxDQUFDLEVBQUUsTUFBTSxDQUFBO0tBQUUsR0FDaEQ7UUFBRSxhQUFhLEVBQUUsTUFBTSxDQUFDO1FBQUMsY0FBYyxDQUFDLEVBQUUsTUFBTSxDQUFBO0tBQUUsR0FDbEQ7UUFBRSxZQUFZLEVBQUUsSUFBSSxDQUFBO0tBQUUsR0FDdEIsU0FBUyxDQUFhO0lBQ25CLFlBQVksRUFBRSxHQUFHLEVBQUUsQ0FBTTtJQUN6QixZQUFZLEVBQUUsR0FBRyxFQUFFLENBQU07SUFFaEMsWUFDUyxZQUFZLEVBQUUsWUFBWSxFQUNqQyxJQUFJLEVBQUU7UUFBRSxvQkFBb0IsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUFBO0tBQUUsRUFDL0MsUUFBUSxFQUFFLGNBQWMsRUFJekI7SUFFRCx3REFBd0Q7SUFDeEQsU0FBUyxJQUFJLE1BQU0sQ0FFbEI7SUFFRCxzREFBc0Q7SUFDdEQsZUFBZSxvQkFFZDtJQUVELGlEQUFpRDtJQUNqRCxlQUFlLElBQUksR0FBRyxFQUFFLENBRXZCO0lBRUQsOEVBQThFO0lBQzlFLHFCQUFxQixDQUFDLGFBQWEsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUFFLGNBQWMsQ0FBQyxFQUFFLE1BQU0sUUFFNUU7SUFFRCx3RUFBd0U7SUFDeEUseUJBQXlCLENBQUMsV0FBVyxFQUFFLE1BQU0sR0FBRyxNQUFNLEVBQUUsY0FBYyxDQUFDLEVBQUUsTUFBTSxRQUU5RTtJQUVELGtEQUFrRDtJQUNsRCxZQUFZLFNBRVg7SUFFRDs7OztPQUlHO0lBQ0gsMkJBQTJCLENBQUMsT0FBTyxFQUFFLE1BQU0sR0FBRyxTQUFTLFFBRXREO0NBQ0Y7QUFFRDs7O0dBR0c7QUFDSCx3QkFBZ0IsYUFBYSxDQUMzQixZQUFZLEVBQUUsWUFBWSxFQUMxQixJQUFJLEVBQUU7SUFBRSxvQkFBb0IsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUFBO0NBQUUsRUFDL0MsUUFBUSxFQUFFLGNBQWMsR0FDdkIsT0FBTyxDQUVUO0FBV0Q7OztHQUdHO0FBQ0gsd0JBQWdCLHFCQUFxQixDQUFDLENBQUMsU0FBUyxVQUFVLEVBQUUsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsT0FBTyxHQUFHLENBQUMsQ0F1SDFGIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"tx_delayer.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/tx_delayer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EACL,KAAK,MAAM,EACX,KAAK,GAAG,EAUT,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,aAAa,CAAC;AAIxE,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,oBAiBjB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,oBAwBjB;AAED,sGAAsG;AACtG,qBAAa,OAAO;IAcT,YAAY,EAAE,YAAY;IAbnC,OAAO,CAAC,MAAM,CAAS;IAEhB,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAa;IACzD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EACX;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD;QAAE,YAAY,EAAE,IAAI,CAAA;KAAE,GACtB,SAAS,CAAa;IACnB,YAAY,EAAE,GAAG,EAAE,CAAM;IACzB,YAAY,EAAE,GAAG,EAAE,CAAM;IAEhC,YACS,YAAY,EAAE,YAAY,EACjC,IAAI,EAAE;QAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,cAAc,EAIzB;IAED,wDAAwD;IACxD,SAAS,IAAI,MAAM,CAElB;IAED,sDAAsD;IACtD,eAAe,oBAEd;IAED,iDAAiD;IACjD,eAAe,IAAI,GAAG,EAAE,CAEvB;IAED,8EAA8E;IAC9E,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,QAE5E;IAED,wEAAwE;IACxE,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,QAE9E;IAED,kDAAkD;IAClD,YAAY,SAEX;IAED;;;;OAIG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,QAEtD;CACF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE;IAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/C,QAAQ,EAAE,cAAc,GACvB,OAAO,CAET;AAaD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,CAuH1F"}
+{"version":3,"file":"tx_delayer.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/tx_delayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,GAAG,EAAmD,MAAM,MAAM,CAAC;AAG9F,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,aAAa,CAAC;AAIxE,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,oBAiBjB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,oBAwBjB;AAED,sGAAsG;AACtG,qBAAa,OAAO;IAcT,YAAY,EAAE,YAAY;IAbnC,OAAO,CAAC,MAAM,CAAS;IAEhB,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAa;IACzD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EACX;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD;QAAE,YAAY,EAAE,IAAI,CAAA;KAAE,GACtB,SAAS,CAAa;IACnB,YAAY,EAAE,GAAG,EAAE,CAAM;IACzB,YAAY,EAAE,GAAG,EAAE,CAAM;IAEhC,YACS,YAAY,EAAE,YAAY,EACjC,IAAI,EAAE;QAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,cAAc,EAIzB;IAED,wDAAwD;IACxD,SAAS,IAAI,MAAM,CAElB;IAED,sDAAsD;IACtD,eAAe,oBAEd;IAED,iDAAiD;IACjD,eAAe,IAAI,GAAG,EAAE,CAEvB;IAED,8EAA8E;IAC9E,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,QAE5E;IAED,wEAAwE;IACxE,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,QAE9E;IAED,kDAAkD;IAClD,YAAY,SAEX;IAED;;;;OAIG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,QAEtD;CACF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE;IAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/C,QAAQ,EAAE,cAAc,GACvB,OAAO,CAET;AAWD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,CAuH1F"}

package/dest/l1_tx_utils/tx_delayer.js

@@ -1,8 +1,9 @@
 import { omit } from '@aztec-labs/foundation/collection';
+import { inspect } from '@aztec-labs/foundation/inspect';
 import { createLogger } from '@aztec-labs/foundation/log';
 import { retryUntil } from '@aztec-labs/foundation/retry';
-import { inspect } from 'util';
-import { keccak256, parseTransaction, publicActions, recoverTransactionAddress, serializeTransaction, walletActions } from 'viem';
+import { publicActions, walletActions } from 'viem';
+import { computeSignedTransactionHash, parseSignedTransaction, recoverSignedTransactionAddress } from '../blob_tx.js';
 const MAX_WAIT_TIME_SECONDS = 180;
 export function waitUntilBlock(client, blockNumber, logger, timeout) {
     const publicClient = 'getBlockNumber' in client && typeof client.getBlockNumber === 'function' ? client : client.extend(publicActions);
@@ -93,9 +94,7 @@ export function waitUntilL1Timestamp(client, timestamp, logger, timeout) {
 }
 /** Tries to recover the sender address from a serialized signed transaction. */ async function tryRecoverSender(serializedTransaction) {
     try {
-        return await recoverTransactionAddress({
-            serializedTransaction: serializedTransaction
-        });
+        return await recoverSignedTransactionAddress(serializedTransaction);
     } catch  {
         return undefined;
     }
@@ -123,7 +122,7 @@ export function waitUntilL1Timestamp(client, timestamp, logger, timeout) {
                     const waitUntil = delayer.nextWait;
                     delayer.nextWait = undefined;
                     // Compute the tx hash manually so we emulate sendRawTransaction response
-                    txHash = computeTxHash(serializedTransaction);
+                    txHash = computeSignedTransactionHash(serializedTransaction);
                     // Cancel tx outright if instructed
                     if ('indefinitely' in waitUntil && waitUntil.indefinitely) {
                         logger.info(`Cancelling tx ${txHash}`, {
@@ -137,7 +136,7 @@ export function waitUntilL1Timestamp(client, timestamp, logger, timeout) {
                     logger.info(`Delaying tx ${txHash} until ${inspect(waitUntil)}`, {
                         sender,
                         argsLen: args.length,
-                        ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars')
+                        ...omit(parseSignedTransaction(serializedTransaction), 'data', 'sidecars')
                     });
                 } else if (delayer.maxInclusionTimeIntoSlot !== undefined) {
                     // Check if we need to delay txs sent too close to the end of the slot.
@@ -146,10 +145,10 @@ export function waitUntilL1Timestamp(client, timestamp, logger, timeout) {
                     });
                     const { timestamp: lastBlockTimestamp, number } = currentBlock;
                     const now = delayer.dateProvider.now();
-                    txHash = computeTxHash(serializedTransaction);
+                    txHash = computeSignedTransactionHash(serializedTransaction);
                     const logData = {
                         sender,
-                        ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars'),
+                        ...omit(parseSignedTransaction(serializedTransaction), 'data', 'sidecars'),
                         lastBlockTimestamp,
                         now,
                         maxInclusionTimeIntoSlot: delayer.maxInclusionTimeIntoSlot
@@ -204,20 +203,3 @@ export function waitUntilL1Timestamp(client, timestamp, logger, timeout) {
         })) : withRawTx;
     return extended;
 }
-/**
- * Compute the tx hash given the serialized tx. Note that if this is a blob tx, we need to
- * exclude the blobs, commitments, and proofs from the hash.
- */ function computeTxHash(serializedTransaction) {
-    if (serializedTransaction.startsWith('0x03')) {
-        const parsed = parseTransaction(serializedTransaction);
-        if (parsed.blobs || parsed.sidecars) {
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const { blobs, sidecars, ...rest } = parsed;
-            return keccak256(serializeTransaction({
-                type: 'eip4844',
-                ...rest
-            }));
-        }
-    }
-    return keccak256(serializedTransaction);
-}

package/dest/publisher_manager.d.ts

@@ -1,42 +1,156 @@
-import { type LoggerBindings } from '@aztec-labs/foundation/log';
+import { type Logger, type LoggerBindings } from '@aztec-labs/foundation/log';
 import { RunningPromise } from '@aztec-labs/foundation/running-promise';
-import { L1TxUtils } from './l1_tx_utils/index.js';
+import { type FeesPerGas, L1TxUtils, type SendCostRequirement } from './l1_tx_utils/index.js';
 export type PublisherFilter<UtilsType extends L1TxUtils> = (utils: UtilsType) => boolean;
 /** Config accepted by PublisherManager. */
 type PublisherManagerConfig = {
     publisherAllowInvalidStates?: boolean;
     publisherFundingThreshold?: bigint;
     publisherFundingAmount?: bigint;
+    /** Warn when a publisher balance is below this multiple of the ETH required for the reference send. */
+    publisherLowBalanceWarningMultiplier?: number;
 };
+/** A send the periodic balance check prices at current fees, to report whether publishers can afford it. */
+export type ReferenceSend = {
+    /** Short name of the send for logs, such as "proposal" or "epoch proof". */
+    name: string;
+    requirement: SendCostRequirement;
+};
+/** Balances read by a periodic balance check, and how many reference sends each publisher can afford. */
+export type PublisherBalanceSnapshot = {
+    /** Publishers whose balance could be read. */
+    publishers: {
+        address: string;
+        balance: bigint;
+        /**
+         * Number of reference sends the balance covers at current fees, 0 while backed off after an insufficient funds
+         * rejection. Unset without a reference send or if fees could not be read.
+         */
+        sendsAffordable?: number;
+    }[];
+    funder?: {
+        address: string;
+        balance: bigint;
+    };
+    /** ETH needed for the reference send at current fees. Unset without a reference send or if fees could not be read. */
+    required?: bigint;
+};
+/** Metrics emitted by the PublisherManager from its periodic balance check. */
+export interface IPublisherManagerMetrics {
+    /** Records the latest balance snapshot, replacing the previous one. Undefined clears it once the manager stops. */
+    recordBalanceSnapshot(snapshot: PublisherBalanceSnapshot | undefined): void;
+}
+/** Balance snapshot of a publisher considered for an L1 send. */
+export type PublisherBalanceInfo = {
+    address: string;
+    balance: bigint;
+    state: string;
+    /** Balance at which a previous send was rejected for insufficient funds, if the publisher is backed off. */
+    insufficientFundsAtBalance?: bigint;
+};
+/** Thrown when publishers are available but none holds enough ETH to afford the requested L1 send. */
+export declare class NoAffordablePublisherError extends Error {
+    readonly required: bigint;
+    readonly requirement: SendCostRequirement;
+    readonly fees: FeesPerGas;
+    readonly publishers: PublisherBalanceInfo[];
+    constructor(required: bigint, requirement: SendCostRequirement, fees: FeesPerGas, publishers: PublisherBalanceInfo[]);
+    /**
+     * ETH the best funded publisher that is not backed off after an insufficient funds rejection is missing to afford the
+     * send. Undefined if every publisher is backed off.
+     */
+    shortfall(): bigint | undefined;
+    /** Tells the operator which publisher to fund and with how much ETH for the send to become affordable. */
+    describeFunding(): string;
+    /** Structured context for logging. */
+    toLogContext(): {
+        required: bigint;
+        shortfall: bigint | undefined;
+        gasLimit: bigint;
+        blobCount: number;
+        maxFeePerGas: bigint;
+        maxFeePerBlobGas: bigint | undefined;
+        publishers: PublisherBalanceInfo[];
+    };
+    private getRichestNotBackedOff;
+}
 export declare class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
     protected publishers: UtilsType[];
-    private log;
+    private static readonly BALANCE_CHECK_INTERVAL_MS;
+    protected log: Logger;
     private config;
-    private static readonly FUNDING_CHECK_INTERVAL_MS;
     protected funder?: UtilsType;
-    protected readonly fundingPromise?: RunningPromise;
+    protected readonly balanceCheckPromise: RunningPromise;
     private started;
+    private readonly metrics?;
+    private readonly referenceSend?;
+    /** Whether the balance check has run since the last start, so the first one logs a summary of all balances. */
+    private loggedBalanceSummary;
+    /** Last time a balance warning was logged, per publisher address or per kind of warning. */
+    private readonly lastLowBalanceWarningAt;
     constructor(publishers: UtilsType[], config: PublisherManagerConfig, opts?: {
         bindings?: LoggerBindings;
         funder?: UtilsType;
+        metrics?: IPublisherManagerMetrics;
+        /**
+         * Send the balance check prices to report whether publishers can afford it. Without one, balances are still
+         * recorded, but affordability is neither recorded nor warned about.
+         */
+        referenceSend?: ReferenceSend;
     });
     /**
      * Clears any interrupted flag left by a previous {@link stop} so publishing works again after a restart,
-     * loads the state of all publishers and the funder, and starts periodic funding checks. Idempotent: a
-     * start while already started is a no-op, so it never re-runs `loadStateAndResumeMonitoring` (which
-     * would spawn a duplicate background monitor per pending nonce). Lifecycle calls are expected to be
-     * serialized by the caller.
+     * loads the state of all publishers and the funder, and starts the periodic balance check, which also tops up
+     * publishers if funding is configured. Idempotent: a start while already started is a no-op, so it never re-runs
+     * `loadStateAndResumeMonitoring` (which would spawn a duplicate background monitor per pending nonce). Lifecycle
+     * calls are expected to be serialized by the caller.
      */
     start(): Promise<void>;
     /**
-     * Stops the funding loop, interrupts all publishers so no further L1 txs are sent, and waits (bounded)
+     * Stops the balance check loop, interrupts all publishers so no further L1 txs are sent, and waits (bounded)
      * for their in-flight tx monitor loops to wind down. Idempotent, and the manager may be restarted
      * afterwards via {@link start}, which clears the interrupted flag.
      */
     stop(): Promise<void>;
-    getAvailablePublisher(filter?: PublisherFilter<UtilsType>): Promise<UtilsType>;
-    private triggerFundingIfNeeded;
+    /**
+     * Finds and prioritises an available publisher. Candidates must pass the filter and not be busy (unless
+     * `publisherAllowInvalidStates` is set and no idle publisher remains), and are ranked by state (see `stateRank`), then
+     * highest balance, then least recently used. Publishers backed off after an insufficient funds rejection are skipped
+     * until their balance increases or the backoff expires.
+     *
+     * With a `requirement`, only publishers whose balance covers the worst-case cost of that send are eligible, and a
+     * {@link NoAffordablePublisherError} is thrown if there are none. Without one, selection is lenient: it prefers funded
+     * publishers but falls back to unfunded ones rather than failing, for sends that are fine to attempt and lose.
+     */
+    getAvailablePublisher(filter?: PublisherFilter<UtilsType>, opts?: {
+        requirement?: SendCostRequirement;
+    }): Promise<UtilsType>;
+    /**
+     * Reads the balance of every publisher and the funder, prices the reference send at current fees, records metrics,
+     * logs balances that are low or cannot afford the reference send, and tops up publishers below the funding threshold
+     * if funding is configured. Runs once a minute while started.
+     */
+    protected checkBalances(): Promise<void>;
+    private getBalances;
+    private getAffordable;
+    private toBalanceInfo;
+    /**
+     * Prefers publishers that are funded and not backed off after an insufficient funds rejection, but never returns an
+     * empty list: if every candidate is excluded, falls back to the full set so lenient sends still have something to try.
+     */
+    private getLenientCandidates;
+    private tryGetBalance;
+    private tryGetReferenceCost;
+    /**
+     * Logs a summary of all balances on the first check after a start, and an error (at most once per interval) while no
+     * publisher can afford the reference send.
+     */
+    private logBalances;
+    /** Warns at most once per interval for every publisher below the low-balance level. */
+    private warnOnLowBalances;
+    private shouldWarn;
+    private fundIfNeeded;
     private fundPublishers;
 }
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHVibGlzaGVyX21hbmFnZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9wdWJsaXNoZXJfbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQWUsS0FBSyxjQUFjLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFDNUYsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBR3hFLE9BQU8sRUFBRSxTQUFTLEVBQWdCLE1BQU0sd0JBQXdCLENBQUM7QUF3QmpFLE1BQU0sTUFBTSxlQUFlLENBQUMsU0FBUyxTQUFTLFNBQVMsSUFBSSxDQUFDLEtBQUssRUFBRSxTQUFTLEtBQUssT0FBTyxDQUFDO0FBRXpGLDJDQUEyQztBQUMzQyxLQUFLLHNCQUFzQixHQUFHO0lBQzVCLDJCQUEyQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQ3RDLHlCQUF5QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ25DLHNCQUFzQixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pDLENBQUM7QUFFRixxQkFBYSxnQkFBZ0IsQ0FBQyxTQUFTLFNBQVMsU0FBUyxHQUFHLFNBQVM7SUFTakUsU0FBUyxDQUFDLFVBQVUsRUFBRSxTQUFTLEVBQUU7SUFSbkMsT0FBTyxDQUFDLEdBQUcsQ0FBUztJQUNwQixPQUFPLENBQUMsTUFBTSxDQUF5QjtJQUN2QyxPQUFPLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBaUI7SUFDbEUsU0FBUyxDQUFDLE1BQU0sQ0FBQyxFQUFFLFNBQVMsQ0FBQztJQUM3QixTQUFTLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBQyxFQUFFLGNBQWMsQ0FBQztJQUNuRCxPQUFPLENBQUMsT0FBTyxDQUFTO0lBRXhCLFlBQ1ksVUFBVSxFQUFFLFNBQVMsRUFBRSxFQUNqQyxNQUFNLEVBQUUsc0JBQXNCLEVBQzlCLElBQUksQ0FBQyxFQUFFO1FBQUUsUUFBUSxDQUFDLEVBQUUsY0FBYyxDQUFDO1FBQUMsTUFBTSxDQUFDLEVBQUUsU0FBUyxDQUFBO0tBQUUsRUE2QnpEO0lBRUQ7Ozs7OztPQU1HO0lBQ1UsS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FtQmxDO0lBRUQ7Ozs7T0FJRztJQUNVLElBQUksSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBV2pDO0lBUVkscUJBQXFCLENBQUMsTUFBTSxHQUFFLGVBQWUsQ0FBQyxTQUFTLENBQWMsR0FBRyxPQUFPLENBQUMsU0FBUyxDQUFDLENBd0R0RztZQUdhLHNCQUFzQjtZQXFDdEIsY0FBYztDQVU3QiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHVibGlzaGVyX21hbmFnZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9wdWJsaXNoZXJfbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQUUsS0FBSyxjQUFjLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFDNUYsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBSXhFLE9BQU8sRUFDTCxLQUFLLFVBQVUsRUFFZixTQUFTLEVBQ1QsS0FBSyxtQkFBbUIsRUFHekIsTUFBTSx3QkFBd0IsQ0FBQztBQTRCaEMsTUFBTSxNQUFNLGVBQWUsQ0FBQyxTQUFTLFNBQVMsU0FBUyxJQUFJLENBQUMsS0FBSyxFQUFFLFNBQVMsS0FBSyxPQUFPLENBQUM7QUFFekYsMkNBQTJDO0FBQzNDLEtBQUssc0JBQXNCLEdBQUc7SUFDNUIsMkJBQTJCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDdEMseUJBQXlCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDbkMsc0JBQXNCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDaEMsdUdBQXVHO0lBQ3ZHLG9DQUFvQyxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQy9DLENBQUM7QUFFRiw0R0FBNEc7QUFDNUcsTUFBTSxNQUFNLGFBQWEsR0FBRztJQUMxQiw0RUFBNEU7SUFDNUUsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUNiLFdBQVcsRUFBRSxtQkFBbUIsQ0FBQztDQUNsQyxDQUFDO0FBRUYseUdBQXlHO0FBQ3pHLE1BQU0sTUFBTSx3QkFBd0IsR0FBRztJQUNyQyw4Q0FBOEM7SUFDOUMsVUFBVSxFQUFFO1FBQ1YsT0FBTyxFQUFFLE1BQU0sQ0FBQztRQUNoQixPQUFPLEVBQUUsTUFBTSxDQUFDO1FBQ2hCOzs7V0FHRztRQUNILGVBQWUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztLQUMxQixFQUFFLENBQUM7SUFDSixNQUFNLENBQUMsRUFBRTtRQUFF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

package/dest/publisher_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publisher_manager.d.ts","sourceRoot":"","sources":["../src/publisher_manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAGxE,OAAO,EAAE,SAAS,EAAgB,MAAM,wBAAwB,CAAC;AAwBjE,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,SAAS,IAAI,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;AAEzF,2CAA2C;AAC3C,KAAK,sBAAsB,GAAG;IAC5B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,qBAAa,gBAAgB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS;IASjE,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE;IARnC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAiB;IAClE,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC7B,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACnD,OAAO,CAAC,OAAO,CAAS;IAExB,YACY,UAAU,EAAE,SAAS,EAAE,EACjC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,EA6BzD;IAED;;;;;;OAMG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBlC;IAED;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAWjC;IAQY,qBAAqB,CAAC,MAAM,GAAE,eAAe,CAAC,SAAS,CAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAwDtG;YAGa,sBAAsB;YAqCtB,cAAc;CAU7B"}
+{"version":3,"file":"publisher_manager.d.ts","sourceRoot":"","sources":["../src/publisher_manager.ts"],"names":[],"mappings":"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"}