@aztec/ethereum 0.0.1-commit.9ef841308 → 0.0.1-commit.a4600f49

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. package/dest/client.d.ts +17 -3
  2. package/dest/client.d.ts.map +1 -1
  3. package/dest/client.js +49 -3
  4. package/dest/config.d.ts +27 -8
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +59 -12
  7. package/dest/contracts/chain_state_override.d.ts +78 -0
  8. package/dest/contracts/chain_state_override.d.ts.map +1 -0
  9. package/dest/contracts/chain_state_override.js +137 -0
  10. package/dest/contracts/empire_base.d.ts +1 -3
  11. package/dest/contracts/empire_base.d.ts.map +1 -1
  12. package/dest/contracts/fee_asset_price_oracle.d.ts +6 -2
  13. package/dest/contracts/fee_asset_price_oracle.d.ts.map +1 -1
  14. package/dest/contracts/fee_asset_price_oracle.js +11 -6
  15. package/dest/contracts/governance.d.ts +108 -33
  16. package/dest/contracts/governance.d.ts.map +1 -1
  17. package/dest/contracts/governance.js +193 -12
  18. package/dest/contracts/governance_proposer.d.ts +33 -3
  19. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  20. package/dest/contracts/governance_proposer.js +51 -9
  21. package/dest/contracts/gse.d.ts +4 -2
  22. package/dest/contracts/gse.d.ts.map +1 -1
  23. package/dest/contracts/gse.js +2 -2
  24. package/dest/contracts/inbox.d.ts +3 -3
  25. package/dest/contracts/inbox.d.ts.map +1 -1
  26. package/dest/contracts/inbox.js +12 -7
  27. package/dest/contracts/index.d.ts +3 -3
  28. package/dest/contracts/index.d.ts.map +1 -1
  29. package/dest/contracts/index.js +2 -2
  30. package/dest/contracts/multicall.d.ts +82 -14
  31. package/dest/contracts/multicall.d.ts.map +1 -1
  32. package/dest/contracts/multicall.js +119 -95
  33. package/dest/contracts/outbox.d.ts +27 -4
  34. package/dest/contracts/outbox.d.ts.map +1 -1
  35. package/dest/contracts/outbox.js +34 -7
  36. package/dest/contracts/rollup.d.ts +5399 -25
  37. package/dest/contracts/rollup.d.ts.map +1 -1
  38. package/dest/contracts/rollup.js +333 -64
  39. package/dest/contracts/{tally_slashing_proposer.d.ts → slashing_proposer.d.ts} +3 -4
  40. package/dest/contracts/slashing_proposer.d.ts.map +1 -0
  41. package/dest/contracts/{tally_slashing_proposer.js → slashing_proposer.js} +13 -15
  42. package/dest/deploy_aztec_l1_contracts.d.ts +18 -10
  43. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -1
  44. package/dest/deploy_aztec_l1_contracts.js +17 -13
  45. package/dest/l1_artifacts.d.ts +14941 -16273
  46. package/dest/l1_artifacts.d.ts.map +1 -1
  47. package/dest/l1_artifacts.js +9 -24
  48. package/dest/l1_contract_addresses.d.ts +61 -65
  49. package/dest/l1_contract_addresses.d.ts.map +1 -1
  50. package/dest/l1_contract_addresses.js +101 -82
  51. package/dest/l1_reader.d.ts +3 -5
  52. package/dest/l1_reader.d.ts.map +1 -1
  53. package/dest/l1_reader.js +3 -6
  54. package/dest/l1_tx_utils/config.js +3 -3
  55. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +23 -4
  56. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -1
  57. package/dest/l1_tx_utils/l1_fee_analyzer.js +65 -3
  58. package/dest/l1_tx_utils/l1_tx_utils.d.ts +7 -1
  59. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  60. package/dest/l1_tx_utils/l1_tx_utils.js +106 -33
  61. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +1 -1
  62. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  63. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +2 -1
  64. package/dest/l1_tx_utils/tx_delayer.d.ts +5 -3
  65. package/dest/l1_tx_utils/tx_delayer.d.ts.map +1 -1
  66. package/dest/l1_tx_utils/tx_delayer.js +7 -5
  67. package/dest/l1_tx_utils/types.d.ts +27 -1
  68. package/dest/l1_tx_utils/types.d.ts.map +1 -1
  69. package/dest/l1_tx_utils/types.js +10 -0
  70. package/dest/publisher_manager.d.ts +18 -6
  71. package/dest/publisher_manager.d.ts.map +1 -1
  72. package/dest/publisher_manager.js +44 -7
  73. package/dest/queries.d.ts +13 -2
  74. package/dest/queries.d.ts.map +1 -1
  75. package/dest/queries.js +69 -4
  76. package/dest/test/blob_kzg_warmup.d.ts +19 -0
  77. package/dest/test/blob_kzg_warmup.d.ts.map +1 -0
  78. package/dest/test/blob_kzg_warmup.js +64 -0
  79. package/dest/test/chain_monitor.d.ts +34 -2
  80. package/dest/test/chain_monitor.d.ts.map +1 -1
  81. package/dest/test/chain_monitor.js +76 -6
  82. package/dest/test/eth_cheat_codes.d.ts +32 -3
  83. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  84. package/dest/test/eth_cheat_codes.js +83 -37
  85. package/dest/test/index.d.ts +2 -1
  86. package/dest/test/index.d.ts.map +1 -1
  87. package/dest/test/index.js +1 -0
  88. package/dest/test/rollup_cheat_codes.d.ts +60 -3
  89. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  90. package/dest/test/rollup_cheat_codes.js +86 -7
  91. package/dest/utils.d.ts +9 -2
  92. package/dest/utils.d.ts.map +1 -1
  93. package/dest/utils.js +34 -6
  94. package/package.json +6 -7
  95. package/src/client.ts +57 -1
  96. package/src/config.ts +82 -16
  97. package/src/contracts/chain_state_override.ts +200 -0
  98. package/src/contracts/empire_base.ts +0 -2
  99. package/src/contracts/fee_asset_price_oracle.ts +10 -5
  100. package/src/contracts/governance.ts +266 -9
  101. package/src/contracts/governance_proposer.ts +52 -5
  102. package/src/contracts/gse.ts +7 -2
  103. package/src/contracts/inbox.ts +13 -5
  104. package/src/contracts/index.ts +2 -2
  105. package/src/contracts/multicall.ts +183 -106
  106. package/src/contracts/outbox.ts +42 -8
  107. package/src/contracts/rollup.ts +372 -62
  108. package/src/contracts/{tally_slashing_proposer.ts → slashing_proposer.ts} +14 -16
  109. package/src/deploy_aztec_l1_contracts.ts +16 -14
  110. package/src/l1_artifacts.ts +12 -35
  111. package/src/l1_contract_addresses.ts +120 -94
  112. package/src/l1_reader.ts +4 -9
  113. package/src/l1_tx_utils/config.ts +3 -3
  114. package/src/l1_tx_utils/l1_fee_analyzer.ts +75 -3
  115. package/src/l1_tx_utils/l1_tx_utils.ts +99 -35
  116. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +2 -1
  117. package/src/l1_tx_utils/tx_delayer.ts +16 -7
  118. package/src/l1_tx_utils/types.ts +32 -0
  119. package/src/publisher_manager.ts +54 -18
  120. package/src/queries.ts +76 -4
  121. package/src/test/blob_kzg_warmup.ts +65 -0
  122. package/src/test/chain_monitor.ts +93 -5
  123. package/src/test/eth_cheat_codes.ts +76 -41
  124. package/src/test/index.ts +1 -0
  125. package/src/test/rollup_cheat_codes.ts +115 -6
  126. package/src/utils.ts +30 -6
  127. package/dest/contracts/empire_slashing_proposer.d.ts +0 -69
  128. package/dest/contracts/empire_slashing_proposer.d.ts.map +0 -1
  129. package/dest/contracts/empire_slashing_proposer.js +0 -216
  130. package/dest/contracts/tally_slashing_proposer.d.ts.map +0 -1
  131. package/dest/generated/l1-contracts-defaults.d.ts +0 -30
  132. package/dest/generated/l1-contracts-defaults.d.ts.map +0 -1
  133. package/dest/generated/l1-contracts-defaults.js +0 -30
  134. package/src/contracts/empire_slashing_proposer.ts +0 -265
  135. package/src/generated/l1-contracts-defaults.ts +0 -32
