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

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 (226) hide show
  1. package/dest/account.d.ts +1 -1
  2. package/dest/chain.d.ts +1 -1
  3. package/dest/client.d.ts +1 -1
  4. package/dest/client.js +6 -2
  5. package/dest/config.d.ts +22 -68
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +61 -380
  8. package/dest/constants.d.ts +1 -1
  9. package/dest/contracts/empire_base.d.ts +9 -5
  10. package/dest/contracts/empire_base.d.ts.map +1 -1
  11. package/dest/contracts/empire_base.js +1 -1
  12. package/dest/contracts/empire_slashing_proposer.d.ts +8 -4
  13. package/dest/contracts/empire_slashing_proposer.d.ts.map +1 -1
  14. package/dest/contracts/empire_slashing_proposer.js +39 -17
  15. package/dest/contracts/errors.d.ts +1 -1
  16. package/dest/contracts/errors.d.ts.map +1 -1
  17. package/dest/contracts/fee_asset_handler.d.ts +6 -5
  18. package/dest/contracts/fee_asset_handler.d.ts.map +1 -1
  19. package/dest/contracts/fee_asset_handler.js +11 -9
  20. package/dest/contracts/fee_asset_price_oracle.d.ts +101 -0
  21. package/dest/contracts/fee_asset_price_oracle.d.ts.map +1 -0
  22. package/dest/contracts/fee_asset_price_oracle.js +651 -0
  23. package/dest/contracts/fee_juice.d.ts +1 -1
  24. package/dest/contracts/fee_juice.d.ts.map +1 -1
  25. package/dest/contracts/governance.d.ts +18 -16
  26. package/dest/contracts/governance.d.ts.map +1 -1
  27. package/dest/contracts/governance.js +14 -4
  28. package/dest/contracts/governance_proposer.d.ts +8 -4
  29. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  30. package/dest/contracts/governance_proposer.js +412 -11
  31. package/dest/contracts/gse.d.ts +1 -1
  32. package/dest/contracts/gse.d.ts.map +1 -1
  33. package/dest/contracts/inbox.d.ts +24 -3
  34. package/dest/contracts/inbox.d.ts.map +1 -1
  35. package/dest/contracts/inbox.js +36 -1
  36. package/dest/contracts/index.d.ts +4 -1
  37. package/dest/contracts/index.d.ts.map +1 -1
  38. package/dest/contracts/index.js +3 -0
  39. package/dest/contracts/log.d.ts +13 -0
  40. package/dest/contracts/log.d.ts.map +1 -0
  41. package/dest/contracts/log.js +1 -0
  42. package/dest/contracts/multicall.d.ts +2 -2
  43. package/dest/contracts/multicall.d.ts.map +1 -1
  44. package/dest/contracts/multicall.js +2 -1
  45. package/dest/contracts/outbox.d.ts +41 -0
  46. package/dest/contracts/outbox.d.ts.map +1 -0
  47. package/dest/contracts/outbox.js +86 -0
  48. package/dest/contracts/registry.d.ts +1 -1
  49. package/dest/contracts/registry.d.ts.map +1 -1
  50. package/dest/contracts/rollup.d.ts +195 -123
  51. package/dest/contracts/rollup.d.ts.map +1 -1
  52. package/dest/contracts/rollup.js +765 -187
  53. package/dest/contracts/slasher_contract.d.ts +1 -1
  54. package/dest/contracts/slasher_contract.d.ts.map +1 -1
  55. package/dest/contracts/tally_slashing_proposer.d.ts +9 -7
  56. package/dest/contracts/tally_slashing_proposer.d.ts.map +1 -1
  57. package/dest/contracts/tally_slashing_proposer.js +11 -4
  58. package/dest/contracts/utils.d.ts +1 -1
  59. package/dest/deploy_aztec_l1_contracts.d.ts +259 -0
  60. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -0
  61. package/dest/deploy_aztec_l1_contracts.js +413 -0
  62. package/dest/deploy_l1_contract.d.ts +68 -0
  63. package/dest/deploy_l1_contract.d.ts.map +1 -0
  64. package/dest/deploy_l1_contract.js +312 -0
  65. package/dest/eth-signer/eth-signer.d.ts +1 -1
  66. package/dest/eth-signer/index.d.ts +1 -1
  67. package/dest/forwarder_proxy.d.ts +32 -0
  68. package/dest/forwarder_proxy.d.ts.map +1 -0
  69. package/dest/forwarder_proxy.js +93 -0
  70. package/dest/generated/l1-contracts-defaults.d.ts +30 -0
  71. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  72. package/dest/generated/l1-contracts-defaults.js +30 -0
  73. package/dest/l1_artifacts.d.ts +7608 -2048
  74. package/dest/l1_artifacts.d.ts.map +1 -1
  75. package/dest/l1_contract_addresses.d.ts +3 -3
  76. package/dest/l1_contract_addresses.d.ts.map +1 -1
  77. package/dest/l1_contract_addresses.js +3 -3
  78. package/dest/l1_reader.d.ts +3 -1
  79. package/dest/l1_reader.d.ts.map +1 -1
  80. package/dest/l1_reader.js +6 -0
  81. package/dest/l1_tx_utils/config.d.ts +11 -5
  82. package/dest/l1_tx_utils/config.d.ts.map +1 -1
  83. package/dest/l1_tx_utils/config.js +43 -7
  84. package/dest/l1_tx_utils/constants.d.ts +8 -2
  85. package/dest/l1_tx_utils/constants.d.ts.map +1 -1
  86. package/dest/l1_tx_utils/constants.js +27 -2
  87. package/dest/l1_tx_utils/factory.d.ts +18 -10
  88. package/dest/l1_tx_utils/factory.d.ts.map +1 -1
  89. package/dest/l1_tx_utils/factory.js +17 -7
  90. package/dest/l1_tx_utils/fee-strategies/index.d.ts +10 -0
  91. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -0
  92. package/dest/l1_tx_utils/fee-strategies/index.js +12 -0
  93. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +8 -0
  94. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -0
  95. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +129 -0
  96. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +23 -0
  97. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -0
  98. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +191 -0
  99. package/dest/l1_tx_utils/fee-strategies/types.d.ts +51 -0
  100. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -0
  101. package/dest/l1_tx_utils/fee-strategies/types.js +3 -0
  102. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +41 -0
  103. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -0
  104. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +42 -0
  105. package/dest/l1_tx_utils/index-blobs.d.ts +3 -0
  106. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -0
  107. package/dest/l1_tx_utils/index-blobs.js +2 -0
  108. package/dest/l1_tx_utils/index.d.ts +4 -1
  109. package/dest/l1_tx_utils/index.d.ts.map +1 -1
  110. package/dest/l1_tx_utils/index.js +3 -0
  111. package/dest/l1_tx_utils/interfaces.d.ts +2 -2
  112. package/dest/l1_tx_utils/interfaces.d.ts.map +1 -1
  113. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +233 -0
  114. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -0
  115. package/dest/l1_tx_utils/l1_fee_analyzer.js +506 -0
  116. package/dest/l1_tx_utils/l1_tx_utils.d.ts +16 -8
  117. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  118. package/dest/l1_tx_utils/l1_tx_utils.js +64 -46
  119. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +19 -30
  120. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  121. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +55 -163
  122. package/dest/l1_tx_utils/signer.d.ts +1 -1
  123. package/dest/l1_tx_utils/tx_delayer.d.ts +56 -0
  124. package/dest/l1_tx_utils/tx_delayer.d.ts.map +1 -0
  125. package/dest/{test → l1_tx_utils}/tx_delayer.js +65 -36
  126. package/dest/l1_tx_utils/types.d.ts +1 -1
  127. package/dest/l1_tx_utils/types.d.ts.map +1 -1
  128. package/dest/l1_tx_utils/utils.d.ts +1 -1
  129. package/dest/l1_types.d.ts +1 -1
  130. package/dest/publisher_manager.d.ts +3 -2
  131. package/dest/publisher_manager.d.ts.map +1 -1
  132. package/dest/publisher_manager.js +2 -2
  133. package/dest/queries.d.ts +2 -2
  134. package/dest/queries.d.ts.map +1 -1
  135. package/dest/queries.js +16 -6
  136. package/dest/test/chain_monitor.d.ts +27 -24
  137. package/dest/test/chain_monitor.d.ts.map +1 -1
  138. package/dest/test/chain_monitor.js +33 -36
  139. package/dest/test/eth_cheat_codes.d.ts +11 -3
  140. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  141. package/dest/test/eth_cheat_codes.js +11 -3
  142. package/dest/test/eth_cheat_codes_with_state.d.ts +1 -1
  143. package/dest/test/eth_cheat_codes_with_state.d.ts.map +1 -1
  144. package/dest/test/index.d.ts +1 -3
  145. package/dest/test/index.d.ts.map +1 -1
  146. package/dest/test/index.js +0 -2
  147. package/dest/test/rollup_cheat_codes.d.ts +17 -13
  148. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  149. package/dest/test/rollup_cheat_codes.js +62 -38
  150. package/dest/test/start_anvil.d.ts +11 -2
  151. package/dest/test/start_anvil.d.ts.map +1 -1
  152. package/dest/test/start_anvil.js +128 -28
  153. package/dest/test/upgrade_utils.d.ts +1 -1
  154. package/dest/test/upgrade_utils.js +2 -2
  155. package/dest/types.d.ts +57 -2
  156. package/dest/types.d.ts.map +1 -1
  157. package/dest/utils.d.ts +16 -3
  158. package/dest/utils.d.ts.map +1 -1
  159. package/dest/utils.js +64 -0
  160. package/dest/zkPassportVerifierAddress.d.ts +1 -1
  161. package/package.json +34 -16
  162. package/src/client.ts +2 -2
  163. package/src/config.ts +74 -460
  164. package/src/contracts/README.md +157 -0
  165. package/src/contracts/empire_base.ts +8 -5
  166. package/src/contracts/empire_slashing_proposer.ts +38 -32
  167. package/src/contracts/fee_asset_handler.ts +10 -7
  168. package/src/contracts/fee_asset_price_oracle.ts +280 -0
  169. package/src/contracts/governance.ts +13 -4
  170. package/src/contracts/governance_proposer.ts +26 -6
  171. package/src/contracts/inbox.ts +55 -3
  172. package/src/contracts/index.ts +3 -0
  173. package/src/contracts/log.ts +13 -0
  174. package/src/contracts/multicall.ts +5 -2
  175. package/src/contracts/outbox.ts +98 -0
  176. package/src/contracts/rollup.ts +446 -167
  177. package/src/contracts/tally_slashing_proposer.ts +15 -8
  178. package/src/deploy_aztec_l1_contracts.ts +650 -0
  179. package/src/deploy_l1_contract.ts +362 -0
  180. package/src/forwarder_proxy.ts +108 -0
  181. package/src/generated/l1-contracts-defaults.ts +32 -0
  182. package/src/l1_contract_addresses.ts +22 -20
  183. package/src/l1_reader.ts +8 -0
  184. package/src/l1_tx_utils/config.ts +52 -11
  185. package/src/l1_tx_utils/constants.ts +13 -2
  186. package/src/l1_tx_utils/factory.ts +31 -31
  187. package/src/l1_tx_utils/fee-strategies/index.ts +22 -0
  188. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +163 -0
  189. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +245 -0
  190. package/src/l1_tx_utils/fee-strategies/types.ts +56 -0
  191. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +108 -0
  192. package/src/l1_tx_utils/index-blobs.ts +2 -0
  193. package/src/l1_tx_utils/index.ts +3 -0
  194. package/src/l1_tx_utils/interfaces.ts +1 -1
  195. package/src/l1_tx_utils/l1_fee_analyzer.ts +803 -0
  196. package/src/l1_tx_utils/l1_tx_utils.ts +71 -36
  197. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +69 -209
  198. package/src/{test → l1_tx_utils}/tx_delayer.ts +82 -52
  199. package/src/publisher_manager.ts +4 -2
  200. package/src/queries.ts +17 -6
  201. package/src/test/chain_monitor.ts +51 -49
  202. package/src/test/eth_cheat_codes.ts +9 -3
  203. package/src/test/index.ts +0 -2
  204. package/src/test/rollup_cheat_codes.ts +63 -43
  205. package/src/test/start_anvil.ts +148 -27
  206. package/src/test/upgrade_utils.ts +2 -2
  207. package/src/types.ts +62 -0
  208. package/src/utils.ts +83 -1
  209. package/dest/deploy_l1_contracts.d.ts +0 -226
  210. package/dest/deploy_l1_contracts.d.ts.map +0 -1
  211. package/dest/deploy_l1_contracts.js +0 -1473
  212. package/dest/index.d.ts +0 -18
  213. package/dest/index.d.ts.map +0 -1
  214. package/dest/index.js +0 -17
  215. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts +0 -26
  216. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts.map +0 -1
  217. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.js +0 -26
  218. package/dest/test/delayed_tx_utils.d.ts +0 -13
  219. package/dest/test/delayed_tx_utils.d.ts.map +0 -1
  220. package/dest/test/delayed_tx_utils.js +0 -28
  221. package/dest/test/tx_delayer.d.ts +0 -36
  222. package/dest/test/tx_delayer.d.ts.map +0 -1
  223. package/src/deploy_l1_contracts.ts +0 -1849
  224. package/src/index.ts +0 -17
  225. package/src/l1_tx_utils/l1_tx_utils_with_blobs.ts +0 -77
  226. package/src/test/delayed_tx_utils.ts +0 -52
