@aztec/ethereum 0.0.1-commit.9b94fc1 → 0.0.1-commit.9ee6fcc6

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 (205) hide show
  1. package/dest/client.d.ts +10 -2
  2. package/dest/client.d.ts.map +1 -1
  3. package/dest/client.js +13 -3
  4. package/dest/config.d.ts +21 -68
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +61 -380
  7. package/dest/contracts/empire_base.d.ts +4 -1
  8. package/dest/contracts/empire_base.d.ts.map +1 -1
  9. package/dest/contracts/empire_slashing_proposer.d.ts +4 -1
  10. package/dest/contracts/empire_slashing_proposer.d.ts.map +1 -1
  11. package/dest/contracts/empire_slashing_proposer.js +31 -15
  12. package/dest/contracts/fee_asset_handler.d.ts +6 -5
  13. package/dest/contracts/fee_asset_handler.d.ts.map +1 -1
  14. package/dest/contracts/fee_asset_handler.js +11 -9
  15. package/dest/contracts/fee_asset_price_oracle.d.ts +101 -0
  16. package/dest/contracts/fee_asset_price_oracle.d.ts.map +1 -0
  17. package/dest/contracts/fee_asset_price_oracle.js +651 -0
  18. package/dest/contracts/governance.d.ts +3 -1
  19. package/dest/contracts/governance.d.ts.map +1 -1
  20. package/dest/contracts/governance.js +14 -4
  21. package/dest/contracts/governance_proposer.d.ts +4 -1
  22. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  23. package/dest/contracts/governance_proposer.js +404 -9
  24. package/dest/contracts/inbox.d.ts +24 -3
  25. package/dest/contracts/inbox.d.ts.map +1 -1
  26. package/dest/contracts/inbox.js +36 -1
  27. package/dest/contracts/index.d.ts +4 -1
  28. package/dest/contracts/index.d.ts.map +1 -1
  29. package/dest/contracts/index.js +3 -0
  30. package/dest/contracts/log.d.ts +13 -0
  31. package/dest/contracts/log.d.ts.map +1 -0
  32. package/dest/contracts/log.js +1 -0
  33. package/dest/contracts/multicall.d.ts +51 -2
  34. package/dest/contracts/multicall.d.ts.map +1 -1
  35. package/dest/contracts/multicall.js +87 -1
  36. package/dest/contracts/outbox.d.ts +41 -0
  37. package/dest/contracts/outbox.d.ts.map +1 -0
  38. package/dest/contracts/outbox.js +86 -0
  39. package/dest/contracts/registry.d.ts +3 -1
  40. package/dest/contracts/registry.d.ts.map +1 -1
  41. package/dest/contracts/registry.js +30 -1
  42. package/dest/contracts/rollup.d.ts +191 -97
  43. package/dest/contracts/rollup.d.ts.map +1 -1
  44. package/dest/contracts/rollup.js +762 -149
  45. package/dest/contracts/tally_slashing_proposer.d.ts +3 -2
  46. package/dest/contracts/tally_slashing_proposer.d.ts.map +1 -1
  47. package/dest/contracts/tally_slashing_proposer.js +8 -1
  48. package/dest/deploy_aztec_l1_contracts.d.ts +259 -0
  49. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -0
  50. package/dest/deploy_aztec_l1_contracts.js +413 -0
  51. package/dest/deploy_l1_contract.d.ts +68 -0
  52. package/dest/deploy_l1_contract.d.ts.map +1 -0
  53. package/dest/deploy_l1_contract.js +312 -0
  54. package/dest/forwarder_proxy.d.ts +32 -0
  55. package/dest/forwarder_proxy.d.ts.map +1 -0
  56. package/dest/forwarder_proxy.js +93 -0
  57. package/dest/generated/l1-contracts-defaults.d.ts +30 -0
  58. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  59. package/dest/generated/l1-contracts-defaults.js +30 -0
  60. package/dest/l1_artifacts.d.ts +5975 -1575
  61. package/dest/l1_artifacts.d.ts.map +1 -1
  62. package/dest/l1_contract_addresses.d.ts +1 -1
  63. package/dest/l1_contract_addresses.d.ts.map +1 -1
  64. package/dest/l1_contract_addresses.js +3 -3
  65. package/dest/l1_reader.d.ts +5 -1
  66. package/dest/l1_reader.d.ts.map +1 -1
  67. package/dest/l1_reader.js +12 -1
  68. package/dest/l1_tx_utils/config.d.ts +9 -3
  69. package/dest/l1_tx_utils/config.d.ts.map +1 -1
  70. package/dest/l1_tx_utils/config.js +31 -4
  71. package/dest/l1_tx_utils/constants.d.ts +8 -2
  72. package/dest/l1_tx_utils/constants.d.ts.map +1 -1
  73. package/dest/l1_tx_utils/constants.js +27 -2
  74. package/dest/l1_tx_utils/factory.d.ts +18 -10
  75. package/dest/l1_tx_utils/factory.d.ts.map +1 -1
  76. package/dest/l1_tx_utils/factory.js +17 -7
  77. package/dest/l1_tx_utils/fee-strategies/index.d.ts +10 -0
  78. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -0
  79. package/dest/l1_tx_utils/fee-strategies/index.js +12 -0
  80. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +8 -0
  81. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -0
  82. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +129 -0
  83. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +23 -0
  84. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -0
  85. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +191 -0
  86. package/dest/l1_tx_utils/fee-strategies/types.d.ts +51 -0
  87. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -0
  88. package/dest/l1_tx_utils/fee-strategies/types.js +3 -0
  89. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +41 -0
  90. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -0
  91. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +42 -0
  92. package/dest/l1_tx_utils/index-blobs.d.ts +3 -0
  93. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -0
  94. package/dest/l1_tx_utils/index-blobs.js +2 -0
  95. package/dest/l1_tx_utils/index.d.ts +4 -1
  96. package/dest/l1_tx_utils/index.d.ts.map +1 -1
  97. package/dest/l1_tx_utils/index.js +3 -0
  98. package/dest/l1_tx_utils/interfaces.d.ts +2 -2
  99. package/dest/l1_tx_utils/interfaces.d.ts.map +1 -1
  100. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +233 -0
  101. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -0
  102. package/dest/l1_tx_utils/l1_fee_analyzer.js +506 -0
  103. package/dest/l1_tx_utils/l1_tx_utils.d.ts +18 -7
  104. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  105. package/dest/l1_tx_utils/l1_tx_utils.js +75 -46
  106. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +4 -15
  107. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  108. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +61 -164
  109. package/dest/l1_tx_utils/tx_delayer.d.ts +56 -0
  110. package/dest/l1_tx_utils/tx_delayer.d.ts.map +1 -0
  111. package/dest/{test → l1_tx_utils}/tx_delayer.js +65 -36
  112. package/dest/publisher_manager.d.ts +21 -6
  113. package/dest/publisher_manager.d.ts.map +1 -1
  114. package/dest/publisher_manager.js +81 -7
  115. package/dest/queries.d.ts +2 -2
  116. package/dest/queries.d.ts.map +1 -1
  117. package/dest/queries.js +12 -4
  118. package/dest/test/chain_monitor.d.ts +35 -14
  119. package/dest/test/chain_monitor.d.ts.map +1 -1
  120. package/dest/test/chain_monitor.js +40 -11
  121. package/dest/test/eth_cheat_codes.d.ts +18 -4
  122. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  123. package/dest/test/eth_cheat_codes.js +10 -6
  124. package/dest/test/index.d.ts +1 -3
  125. package/dest/test/index.d.ts.map +1 -1
  126. package/dest/test/index.js +0 -2
  127. package/dest/test/rollup_cheat_codes.d.ts +9 -6
  128. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  129. package/dest/test/rollup_cheat_codes.js +32 -6
  130. package/dest/test/start_anvil.d.ts +24 -2
  131. package/dest/test/start_anvil.d.ts.map +1 -1
  132. package/dest/test/start_anvil.js +143 -29
  133. package/dest/test/upgrade_utils.js +2 -2
  134. package/dest/types.d.ts +57 -2
  135. package/dest/types.d.ts.map +1 -1
  136. package/dest/utils.d.ts +16 -3
  137. package/dest/utils.d.ts.map +1 -1
  138. package/dest/utils.js +80 -12
  139. package/package.json +33 -16
  140. package/src/client.ts +10 -2
  141. package/src/config.ts +77 -459
  142. package/src/contracts/README.md +157 -0
  143. package/src/contracts/empire_base.ts +3 -1
  144. package/src/contracts/empire_slashing_proposer.ts +28 -28
  145. package/src/contracts/fee_asset_handler.ts +10 -7
  146. package/src/contracts/fee_asset_price_oracle.ts +280 -0
  147. package/src/contracts/governance.ts +13 -4
  148. package/src/contracts/governance_proposer.ts +16 -2
  149. package/src/contracts/inbox.ts +55 -3
  150. package/src/contracts/index.ts +3 -0
  151. package/src/contracts/log.ts +13 -0
  152. package/src/contracts/multicall.ts +70 -3
  153. package/src/contracts/outbox.ts +98 -0
  154. package/src/contracts/registry.ts +31 -1
  155. package/src/contracts/rollup.ts +445 -118
  156. package/src/contracts/tally_slashing_proposer.ts +7 -1
  157. package/src/deploy_aztec_l1_contracts.ts +650 -0
  158. package/src/deploy_l1_contract.ts +362 -0
  159. package/src/forwarder_proxy.ts +108 -0
  160. package/src/generated/l1-contracts-defaults.ts +32 -0
  161. package/src/l1_contract_addresses.ts +22 -20
  162. package/src/l1_reader.ts +21 -1
  163. package/src/l1_tx_utils/config.ts +44 -6
  164. package/src/l1_tx_utils/constants.ts +13 -2
  165. package/src/l1_tx_utils/factory.ts +31 -31
  166. package/src/l1_tx_utils/fee-strategies/index.ts +22 -0
  167. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +163 -0
  168. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +245 -0
  169. package/src/l1_tx_utils/fee-strategies/types.ts +56 -0
  170. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +108 -0
  171. package/src/l1_tx_utils/index-blobs.ts +2 -0
  172. package/src/l1_tx_utils/index.ts +3 -0
  173. package/src/l1_tx_utils/interfaces.ts +1 -1
  174. package/src/l1_tx_utils/l1_fee_analyzer.ts +803 -0
  175. package/src/l1_tx_utils/l1_tx_utils.ts +84 -36
  176. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +75 -210
  177. package/src/{test → l1_tx_utils}/tx_delayer.ts +82 -52
  178. package/src/publisher_manager.ts +107 -10
  179. package/src/queries.ts +11 -3
  180. package/src/test/chain_monitor.ts +77 -18
  181. package/src/test/eth_cheat_codes.ts +8 -6
  182. package/src/test/index.ts +0 -2
  183. package/src/test/rollup_cheat_codes.ts +32 -9
  184. package/src/test/start_anvil.ts +178 -28
  185. package/src/test/upgrade_utils.ts +2 -2
  186. package/src/types.ts +62 -0
  187. package/src/utils.ts +100 -15
  188. package/dest/deploy_l1_contracts.d.ts +0 -673
  189. package/dest/deploy_l1_contracts.d.ts.map +0 -1
  190. package/dest/deploy_l1_contracts.js +0 -1491
  191. package/dest/index.d.ts +0 -18
  192. package/dest/index.d.ts.map +0 -1
  193. package/dest/index.js +0 -17
  194. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts +0 -26
  195. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts.map +0 -1
  196. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.js +0 -26
  197. package/dest/test/delayed_tx_utils.d.ts +0 -13
  198. package/dest/test/delayed_tx_utils.d.ts.map +0 -1
  199. package/dest/test/delayed_tx_utils.js +0 -28
  200. package/dest/test/tx_delayer.d.ts +0 -36
  201. package/dest/test/tx_delayer.d.ts.map +0 -1
  202. package/src/deploy_l1_contracts.ts +0 -1869
  203. package/src/index.ts +0 -17
  204. package/src/l1_tx_utils/l1_tx_utils_with_blobs.ts +0 -77
  205. package/src/test/delayed_tx_utils.ts +0 -52