@@ -5,7 +5,7 @@ import { InterruptError, TimeoutError } from '@aztec/foundation/error';
5
5
  import { EthAddress } from '@aztec/foundation/eth-address';
6
6
  import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
7
7
  import { Semaphore } from '@aztec/foundation/queue';
8
- import { retryUntil } from '@aztec/foundation/retry';
8
+ import { makeBackoff, retry, retryUntil } from '@aztec/foundation/retry';
9
9
  import { sleep } from '@aztec/foundation/sleep';
10
10
  import { DateProvider } from '@aztec/foundation/timer';
11
11
  import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
@@ -36,6 +36,7 @@ import {
36
36
  type L1TxConfig,
37
37
  type L1TxRequest,
38
38
  type L1TxState,
39
+ L1TxTimeoutError,
39
40
  type SigningCallback,
40
41
  TerminalTxUtilsState,
41
42
  TxUtilsState,
@@ -44,6 +45,11 @@ import {
44
45
 
45
46
  const MAX_L1_TX_STATES = 32;
46
47
 
48
+ // Backoff (in seconds) for retrying the read-only RPC calls that prepare a tx cancellation. A
49
+ // cancellation is fired in the background after a tx times out and is important (it frees the stuck
50
+ // nonce), so a transient RPC failure while reading the pending nonce or gas price must not abandon it.
51
+ const CANCELLATION_PREP_RETRY_BACKOFF_S = [1, 2, 4, 8];
52
+
47
53
  export class L1TxUtils extends ReadOnlyL1TxUtils {
48
54
  protected txs: L1TxState[] = [];
49
55
  /** Last nonce successfully sent to the chain. Used as a lower bound when a fallback RPC node returns a stale count. */
@@ -131,6 +137,14 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
131
137
  );
132
138
  }
133
139
 
140
+ /**
141
+ * Clears the cached `lastSentNonce` so the next `sendTransaction` call fetches the real
142
+ * nonce from the chain. Call this after an L1 reorg to prevent stale nonce references.
143
+ */
144
+ public resetNonce(): void {
145
+ this.lastSentNonce = undefined;
146
+ }
147
+
134
148
  public getSenderAddress() {
135
149
  return this.address;
136
150
  }
@@ -213,6 +227,19 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
213
227
  return await this.signTransaction(txRequest as TransactionSerializable);
214
228
  }
