@aztec/ethereum 0.0.1-commit.f1df4d2 → 0.0.1-commit.f224bb98b

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 (105) hide show
  1. package/dest/config.d.ts +3 -1
  2. package/dest/config.d.ts.map +1 -1
  3. package/dest/config.js +11 -3
  4. package/dest/contracts/empire_base.d.ts +3 -1
  5. package/dest/contracts/empire_base.d.ts.map +1 -1
  6. package/dest/contracts/empire_slashing_proposer.d.ts +3 -1
  7. package/dest/contracts/empire_slashing_proposer.d.ts.map +1 -1
  8. package/dest/contracts/empire_slashing_proposer.js +9 -0
  9. package/dest/contracts/fee_asset_price_oracle.d.ts +101 -0
  10. package/dest/contracts/fee_asset_price_oracle.d.ts.map +1 -0
  11. package/dest/contracts/fee_asset_price_oracle.js +651 -0
  12. package/dest/contracts/governance.js +3 -3
  13. package/dest/contracts/governance_proposer.d.ts +3 -1
  14. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  15. package/dest/contracts/governance_proposer.js +9 -0
  16. package/dest/contracts/index.d.ts +2 -1
  17. package/dest/contracts/index.d.ts.map +1 -1
  18. package/dest/contracts/index.js +1 -0
  19. package/dest/contracts/registry.d.ts +3 -1
  20. package/dest/contracts/registry.d.ts.map +1 -1
  21. package/dest/contracts/registry.js +30 -1
  22. package/dest/contracts/rollup.d.ts +10 -6
  23. package/dest/contracts/rollup.d.ts.map +1 -1
  24. package/dest/contracts/rollup.js +22 -7
  25. package/dest/deploy_aztec_l1_contracts.d.ts +2 -3
  26. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -1
  27. package/dest/deploy_aztec_l1_contracts.js +33 -19
  28. package/dest/deploy_l1_contract.js +3 -3
  29. package/dest/generated/l1-contracts-defaults.d.ts +1 -1
  30. package/dest/generated/l1-contracts-defaults.js +1 -1
  31. package/dest/l1_artifacts.d.ts +1051 -42
  32. package/dest/l1_artifacts.d.ts.map +1 -1
  33. package/dest/l1_tx_utils/config.d.ts +7 -1
  34. package/dest/l1_tx_utils/config.d.ts.map +1 -1
  35. package/dest/l1_tx_utils/config.js +14 -1
  36. package/dest/l1_tx_utils/factory.d.ts +18 -10
  37. package/dest/l1_tx_utils/factory.d.ts.map +1 -1
  38. package/dest/l1_tx_utils/factory.js +17 -7
  39. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +1 -1
  40. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +1 -1
  41. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +15 -15
  42. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -1
  43. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +9 -15
  44. package/dest/l1_tx_utils/index-blobs.d.ts +3 -3
  45. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -1
  46. package/dest/l1_tx_utils/index-blobs.js +2 -2
  47. package/dest/l1_tx_utils/index.d.ts +2 -1
  48. package/dest/l1_tx_utils/index.d.ts.map +1 -1
  49. package/dest/l1_tx_utils/index.js +1 -0
  50. package/dest/l1_tx_utils/l1_tx_utils.d.ts +18 -7
  51. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  52. package/dest/l1_tx_utils/l1_tx_utils.js +52 -36
  53. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +1 -1
  54. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  55. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +8 -4
  56. package/dest/l1_tx_utils/tx_delayer.d.ts +56 -0
  57. package/dest/l1_tx_utils/tx_delayer.d.ts.map +1 -0
  58. package/dest/{test → l1_tx_utils}/tx_delayer.js +62 -34
  59. package/dest/test/index.d.ts +1 -3
  60. package/dest/test/index.d.ts.map +1 -1
  61. package/dest/test/index.js +0 -2
  62. package/dest/test/start_anvil.d.ts +16 -3
  63. package/dest/test/start_anvil.d.ts.map +1 -1
  64. package/dest/test/start_anvil.js +129 -29
  65. package/dest/test/upgrade_utils.js +2 -2
  66. package/dest/utils.d.ts +1 -1
  67. package/dest/utils.d.ts.map +1 -1
  68. package/dest/utils.js +16 -12
  69. package/package.json +5 -7
  70. package/src/config.ts +15 -2
  71. package/src/contracts/empire_base.ts +2 -0
  72. package/src/contracts/empire_slashing_proposer.ts +6 -0
  73. package/src/contracts/fee_asset_price_oracle.ts +280 -0
  74. package/src/contracts/governance.ts +3 -3
  75. package/src/contracts/governance_proposer.ts +6 -0
  76. package/src/contracts/index.ts +1 -0
  77. package/src/contracts/registry.ts +31 -1
  78. package/src/contracts/rollup.ts +38 -9
  79. package/src/deploy_aztec_l1_contracts.ts +56 -29
  80. package/src/deploy_l1_contract.ts +3 -3
  81. package/src/generated/l1-contracts-defaults.ts +1 -1
  82. package/src/l1_tx_utils/config.ts +20 -0
  83. package/src/l1_tx_utils/factory.ts +31 -31
  84. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +1 -1
  85. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +1 -1
  86. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +43 -54
  87. package/src/l1_tx_utils/index-blobs.ts +2 -2
  88. package/src/l1_tx_utils/index.ts +1 -0
  89. package/src/l1_tx_utils/l1_tx_utils.ts +54 -26
  90. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +8 -4
  91. package/src/{test → l1_tx_utils}/tx_delayer.ts +78 -50
  92. package/src/test/index.ts +0 -2
  93. package/src/test/start_anvil.ts +154 -29
  94. package/src/test/upgrade_utils.ts +2 -2
  95. package/src/utils.ts +17 -14
  96. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts +0 -26
  97. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.d.ts.map +0 -1
  98. package/dest/l1_tx_utils/l1_tx_utils_with_blobs.js +0 -26
  99. package/dest/test/delayed_tx_utils.d.ts +0 -13
  100. package/dest/test/delayed_tx_utils.d.ts.map +0 -1
  101. package/dest/test/delayed_tx_utils.js +0 -28
  102. package/dest/test/tx_delayer.d.ts +0 -36
  103. package/dest/test/tx_delayer.d.ts.map +0 -1
  104. package/src/l1_tx_utils/l1_tx_utils_with_blobs.ts +0 -77
  105. 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,16 @@ 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';