@@ -1,5 +1,5 @@
1
1
  import { omit } from '@aztec/foundation/collection';
2
- import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
3
  import { retryUntil } from '@aztec/foundation/retry';
4
4
  import type { DateProvider } from '@aztec/foundation/timer';
5
5
 
@@ -9,14 +9,18 @@ import {
9
9
  type Hex,
10
10
  type PublicClient,
11
11
  type TransactionSerializableEIP4844,
12
+ type TransactionSerialized,
12
13
  keccak256,
13
14
  parseTransaction,
14
15
  publicActions,
16
+ recoverTransactionAddress,
15
17
  serializeTransaction,
16
18
  walletActions,
17
19
  } from 'viem';
18
20
 
19
- import { type ViemClient, isExtendedClient } from '../types.js';
21
+ import type { ExtendedViemWalletClient, ViemClient } from '../types.js';
22
+
23
+ const MAX_WAIT_TIME_SECONDS = 180;
20
24
 
21
25
  export function waitUntilBlock<T extends Client>(
22
26
  client: T,
@@ -36,7 +40,7 @@ export function waitUntilBlock<T extends Client>(
36
40
  return currentBlockNumber >= BigInt(blockNumber);
37
41
  },
38
42
  `Wait until L1 block ${blockNumber}`,
39
- timeout ?? 120,
43
+ timeout ?? MAX_WAIT_TIME_SECONDS,
40
44
  0.1,
41
45
  );