215
229
 
230
+ private async checkInterruptedOrTimedOut(gasConfig: Pick<L1TxConfig, 'txTimeoutAt'>): Promise<Date> {
231
+ if (this.interrupted) {
232
+ throw new InterruptError(`Transaction sending is interrupted`);
233
+ }
234
+ const now = new Date(await this.getL1Timestamp());
235
+ if (gasConfig.txTimeoutAt && now > gasConfig.txTimeoutAt) {
236
+ throw new TimeoutError(
237
+ `Transaction timed out before sending (now ${now.toISOString()} > timeoutAt ${gasConfig.txTimeoutAt.toISOString()})`,
238
+ );
239
+ }
240
+ return now;
241
+ }
242
+
216
243
  /**
217
244
  * Sends a transaction with gas estimation and pricing
218
245
  * @param request - The transaction request (to, data, value)
@@ -225,14 +252,15 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
225
252
  blobInputs?: L1BlobInputs,
226
253
  stateChange: TxUtilsState = TxUtilsState.SENT,
227
254
  ): Promise<{ txHash: Hex; state: L1TxState }> {
228
- if (this.interrupted) {
229
- throw new InterruptError(`Transaction sending is interrupted`);
230
- }
231
-
232
255
  try {
233
256
  const gasConfig = merge(this.config, gasConfigOverrides);
234
257
  const account = this.getSenderAddress().toString();
235
258
 
259
+ // Fail fast before doing any work (gas estimation, balance check) if we've been interrupted
260
+ // or if the caller's deadline has already passed. The same check is repeated after gas
261
+ // estimation in case it took long enough to push us past the deadline.
262
+ await this.checkInterruptedOrTimedOut(gasConfig);
263
+
236
264
  let gasLimit: bigint;
237
265
  if (this.debugMaxGasLimit) {
238
266
  gasLimit = MAX_L1_TX_LIMIT;
@@ -245,16 +273,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
245
273
 
246
274
  const gasPrice = await this.getGasPrice(gasConfig, !!blobInputs);
247
275
 
248
- if (this.interrupted) {
249
- throw new InterruptError(`Transaction sending is interrupted`);
250
- }
251
-
252
- const now = new Date(await this.getL1Timestamp());
253
- if (gasConfig.txTimeoutAt && now > gasConfig.txTimeoutAt) {
254
- throw new TimeoutError(
255
- `Transaction timed out before sending (now ${now.toISOString()} > timeoutAt ${gasConfig.txTimeoutAt.toISOString()})`,
256
- );
257
- }
276
+ const now = await this.checkInterruptedOrTimedOut(gasConfig);
258
277
 
259
278
  let txHash: Hex;
260
279
  let nonce: number;
@@ -281,13 +300,14 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
281
300
  // Create the new state for monitoring
282
301
  const l1TxState: L1TxState = {
283
302
  ...baseState,
284
- id: (await this.store?.consumeNextStateId(account)) ?? Math.max(...this.txs.map(tx => tx.id), 0),
303
+ id: (await this.store?.consumeNextStateId(account)) ?? Math.max(...this.txs.map(tx => tx.id), -1) + 1,
285
304
  txHashes: [txHash],
286
305
  cancelTxHashes: [],
287
306
  status: TxUtilsState.IDLE,
288
307
  txConfigOverrides: gasConfigOverrides ?? {},
289
308
  sentAtL1Ts: now,
290
309
  lastSentAtL1Ts: now,
310
+ gasPriceHistory: [baseState.gasPrice],
291
311
  };
292
312
 
293
313
  // And persist it
@@ -418,10 +438,23 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
418
438
 
419
439
  const initialTxHash = txHashes[0];
420
440
  let currentTxHash = txHashes.at(-1)!;
421
- let l1Timestamp: number;
441
+ let l1Timestamp = 0;
422
442
 
423
443
  while (true) {
424
- l1Timestamp = await this.getL1Timestamp();
444
+ try {
445
+ l1Timestamp = await this.getL1Timestamp();
446
+ } catch (err) {
447
+ // A transient RPC failure here must not abort monitoring with a rejection: callers that
448
+ // fire this loop in the background would surface it as an unhandled rejection (e.g. when a
449
+ // test tears down its L1 node while a monitor iteration is in flight). Exit quietly if we
450
+ // are shutting down, otherwise retry on the next interval.
451
+ if (this.interrupted) {
452
+ break;
453
+ }
454
+ this.logger.error(`Error fetching L1 timestamp while monitoring tx ${currentTxHash}`, err, { nonce, account });
455
+ await sleep(gasConfig.checkIntervalMs!);
456
+ continue;
457
+ }
425
458
 
426
459
  try {
427
460
  const timePassed = l1Timestamp - state.lastSentAtL1Ts.getTime();
@@ -473,6 +506,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
473
506
  if (timePassed >= stallTimeMs && attempts <= maxSpeedUpAttempts) {
474
507
  const newGasPrice = await this.getGasPrice(gasConfig, isBlobTx, attempts, state.gasPrice);
475
508
  state.gasPrice = newGasPrice;
509
+ state.gasPriceHistory?.push(newGasPrice);
476
510
 
477
511
  this.logger.debug(
478
512
  `Tx ${currentTxHash} with nonce ${nonce} from ${account} appears stuck. ` +
@@ -641,8 +675,22 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
641
675
  blobInputs?: L1BlobInputs,
642
676
  ): Promise<{ receipt: TransactionReceipt; state: L1TxState }> {
643
677
  const { state } = await this.sendTransaction(request, gasConfig, blobInputs);
644
- const receipt = await this.monitorTransaction(state);
645
- return { receipt, state };
678
+ try {
679
+ const receipt = await this.monitorTransaction(state);
680
+ return { receipt, state };
681
+ } catch (err) {
682
+ if (err instanceof TimeoutError) {
683
+ // Snapshot the ladder now: the fire-and-forget cancellation mutates state.gasPrice moments later.
684
+ throw new L1TxTimeoutError(err.message, {
685
+ gasPriceHistory: state.gasPriceHistory ? [...state.gasPriceHistory] : undefined,
686
+ finalGasPrice: state.gasPrice,
687
+ attempts: state.txHashes.length,
688
+ nonce: state.nonce,
689
+ gasLimit: state.gasLimit,
690
+ });
691
+ }
692
+ throw err;
693
+ }
646
694
  }
647
695
 
648
696
  public override async simulate(
@@ -693,9 +741,37 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
693
741
  return;
694
742
  }
695
743
 
696
- // Check if the original tx is still pending
697
- const currentNonce = await this.client.getTransactionCount({ address: account, blockTag: 'pending' });
698
- if (currentNonce < nonce) {
744
+ // Resolve the pending nonce and cancellation gas price up front. These are read-only RPC calls, so
745
+ // they are safe to retry; a transient RPC failure here must not permanently abandon the cancellation
746
+ // (which would leave the nonce stuck and the tx state stranded short of CANCELLED). We retry with a
747
+ // real backoff before giving up, unlike getGasPrice's tight internal retry which can be exhausted by
748
+ // a brief node hiccup. The retried block performs no state-changing send, so retrying cannot
749
+ // double-send the cancellation tx.
750
+ const { currentNonce, cancelGasPrice } = await retry(
751
+ async () => {
752
+ const currentNonce = await this.client.getTransactionCount({ address: account, blockTag: 'pending' });
753
+ if (currentNonce >= nonce) {
754
+ // Get gas price with higher priority fee for cancellation
755
+ const cancelGasPrice = await this.getGasPrice(
756
+ {
757
+ ...this.config,
758
+ // Use high bump for cancellation to ensure it replaces the original tx
759
+ priorityFeeRetryBumpPercentage: 150, // 150% bump should be enough to replace any tx
760
+ },
761
+ isBlobTx,
762
+ state.txHashes.length,
763
+ previousGasPrice,
764
+ );
765
+ return { currentNonce, cancelGasPrice };
766
+ }
767
+ return { currentNonce, cancelGasPrice: undefined };
768
+ },
769
+ `Preparing cancellation for L1 tx from account ${account} with nonce ${nonce}`,
770
+ makeBackoff(CANCELLATION_PREP_RETRY_BACKOFF_S),
771
+ this.logger,
772
+ );
773
+
774
+ if (cancelGasPrice === undefined) {
699
775
  this.logger.verbose(
700
776
  `Not sending cancellation for L1 tx from account ${account} with nonce ${nonce} as it is dropped`,
701
777
  { nonce, account, currentNonce },
@@ -704,18 +780,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
704
780
  return;
705
781
  }
706
782
 
707
- // Get gas price with higher priority fee for cancellation
708
- const cancelGasPrice = await this.getGasPrice(
709
- {
710
- ...this.config,
711
- // Use high bump for cancellation to ensure it replaces the original tx
712
- priorityFeeRetryBumpPercentage: 150, // 150% bump should be enough to replace any tx
713
- },
714
- isBlobTx,
715
- state.txHashes.length,
716
- previousGasPrice,
717
- );
718
-
719
783
  const { maxFeePerGas, maxPriorityFeePerGas, maxFeePerBlobGas } = cancelGasPrice;
720
784
  this.logger.verbose(
721
785
  `Attempting to cancel L1 ${isBlobTx ? 'blob' : 'vanilla'} transaction from account ${account} with nonce ${nonce} after time out`,
@@ -3,6 +3,7 @@ import type { EthAddress } from '@aztec/foundation/eth-address';
3
3
  import { type Logger, createLogger } from '@aztec/foundation/log';
4
4
  import { makeBackoff, retry } from '@aztec/foundation/retry';
5
5
  import { DateProvider } from '@aztec/foundation/timer';
6
+ import { getErrorCause } from '@aztec/foundation/types';
6
7
  import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
7
8
 
8
9
  import pickBy from 'lodash.pickby';
@@ -395,7 +396,7 @@ export class ReadOnlyL1TxUtils {
395
396
  this.logger?.debug(`L1 transaction simulation succeeded`, { ...result[0].calls[0] });
396
397
  return { gasUsed: result[0].gasUsed, result: result[0].calls[0].data as `0x${string}` };
397
398
  } catch (err) {
398
- if (err instanceof MethodNotFoundRpcError || err instanceof MethodNotSupportedRpcError) {
399
+ if (getErrorCause(err, MethodNotFoundRpcError) || getErrorCause(err, MethodNotSupportedRpcError)) {
399
400
  if (gasConfig.fallbackGasEstimate) {
400
401
  this.logger?.warn(
401
402
  `Node does not support eth_simulateV1 API. Using fallback gas estimate: ${gasConfig.fallbackGasEstimate}`,
@@ -81,7 +81,11 @@ export class Delayer {
81
81
 
82
82
  public maxInclusionTimeIntoSlot: number | undefined = undefined;
83
83
  public ethereumSlotDuration: bigint;
84
- public nextWait: { l1Timestamp: bigint } | { l1BlockNumber: bigint } | { indefinitely: true } | undefined = undefined;
84
+ public nextWait:
85
+ | { l1Timestamp: bigint; timeoutSeconds?: number }
86
+ | { l1BlockNumber: bigint; timeoutSeconds?: number }
87
+ | { indefinitely: true }
88
+ | undefined = undefined;
85
89
  public sentTxHashes: Hex[] = [];
86
90
  public cancelledTxs: Hex[] = [];
87
91
 
@@ -110,13 +114,13 @@ export class Delayer {
110
114
  }
111
115
 
112
116
  /** Delays the next tx to be sent so it lands on the given L1 block number. */