20
22
 
21
23
  const MAX_WAIT_TIME_SECONDS = 180;
22
24
 
@@ -73,82 +75,98 @@ export function waitUntilL1Timestamp<T extends Client>(
73
75
  );
74
76
  }
75
77
 
76
- export interface Delayer {
77
- /** Returns the hashes of all effectively sent txs. */
78
- getSentTxHashes(): Hex[];
79
- /** Returns the raw hex for all cancelled txs. */
80
- getCancelledTxs(): Hex[];
81
- /** Delays the next tx to be sent so it lands on the given L1 block number. */
82
- pauseNextTxUntilBlock(l1BlockNumber: number | bigint | undefined): void;
83
- /** Delays the next tx to be sent so it lands on the given timestamp. */
84
- pauseNextTxUntilTimestamp(l1Timestamp: number | bigint | undefined): void;
85
- /** Delays the next tx to be sent indefinitely. */
86
- cancelNextTx(): void;
87
- /**
88
- * Sets max inclusion time into slot. If more than this many seconds have passed
89
- * since the last L1 block was mined, then any tx will not be mined in the current
90
- * L1 slot but will be deferred for the next one.
91
- */
92
- setMaxInclusionTimeIntoSlot(seconds: number | bigint | undefined): void;
93
- }
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[] = [];
94
87
 
95
- class DelayerImpl implements Delayer {
96
- private logger = createLogger('ethereum:tx_delayer');
97
88
  constructor(
98
89
  public dateProvider: DateProvider,
99
90
  opts: { ethereumSlotDuration: bigint | number },
91
+ bindings: LoggerBindings,
100
92
  ) {
101
93
  this.ethereumSlotDuration = BigInt(opts.ethereumSlotDuration);
94
+ this.logger = createLogger('ethereum:tx_delayer', bindings);
102
95
  }
103
96
 
104
- public maxInclusionTimeIntoSlot: number | undefined = undefined;
105
- public ethereumSlotDuration: bigint;
106
- public nextWait: { l1Timestamp: bigint } | { l1BlockNumber: bigint } | { indefinitely: true } | undefined = undefined;
107
- public sentTxHashes: Hex[] = [];
108
- public cancelledTxs: Hex[] = [];
97
+ /** Returns the logger instance used by this delayer. */
98
+ getLogger(): Logger {
99
+ return this.logger;
100
+ }
109
101
 
102
+ /** Returns the hashes of all effectively sent txs. */
110
103
  getSentTxHashes() {
111
104
  return this.sentTxHashes;
112
105
  }
113
106
 
107
+ /** Returns the raw hex for all cancelled txs. */
114
108
  getCancelledTxs(): Hex[] {
115
109
  return this.cancelledTxs;
116
110
  }
117
111
 
112
+ /** Delays the next tx to be sent so it lands on the given L1 block number. */
118
113
  pauseNextTxUntilBlock(l1BlockNumber: number | bigint) {
119
114
  this.nextWait = { l1BlockNumber: BigInt(l1BlockNumber) };
120
115
  }
121
116
 
117
+ /** Delays the next tx to be sent so it lands on the given timestamp. */
122
118
  pauseNextTxUntilTimestamp(l1Timestamp: number | bigint) {
123
119
  this.nextWait = { l1Timestamp: BigInt(l1Timestamp) };
124
120
  }
125
121
 
122
+ /** Delays the next tx to be sent indefinitely. */
126
123
  cancelNextTx() {
127
124
  this.nextWait = { indefinitely: true };
128
125
  }
129
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
+ */
130
132
  setMaxInclusionTimeIntoSlot(seconds: number | undefined) {
131
133
  this.maxInclusionTimeIntoSlot = seconds;
132
134
  }
133
135
  }