42
46
  }
@@ -66,87 +70,103 @@ export function waitUntilL1Timestamp<T extends Client>(
66
70
  return currentTs >= BigInt(timestamp);
67
71
  },
68
72
  `Wait until L1 timestamp ${timestamp}`,
69
- timeout ?? 120,
73
+ timeout ?? MAX_WAIT_TIME_SECONDS,
70
74
  0.1,
71
75
  );
72
76
  }
73
77
 
74
- export interface Delayer {
75
- /** Returns the hashes of all effectively sent txs. */
76
- getSentTxHashes(): Hex[];
77
- /** Returns the raw hex for all cancelled txs. */
78
- getCancelledTxs(): Hex[];
79
- /** Delays the next tx to be sent so it lands on the given L1 block number. */
80
- pauseNextTxUntilBlock(l1BlockNumber: number | bigint | undefined): void;
81
- /** Delays the next tx to be sent so it lands on the given timestamp. */
82
- pauseNextTxUntilTimestamp(l1Timestamp: number | bigint | undefined): void;
83
- /** Delays the next tx to be sent indefinitely. */
84
- cancelNextTx(): void;
85
- /**
86
- * Sets max inclusion time into slot. If more than this many seconds have passed
87
- * since the last L1 block was mined, then any tx will not be mined in the current
88
- * L1 slot but will be deferred for the next one.
89
- */
90
- setMaxInclusionTimeIntoSlot(seconds: number | bigint | undefined): void;
91
- }
78
+ /** Manages tx delaying for testing, intercepting sendRawTransaction calls to delay or cancel them. */
79
+ export class Delayer {
80
+ private logger: Logger;
81
+
82
+ public maxInclusionTimeIntoSlot: number | undefined = undefined;
83
+ public ethereumSlotDuration: bigint;
84
+ public nextWait: { l1Timestamp: bigint } | { l1BlockNumber: bigint } | { indefinitely: true } | undefined = undefined;
85
+ public sentTxHashes: Hex[] = [];
86
+ public cancelledTxs: Hex[] = [];
92
87
 
93
- class DelayerImpl implements Delayer {
94
- private logger = createLogger('ethereum:tx_delayer');
95
88
  constructor(
96
89
  public dateProvider: DateProvider,
97
90
  opts: { ethereumSlotDuration: bigint | number },
91
+ bindings: LoggerBindings,
98
92
  ) {
99
93
  this.ethereumSlotDuration = BigInt(opts.ethereumSlotDuration);
94
+ this.logger = createLogger('ethereum:tx_delayer', bindings);
100
95
  }
101
96
 
102
- public maxInclusionTimeIntoSlot: number | undefined = undefined;
103
- public ethereumSlotDuration: bigint;
104
- public nextWait: { l1Timestamp: bigint } | { l1BlockNumber: bigint } | { indefinitely: true } | undefined = undefined;
105
- public sentTxHashes: Hex[] = [];
106
- public cancelledTxs: Hex[] = [];
97
+ /** Returns the logger instance used by this delayer. */
98
+ getLogger(): Logger {
99
+ return this.logger;
100
+ }
107
101
 
102
+ /** Returns the hashes of all effectively sent txs. */
108
103
  getSentTxHashes() {
109
104
  return this.sentTxHashes;
110
105
  }
111
106
 
107
+ /** Returns the raw hex for all cancelled txs. */
112
108
  getCancelledTxs(): Hex[] {
113
109
  return this.cancelledTxs;
114
110
  }
115
111
 
112
+ /** Delays the next tx to be sent so it lands on the given L1 block number. */
116
113
  pauseNextTxUntilBlock(l1BlockNumber: number | bigint) {
117
114
  this.nextWait = { l1BlockNumber: BigInt(l1BlockNumber) };
118
115
  }
119
116
 
117
+ /** Delays the next tx to be sent so it lands on the given timestamp. */
120
118
  pauseNextTxUntilTimestamp(l1Timestamp: number | bigint) {
121
119
  this.nextWait = { l1Timestamp: BigInt(l1Timestamp) };
122
120
  }
123
121
 
122
+ /** Delays the next tx to be sent indefinitely. */
124
123
  cancelNextTx() {
125
124
  this.nextWait = { indefinitely: true };
126
125
  }
127
126
 
127
+ /**
128
+ * Sets max inclusion time into slot. If more than this many seconds have passed
129
+ * since the last L1 block was mined, then any tx will not be mined in the current
130
+ * L1 slot but will be deferred for the next one.
131
+ */
128
132
  setMaxInclusionTimeIntoSlot(seconds: number | undefined) {
129
133
  this.maxInclusionTimeIntoSlot = seconds;
130
134
  }
131
135
  }
132
136
 
133
137
  /**
134
- * Returns a new client (without modifying the one passed in) with an injected tx delayer.
135
- * The delayer can be used to hold off the next tx to be sent until a given block number.
136
- * TODO(#10824): This doesn't play along well with blob txs for some reason.
138
+ * Creates a new Delayer instance. Exposed so callers can create a single shared delayer
139
+ * and pass it to multiple `wrapClientWithDelayer` calls.
137
140
  */
138
- export function withDelayer<T extends ViemClient>(
139
- client: T,
141
+ export function createDelayer(
140
142
  dateProvider: DateProvider,
141
143
  opts: { ethereumSlotDuration: bigint | number },
142
- ): { client: T; delayer: Delayer } {
143
- if (!isExtendedClient(client)) {
144
- throw new Error('withDelayer has to be instantiated with a wallet viem client.');
144
+ bindings: LoggerBindings,
145
+ ): Delayer {
146
+ return new Delayer(dateProvider, opts, bindings);
147
+ }
148
+
149
+ /** Tries to recover the sender address from a serialized signed transaction. */
150
+ async function tryRecoverSender(serializedTransaction: Hex): Promise<string | undefined> {
151
+ try {
152
+ return await recoverTransactionAddress({
153
+ serializedTransaction: serializedTransaction as TransactionSerialized,
154
+ });
155
+ } catch {
156
+ return undefined;
145
157
  }
146
- const logger = createLogger('ethereum:tx_delayer');
147
- const delayer = new DelayerImpl(dateProvider, opts);
158
+ }
148
159
 
149
- const extended = client
160
+ /**
161
+ * Wraps a viem client with tx delaying logic. Returns the wrapped client.
162
+ * The delayer intercepts sendRawTransaction calls and delays them based on the delayer's state.
163
+ */
164
+ export function wrapClientWithDelayer<T extends ViemClient>(client: T, delayer: Delayer): T {
165
+ const logger = delayer.getLogger();
166
+
167
+ // Cast to ExtendedViemWalletClient for the extend chain since it has sendRawTransaction.
168
+ // The sendRawTransaction override is applied to all clients regardless of type.
169
+ const withRawTx = (client as unknown as ExtendedViemWalletClient)
150
170
  // Tweak sendRawTransaction so it uses the delay defined in the delayer.
151
171
  // Note that this will only work with local accounts (ie accounts for which we have the private key).
152
172
  // Transactions signed by the node will not be delayed since they use sendTransaction directly,
@@ -158,6 +178,7 @@ export function withDelayer<T extends ViemClient>(
158
178
 
159
179
  const { serializedTransaction } = args[0];
160
180
  const publicClient = client as unknown as PublicClient;
181
+ const sender = await tryRecoverSender(serializedTransaction);
161
182
 
162
183
  if (delayer.nextWait !== undefined) {
163
184
  // Check if we have been instructed to delay the next tx.
@@ -169,7 +190,7 @@ export function withDelayer<T extends ViemClient>(
169
190
 
170
191
  // Cancel tx outright if instructed
171
192
  if ('indefinitely' in waitUntil && waitUntil.indefinitely) {
172
- logger.info(`Cancelling tx ${txHash}`);
193
+ logger.info(`Cancelling tx ${txHash}`, { sender });
173
194
  delayer.cancelledTxs.push(serializedTransaction);
174
195
  return Promise.resolve(txHash);
175
196
  }
@@ -183,6 +204,7 @@ export function withDelayer<T extends ViemClient>(
183
204
  : undefined;
184
205
 
185
206
  logger.info(`Delaying tx ${txHash} until ${inspect(waitUntil)}`, {
207
+ sender,
186
208
  argsLen: args.length,
187
209
  ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars'),
188
210
  });
@@ -194,6 +216,7 @@ export function withDelayer<T extends ViemClient>(
194
216
 
195
217
  txHash = computeTxHash(serializedTransaction);
196
218
  const logData = {
219
+ sender,
197
220
  ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars'),
198
221
  lastBlockTimestamp,
199
222
  now,
@@ -223,28 +246,35 @@ export function withDelayer<T extends ViemClient>(
223
246
  computedTxHash: txHash,
224
247
  });
225
248
  }
226
- logger.info(`Sent previously delayed tx ${clientTxHash}`);
249
+ logger.info(`Sent previously delayed tx ${clientTxHash}`, { sender });
227
250
  delayer.sentTxHashes.push(clientTxHash);
228
251
  })
229
252
  .catch(err => logger.error(`Error sending tx after delay`, err));
230
253
  return Promise.resolve(txHash!);
231
254
  } else {
232
255
  const txHash = await client.sendRawTransaction(...args);
233
- logger.verbose(`Sent tx immediately ${txHash}`);
256
+ logger.debug(`Sent tx immediately ${txHash}`, { sender });
234
257
  delayer.sentTxHashes.push(txHash);
235
258
  return txHash;
236
259
  }
237
260
  },
238
- }))
239
- // Re-extend with sendTransaction so it uses the modified sendRawTransaction.
240
- .extend(client => ({ sendTransaction: walletActions(client).sendTransaction }))
241
- // And with the actions that depend on the modified sendTransaction
242
- .extend(client => ({
243
- writeContract: walletActions(client).writeContract,
244
- deployContract: walletActions(client).deployContract,
245
- })) as T;
261
+ }));
262
+
263
+ // Only re-bind wallet actions (sendTransaction, writeContract, deployContract) for wallet clients.
264
+ // This is needed for tests that use wallet actions directly rather than sendRawTransaction.
265
+ const isWalletClient = 'account' in client && client.account !== undefined;
266
+ const extended = isWalletClient
267
+ ? withRawTx
268
+ // Re-extend with sendTransaction so it uses the modified sendRawTransaction.
269
+ .extend(client => ({ sendTransaction: walletActions(client).sendTransaction }))
270
+ // And with the actions that depend on the modified sendTransaction
271
+ .extend(client => ({
272
+ writeContract: walletActions(client).writeContract,
273
+ deployContract: walletActions(client).deployContract,
274
+ }))
275
+ : withRawTx;
246
276
 