@@ -1,8 +1,9 @@
1
+ import type { BlobKzgInstance } from '@aztec/blob-lib/types';
1
2
  import { maxBigint } from '@aztec/foundation/bigint';
2
3
  import { merge, pick } from '@aztec/foundation/collection';
3
4
  import { InterruptError, TimeoutError } from '@aztec/foundation/error';
4
5
  import { EthAddress } from '@aztec/foundation/eth-address';
5
- import { type Logger, createLogger } from '@aztec/foundation/log';
6
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
6
7
  import { retryUntil } from '@aztec/foundation/retry';
7
8
  import { sleep } from '@aztec/foundation/sleep';
8
9
  import { DateProvider } from '@aztec/foundation/timer';
@@ -13,23 +14,21 @@ import {
13
14
  type Abi,
14
15
  type BlockOverrides,
15
16
  type Hex,
16
- type NonceManager,
17
17
  type PrepareTransactionRequestRequest,
18
18
  type StateOverride,
19
19
  type TransactionReceipt,
20
20
  type TransactionSerializable,
21
- createNonceManager,
22
21
  formatGwei,
23
22
  serializeTransaction,
24
23
  } from 'viem';
25
- import { jsonRpc } from 'viem/nonce';
26
24
 
27
25
  import type { ViemClient } from '../types.js';