134
136
 
135
137
  /**
136
- * Returns a new client (without modifying the one passed in) with an injected tx delayer.
137
- * The delayer can be used to hold off the next tx to be sent until a given block number.
138
- * 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.
139
140
  */
140
- export function withDelayer<T extends ViemClient>(
141
- client: T,
141
+ export function createDelayer(
142
142
  dateProvider: DateProvider,
143
143
  opts: { ethereumSlotDuration: bigint | number },
144
- ): { client: T; delayer: Delayer } {
145
- if (!isExtendedClient(client)) {
146
- 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;
147
157
  }
148
- const logger = createLogger('ethereum:tx_delayer');
149
- const delayer = new DelayerImpl(dateProvider, opts);
158
+ }
150
159
 
151
- 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)
152
170
  // Tweak sendRawTransaction so it uses the delay defined in the delayer.
153
171
  // Note that this will only work with local accounts (ie accounts for which we have the private key).
154
172
  // Transactions signed by the node will not be delayed since they use sendTransaction directly,
@@ -160,6 +178,7 @@ export function withDelayer<T extends ViemClient>(
160
178
 
161
179
  const { serializedTransaction } = args[0];
162
180
  const publicClient = client as unknown as PublicClient;
181
+ const sender = await tryRecoverSender(serializedTransaction);
163
182
 
164
183
  if (delayer.nextWait !== undefined) {
165
184
  // Check if we have been instructed to delay the next tx.
@@ -171,7 +190,7 @@ export function withDelayer<T extends ViemClient>(
171
190
 
172
191
  // Cancel tx outright if instructed
173
192
  if ('indefinitely' in waitUntil && waitUntil.indefinitely) {
174
- logger.info(`Cancelling tx ${txHash}`);
193
+ logger.info(`Cancelling tx ${txHash}`, { sender });
175
194
  delayer.cancelledTxs.push(serializedTransaction);
176
195
  return Promise.resolve(txHash);
177
196
  }
@@ -185,6 +204,7 @@ export function withDelayer<T extends ViemClient>(
185
204
  : undefined;
186
205
 
187
206
  logger.info(`Delaying tx ${txHash} until ${inspect(waitUntil)}`, {
207
+ sender,
188
208
  argsLen: args.length,
189
209
  ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars'),
190
210
  });
@@ -196,6 +216,7 @@ export function withDelayer<T extends ViemClient>(
196
216
 
197
217
  txHash = computeTxHash(serializedTransaction);
198
218
  const logData = {
219
+ sender,
199
220
  ...omit(parseTransaction(serializedTransaction), 'data', 'sidecars'),
200
221
  lastBlockTimestamp,
201
222
  now,
@@ -225,28 +246,35 @@ export function withDelayer<T extends ViemClient>(
225
246
  computedTxHash: txHash,
226
247
  });
227
248
  }
228
- logger.info(`Sent previously delayed tx ${clientTxHash}`);
249
+ logger.info(`Sent previously delayed tx ${clientTxHash}`, { sender });
229
250
  delayer.sentTxHashes.push(clientTxHash);
230
251
  })
231
252
  .catch(err => logger.error(`Error sending tx after delay`, err));
232
253
  return Promise.resolve(txHash!);
233
254
  } else {
234
255
  const txHash = await client.sendRawTransaction(...args);
235
- logger.debug(`Sent tx immediately ${txHash}`);
256
+ logger.debug(`Sent tx immediately ${txHash}`, { sender });
236
257
  delayer.sentTxHashes.push(txHash);
237
258
  return txHash;
238
259
  }
239
260
  },
240
- }))
241
- // Re-extend with sendTransaction so it uses the modified sendRawTransaction.
242
- .extend(client => ({ sendTransaction: walletActions(client).sendTransaction }))
243
- // And with the actions that depend on the modified sendTransaction
244
- .extend(client => ({
245
- writeContract: walletActions(client).writeContract,
246
- deployContract: walletActions(client).deployContract,
247
- })) 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;
248
276
 
249
- return { client: extended, delayer };
277
+ return extended as T;
250
278
  }
251
279
 