247
- return { client: extended, delayer };
277
+ return extended as T;
248
278
  }
249
279
 
250
280
  /**
@@ -1,6 +1,8 @@
1
1
  import { pick } from '@aztec/foundation/collection';
2
- import { createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
+ import { RunningPromise } from '@aztec/foundation/running-promise';
3
4
 
5
+ import { Multicall3 } from './contracts/multicall.js';
4
6
  import { L1TxUtils, TxUtilsState } from './l1_tx_utils/index.js';
5
7
 
6
8
  // Defines the order in which we prioritise publishers based on their state (first is better)
@@ -27,22 +29,72 @@ const busyStates: TxUtilsState[] = [
27
29
 
28
30
  export type PublisherFilter<UtilsType extends L1TxUtils> = (utils: UtilsType) => boolean;
29
31
 
32
+ /** Config accepted by PublisherManager. */
33
+ type PublisherManagerConfig = {
34
+ publisherAllowInvalidStates?: boolean;
35
+ publisherFundingThreshold?: bigint;
36
+ publisherFundingAmount?: bigint;
37
+ };
38
+
30
39
  export class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
31
- private log = createLogger('publisher:manager');
32
- private config: { publisherAllowInvalidStates?: boolean };
40
+ private log: Logger;
41
+ private config: PublisherManagerConfig;
42
+ private static readonly FUNDING_CHECK_INTERVAL_MS = 2 * 60 * 1000;
43
+ private funder?: UtilsType;
44
+ private fundingPromise?: RunningPromise;
33
45
 