28
26
  import { formatViemError } from '../utils.js';
29
27
  import { type L1TxUtilsConfig, l1TxUtilsConfigMappings } from './config.js';
30
- import { LARGE_GAS_LIMIT } from './constants.js';
28
+ import { MAX_L1_TX_LIMIT } from './constants.js';
31
29
  import type { IL1TxMetrics, IL1TxStore } from './interfaces.js';
32
30
  import { ReadOnlyL1TxUtils } from './readonly_l1_tx_utils.js';
31
+ import { Delayer, createDelayer, wrapClientWithDelayer } from './tx_delayer.js';
33
32
  import {
34
33
  DroppedTransactionError,
35
34
  type L1BlobInputs,
@@ -45,8 +44,11 @@ import {
45
44
  const MAX_L1_TX_STATES = 32;
46
45
 
47
46
  export class L1TxUtils extends ReadOnlyL1TxUtils {
48
- protected nonceManager: NonceManager;
49
47
  protected txs: L1TxState[] = [];
48
+ /** Tx delayer for testing. Only set when enableDelayer config is true. */
49
+ public delayer?: Delayer;
50
+ /** KZG instance for blob operations. */
51
+ protected kzg?: BlobKzgInstance;
50
52
 
51
53
  constructor(
52
54
  public override client: ViemClient,
@@ -58,9 +60,25 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
58
60
  debugMaxGasLimit: boolean = false,
59
61
  protected store?: IL1TxStore,
60
62
  protected metrics?: IL1TxMetrics,
63
+ kzg?: BlobKzgInstance,
64
+ delayer?: Delayer,
61
65
  ) {
62
66
  super(client, logger, dateProvider, config, debugMaxGasLimit);
63
- this.nonceManager = createNonceManager({ source: jsonRpc() });
67
+ this.kzg = kzg;
68
+
69
+ // Set up delayer: use provided one or create new
70
+ if (config?.enableDelayer && config?.ethereumSlotDuration) {
71
+ this.delayer =
72
+ delayer ?? this.createDelayer({ ethereumSlotDuration: config.ethereumSlotDuration }, logger.getBindings());
73
+ this.client = wrapClientWithDelayer(this.client, this.delayer);
74
+ if (config.txDelayerMaxInclusionTimeIntoSlot !== undefined) {
75
+ this.delayer.setMaxInclusionTimeIntoSlot(config.txDelayerMaxInclusionTimeIntoSlot);
76
+ }
77
+ } else if (delayer) {
78
+ // Delayer provided but enableDelayer not set — just store it without wrapping
79
+ logger.warn('Delayer provided but enableDelayer config is not set; delayer will not be used');
80
+ this.delayer = delayer;
81
+ }
64
82
  }
65
83
 
66
84
  public get state() {
@@ -130,12 +148,32 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
130
148
  return;
131
149
  }
132
150
 
133
- // Convert loaded states (which have id) to the txs format
134
- this.txs = loadedStates;
135
- this.logger.info(`Rehydrated ${loadedStates.length} tx states for account ${account}`);
151
+ // Clean up excess states if we have more than MAX_L1_TX_STATES
152
+ if (loadedStates.length > MAX_L1_TX_STATES) {
153
+ this.logger.warn(
154
+ `Found ${loadedStates.length} tx states for account ${account}, pruning to most recent ${MAX_L1_TX_STATES}`,
155
+ );
156
+
157
+ // Keep only the most recent MAX_L1_TX_STATES
158
+ const statesToKeep = loadedStates.slice(-MAX_L1_TX_STATES);
159
+ const statesToDelete = loadedStates.slice(0, -MAX_L1_TX_STATES);
160
+
161
+ // Batch delete old states in a transaction for efficiency
162
+ const idsToDelete = statesToDelete.map(s => s.id);
163
+ await this.store.deleteState(account, ...idsToDelete);
164
+
165
+ this.txs = statesToKeep;
166
+ this.logger.info(
167
+ `Cleaned up ${statesToDelete.length} old tx states, kept ${statesToKeep.length} for account ${account}`,
168
+ );
169
+ } else {
170
+ // Convert loaded states (which have id) to the txs format
171
+ this.txs = loadedStates;
172
+ this.logger.info(`Rehydrated ${loadedStates.length} tx states for account ${account}`);
173
+ }
136
174
 
137
175
  // Find all pending states and resume monitoring
138
- const pendingStates = loadedStates.filter(state => !TerminalTxUtilsState.includes(state.status));
176
+ const pendingStates = this.txs.filter(state => !TerminalTxUtilsState.includes(state.status));
139
177
  if (pendingStates.length === 0) {
140
178
  return;
141
179
  }
@@ -187,7 +225,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
187
225
 
188
226
  let gasLimit: bigint;
189
227
  if (this.debugMaxGasLimit) {
190
- gasLimit = LARGE_GAS_LIMIT;
228
+ gasLimit = MAX_L1_TX_LIMIT;
191
229
  } else if (gasConfig.gasLimit) {
192
230
  gasLimit = gasConfig.gasLimit;
193
231
  } else {
@@ -201,15 +239,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
201
239
  throw new InterruptError(`Transaction sending is interrupted`);
202
240
  }
203
241
 
204
- const nonce = await this.nonceManager.consume({
205
- client: this.client,
206
- address: account,
207
- chainId: this.client.chain.id,
208
- });
209
-
210
- const baseState = { request, gasLimit, blobInputs, gasPrice, nonce };
211
- const txData = this.makeTxData(baseState, { isCancelTx: false });
212
-
213
242
  const now = new Date(await this.getL1Timestamp());
214
243
  if (gasConfig.txTimeoutAt && now > gasConfig.txTimeoutAt) {
215
244
  throw new TimeoutError(
@@ -217,6 +246,11 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
217
246
  );
218
247
  }
219
248
 
249
+ const nonce = await this.client.getTransactionCount({ address: account, blockTag: 'pending' });
250
+
251
+ const baseState = { request, gasLimit, blobInputs, gasPrice, nonce };
252
+ const txData = this.makeTxData(baseState, { isCancelTx: false });
253
+
220
254
  // Send the new tx
221
255
  const signedRequest = await this.prepareSignedTransaction(txData);
222
256
  const txHash = await this.client.sendRawTransaction({ serializedTransaction: signedRequest });
@@ -263,7 +297,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
263
297
  return { txHash, state: l1TxState };
264
298
  } catch (err: any) {
265
299
  const viemError = formatViemError(err, request.abi);
266
- this.logger.error(`Failed to send L1 transaction`, viemError, {
300
+ this.logger.error(`Failed to send L1 transaction: ${viemError.message}`, viemError, {
267
301
  request: pick(request, 'to', 'value'),
268
302
  });
269
303
  throw viemError;
@@ -403,7 +437,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
403
437
  { nonce, account, pendingNonce, timePassed },
404
438
  );
405
439
  await this.updateState(state, TxUtilsState.NOT_MINED);
406
- this.nonceManager.reset({ address: account, chainId: this.client.chain.id });
407
440
  throw new DroppedTransactionError(nonce, account);
408
441
  }
409
442
 
@@ -495,12 +528,7 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
495
528
 
496
529
  // Oh no, the transaction has timed out!
497
530
  if (isCancelTx || !gasConfig.cancelTxOnTimeout) {
498
- // If this was already a cancellation tx, or we are configured to not cancel txs, we just mark it as NOT_MINED
499
- // and reset the nonce manager, so the next tx that comes along can reuse the nonce if/when this tx gets dropped.
500
- // This is the nastiest scenario for us, since the new tx could acquire the next nonce, but then this tx is dropped,
501
- // and the new tx would never get mined. Eventually, the new tx would also drop.
502
531
  await this.updateState(state, TxUtilsState.NOT_MINED);
503
- this.nonceManager.reset({ address: account, chainId: this.client.chain.id });
504
532
  } else {
505
533
  // Otherwise we fire the cancellation without awaiting to avoid blocking the caller,
506
534
  // and monitor it in the background so we can speed it up as needed.
@@ -611,12 +639,12 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
611
639
  from: request.from ?? this.getSenderAddress().toString(),
612
640
  maxFeePerGas: gasPrice.maxFeePerGas,
613
641
  maxPriorityFeePerGas: gasPrice.maxPriorityFeePerGas,
614
- gas: request.gas ?? LARGE_GAS_LIMIT,
642
+ gas: request.gas ?? MAX_L1_TX_LIMIT,
615
643
  };
616
644
 
617
645
  if (!request.gas && !gasConfig.ignoreBlockGasLimit) {
618
- // LARGE_GAS_LIMIT is set as call.gas, increase block gasLimit
619
- blockOverrides.gasLimit = LARGE_GAS_LIMIT * 2n;
646
+ // MAX_L1_TX_LIMIT is set as call.gas, ensure block gasLimit is sufficient
647
+ blockOverrides.gasLimit = MAX_L1_TX_LIMIT;
620
648
  }
621
649
 
622
650
  return this._simulate(call, blockOverrides, stateOverrides, gasConfig, abi);
@@ -639,7 +667,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
639
667
  { nonce, account },
640
668
  );
641
669
  await this.updateState(state, TxUtilsState.NOT_MINED);
642
- this.nonceManager.reset({ address: account, chainId: this.client.chain.id });
643
670
  return;
644
671
  }
645
672
 
@@ -651,7 +678,6 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
651
678
  { nonce, account, currentNonce },
652
679
  );