252
280
  /**
package/src/test/index.ts CHANGED
@@ -1,8 +1,6 @@
1
- export * from './delayed_tx_utils.js';
2
1
  export * from './eth_cheat_codes.js';
3
2
  export * from './eth_cheat_codes_with_state.js';
4
3
  export * from './start_anvil.js';
5
- export * from './tx_delayer.js';
6
4
  export * from './upgrade_utils.js';
7
5
  export * from './chain_monitor.js';
8
6
  export * from './rollup_cheat_codes.js';
@@ -2,9 +2,17 @@ import { createLogger } from '@aztec/foundation/log';
2
2
  import { makeBackoff, retry } from '@aztec/foundation/retry';
3
3
  import { fileURLToPath } from '@aztec/foundation/url';
4
4
 
5
- import { type Anvil, createAnvil } from '@viem/anvil';
5
+ import { type ChildProcess, spawn } from 'child_process';
6
6
  import { dirname, resolve } from 'path';
7
7
 
8
+ /** Minimal interface matching the @viem/anvil Anvil shape used by callers. */
9
+ export interface Anvil {
10
+ readonly port: number;
11
+ readonly host: string;
12
+ readonly status: 'listening' | 'idle';
13
+ stop(): Promise<void>;
14
+ }
15
+
8
16
  /**
9
17
  * Ensures there's a running Anvil instance and returns the RPC URL.
10
18
  */
@@ -16,56 +24,173 @@ export async function startAnvil(
16
24
  captureMethodCalls?: boolean;
17
25
  accounts?: number;
18
26
  chainId?: number;
19
- /** The hardfork to use - note: @viem/anvil types are out of date but 'cancun' and 'latest' work */
27
+ /** The hardfork to use (e.g. 'cancun', 'latest'). */
20
28
  hardfork?: string;
29
+ /**
30
+ * Number of slots per epoch used by anvil to compute the 'finalized' and 'safe' block tags.
31
+ * Anvil reports `finalized = latest - slotsInAnEpoch * 2`.
32
+ * Defaults to 1 so the finalized block advances immediately, making tests that check
33
+ * L1-finality-based logic work without needing hundreds of mined blocks.
34
+ */
35
+ slotsInAnEpoch?: number;
21
36
  } = {},