34
46
  constructor(
35
47
  private publishers: UtilsType[],
36
- config: { publisherAllowInvalidStates?: boolean },
48
+ config: PublisherManagerConfig,
49
+ opts?: { bindings?: LoggerBindings; funder?: UtilsType },
37
50
  ) {
51
+ this.funder = opts?.funder;
52
+ this.log = createLogger('publisher:manager', opts?.bindings);
38
53
  this.log.info(`PublisherManager initialized with ${publishers.length} publishers.`);
39
54
  this.publishers = publishers;
40
- this.config = pick(config, 'publisherAllowInvalidStates');
55
+ this.config = pick(config, 'publisherAllowInvalidStates', 'publisherFundingThreshold', 'publisherFundingAmount');
56
+
57
+ const hasThreshold = this.config.publisherFundingThreshold !== undefined;
58
+ const hasAmount = this.config.publisherFundingAmount !== undefined;
59
+ if (hasThreshold !== hasAmount) {
60
+ this.log.warn(`Incomplete funding config: both publisherFundingThreshold and publisherFundingAmount must be set`);
61
+ }
62
+
63
+ if (this.funder) {
64
+ const funderAddress = this.funder.getSenderAddress();
65
+ if (publishers.some(p => p.getSenderAddress().equals(funderAddress))) {
66
+ this.log.error(`Funding account ${funderAddress} is also a publisher, disabling funding to avoid self-funding`);
67
+ this.funder = undefined;
68
+ }
69
+ }
41
70
  }
42
71
 
43
- /** Loads the state of all publishers and resumes monitoring any pending txs */
44
- public async loadState(): Promise<void> {
45
- await Promise.all(this.publishers.map(pub => pub.loadStateAndResumeMonitoring()));
72
+ /** Loads the state of all publishers and the funder, and starts periodic funding checks. */
73
+ public async start(): Promise<void> {
74
+ await Promise.all([
75
+ ...this.publishers.map(pub => pub.loadStateAndResumeMonitoring()),
76
+ this.funder?.loadStateAndResumeMonitoring(),
77
+ ]);
78
+
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
+ }
91
+ }
92
+
93
+ /** Stops the funding loop and interrupts all publishers. */
94
+ public async stop(): Promise<void> {
95
+ await this.fundingPromise?.stop();
96
+ this.publishers.forEach(pub => pub.interrupt());
97
+ this.funder?.interrupt();
46
98
  }
47
99
 
48
100
  // Finds and prioritises available publishers based on
@@ -100,7 +152,52 @@ export class PublisherManager<UtilsType extends L1TxUtils = L1TxUtils> {
100
152
  return sortedPublishers[0].publisher;
101
153
  }