653
680
  await this.updateState(state, TxUtilsState.NOT_MINED);
654
- this.nonceManager.reset({ address: account, chainId: this.client.chain.id });
655
681
  return;
656
682
  }
657
683
 
@@ -711,8 +737,17 @@ export class L1TxUtils extends ReadOnlyL1TxUtils {
711
737
  return Number(timestamp) * 1000;
712
738
  }
713
739
 
714
- /** Makes empty blob inputs for the cancellation tx. To be overridden in L1TxUtilsWithBlobs. */
715
- protected makeEmptyBlobInputs(_maxFeePerBlobGas: bigint): Required<L1BlobInputs> {
716
- throw new Error('Cannot make empty blob inputs for cancellation');
740
+ /** Makes empty blob inputs for the cancellation tx. */
741
+ protected makeEmptyBlobInputs(maxFeePerBlobGas: bigint): Required<L1BlobInputs> {
742
+ if (!this.kzg) {
743
+ throw new Error('Cannot make empty blob inputs for cancellation without kzg');
744
+ }
745
+ const blobData = new Uint8Array(131072).fill(0);
746
+ return { blobs: [blobData], kzg: this.kzg, maxFeePerBlobGas };
747
+ }
748
+
749
+ /** Creates a new delayer instance. */
750
+ protected createDelayer(opts: { ethereumSlotDuration: bigint | number }, bindings: LoggerBindings): Delayer {
751
+ return createDelayer(this.dateProvider, opts, bindings);
717
752
  }
718
753
  }