113
- pauseNextTxUntilBlock(l1BlockNumber: number | bigint) {
114
- this.nextWait = { l1BlockNumber: BigInt(l1BlockNumber) };
117
+ pauseNextTxUntilBlock(l1BlockNumber: number | bigint, timeoutSeconds?: number) {
118
+ this.nextWait = { l1BlockNumber: BigInt(l1BlockNumber), timeoutSeconds };
115
119
  }
116
120
 
117
121
  /** Delays the next tx to be sent so it lands on the given timestamp. */
118
- pauseNextTxUntilTimestamp(l1Timestamp: number | bigint) {
119
- this.nextWait = { l1Timestamp: BigInt(l1Timestamp) };
122
+ pauseNextTxUntilTimestamp(l1Timestamp: number | bigint, timeoutSeconds?: number) {
123
+ this.nextWait = { l1Timestamp: BigInt(l1Timestamp), timeoutSeconds };
120
124
  }
121
125
 
122
126
  /** Delays the next tx to be sent indefinitely. */
@@ -198,9 +202,14 @@ export function wrapClientWithDelayer<T extends ViemClient>(client: T, delayer:
198
202
  // Or wait until the desired block number or timestamp
199
203
  wait =
200
204
  'l1BlockNumber' in waitUntil
201
- ? waitUntilBlock(publicClient, waitUntil.l1BlockNumber - 1n, logger)
205
+ ? waitUntilBlock(publicClient, waitUntil.l1BlockNumber - 1n, logger, waitUntil.timeoutSeconds)
202
206
  : 'l1Timestamp' in waitUntil
203
- ? waitUntilL1Timestamp(publicClient, waitUntil.l1Timestamp - delayer.ethereumSlotDuration, logger)
207
+ ? waitUntilL1Timestamp(
208
+ publicClient,
209
+ waitUntil.l1Timestamp - delayer.ethereumSlotDuration,
210
+ logger,
211
+ waitUntil.timeoutSeconds,
212
+ )
204
213
  : undefined;
205
214
 
206
215
  logger.info(`Delaying tx ${txHash} until ${inspect(waitUntil)}`, {
@@ -1,4 +1,5 @@
1
1
  import type { BlobKzgInstance } from '@aztec/blob-lib/types';
2
+ import { TimeoutError } from '@aztec/foundation/error';
2
3
  import { EthAddress } from '@aztec/foundation/eth-address';
3
4
  import type { ViemTransactionSignature } from '@aztec/foundation/eth-signature';
4
5
 
@@ -55,6 +56,12 @@ export type L1TxState = {
55
56
  cancelTxHashes: Hex[];
56
57
  gasLimit: bigint;
57
58
  gasPrice: GasPrice;
59
+ /**
60
+ * Prices used for each attempt (initial send followed by each speed-up), in order. Always set on
61
+ * newly sent txs; optional because states restored from the state store predate the field.
62
+ * In-memory only — not persisted by the state store.
63
+ */
64
+ gasPriceHistory?: GasPrice[];
58
65
  txConfigOverrides: L1TxConfig;
59
66
  request: L1TxRequest;
60
67
  status: TxUtilsState;
@@ -83,3 +90,28 @@ export class DroppedTransactionError extends Error {
83
90
  this.name = 'DroppedTransactionError';
84
91
  }
85
92
  }
93
+
94
+ /** Snapshot of what a timed-out L1 tx tried to pay, taken when the timeout is raised. */
95
+ export type TimedOutTxState = {
96
+ /** Prices used across the initial send and each speed-up, in order (undefined only for restored states). */
97
+ gasPriceHistory?: GasPrice[];
98
+ /** The last price the tx was sent at before timing out. */
99
+ finalGasPrice: GasPrice;
100
+ /** Number of send attempts (initial + speed-ups). */
101
+ attempts: number;
102
+ nonce: number;
103
+ gasLimit: bigint;
104
+ };
105
+
106
+ /**
107
+ * Thrown by sendAndMonitorTransaction when a tx times out. Subclasses TimeoutError so existing
108
+ * `instanceof TimeoutError` checks keep working, while carrying the gas-price ladder for diagnostics.
109
+ */
110
+ export class L1TxTimeoutError extends TimeoutError {
111
+ constructor(
112
+ message: string,
113
+ public readonly txState: TimedOutTxState,
114
+ ) {
115
+ super(message);
116
+ }
117
+ }
@@ -40,11 +40,12 @@ export class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
40
40
  private log: Logger;
41
41
  private config: PublisherManagerConfig;
42
42
  private static readonly FUNDING_CHECK_INTERVAL_MS = 2 * 60 * 1000;
43
- private funder?: UtilsType;
44
- private fundingPromise?: RunningPromise;
43
+ protected funder?: UtilsType;
44
+ protected readonly fundingPromise?: RunningPromise;
45
+ private started = false;
45
46
 
46
47
  constructor(
47
- private publishers: UtilsType[],
48
+ protected publishers: UtilsType[],
48
49
  config: PublisherManagerConfig,
49
50
  opts?: { bindings?: LoggerBindings; funder?: UtilsType },
50
51
  ) {
@@ -67,34 +68,60 @@ export class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
67
68
  this.funder = undefined;
68
69
  }
69
70
  }
71
+
72
+ if (this.funder && hasThreshold && hasAmount) {
73
+ this.fundingPromise = new RunningPromise(
74
+ () => this.triggerFundingIfNeeded(),
75
+ this.log,
76
+ PublisherManager.FUNDING_CHECK_INTERVAL_MS,
77
+ );
78
+ }
70
79
  }
71
80
 
72
- /** Loads the state of all publishers and the funder, and starts periodic funding checks. */
81
+ /**
82
+ * Clears any interrupted flag left by a previous {@link stop} so publishing works again after a restart,
83
+ * loads the state of all publishers and the funder, and starts periodic funding checks. Idempotent: a
84
+ * start while already started is a no-op, so it never re-runs `loadStateAndResumeMonitoring` (which
85
+ * would spawn a duplicate background monitor per pending nonce). Lifecycle calls are expected to be
86
+ * serialized by the caller.
87
+ */
73
88
  public async start(): Promise<void> {
89
+ if (this.started) {
90
+ this.log.debug('PublisherManager already started, ignoring start');
91
+ return;
92
+ }
93
+
94
+ // Clear the interrupted flag set by a previous stop() so a restarted manager can publish again.
95
+ // On a first start this is a no-op (the flag is already clear).
96
+ this.publishers.forEach(pub => pub.restart());
97
+ this.funder?.restart();
98
+
74
99
  await Promise.all([
75
100
  ...this.publishers.map(pub => pub.loadStateAndResumeMonitoring()),
76
101
  this.funder?.loadStateAndResumeMonitoring(),
77
102
  ]);
78
103
 
79
- if (
80
- this.funder &&
81
- this.config.publisherFundingThreshold !== undefined &&
82
- this.config.publisherFundingAmount !== undefined
83
- ) {
84
- this.fundingPromise = new RunningPromise(
85
- () => this.triggerFundingIfNeeded(),
86
- this.log,
87
- PublisherManager.FUNDING_CHECK_INTERVAL_MS,
88
- );
89
- this.fundingPromise.start();
90
- }
104
+ this.fundingPromise?.start();
105
+ // Marked started only once fully up, so a start that failed to load state can be retried.
106
+ this.started = true;
91
107
  }
92
108
 
93
- /** Stops the funding loop and interrupts all publishers. */
109
+ /**
110
+ * Stops the funding loop, interrupts all publishers so no further L1 txs are sent, and waits (bounded)
111
+ * for their in-flight tx monitor loops to wind down. Idempotent, and the manager may be restarted
112
+ * afterwards via {@link start}, which clears the interrupted flag.
113
+ */
94
114
  public async stop(): Promise<void> {
115
+ this.started = false;
95
116
  await this.fundingPromise?.stop();
96
117
  this.publishers.forEach(pub => pub.interrupt());
97
118
  this.funder?.interrupt();
119
+ // Wait for in-flight tx monitor loops to observe the interrupt, so no L1 requests are still
120
+ // being issued after shutdown (e.g. against an anvil instance a test is about to tear down).
121
+ await Promise.all([
122
+ ...this.publishers.map(pub => pub.waitMonitoringStopped()),
123
+ this.funder?.waitMonitoringStopped(),
124
+ ]);
98
125
  }
99
126
 
100
127
  // Finds and prioritises available publishers based on
@@ -133,8 +160,17 @@ export class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
133
160
  }),
134
161
  );