102
154
 
103
- public interrupt() {
104
- this.publishers.forEach(pub => pub.interrupt());
155
+ /** Check all publisher balances and fund those below threshold. */
156
+ private async triggerFundingIfNeeded(): Promise<void> {
157
+ const { funder, config } = this;
158
+ if (!funder || config.publisherFundingThreshold === undefined || config.publisherFundingAmount === undefined) {
159
+ return;
160
+ }
161
+
162
+ const allBalances = await Promise.all(
163
+ this.publishers.map(async pub => ({ balance: await pub.getSenderBalance(), publisher: pub })),
164
+ );
165
+ const lowBalance = allBalances.filter(p => p.balance < config.publisherFundingThreshold!);
166
+ if (lowBalance.length === 0) {
167
+ return;
168
+ }
169
+
170
+ const fundingAmount = config.publisherFundingAmount!;
171
+ const funderBalance = await funder.getSenderBalance();
172
+
173
+ if (funderBalance < 10n * fundingAmount) {
174
+ this.log.warn(`Funding account balance is low`, { funderBalance, threshold: 10n * fundingAmount });
175
+ }
176
+ const affordableCount = Number(funderBalance / fundingAmount);
177
+ if (affordableCount === 0) {
178
+ this.log.error(`Funding account balance too low to fund any publisher`, { funderBalance, fundingAmount });
179
+ return;
180
+ }
181
+ if (affordableCount < lowBalance.length) {
182
+ this.log.warn(`Funder can only afford ${affordableCount}/${lowBalance.length} publishers`, {
183
+ funderBalance,
184
+ fundingAmount,
185
+ });
186
+ }
187
+
188
+ const toFund = lowBalance.slice(0, affordableCount).map(p => p.publisher);
189
+ await this.fundPublishers(toFund);
190
+ }
191
+
192
+ /** Fund publishers via a single Multicall3 aggregate3Value transaction. */
193
+ private async fundPublishers(publishers: UtilsType[]): Promise<void> {
194
+ const fundingAmount = this.config.publisherFundingAmount!;
195
+ const calls = publishers.map(pub => ({
196
+ to: pub.getSenderAddress().toString(),
197
+ value: fundingAmount,
198
+ }));
199
+
200
+ await Multicall3.forwardValue(calls, this.funder!, this.log);
201
+ this.log.info(`Funded ${publishers.length} publishers`);
105
202
  }
106
203
  }
package/src/queries.ts CHANGED
@@ -1,8 +1,9 @@
1
1
  import { EthAddress } from '@aztec/foundation/eth-address';
2
2
 
3
- import type { L1ContractsConfig } from './config.js';
3
+ import { DefaultL1ContractsConfig, type L1ContractsConfig } from './config.js';
4
4
  import { ReadOnlyGovernanceContract } from './contracts/governance.js';
5
5
  import { GovernanceProposerContract } from './contracts/governance_proposer.js';
6
+ import { InboxContract } from './contracts/inbox.js';
6
7
  import { RollupContract } from './contracts/rollup.js';
7
8
  import type { ViemPublicClient } from './types.js';
8
9
 