@@ -1,4 +1,5 @@
1
- import { getKeys, median, merge, pick, times } from '@aztec/foundation/collection';
1
+ import { getKeys, merge, pick, times } from '@aztec/foundation/collection';
2
+ import type { EthAddress } from '@aztec/foundation/eth-address';
2
3
  import { type Logger, createLogger } from '@aztec/foundation/log';
3
4
  import { makeBackoff, retry } from '@aztec/foundation/retry';
4
5
  import { DateProvider } from '@aztec/foundation/timer';
@@ -11,6 +12,7 @@ import {
11
12
  type BaseError,
12
13
  type BlockOverrides,
13
14
  type ContractFunctionExecutionError,
15
+ type GetCodeReturnType,
14
16
  type Hex,
15
17
  MethodNotFoundRpcError,
16
18
  MethodNotSupportedRpcError,
@@ -25,15 +27,17 @@ import type { ViemClient } from '../types.js';
25
27
  import { type L1TxUtilsConfig, defaultL1TxUtilsConfig, l1TxUtilsConfigMappings } from './config.js';
26
28
  import {
27
29
  BLOCK_TIME_MS,
28
- LARGE_GAS_LIMIT,
30
+ MAX_L1_TX_LIMIT,
29
31
  MIN_BLOB_REPLACEMENT_BUMP_PERCENTAGE,
30
32
  MIN_REPLACEMENT_BUMP_PERCENTAGE,
31
33
  WEI_CONST,
32
34
  } from './constants.js';
35
+ import { P75AllTxsPriorityFeeStrategy, type PriorityFeeStrategy } from './fee-strategies/index.js';
33
36
  import type { GasPrice, L1BlobInputs, L1TxRequest, TransactionStats } from './types.js';
34
37
  import { getCalldataGasUsage, tryGetCustomErrorNameContractFunction } from './utils.js';
35
38
 
36
- const HISTORICAL_BLOCK_COUNT = 5;
39
+ // Change this to the current strategy we want to use
40
+ const CurrentStrategy: PriorityFeeStrategy = P75AllTxsPriorityFeeStrategy;
37
41
 
38
42
  export class ReadOnlyL1TxUtils {
39
43
  public config: Required<L1TxUtilsConfig>;
@@ -65,122 +69,8 @@ export class ReadOnlyL1TxUtils {
65
69
  return this.client.getBlockNumber();
66
70
  }
67
71
 
68
- /**
69
- * Analyzes pending transactions and recent fee history to determine a competitive priority fee.
70
- * Falls back to network estimate if data is unavailable or fails.
71
- * @param networkEstimateResult - Result from estimateMaxPriorityFeePerGas RPC call
72
- * @param pendingBlockResult - Result from getBlock with pending tag RPC call
73
- * @param feeHistoryResult - Result from getFeeHistory RPC call
74
- * @returns A competitive priority fee based on pending txs and recent block history
75
- */
76
- protected getCompetitivePriorityFee(
77
- networkEstimateResult: PromiseSettledResult<bigint | null>,
78
- pendingBlockResult: PromiseSettledResult<Awaited<ReturnType<ViemClient['getBlock']>> | null>,
79
- feeHistoryResult: PromiseSettledResult<Awaited<ReturnType<ViemClient['getFeeHistory']>> | null>,
80
- ): bigint {
81
- const networkEstimate =
82
- networkEstimateResult.status === 'fulfilled' && typeof networkEstimateResult.value === 'bigint'
83
- ? networkEstimateResult.value
84
- : 0n;
85
- let competitiveFee = networkEstimate;
86
-
87
- if (
88
- pendingBlockResult.status === 'fulfilled' &&
89
- pendingBlockResult.value !== null &&
90
- pendingBlockResult.value.transactions &&
91
- pendingBlockResult.value.transactions.length > 0
92
- ) {
93
- const pendingBlock = pendingBlockResult.value;
94
- // Extract priority fees from pending transactions
95
- const pendingFees = pendingBlock.transactions
96
- .map(tx => {
97
- // Transaction can be just a hash string, so we need to check if it's an object
98
- if (typeof tx === 'string') {
99
- return 0n;
100
- }
101
- const fee = tx.maxPriorityFeePerGas || 0n;
102
- // Debug: Log suspicious fees
103
- if (fee > 100n * WEI_CONST) {
104
- this.logger?.warn('Suspicious high priority fee in pending tx', {
105
- txHash: tx.hash,
106
- maxPriorityFeePerGas: formatGwei(fee),
107
- maxFeePerGas: formatGwei(tx.maxFeePerGas || 0n),
108
- maxFeePerBlobGas: tx.maxFeePerBlobGas ? formatGwei(tx.maxFeePerBlobGas) : 'N/A',
109
- });
110
- }
111
- return fee;
112
- })
113
- .filter((fee: bigint) => fee > 0n);
114
-
115
- if (pendingFees.length > 0) {
116
- // Use 75th percentile of pending fees to be competitive
117
- const sortedPendingFees = [...pendingFees].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
118
- const percentile75Index = Math.floor((sortedPendingFees.length - 1) * 0.75);
119
- const pendingCompetitiveFee = sortedPendingFees[percentile75Index];
120
-
121
- if (pendingCompetitiveFee > competitiveFee) {
122
- competitiveFee = pendingCompetitiveFee;
123
- }
124
-
125
- this.logger?.debug('Analyzed pending transactions for competitive pricing', {
126
- pendingTxCount: pendingFees.length,
127
- pendingP75: formatGwei(pendingCompetitiveFee),
128
- });
129
- }
130
- }
131
- if (
132
- feeHistoryResult.status === 'fulfilled' &&
133
- feeHistoryResult.value !== null &&
134
- feeHistoryResult.value.reward &&
135
- feeHistoryResult.value.reward.length > 0
136
- ) {
137
- const feeHistory = feeHistoryResult.value;
138
- // Extract 75th percentile fees from each block
139
- const percentile75Fees = feeHistory.reward!.map(rewards => rewards[0] || 0n).filter(fee => fee > 0n);
140
-
141
- if (percentile75Fees.length > 0) {
142
- // Calculate median of the 75th percentile fees across blocks
143
- const medianHistoricalFee = median(percentile75Fees) ?? 0n;
144
-
145
- // Debug: Log suspicious fees from history
146
- if (medianHistoricalFee > 100n * WEI_CONST) {
147
- this.logger?.warn('Suspicious high fee in history', {
148
- historicalMedian: formatGwei(medianHistoricalFee),
149
- allP75Fees: percentile75Fees.map(f => formatGwei(f)),
150
- });
151
- }
152
-
153
- if (medianHistoricalFee > competitiveFee) {
154
- competitiveFee = medianHistoricalFee;
155
- }
156
-
157
- this.logger?.debug('Analyzed fee history for competitive pricing', {
158
- historicalMedian: formatGwei(medianHistoricalFee),
159
- });
160
- }
161
- }
162
-
163
- // Sanity check: cap competitive fee at 100x network estimate to avoid using unrealistic fees
164
- // (e.g., Anvil returns inflated historical fees that don't reflect actual network conditions)
165
- const maxReasonableFee = networkEstimate * 100n;
166
- if (competitiveFee > maxReasonableFee) {
167
- this.logger?.warn('Competitive fee exceeds sanity cap, using capped value', {
168
- competitiveFee: formatGwei(competitiveFee),
169
- networkEstimate: formatGwei(networkEstimate),
170
- cappedTo: formatGwei(maxReasonableFee),
171
- });
172
- competitiveFee = maxReasonableFee;
173
- }
174
-
175
- // Log final decision
176
- if (competitiveFee > networkEstimate) {
177
- this.logger?.debug('Using competitive fee from market analysis', {
178
- networkEstimate: formatGwei(networkEstimate),
179
- competitive: formatGwei(competitiveFee),
180
- });
181
- }
182
-
183
- return competitiveFee;
72
+ public getCode(address: EthAddress): Promise<GetCodeReturnType> {
73
+ return this.client.getCode({ address: address.toString() });
184
74
  }
185
75
 
186
76
  /**
@@ -194,69 +84,47 @@ export class ReadOnlyL1TxUtils {
194
84
  ): Promise<GasPrice> {
195
85
  const gasConfig = merge(this.config, gasConfigOverrides);
196
86
 
197
- // Make all RPC calls in parallel upfront with retry logic
198
- const latestBlockPromise = this.tryTwice(
199
- () => this.client.getBlock({ blockTag: 'latest' }),
200
- 'Getting latest block',
87
+ // Execute strategy - it handles all RPC calls internally and returns everything we need
88
+ const strategyResult = await retry(
89
+ () =>
90
+ CurrentStrategy.execute(this.client, {
91
+ gasConfig,
92
+ isBlobTx,
93
+ logger: this.logger,
94
+ }),
95
+ 'Executing priority fee strategy',
96
+ makeBackoff(times(2, () => 0)),
97
+ this.logger,
98
+ true,
201
99
  );
202
- const networkEstimatePromise = gasConfig.fixedPriorityFeePerGas
203
- ? null
204
- : this.tryTwice(() => this.client.estimateMaxPriorityFeePerGas(), 'Estimating max priority fee per gas');
205
- const pendingBlockPromise = gasConfig.fixedPriorityFeePerGas
206
- ? null
207
- : this.tryTwice(
208
- () => this.client.getBlock({ blockTag: 'pending', includeTransactions: true }),
209
- 'Getting pending block',
210
- );
211
- const feeHistoryPromise = gasConfig.fixedPriorityFeePerGas
212
- ? null
213
- : this.tryTwice(
214
- () => this.client.getFeeHistory({ blockCount: HISTORICAL_BLOCK_COUNT, rewardPercentiles: [75] }),
215
- 'Getting fee history',
216
- );
217
- const blobBaseFeePromise = isBlobTx
218
- ? this.tryTwice(() => this.client.getBlobBaseFee(), 'Getting blob base fee')
219
- : null;
220
-
221
- const [latestBlockResult, networkEstimateResult, pendingBlockResult, feeHistoryResult, blobBaseFeeResult] =
222
- await Promise.allSettled([
223
- latestBlockPromise,
224
- networkEstimatePromise ?? Promise.resolve(0n),
225
- pendingBlockPromise ?? Promise.resolve(null),
226
- feeHistoryPromise ?? Promise.resolve(null),
227
- blobBaseFeePromise ?? Promise.resolve(0n),
228
- ]);
229
-
230
- // Extract results
231
- const baseFee =
232
- latestBlockResult.status === 'fulfilled' &&
233
- typeof latestBlockResult.value === 'object' &&
234
- latestBlockResult.value.baseFeePerGas
235
- ? latestBlockResult.value.baseFeePerGas
236
- : 0n;
237
-
238
- // Get blob base fee if available
239
- let blobBaseFee = 0n;
240
- if (isBlobTx && blobBaseFeeResult.status === 'fulfilled' && typeof blobBaseFeeResult.value === 'bigint') {
241
- blobBaseFee = blobBaseFeeResult.value;
242
- } else if (isBlobTx) {
100
+
101
+ const { latestBlock, blobBaseFee, priorityFee: strategyPriorityFee } = strategyResult;
102
+
103
+ // Extract base fee from latest block
104
+ const baseFee = latestBlock.baseFeePerGas ?? 0n;
105
+
106
+ // Handle blob base fee
107
+ if (isBlobTx && blobBaseFee === undefined) {
243
108
  this.logger?.warn('Failed to get L1 blob base fee', attempt);
244
109
  }
245
110
 
246
- let priorityFee: bigint;
247
- if (gasConfig.fixedPriorityFeePerGas) {
248
- this.logger?.debug('Using fixed priority fee per L1 gas', {
249
- fixedPriorityFeePerGas: gasConfig.fixedPriorityFeePerGas,
250
- });
251
- // try to maintain precision up to 1000000 wei
252
- priorityFee = BigInt(gasConfig.fixedPriorityFeePerGas * 1_000_000) * (WEI_CONST / 1_000_000n);
253
- } else {
254
- // Get competitive priority fee (includes network estimate + analysis)
255
- priorityFee = this.getCompetitivePriorityFee(networkEstimateResult, pendingBlockResult, feeHistoryResult);
111
+ let priorityFee = strategyPriorityFee;
112
+
113
+ // Apply minimum priority fee floor if configured
114
+ if (gasConfig.minimumPriorityFeePerGas) {
115
+ const minimumPriorityFee = BigInt(Math.trunc(gasConfig.minimumPriorityFeePerGas * Number(WEI_CONST)));
116
+ if (priorityFee < minimumPriorityFee) {
117
+ this.logger?.debug('Applying minimum priority fee floor', {
118
+ calculatedPriorityFee: formatGwei(priorityFee),
119
+ minimumPriorityFeePerGas: gasConfig.minimumPriorityFeePerGas,
120
+ appliedFee: formatGwei(minimumPriorityFee),
121
+ });
122
+ priorityFee = minimumPriorityFee;
123
+ }
256
124
  }
257
125
  let maxFeePerGas = baseFee;
258
126
 
259
- let maxFeePerBlobGas = blobBaseFee;
127
+ let maxFeePerBlobGas = blobBaseFee ?? 0n;
260
128
 
261
129
  // Bump base fee so it's valid for next blocks if it stalls
262
130
  const numBlocks = Math.ceil(gasConfig.stallTimeMs! / BLOCK_TIME_MS);
@@ -281,18 +149,15 @@ export class ReadOnlyL1TxUtils {
281
149
  (previousGasPrice!.maxPriorityFeePerGas * (100_00n + BigInt(bumpPercentage * 1_00))) / 100_00n;
282
150
  const minMaxFee = (previousGasPrice!.maxFeePerGas * (100_00n + BigInt(bumpPercentage * 1_00))) / 100_00n;
283
151
 
284
- let competitivePriorityFee = priorityFee;
285
- if (!gasConfig.fixedPriorityFeePerGas) {
286
- // Apply bump percentage to competitive fee
287
- competitivePriorityFee = (priorityFee * (100_00n + BigInt(configBump * 1_00))) / 100_00n;
152
+ // Apply bump percentage to competitive fee
153
+ const competitivePriorityFee = (priorityFee * (100_00n + BigInt(configBump * 1_00))) / 100_00n;
288
154
 
289
- this.logger?.debug(`Speed-up attempt ${attempt}: using competitive fee strategy`, {
290
- networkEstimate: formatGwei(priorityFee),
291
- competitiveFee: formatGwei(competitivePriorityFee),
292
- minRequired: formatGwei(minPriorityFee),
293
- bumpPercentage: configBump,
294
- });
295
- }
155
+ this.logger?.debug(`Speed-up attempt ${attempt}: using competitive fee strategy`, {
156
+ networkEstimate: formatGwei(priorityFee),
157
+ competitiveFee: formatGwei(competitivePriorityFee),
158
+ minRequired: formatGwei(minPriorityFee),
159
+ bumpPercentage: configBump,
160
+ });
296
161
 
297
162
  // Use maximum between competitive fee and minimum required bump
298
163
  const finalPriorityFee = competitivePriorityFee > minPriorityFee ? competitivePriorityFee : minPriorityFee;
@@ -303,26 +168,22 @@ export class ReadOnlyL1TxUtils {
303
168
  maxFeePerGas += finalPriorityFee;
304
169
  maxFeePerGas = maxFeePerGas > minMaxFee ? maxFeePerGas : minMaxFee;
305
170
 
306
- if (!gasConfig.fixedPriorityFeePerGas) {
307
- this.logger?.debug(`Speed-up fee decision: using ${feeSource} fee`, {
308
- finalPriorityFee: formatGwei(finalPriorityFee),
309
- });
310
- }
171
+ this.logger?.debug(`Speed-up fee decision: using ${feeSource} fee`, {
172
+ finalPriorityFee: formatGwei(finalPriorityFee),
173
+ });
311
174
  } else {
312
175
  // First attempt: apply configured bump percentage to competitive fee
313
176
  // multiply by 100 & divide by 100 to maintain some precision
314
- if (!gasConfig.fixedPriorityFeePerGas) {
315
- priorityFee = (priorityFee * (100_00n + BigInt((gasConfig.priorityFeeBumpPercentage || 0) * 1_00))) / 100_00n;
316
- this.logger?.debug('Initial transaction: using competitive fee from market analysis', {
317
- networkEstimate: formatGwei(priorityFee),
318
- });
319
- }
177
+ priorityFee = (priorityFee * (100_00n + BigInt((gasConfig.priorityFeeBumpPercentage || 0) * 1_00))) / 100_00n;
178
+ this.logger?.debug('Initial transaction: using competitive fee from market analysis', {
179
+ networkEstimate: formatGwei(priorityFee),
180
+ });
320
181
  maxFeePerGas += priorityFee;
321
182
  }
322
183
 
323
184
  // maxGwei and maxBlobGwei are hard limits
324
- const effectiveMaxGwei = gasConfig.maxGwei! * WEI_CONST;
325
- const effectiveMaxBlobGwei = gasConfig.maxBlobGwei! * WEI_CONST;
185
+ const effectiveMaxGwei = BigInt(Math.trunc(gasConfig.maxGwei! * Number(WEI_CONST)));
186
+ const effectiveMaxBlobGwei = BigInt(Math.trunc(gasConfig.maxBlobGwei! * Number(WEI_CONST)));
326
187
 
327
188
  // Ensure we don't exceed maxGwei
328
189
  if (effectiveMaxGwei > 0n) {
@@ -357,7 +218,7 @@ export class ReadOnlyL1TxUtils {
357
218
  baseFee: formatGwei(baseFee),
358
219
  maxFeePerGas: formatGwei(maxFeePerGas),
359
220
  maxPriorityFeePerGas: formatGwei(maxPriorityFeePerGas),
360
- blobBaseFee: formatGwei(blobBaseFee),
221
+ blobBaseFee: formatGwei(blobBaseFee ?? 0n),
361
222
  maxFeePerBlobGas: formatGwei(maxFeePerBlobGas),
362
223
  },
363
224
  );
@@ -388,12 +249,18 @@ export class ReadOnlyL1TxUtils {
388
249
  ...request,
389
250
  ..._blobInputs,
390
251
  maxFeePerBlobGas: gasPrice.maxFeePerBlobGas!,
391
- gas: LARGE_GAS_LIMIT,
252
+ gas: MAX_L1_TX_LIMIT,
253
+ blockTag: 'latest',
392
254
  });
393
255
 
394
256
  this.logger?.trace(`Estimated gas for blob tx: ${initialEstimate}`);
395
257
  } else {
396
- initialEstimate = await this.client.estimateGas({ account, ...request, gas: LARGE_GAS_LIMIT });
258
+ initialEstimate = await this.client.estimateGas({
259
+ account,
260
+ ...request,
261
+ gas: MAX_L1_TX_LIMIT,
262
+ blockTag: 'latest',
263
+ });
397
264
  this.logger?.trace(`Estimated gas for non-blob tx: ${initialEstimate}`);
398
265
  }
399
266
 
@@ -549,11 +416,4 @@ export class ReadOnlyL1TxUtils {
549
416
  });
550
417
  return bumpedGasLimit;
551
418
  }
552
-
553
- /**
554
- * Helper function to retry RPC calls twice
555
- */
556
- private tryTwice<T>(fn: () => Promise<T>, description: string): Promise<T> {
557
- return retry<T>(fn, description, makeBackoff(times(2, () => 0)), this.logger, true);
558
- }
559
419
  }