135
162
 
163
+ // Discount unfunded publishers: a publisher with no ETH cannot send a tx, so it must never win
164
+ // selection regardless of how favourable its state or last-used time is. Fall back to the full
165
+ // set only if every candidate is unfunded, so behaviour is no worse than before.
166
+ let fundedPublishers = publishersWithBalance.filter(p => p.balance > 0n);
167
+ if (fundedPublishers.length === 0) {
168
+ this.log.warn(`All candidate publishers have zero balance; selecting from unfunded publishers.`);
169
+ fundedPublishers = publishersWithBalance;
170
+ }
171
+
136
172
  // Sort based on state, then balance, then time since last use
137
- const sortedPublishers = publishersWithBalance.sort((a, b) => {
173
+ const sortedPublishers = fundedPublishers.sort((a, b) => {
138
174
  const stateComparison = sortOrder.indexOf(a.publisher.state) - sortOrder.indexOf(b.publisher.state);
139
175
  if (stateComparison !== 0) {
140
176
  return stateComparison;
package/src/queries.ts CHANGED
@@ -1,11 +1,77 @@
1
1
  import { EthAddress } from '@aztec/foundation/eth-address';
2
2
 
3
+ import { BaseError, type Block } from 'viem';
4
+
3
5
  import { DefaultL1ContractsConfig, type L1ContractsConfig } from './config.js';
4
6
  import { ReadOnlyGovernanceContract } from './contracts/governance.js';
5
7
  import { GovernanceProposerContract } from './contracts/governance_proposer.js';
6
8
  import { InboxContract } from './contracts/inbox.js';
7
9
  import { RollupContract } from './contracts/rollup.js';
8
- import type { ViemPublicClient } from './types.js';
10
+ import type { ViemClient, ViemPublicClient } from './types.js';
11
+
12
+ /**
13
+ * Returns the L1 finalized block, or `undefined` if the chain does not yet have one
14
+ * (common on freshly started devnets). Rethrows any other RPC error.
15
+ */
16
+ export async function getFinalizedL1Block(client: ViemClient): Promise<Block<bigint, false, 'finalized'> | undefined> {
17
+ try {
18
+ return await client.getBlock({ blockTag: 'finalized', includeTransactions: false });
19
+ } catch (err) {
20
+ if (isFinalizedBlockTagNotFoundError(err)) {
21
+ return undefined;
22
+ }
23
+ throw err;
24
+ }
25
+ }
26
+
27
+ // Error messages returned by popular Ethereum execution clients when
28
+ // eth_getBlockByNumber / eth_call is called with blockTag "finalized" or
29
+ // "safe" and no such block has been produced yet:
30
+ //
31
+ // geth "finalized block not found"
32
+ // "safe block not found"
33
+ // reth "block not found: finalized"
34
+ // "block not found: safe"
35
+ // nethermind "Unknown block error" (same for both tags)
36
+ // besu "Unknown block"
37
+ // erigon 'block "finalized" not available (head block: N)'
38
+ // 'block "safe" not available (head block: N)'
39
+ //
40
+ // A combined regex covers all five:
41
+ const FINALIZED_BLOCK_TAG_NOT_FOUND_MESSAGE_RE =
42
+ /(finalized|safe) block not found|block not found: (finalized|safe)|unknown block|block "(finalized|safe)" not available/i;
43
+
44
+ /**
45
+ * Returns true if the error originates from an RPC call that failed because
46
+ * the "finalized" (or "safe") block tag is not yet available on the chain.
47
+ */
48
+ export function isFinalizedBlockTagNotFoundError(err: unknown): boolean {
49
+ if (!err) {
50
+ return false;
51
+ }
52
+
53
+ if (err instanceof BaseError) {
54
+ const hit = err.walk((e: any) => matchesFinalizedBlockTagNotFound(e));
55
+ if (hit) {
56
+ return true;
57
+ }
58
+ }
59
+
60
+ for (let cur: any = err, i = 0; cur && i < 10; cur = cur.cause, i++) {
61
+ if (matchesFinalizedBlockTagNotFound(cur)) {
62
+ return true;
63
+ }
64
+ }
65
+ return false;
66
+ }
67
+
68
+ function matchesFinalizedBlockTagNotFound(e: any): boolean {
69
+ if (!e) {
70
+ return false;
71
+ }
72
+ const text = `${e.details ?? ''} ${e.message ?? ''} ${e.shortMessage ?? ''}`;
73
+ return FINALIZED_BLOCK_TAG_NOT_FOUND_MESSAGE_RE.test(text);
74
+ }
9
75
 
10
76
  /** Reads the L1ContractsConfig from L1 contracts. */
11
77
  export async function getL1ContractsConfig(
@@ -76,8 +142,8 @@ export async function getL1ContractsConfig(
76
142
  slasherProposer?.getRoundSize() ?? 0n,
77
143
  slasherProposer?.getLifetimeInRounds() ?? 0n,
78
144
  slasherProposer?.getExecutionDelayInRounds() ?? 0n,
79
- slasherProposer?.type === 'tally' ? slasherProposer.getSlashOffsetInRounds() : 0n,
80
- slasherProposer?.type === 'tally' ? slasherProposer.getSlashingAmounts() : [0n, 0n, 0n],
145
+ slasherProposer?.getSlashOffsetInRounds() ?? 0n,
146
+ slasherProposer?.getSlashingAmounts() ?? [0n, 0n, 0n],
81
147
  slasher?.getVetoer() ?? EthAddress.ZERO,
82
148
  slasher?.getSlashingDisableDuration() ?? 0,
83
149
  rollup.getManaTarget(),
@@ -114,11 +180,17 @@ export async function getL1ContractsConfig(
114
180
  rollupVersion: Number(rollupVersion),
115
181
  genesisArchiveTreeRoot: genesisArchiveTreeRoot.toString(),
116
182
  exitDelaySeconds: Number(exitDelay),
117
- slasherFlavor: slasherProposer?.type ?? 'tally',
183
+ slasherEnabled: !!slasherProposer,
118
184
  slashingOffsetInRounds: Number(slashingOffsetInRounds),
119
185
  slashAmountSmall: slashingAmounts[0],
120
186
  slashAmountMedium: slashingAmounts[1],
121
187
  slashAmountLarge: slashingAmounts[2],
122
188
  initialEthPerFeeAsset: DefaultL1ContractsConfig.initialEthPerFeeAsset,
189
+ // Not exposed by the rollup contract; fall back to defaults like the other non-on-chain fields above.
190
+ entryQueueBootstrapValidatorSetSize: DefaultL1ContractsConfig.entryQueueBootstrapValidatorSetSize,
191
+ entryQueueBootstrapFlushSize: DefaultL1ContractsConfig.entryQueueBootstrapFlushSize,
192
+ entryQueueFlushSizeMin: DefaultL1ContractsConfig.entryQueueFlushSizeMin,
193
+ entryQueueFlushSizeQuotient: DefaultL1ContractsConfig.entryQueueFlushSizeQuotient,
194
+ entryQueueMaxFlushSize: DefaultL1ContractsConfig.entryQueueMaxFlushSize,
123
195
  };
124
196
  }
@@ -0,0 +1,65 @@
1
+ import { getBytesPerBlob, getBytesPerCommitment, getKzg } from '@aztec/blob-lib';
2
+ import type { Logger } from '@aztec/foundation/log';
3
+
4
+ import type { ExtendedViemWalletClient } from '../types.js';
5
+
6
+ /**
7
+ * Warms both KZG trusted setups in parallel for tests against a local anvil:
8
+ * - anvil's own setup, loaded lazily when it first validates a blob sidecar in `eth_sendRawTransaction`
9
+ * - our `@crate-crypto/node-eth-kzg` singleton (`getKzg()`, a ~2.2s synchronous precomp build)
10
+ *
11
+ * Without this, the first checkpoint publish pays both serially (~4.4s). The recipe does all RPC round
12
+ * trips up front, fires a single bare raw send carrying a fake (garbage) blob sidecar that anvil rejects
13
+ * after loading its trusted setup, yields once to flush the socket write, then synchronously builds our
14
+ * own precomp tables while anvil warms in parallel. The fake tx is rejected at admission, so it never
15
+ * enters the pool, mines no block, and burns no nonce — sending it from the passed client is harmless.
16
+ *
17
+ * Best-effort: any failure is debug-logged and swallowed, leaving lazy init as the fallback. Never throws.
18
+ *
19
+ * @param l1Client - The L1 client whose account sends the (rejected) warm-up blob tx.
20
+ */
21
+ export async function warmBlobKzg(l1Client: ExtendedViemWalletClient, logger?: Logger): Promise<void> {
22
+ try {
23
+ // A pure-JS fake kzg: returns deterministic garbage of the correct lengths (commitment and proof are
24
+ // both 48 bytes). It makes viem build a syntactically valid sidecar without initializing any native
25
+ // module, so anvil loads its trusted setup to validate the (invalid) proof and then rejects the tx.
26
+ const fakeKzg = {
27
+ blobToKzgCommitment: () => {
28
+ const commitment = new Uint8Array(getBytesPerCommitment());
29
+ commitment.fill(0xab);
30
+ commitment[0] = 0xc0;
31
+ return commitment;
32
+ },
33
+ computeBlobKzgProof: () => {
34
+ const proof = new Uint8Array(getBytesPerCommitment());
35
+ proof.fill(0xcd);
36
+ proof[0] = 0xc0;
37
+ return proof;
38
+ },
39
+ };
40
+
41
+ // All RPC round trips (nonce, fees, gas) happen here, so only a single socket write remains to flush.
42
+ const prepared = await l1Client.prepareTransactionRequest({
43
+ blobs: [new Uint8Array(getBytesPerBlob())],
44
+ kzg: fakeKzg,
45
+ to: '0x0000000000000000000000000000000000000000',
46
+ value: 0n,
47
+ maxFeePerBlobGas: 1_000_000_000_000n,
48
+ });
49
+ const serialized = await l1Client.signTransaction(prepared);
50
+
51
+ // Fire the raw send without awaiting and swallow the expected rejection.
52
+ const sent = l1Client.request({ method: 'eth_sendRawTransaction', params: [serialized] }).catch(() => {});
53
+
54
+ // Flush the single socket write so anvil receives the tx and starts loading its trusted setup in its
55
+ // own process before we block the event loop below.
56
+ await new Promise(resolve => setImmediate(resolve));
57
+
58
+ // Synchronously build our precomp tables (~2.2s, event-loop-blocking); anvil warms in parallel.
59
+ getKzg();
60
+
61
+ await sent;
62
+ } catch (err) {
63
+ logger?.debug('Failed to warm blob KZG; falling back to lazy init', { err });
64
+ }
65
+ }