@@ -25,6 +26,8 @@ export async function getL1ContractsConfig(
25
26
  const rollup = new RollupContract(publicClient, rollupAddress.toString());
26
27
  const slasherProposer = await rollup.getSlashingProposer();
27
28
  const slasher = await rollup.getSlasherContract();
29
+ const rollupAddresses = await rollup.getRollupAddresses();
30
+ const inboxContract = new InboxContract(publicClient, rollupAddresses.inboxAddress.toString());
28
31
 
29
32
  const [
30
33
  l1StartBlock,
@@ -35,6 +38,7 @@ export async function getL1ContractsConfig(
35
38
  aztecTargetCommitteeSize,
36
39
  lagInEpochsForValidatorSet,
37
40
  lagInEpochsForRandao,
41
+ inboxLag,
38
42
  activationThreshold,
39
43
  ejectionThreshold,
40
44
  localEjectionThreshold,
@@ -62,6 +66,7 @@ export async function getL1ContractsConfig(
62
66
  rollup.getTargetCommitteeSize(),
63
67
  rollup.getLagInEpochsForValidatorSet(),
64
68
  rollup.getLagInEpochsForRandao(),
69
+ inboxContract.getLag(),
65
70
  rollup.getActivationThreshold(),
66
71
  rollup.getEjectionThreshold(),
67
72
  rollup.getLocalEjectionThreshold(),
@@ -91,13 +96,15 @@ export async function getL1ContractsConfig(
91
96
  aztecTargetCommitteeSize: Number(aztecTargetCommitteeSize),
92
97
  lagInEpochsForValidatorSet: Number(lagInEpochsForValidatorSet),
93
98
  lagInEpochsForRandao: Number(lagInEpochsForRandao),
99
+ inboxLag: Number(inboxLag),
94
100
  governanceProposerQuorum: Number(governanceProposerQuorum),
95
101
  governanceProposerRoundSize: Number(governanceProposerRoundSize),
102
+ governanceVotingDuration: DefaultL1ContractsConfig.governanceVotingDuration,
96
103
  activationThreshold,
97
104
  ejectionThreshold,
98
105
  localEjectionThreshold,
99
106
  slashingQuorum: Number(slashingQuorum),
100
- slashingRoundSizeInEpochs: Number(slashingRoundSize / aztecEpochDuration),
107
+ slashingRoundSizeInEpochs: Number(Number(slashingRoundSize) / aztecEpochDuration),
101
108
  slashingLifetimeInRounds: Number(slashingLifetimeInRounds),
102
109
  slashingExecutionDelayInRounds: Number(slashingExecutionDelayInRounds),
103
110
  slashingVetoer,
@@ -105,12 +112,13 @@ export async function getL1ContractsConfig(
105
112
  manaTarget,
106
113
  provingCostPerMana: provingCostPerMana,
107
114
  rollupVersion: Number(rollupVersion),
108
- genesisArchiveTreeRoot,
115
+ genesisArchiveTreeRoot: genesisArchiveTreeRoot.toString(),
109
116
  exitDelaySeconds: Number(exitDelay),
110
117
  slasherFlavor: slasherProposer?.type ?? 'tally',
111
118
  slashingOffsetInRounds: Number(slashingOffsetInRounds),
112
119
  slashAmountSmall: slashingAmounts[0],
113
120
  slashAmountMedium: slashingAmounts[1],
114
121
  slashAmountLarge: slashingAmounts[2],
122
+ initialEthPerFeeAsset: DefaultL1ContractsConfig.initialEthPerFeeAsset,
115
123
  };
116
124
  }
@@ -1,5 +1,6 @@
1
- import { InboxContract, type RollupContract } from '@aztec/ethereum/contracts';
2
- import { EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
1
+ import type { ManaMinFeeComponents, RollupContract } from '@aztec/ethereum/contracts';
2
+ import { InboxContract } from '@aztec/ethereum/contracts';
3
+ import { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
4
  import { EthAddress } from '@aztec/foundation/eth-address';
4
5
  import { createLogger } from '@aztec/foundation/log';
5
6
  import { promiseWithResolvers } from '@aztec/foundation/promise';
@@ -9,13 +10,30 @@ import { EventEmitter } from 'events';
9
10
 
10
11
  import type { ViemClient } from '../types.js';
11
12
 
13
+ /** L2 fee data reported by the chain monitor. */
14
+ export type L2FeeData = ManaMinFeeComponents & {
15
+ /** Total minimum fee per mana in Fee Juice (sum of sequencerCost + proverCost + congestionCost). */
16
+ minFeePerMana: bigint;
17
+ /** L1 base fee observed by the oracle. */
18
+ l1BaseFee: bigint;
19
+ /** L1 blob fee observed by the oracle. */
20
+ l1BlobFee: bigint;
21
+ /** ETH per fee asset exchange rate (1e12 precision). */
22
+ ethPerFeeAsset: bigint;
23
+ /** Mana target per checkpoint. */
24
+ manaTarget: bigint;
25
+ };
26
+
12
27
  export type ChainMonitorEventMap = {
13
28
  'l1-block': [{ l1BlockNumber: number; timestamp: bigint }];
14
- checkpoint: [{ checkpointNumber: number; l1BlockNumber: number; l2SlotNumber: SlotNumber; timestamp: bigint }];
15
- 'checkpoint-proven': [{ provenCheckpointNumber: number; l1BlockNumber: number; timestamp: bigint }];
29
+ checkpoint: [
30
+ { checkpointNumber: CheckpointNumber; l1BlockNumber: number; l2SlotNumber: SlotNumber; timestamp: bigint },
31
+ ];
32
+ 'checkpoint-proven': [{ provenCheckpointNumber: CheckpointNumber; l1BlockNumber: number; timestamp: bigint }];
16
33
  'l2-messages': [{ totalL2Messages: number; l1BlockNumber: number }];
17
34
  'l2-epoch': [{ l2EpochNumber: EpochNumber; timestamp: bigint; committee: EthAddress[] | undefined }];
18
35
  'l2-slot': [{ l2SlotNumber: SlotNumber; timestamp: bigint }];
36
+ 'l2-fees': [L2FeeData];
19
37
  };
20
38
 
21
39
  /** Utility class that polls the chain on quick intervals and logs new L1 blocks, L2 blocks, and L2 proofs. */
@@ -29,9 +47,9 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
29
47
  /** Current L1 block number */
30
48
  public l1BlockNumber!: number;
31
49
  /** Current checkpoint number */
32
- public checkpointNumber!: number;
50
+ public checkpointNumber!: CheckpointNumber;
33
51
  /** Current proven checkpoint number */
34
- public provenCheckpointNumber!: number;
52
+ public provenCheckpointNumber!: CheckpointNumber;
35
53
  /** L1 timestamp for the current checkpoint */
36
54
  public checkpointTimestamp!: bigint;
37
55
  /** L1 timestamp for the proven checkpoint */
@@ -42,6 +60,8 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
42
60
  public l2EpochNumber!: EpochNumber;
43
61
  /** Current L2 slot number */
44
62
  public l2SlotNumber!: SlotNumber;
63
+ /** Current L2 fee data (components of the minimum fee per mana). */
64
+ public l2FeeData!: L2FeeData;
45
65
 
46
66
  constructor(
47
67
  private readonly rollup: RollupContract,
@@ -74,7 +94,7 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
74
94
  }
75
95
  }
76
96
 
77
- private async getInbox() {
97
+ protected async getInbox() {
78
98
  if (!this.inbox) {
79
99
  const { inboxAddress } = await this.rollup.getRollupAddresses();
80
100
  this.inbox = new InboxContract(this.l1Client, inboxAddress);
@@ -115,9 +135,9 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
115
135
  this.emit('l1-block', { l1BlockNumber: newL1BlockNumber, timestamp });
116
136
  let msg = `L1 block ${newL1BlockNumber} mined at ${timestampString}`;
117
137
 
118
- const newCheckpointNumber = Number(await this.rollup.getCheckpointNumber());
138
+ const newCheckpointNumber = await this.rollup.getCheckpointNumber();
119
139
  if (this.checkpointNumber !== newCheckpointNumber) {
120
- const epochNumber = await this.rollup.getEpochNumberForCheckpoint(BigInt(newCheckpointNumber));
140
+ const epochNumber = await this.rollup.getEpochNumberForCheckpoint(newCheckpointNumber);
121
141
  msg += ` with new checkpoint ${newCheckpointNumber} for epoch ${epochNumber}`;
122
142
  this.checkpointNumber = newCheckpointNumber;
123
143
  this.checkpointTimestamp = timestamp;
@@ -129,9 +149,9 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
129
149
  });
130
150
  }
131
151
 
132
- const newProvenCheckpointNumber = Number(await this.rollup.getProvenCheckpointNumber());
152
+ const newProvenCheckpointNumber = await this.rollup.getProvenCheckpointNumber();
133
153
  if (this.provenCheckpointNumber !== newProvenCheckpointNumber) {
134
- const epochNumber = await this.rollup.getEpochNumberForCheckpoint(BigInt(newProvenCheckpointNumber));
154
+ const epochNumber = await this.rollup.getEpochNumberForCheckpoint(newProvenCheckpointNumber);
135
155
  msg += ` with proof up to checkpoint ${newProvenCheckpointNumber} for epoch ${epochNumber}`;
136
156
  this.provenCheckpointNumber = newProvenCheckpointNumber;
137
157
  this.provenCheckpointTimestamp = timestamp;
@@ -153,9 +173,9 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
153
173
  let committee: EthAddress[] | undefined;
154
174
  if (l2Epoch !== this.l2EpochNumber) {
155
175
  this.l2EpochNumber = l2Epoch;
156
- committee = (await this.rollup.getCurrentEpochCommittee())?.map(addr => EthAddress.fromString(addr));
176
+ committee = await this.rollup.getCurrentEpochCommittee();
157
177
  this.emit('l2-epoch', { l2EpochNumber: l2Epoch, timestamp, committee });
158
- msg += ` starting new epoch ${this.l2EpochNumber} `;
178
+ msg += ` starting new epoch ${this.l2EpochNumber}`;
159
179
  }
160
180
 
161
181
  if (l2SlotNumber !== this.l2SlotNumber) {
@@ -163,6 +183,13 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
163
183
  this.emit('l2-slot', { l2SlotNumber, timestamp });
164
184
  }
165
185
 
186
+ const feeData = await this.fetchFeeData(timestamp);
187
+ if (this.hasFeeDataChanged(feeData)) {
188
+ msg += ` with L2 min fee ${feeData.minFeePerMana}`;
189
+ this.l2FeeData = feeData;
190
+ this.emit('l2-fees', feeData);
191
+ }
192
+
166
193
  this.logger.info(msg, {
167
194
  currentTimestamp: this.dateProvider.nowInSeconds(),
168
195
  l1Timestamp: timestamp,
@@ -173,6 +200,7 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
173
200
  provenCheckpointNumber: this.provenCheckpointNumber,
174
201
  totalL2Messages: this.totalL2Messages,
175
202
  committee,
203
+ ...this.l2FeeData,
176
204
  });
177
205
 
178
206
  return this;
@@ -225,14 +253,13 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
225
253
  });
226
254
  }
227
255
 
228
- public waitUntilCheckpoint(checkpointNumber: number | bigint): Promise<void> {
229
- const targetBlock = typeof checkpointNumber === 'bigint' ? checkpointNumber.valueOf() : checkpointNumber;
230
- if (this.checkpointNumber >= targetBlock) {
256
+ public waitUntilCheckpoint(checkpointNumber: CheckpointNumber): Promise<void> {
257
+ if (this.checkpointNumber >= checkpointNumber) {
231
258
  return Promise.resolve();
232
259
  }
233
260
  return new Promise(resolve => {
234
- const listener = (data: { checkpointNumber: number; timestamp: bigint }) => {
235
- if (data.checkpointNumber >= targetBlock) {
261
+ const listener = (data: { checkpointNumber: CheckpointNumber; timestamp: bigint }) => {
262
+ if (data.checkpointNumber >= checkpointNumber) {
236
263
  this.off('checkpoint', listener);
237
264
  resolve();
238
265
  }
@@ -240,4 +267,36 @@ export class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
240
267
  this.on('checkpoint', listener);
241
268
  });
242
269
  }
270
+
271
+ private async fetchFeeData(timestamp: bigint): Promise<L2FeeData> {
272
+ const [components, minFeePerMana, l1Fees, ethPerFeeAsset, manaTarget] = await Promise.all([
273
+ this.rollup.getManaMinFeeComponentsAt(timestamp, true),
274
+ this.rollup.getManaMinFeeAt(timestamp, true),
275
+ this.rollup.getL1FeesAt(timestamp),
276
+ this.rollup.getEthPerFeeAsset(),
277
+ this.rollup.getManaTarget(),
278
+ ]);
279
+ return {
280
+ ...components,
281
+ minFeePerMana,
282
+ l1BaseFee: l1Fees.baseFee,
283
+ l1BlobFee: l1Fees.blobFee,
284
+ ethPerFeeAsset,
285
+ manaTarget,
286
+ };
287
+ }
288
+
289
+ private hasFeeDataChanged(newData: L2FeeData): boolean {
290
+ if (!this.l2FeeData) {
291
+ return true;
292
+ }
293
+ return (
294
+ this.l2FeeData.sequencerCost !== newData.sequencerCost ||
295
+ this.l2FeeData.proverCost !== newData.proverCost ||
296
+ this.l2FeeData.congestionCost !== newData.congestionCost ||
297
+ this.l2FeeData.l1BaseFee !== newData.l1BaseFee ||
298
+ this.l2FeeData.l1BlobFee !== newData.l1BlobFee ||
299
+ this.l2FeeData.ethPerFeeAsset !== newData.ethPerFeeAsset
300
+ );
301
+ }
243
302
  }