22
37
  ): Promise<{ anvil: Anvil; methodCalls?: string[]; rpcUrl: string; stop: () => Promise<void> }> {
23
38
  const anvilBinary = resolve(dirname(fileURLToPath(import.meta.url)), '../../', 'scripts/anvil_kill_wrapper.sh');
24
39
  const logger = opts.log ? createLogger('ethereum:anvil') : undefined;
25
40
  const methodCalls = opts.captureMethodCalls ? ([] as string[]) : undefined;
26
41
 
27
- let port: number | undefined;
42
+ let detectedPort: number | undefined;
28
43
 
29
- // Start anvil.
30
- // We go via a wrapper script to ensure if the parent dies, anvil dies.
31
44
  const anvil = await retry(
32
45
  async () => {
33
- const anvil = createAnvil({
34
- anvilBinary,
35
- host: '127.0.0.1',
36
- port: opts.port ?? (process.env.ANVIL_PORT ? parseInt(process.env.ANVIL_PORT) : 8545),
37
- blockTime: opts.l1BlockTime,
38
- stopTimeout: 1000,
39
- accounts: opts.accounts ?? 20,
40
- gasLimit: 45_000_000n,
41
- chainId: opts.chainId ?? 31337,
46
+ const port = opts.port ?? (process.env.ANVIL_PORT ? parseInt(process.env.ANVIL_PORT) : 8545);
47
+ const args: string[] = [
48
+ '--host',
49
+ '127.0.0.1',
50
+ '--port',
51
+ String(port),
52
+ '--accounts',
53
+ String(opts.accounts ?? 20),
54
+ '--gas-limit',
55
+ String(45_000_000),
56
+ '--chain-id',
57
+ String(opts.chainId ?? 31337),
58
+ ];
59
+ if (opts.l1BlockTime !== undefined) {
60
+ args.push('--block-time', String(opts.l1BlockTime));
61
+ }
62
+ if (opts.hardfork !== undefined) {
63
+ args.push('--hardfork', opts.hardfork);
64
+ }
65
+ args.push('--slots-in-an-epoch', String(opts.slotsInAnEpoch ?? 1));
66
+
67
+ const child = spawn(anvilBinary, args, {
68
+ stdio: ['ignore', 'pipe', 'pipe'],
69
+ env: { ...process.env, RAYON_NUM_THREADS: '1' },
42
70
  });
43
71
 
44
- // Listen to the anvil output to get the port.
45
- const removeHandler = anvil.on('message', (message: string) => {
46
- logger?.debug(message.trim());
72
+ // Wait for "Listening on" or an early exit.
73
+ await new Promise<void>((resolve, reject) => {
74
+ let stderr = '';
75
+
76
+ const onStdout = (data: Buffer) => {
77
+ const text = data.toString();
78
+ logger?.debug(text.trim());
79
+ methodCalls?.push(...(text.match(/eth_[^\s]+/g) || []));
47
80
 
48
- methodCalls?.push(...(message.match(/eth_[^\s]+/g) || []));
49
- if (port === undefined && message.includes('Listening on')) {
50
- port = parseInt(message.match(/Listening on ([^:]+):(\d+)/)![2]);
51
- }
81
+ if (detectedPort === undefined && text.includes('Listening on')) {
82
+ const match = text.match(/Listening on ([^:]+):(\d+)/);
83
+ if (match) {
84
+ detectedPort = parseInt(match[2]);
85
+ }
86
+ }
87
+ if (detectedPort !== undefined) {
88
+ child.stdout?.removeListener('data', onStdout);
89
+ child.stderr?.removeListener('data', onStderr);
90
+ child.removeListener('close', onClose);
91
+ resolve();
92
+ }
93
+ };
94
+
95
+ const onStderr = (data: Buffer) => {
96
+ stderr += data.toString();
97
+ logger?.debug(data.toString().trim());
98
+ };
99
+
100
+ const onClose = (code: number | null) => {
101
+ child.stdout?.removeListener('data', onStdout);
102
+ child.stderr?.removeListener('data', onStderr);
103
+ reject(new Error(`Anvil exited with code ${code} before listening. stderr: ${stderr}`));
104
+ };
105
+
106
+ child.stdout?.on('data', onStdout);
107
+ child.stderr?.on('data', onStderr);
108
+ child.once('close', onClose);
52
109
  });
53
- await anvil.start();
54
- if (!logger && !opts.captureMethodCalls) {
55
- removeHandler();
110
+
111
+ // Continue piping for logging / method-call capture after startup.
112
+ if (logger || opts.captureMethodCalls) {
113
+ child.stdout?.on('data', (data: Buffer) => {
114
+ const text = data.toString();
115
+ logger?.debug(text.trim());
116
+ methodCalls?.push(...(text.match(/eth_[^\s]+/g) || []));
117
+ });
118
+ child.stderr?.on('data', (data: Buffer) => {
119
+ logger?.debug(data.toString().trim());
120
+ });
121
+ } else {
122
+ // Consume streams so the child process doesn't block on full pipe buffers.
123
+ child.stdout?.resume();
124
+ child.stderr?.resume();
56
125
  }
57
126
 
58
- return anvil;
127
+ return child;
59
128
  },
60
129
  'Start anvil',
61
130
  makeBackoff([5, 5, 5]),
62
131
  );
63
132
 
64
- if (!port) {
133
+ if (!detectedPort) {
65
134
  throw new Error('Failed to start anvil');
66
135
  }
67
136
 
68
- // Monkeypatch the anvil instance to include the actually assigned port
69
- // Object.defineProperty(anvil, 'port', { value: port, writable: false });
70
- return { anvil, methodCalls, stop: () => anvil.stop(), rpcUrl: `http://127.0.0.1:${port}` };
137
+ const port = detectedPort;
138
+ let status: 'listening' | 'idle' = 'listening';
139
+
140
+ anvil.once('close', () => {
141
+ status = 'idle';
142
+ });
143
+
144
+ const stop = async () => {
145
+ if (status === 'idle') {
146
+ return;
147
+ }
148
+ await killChild(anvil);
149
+ };
150
+
151
+ const anvilObj: Anvil = {
152
+ port,
153
+ host: '127.0.0.1',
154
+ get status() {
155
+ return status;
156
+ },
157
+ stop,
158
+ };
159
+
160
+ return { anvil: anvilObj, methodCalls, stop, rpcUrl: `http://127.0.0.1:${port}` };
161
+ }
162
+
163
+ /** Send SIGTERM, wait up to 5 s, then SIGKILL. All timers are always cleared. */
164
+ function killChild(child: ChildProcess): Promise<void> {
165
+ return new Promise<void>(resolve => {
166
+ if (child.exitCode !== null || child.killed) {
167
+ child.stdout?.destroy();
168
+ child.stderr?.destroy();
169
+ resolve();
170
+ return;
171
+ }
172
+
173
+ let killTimer: NodeJS.Timeout | undefined;
174
+
175
+ const onClose = () => {
176
+ if (killTimer !== undefined) {
177
+ clearTimeout(killTimer);
178
+ }
179
+ // Destroy stdio streams so their PipeWrap handles don't keep the event loop alive.
180
+ child.stdout?.destroy();
181
+ child.stderr?.destroy();
182
+ resolve();
183
+ };
184
+
185
+ child.once('close', onClose);
186
+ child.kill('SIGTERM');
187
+
188
+ killTimer = setTimeout(() => {
189
+ killTimer = undefined;
190
+ child.kill('SIGKILL');
191
+ }, 5000);
192
+
193
+ // Ensure the timer does not prevent Node from exiting.
194
+ killTimer.unref();
195
+ });
71
196
  }
@@ -7,7 +7,7 @@ import { type GetContractReturnType, type PrivateKeyAccount, getContract } from
7
7
 
8
8
  import { extractProposalIdFromLogs } from '../contracts/governance.js';
9
9
  import type { L1ContractAddresses } from '../l1_contract_addresses.js';
10
- import { createL1TxUtilsFromViemWallet } from '../l1_tx_utils/index.js';
10
+ import { createL1TxUtils } from '../l1_tx_utils/index.js';
11
11
  import type { ExtendedViemWalletClient, ViemPublicClient } from '../types.js';
12
12
  import { EthCheatCodes } from './eth_cheat_codes.js';
13
13
 
@@ -22,7 +22,7 @@ export async function executeGovernanceProposal(
22
22
  ) {
23
23
  const proposal = await governance.read.getProposal([proposalId]);
24
24
 
25
- const l1TxUtils = createL1TxUtilsFromViemWallet(l1Client);
25
+ const l1TxUtils = createL1TxUtils(l1Client);
26
26
 
27
27
  const waitL1Block = async () => {
28
28
  await l1TxUtils.sendAndMonitorTransaction({
package/src/utils.ts CHANGED
@@ -170,6 +170,21 @@ function getNestedErrorData(error: unknown): string | undefined {
170
170
  return undefined;
171
171
  }
172
172
 
173
+ /**
174
+ * Truncates an error message to a safe length for log renderers.
175
+ * LogExplorer can only render up to 2500 characters in its summary view.
176
+ * We cap at 2000 to leave room for decorating context added by callers.
177
+ */
178
+ function truncateErrorMessage(message: string): string {
179
+ const MAX = 2000;
180
+ const CHUNK = 950;
181
+ if (message.length <= MAX) {
182
+ return message;
183
+ }
184
+ const truncated = message.length - 2 * CHUNK;
185
+ return message.slice(0, CHUNK) + `...${truncated} characters truncated...` + message.slice(-CHUNK);
186
+ }
187
+
173
188
  /**
174
189
  * Formats a Viem error into a FormattedViemError instance.
175
190
  * @param error - The error to format.
@@ -232,22 +247,10 @@ export function formatViemError(error: any, abi: Abi = ErrorsAbi): FormattedViem
232
247
 
233
248
  // If it's a regular Error instance, return it with its message
234
249
  if (error instanceof Error) {
235
- return new FormattedViemError(error.message, (error as any)?.metaMessages);
236
- }
237
-
238
- const body = String(error);
239
- const length = body.length;
240
- // LogExplorer can only render up to 2500 characters in it's summary view. Try to keep the whole message below this number
241
- // Limit the error to 2000 chacaters in order to allow code higher up to decorate this error with extra details (up to 500 characters)
242
- if (length > 2000) {
243
- const chunk = 950;
244
- const truncated = length - 2 * chunk;
245
- return new FormattedViemError(
246
- body.slice(0, chunk) + `...${truncated} characters truncated...` + body.slice(-1 * chunk),
247
- );
250
+ return new FormattedViemError(truncateErrorMessage(error.message), (error as any)?.metaMessages);
248
251
  }
249
252
 
250
- return new FormattedViemError(body);
253
+ return new FormattedViemError(truncateErrorMessage(String(error)));
251
254
  }
252
255
 
253
256
  function stripAbis(obj: any) {
@@ -1,26 +0,0 @@
1
- import type { Logger } from '@aztec/foundation/log';
2
- import { DateProvider } from '@aztec/foundation/timer';
3
- import type { EthSigner } from '../eth-signer/eth-signer.js';
4
- import type { ExtendedViemWalletClient, ViemClient } from '../types.js';
5
- import type { L1TxUtilsConfig } from './config.js';
6
- import type { IL1TxMetrics, IL1TxStore } from './interfaces.js';
7
- import { L1TxUtils } from './l1_tx_utils.js';
8
- import type { L1BlobInputs } from './types.js';
9
- /** Extends L1TxUtils with the capability to cancel blobs. This needs to be a separate class so we don't require a dependency on blob-lib unnecessarily. */
10
- export declare class L1TxUtilsWithBlobs extends L1TxUtils {
11
- /** Makes empty blob inputs for the cancellation tx. */
12
- protected makeEmptyBlobInputs(maxFeePerBlobGas: bigint): Required<L1BlobInputs>;
13
- }
14
- export declare function createL1TxUtilsWithBlobsFromViemWallet(client: ExtendedViemWalletClient, deps?: {
15
- logger?: Logger;
16
- dateProvider?: DateProvider;
17
- store?: IL1TxStore;
18
- metrics?: IL1TxMetrics;
19
- }, config?: Partial<L1TxUtilsConfig>, debugMaxGasLimit?: boolean): L1TxUtilsWithBlobs;
20
- export declare function createL1TxUtilsWithBlobsFromEthSigner(client: ViemClient, signer: EthSigner, deps?: {
21
- logger?: Logger;
22
- dateProvider?: DateProvider;
23
- store?: IL1TxStore;
24
- metrics?: IL1TxMetrics;
25
- }, config?: Partial<L1TxUtilsConfig>, debugMaxGasLimit?: boolean): L1TxUtilsWithBlobs;
26
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfdHhfdXRpbHNfd2l0aF9ibG9icy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2wxX3R4X3V0aWxzL2wxX3R4X3V0aWxzX3dpdGhfYmxvYnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDcEQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBSXZELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzdELE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUN4RSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLFVBQVUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ2hFLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUU3QyxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQW1CLE1BQU0sWUFBWSxDQUFDO0FBRWhFLDJKQUEySjtBQUMzSixxQkFBYSxrQkFBbUIsU0FBUSxTQUFTO0lBQy9DLHVEQUF1RDtJQUN2RCxVQUFtQixtQkFBbUIsQ0FBQyxnQkFBZ0IsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQUFDLFlBQVksQ0FBQyxDQUl2RjtDQUNGO0FBRUQsd0JBQWdCLHNDQUFzQyxDQUNwRCxNQUFNLEVBQUUsd0JBQXdCLEVBQ2hDLElBQUksR0FBRTtJQUNKLE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNoQixZQUFZLENBQUMsRUFBRSxZQUFZLENBQUM7SUFDNUIsS0FBSyxDQUFDLEVBQUUsVUFBVSxDQUFDO0lBQ25CLE9BQU8sQ0FBQyxFQUFFLFlBQVksQ0FBQztDQUNuQixFQUNOLE1BQU0sR0FBRSxPQUFPLENBQUMsZUFBZSxDQUFNLEVBQ3JDLGdCQUFnQixHQUFFLE9BQWUsc0JBYWxDO0FBRUQsd0JBQWdCLHFDQUFxQyxDQUNuRCxNQUFNLEVBQUUsVUFBVSxFQUNsQixNQUFNLEVBQUUsU0FBUyxFQUNqQixJQUFJLEdBQUU7SUFDSixNQUFNLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDaEIsWUFBWSxDQUFDLEVBQUUsWUFBWSxDQUFDO0lBQzVCLEtBQUssQ0FBQyxFQUFFLFVBQVUsQ0FBQztJQUNuQixPQUFPLENBQUMsRUFBRSxZQUFZLENBQUM7Q0FDbkIsRUFDTixNQUFNLEdBQUUsT0FBTyxDQUFDLGVBQWUsQ0FBTSxFQUNyQyxnQkFBZ0IsR0FBRSxPQUFlLHNCQWlCbEMifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"l1_tx_utils_with_blobs.d.ts","sourceRoot":"","sources":["../../src/l1_tx_utils/l1_tx_utils_with_blobs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAEhE,2JAA2J;AAC3J,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,uDAAuD;IACvD,UAAmB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,CAIvF;CACF;AAED,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,wBAAwB,EAChC,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CACnB,EACN,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,gBAAgB,GAAE,OAAe,sBAalC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CACnB,EACN,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,gBAAgB,GAAE,OAAe,sBAiBlC"}
@@ -1,26 +0,0 @@
1
- import { Blob } from '@aztec/blob-lib';
2
- import { EthAddress } from '@aztec/foundation/eth-address';
3
- import { L1TxUtils } from './l1_tx_utils.js';
4
- import { createViemSigner } from './signer.js';
5
- /** Extends L1TxUtils with the capability to cancel blobs. This needs to be a separate class so we don't require a dependency on blob-lib unnecessarily. */ export class L1TxUtilsWithBlobs extends L1TxUtils {
6
- /** Makes empty blob inputs for the cancellation tx. */ makeEmptyBlobInputs(maxFeePerBlobGas) {
7
- const blobData = new Uint8Array(131072).fill(0);
8
- const kzg = Blob.getViemKzgInstance();
9
- return {
10
- blobs: [
11
- blobData
12
- ],
13
- kzg,
14
- maxFeePerBlobGas
15
- };
16
- }
17
- }
18
- export function createL1TxUtilsWithBlobsFromViemWallet(client, deps = {}, config = {}, debugMaxGasLimit = false) {
19
- return new L1TxUtilsWithBlobs(client, EthAddress.fromString(client.account.address), createViemSigner(client), deps.logger, deps.dateProvider, config, debugMaxGasLimit, deps.store, deps.metrics);
20
- }
21
- export function createL1TxUtilsWithBlobsFromEthSigner(client, signer, deps = {}, config = {}, debugMaxGasLimit = false) {
22
- const callback = async (transaction, _signingAddress)=>{
23
- return (await signer.signTransaction(transaction)).toViemTransactionSignature();
24
- };
25
- return new L1TxUtilsWithBlobs(client, signer.address, callback, deps.logger, deps.dateProvider, config, debugMaxGasLimit, deps.store, deps.metrics);
26
- }
@@ -1,13 +0,0 @@
1
- import { type Logger } from '@aztec/foundation/log';
2
- import { DateProvider } from '@aztec/foundation/timer';
3
- import { type L1TxUtilsConfig } from '../l1_tx_utils/index.js';
4
- import { L1TxUtilsWithBlobs } from '../l1_tx_utils/l1_tx_utils_with_blobs.js';
5
- import type { ExtendedViemWalletClient } from '../types.js';
6
- import { type Delayer } from './tx_delayer.js';
7
- export declare class DelayedTxUtils extends L1TxUtilsWithBlobs {
8
- delayer: Delayer | undefined;
9
- static fromL1TxUtils(l1TxUtils: L1TxUtilsWithBlobs, ethereumSlotDuration: number, wallet: ExtendedViemWalletClient): DelayedTxUtils;
10
- enableDelayer(ethereumSlotDuration: number): void;
11
- }
12
- export declare function createDelayedL1TxUtilsFromViemWallet(client: ExtendedViemWalletClient, logger?: Logger, dateProvider?: DateProvider, config?: Partial<L1TxUtilsConfig>, debugMaxGasLimit?: boolean): DelayedTxUtils;
13
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVsYXllZF90eF91dGlscy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3QvZGVsYXllZF90eF91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRXZELE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBb0IsTUFBTSx5QkFBeUIsQ0FBQztBQUNqRixPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQ0FBMEMsQ0FBQztBQUM5RSxPQUFPLEtBQUssRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM1RCxPQUFPLEVBQUUsS0FBSyxPQUFPLEVBQWUsTUFBTSxpQkFBaUIsQ0FBQztBQUU1RCxxQkFBYSxjQUFlLFNBQVEsa0JBQWtCO0lBQzdDLE9BQU8sRUFBRSxPQUFPLEdBQUcsU0FBUyxDQUFDO0lBRXBDLE9BQWMsYUFBYSxDQUN6QixTQUFTLEVBQUUsa0JBQWtCLEVBQzdCLG9CQUFvQixFQUFFLE1BQU0sRUFDNUIsTUFBTSxFQUFFLHdCQUF3QixrQkFTakM7SUFFTSxhQUFhLENBQUMsb0JBQW9CLEVBQUUsTUFBTSxRQU1oRDtDQUNGO0FBRUQsd0JBQWdCLG9DQUFvQyxDQUNsRCxNQUFNLEVBQUUsd0JBQXdCLEVBQ2hDLE1BQU0sR0FBRSxNQUFrQyxFQUMxQyxZQUFZLEdBQUUsWUFBaUMsRUFDL0MsTUFBTSxDQUFDLEVBQUUsT0FBTyxDQUFDLGVBQWUsQ0FBQyxFQUNqQyxnQkFBZ0IsR0FBRSxPQUFlLGtCQVdsQyJ9
@@ -1 +0,0 @@
1
- {"version":3,"file":"delayed_tx_utils.d.ts","sourceRoot":"","sources":["../../src/test/delayed_tx_utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,KAAK,OAAO,EAAe,MAAM,iBAAiB,CAAC;AAE5D,qBAAa,cAAe,SAAQ,kBAAkB;IAC7C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAEpC,OAAc,aAAa,CACzB,SAAS,EAAE,kBAAkB,EAC7B,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,wBAAwB,kBASjC;IAEM,aAAa,CAAC,oBAAoB,EAAE,MAAM,QAMhD;CACF;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,wBAAwB,EAChC,MAAM,GAAE,MAAkC,EAC1C,YAAY,GAAE,YAAiC,EAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,gBAAgB,GAAE,OAAe,kBAWlC"}
@@ -1,28 +0,0 @@
1
- import { EthAddress } from '@aztec/foundation/eth-address';
2
- import { createLogger } from '@aztec/foundation/log';
3
- import { DateProvider } from '@aztec/foundation/timer';
4
- import { createViemSigner } from '../l1_tx_utils/index.js';
5
- import { L1TxUtilsWithBlobs } from '../l1_tx_utils/l1_tx_utils_with_blobs.js';
6
- import { withDelayer } from './tx_delayer.js';
7
- export class DelayedTxUtils extends L1TxUtilsWithBlobs {
8
- delayer;
9
- static fromL1TxUtils(l1TxUtils, ethereumSlotDuration, wallet) {
10
- const { client, delayer } = withDelayer(wallet, l1TxUtils.dateProvider, {
11
- ethereumSlotDuration
12
- });
13
- const casted = l1TxUtils;
14
- casted.delayer = delayer;
15
- casted.client = client;
16
- return casted;
17
- }
18
- enableDelayer(ethereumSlotDuration) {
19
- const { client, delayer } = withDelayer(this.client, this.dateProvider, {
20
- ethereumSlotDuration
21
- });
22
- this.delayer = delayer;
23
- this.client = client;
24
- }
25
- }
26
- export function createDelayedL1TxUtilsFromViemWallet(client, logger = createLogger('L1TxUtils'), dateProvider = new DateProvider(), config, debugMaxGasLimit = false) {
27
- return new DelayedTxUtils(client, EthAddress.fromString(client.account.address), createViemSigner(client), logger, dateProvider, config, debugMaxGasLimit);
28
- }