@aztec/validator-client 0.0.1-commit.fce3e4f → 0.0.1-commit.ffe5b04ea

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 (57) hide show
  1. package/README.md +327 -0
  2. package/dest/block_proposal_handler.d.ts +25 -14
  3. package/dest/block_proposal_handler.d.ts.map +1 -1
  4. package/dest/block_proposal_handler.js +366 -105
  5. package/dest/checkpoint_builder.d.ts +76 -0
  6. package/dest/checkpoint_builder.d.ts.map +1 -0
  7. package/dest/checkpoint_builder.js +228 -0
  8. package/dest/config.d.ts +1 -1
  9. package/dest/config.d.ts.map +1 -1
  10. package/dest/config.js +37 -8
  11. package/dest/duties/validation_service.d.ts +42 -13
  12. package/dest/duties/validation_service.d.ts.map +1 -1
  13. package/dest/duties/validation_service.js +105 -28
  14. package/dest/factory.d.ts +13 -8
  15. package/dest/factory.d.ts.map +1 -1
  16. package/dest/factory.js +4 -3
  17. package/dest/index.d.ts +2 -1
  18. package/dest/index.d.ts.map +1 -1
  19. package/dest/index.js +1 -0
  20. package/dest/key_store/ha_key_store.d.ts +99 -0
  21. package/dest/key_store/ha_key_store.d.ts.map +1 -0
  22. package/dest/key_store/ha_key_store.js +208 -0
  23. package/dest/key_store/index.d.ts +2 -1
  24. package/dest/key_store/index.d.ts.map +1 -1
  25. package/dest/key_store/index.js +1 -0
  26. package/dest/key_store/interface.d.ts +36 -6
  27. package/dest/key_store/interface.d.ts.map +1 -1
  28. package/dest/key_store/local_key_store.d.ts +10 -5
  29. package/dest/key_store/local_key_store.d.ts.map +1 -1
  30. package/dest/key_store/local_key_store.js +9 -5
  31. package/dest/key_store/node_keystore_adapter.d.ts +18 -5
  32. package/dest/key_store/node_keystore_adapter.d.ts.map +1 -1
  33. package/dest/key_store/node_keystore_adapter.js +18 -4
  34. package/dest/key_store/web3signer_key_store.d.ts +10 -5
  35. package/dest/key_store/web3signer_key_store.d.ts.map +1 -1
  36. package/dest/key_store/web3signer_key_store.js +9 -5
  37. package/dest/metrics.d.ts +12 -3
  38. package/dest/metrics.d.ts.map +1 -1
  39. package/dest/metrics.js +46 -30
  40. package/dest/validator.d.ts +76 -21
  41. package/dest/validator.d.ts.map +1 -1
  42. package/dest/validator.js +478 -57
  43. package/package.json +23 -13
  44. package/src/block_proposal_handler.ts +288 -75
  45. package/src/checkpoint_builder.ts +390 -0
  46. package/src/config.ts +36 -7
  47. package/src/duties/validation_service.ts +156 -33
  48. package/src/factory.ts +18 -8
  49. package/src/index.ts +1 -0
  50. package/src/key_store/ha_key_store.ts +269 -0
  51. package/src/key_store/index.ts +1 -0
  52. package/src/key_store/interface.ts +44 -5
  53. package/src/key_store/local_key_store.ts +14 -5
  54. package/src/key_store/node_keystore_adapter.ts +28 -5
  55. package/src/key_store/web3signer_key_store.ts +18 -5
  56. package/src/metrics.ts +63 -33
  57. package/src/validator.ts +640 -85
@@ -1,33 +1,102 @@
1
+ function _ts_add_disposable_resource(env, value, async) {
2
+ if (value !== null && value !== void 0) {
3
+ if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
4
+ var dispose, inner;
5
+ if (async) {
6
+ if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
7
+ dispose = value[Symbol.asyncDispose];
8
+ }
9
+ if (dispose === void 0) {
10
+ if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
11
+ dispose = value[Symbol.dispose];
12
+ if (async) inner = dispose;
13
+ }
14
+ if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
15
+ if (inner) dispose = function() {
16
+ try {
17
+ inner.call(this);
18
+ } catch (e) {
19
+ return Promise.reject(e);
20
+ }
21
+ };
22
+ env.stack.push({
23
+ value: value,
24
+ dispose: dispose,
25
+ async: async
26
+ });
27
+ } else if (async) {
28
+ env.stack.push({
29
+ async: true
30
+ });
31
+ }
32
+ return value;
33
+ }
34
+ function _ts_dispose_resources(env) {
35
+ var _SuppressedError = typeof SuppressedError === "function" ? SuppressedError : function(error, suppressed, message) {
36
+ var e = new Error(message);
37
+ return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
38
+ };
39
+ return (_ts_dispose_resources = function _ts_dispose_resources(env) {
40
+ function fail(e) {
41
+ env.error = env.hasError ? new _SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
42
+ env.hasError = true;
43
+ }
44
+ var r, s = 0;
45
+ function next() {
46
+ while(r = env.stack.pop()){
47
+ try {
48
+ if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
49
+ if (r.dispose) {
50
+ var result = r.dispose.call(r.value);
51
+ if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) {
52
+ fail(e);
53
+ return next();
54
+ });
55
+ } else s |= 1;
56
+ } catch (e) {
57
+ fail(e);
58
+ }
59
+ }
60
+ if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
61
+ if (env.hasError) throw env.error;
62
+ }
63
+ return next();
64
+ })(env);
65
+ }
1
66
  import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
2
- import { SlotNumber } from '@aztec/foundation/branded-types';
67
+ import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
68
+ import { pick } from '@aztec/foundation/collection';
69
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
70
  import { TimeoutError } from '@aztec/foundation/error';
4
- import { Fr } from '@aztec/foundation/fields';
5
71
  import { createLogger } from '@aztec/foundation/log';
6
72
  import { retryUntil } from '@aztec/foundation/retry';
7
73
  import { DateProvider, Timer } from '@aztec/foundation/timer';
8
- import { getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
74
+ import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
75
+ import { Gas } from '@aztec/stdlib/gas';
9
76
  import { computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
10
- import { ConsensusPayload } from '@aztec/stdlib/p2p';
11
- import { GlobalVariables } from '@aztec/stdlib/tx';
12
77
  import { ReExFailedTxsError, ReExStateMismatchError, ReExTimeoutError, TransactionsNotAvailableError } from '@aztec/stdlib/validators';
13
78
  import { getTelemetryClient } from '@aztec/telemetry-client';
14
79
  export class BlockProposalHandler {
15
- blockBuilder;
80
+ checkpointsBuilder;
81
+ worldState;
16
82
  blockSource;
17
83
  l1ToL2MessageSource;
18
84
  txProvider;
19
85
  blockProposalValidator;
86
+ epochCache;
20
87
  config;
21
88
  metrics;
22
89
  dateProvider;
23
90
  log;
24
91
  tracer;
25
- constructor(blockBuilder, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, config, metrics, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator:block-proposal-handler')){
26
- this.blockBuilder = blockBuilder;
92
+ constructor(checkpointsBuilder, worldState, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, epochCache, config, metrics, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator:block-proposal-handler')){
93
+ this.checkpointsBuilder = checkpointsBuilder;
94
+ this.worldState = worldState;
27
95
  this.blockSource = blockSource;
28
96
  this.l1ToL2MessageSource = l1ToL2MessageSource;
29
97
  this.txProvider = txProvider;
30
98
  this.blockProposalValidator = blockProposalValidator;
99
+ this.epochCache = epochCache;
31
100
  this.config = config;
32
101
  this.metrics = metrics;
33
102
  this.dateProvider = dateProvider;
@@ -37,27 +106,35 @@ export class BlockProposalHandler {
37
106
  }
38
107
  this.tracer = telemetry.getTracer('BlockProposalHandler');
39
108
  }
40
- registerForReexecution(p2pClient) {
109
+ register(p2pClient, shouldReexecute) {
110
+ // Non-validator handler that processes or re-executes for monitoring but does not attest.
111
+ // Returns boolean indicating whether the proposal was valid.
41
112
  const handler = async (proposal, proposalSender)=>{
42
113
  try {
43
- const result = await this.handleBlockProposal(proposal, proposalSender, true);
114
+ const { slotNumber, blockNumber } = proposal;
115
+ const result = await this.handleBlockProposal(proposal, proposalSender, shouldReexecute);
44
116
  if (result.isValid) {
45
- this.log.info(`Non-validator reexecution completed for slot ${proposal.slotNumber}`, {
117
+ this.log.info(`Non-validator block proposal ${blockNumber} at slot ${slotNumber} handled`, {
46
118
  blockNumber: result.blockNumber,
119
+ slotNumber,
47
120
  reexecutionTimeMs: result.reexecutionResult?.reexecutionTimeMs,
48
121
  totalManaUsed: result.reexecutionResult?.totalManaUsed,
49
- numTxs: result.reexecutionResult?.block?.body?.txEffects?.length ?? 0
122
+ numTxs: result.reexecutionResult?.block?.body?.txEffects?.length ?? 0,
123
+ reexecuted: shouldReexecute
50
124
  });
125
+ return true;
51
126
  } else {
52
- this.log.warn(`Non-validator reexecution failed for slot ${proposal.slotNumber}`, {
127
+ this.log.warn(`Non-validator block proposal ${blockNumber} at slot ${slotNumber} failed processing with ${result.reason}`, {
53
128
  blockNumber: result.blockNumber,
129
+ slotNumber,
54
130
  reason: result.reason
55
131
  });
132
+ return false;
56
133
  }
57
134
  } catch (error) {
58
135
  this.log.error('Error processing block proposal in non-validator handler', error);
136
+ return false;
59
137
  }
60
- return undefined; // Non-validator nodes don't return attestations
61
138
  };
62
139
  p2pClient.registerBlockProposalHandler(handler);
63
140
  return this;
@@ -65,7 +142,7 @@ export class BlockProposalHandler {
65
142
  async handleBlockProposal(proposal, proposalSender, shouldReexecute) {
66
143
  const slotNumber = proposal.slotNumber;
67
144
  const proposer = proposal.getSender();
68
- const config = this.blockBuilder.getConfig();
145
+ const config = this.checkpointsBuilder.getConfig();
69
146
  // Reject proposals with invalid signatures
70
147
  if (!proposer) {
71
148
  this.log.warn(`Received proposal with invalid signature for slot ${slotNumber}`);
@@ -84,8 +161,8 @@ export class BlockProposalHandler {
84
161
  });
85
162
  // Check that the proposal is from the current proposer, or the next proposer
86
163
  // This should have been handled by the p2p layer, but we double check here out of caution
87
- const invalidProposal = await this.blockProposalValidator.validate(proposal);
88
- if (invalidProposal) {
164
+ const validationResult = await this.blockProposalValidator.validate(proposal);
165
+ if (validationResult.result !== 'accept') {
89
166
  this.log.warn(`Proposal is not valid, skipping processing`, proposalInfo);
90
167
  return {
91
168
  isValid: false,
@@ -93,18 +170,18 @@ export class BlockProposalHandler {
93
170
  };
94
171
  }
95
172
  // Check that the parent proposal is a block we know, otherwise reexecution would fail
96
- const parentBlockHeader = await this.getParentBlock(proposal);
97
- if (parentBlockHeader === undefined) {
173
+ const parentBlock = await this.getParentBlock(proposal);
174
+ if (parentBlock === undefined) {
98
175
  this.log.warn(`Parent block for proposal not found, skipping processing`, proposalInfo);
99
176
  return {
100
177
  isValid: false,
101
178
  reason: 'parent_block_not_found'
102
179
  };
103
180
  }
104
- // Check that the parent block's slot is less than the proposal's slot (should not happen, but we check anyway)
105
- if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() >= slotNumber) {
106
- this.log.warn(`Parent block slot is greater than or equal to proposal slot, skipping processing`, {
107
- parentBlockSlot: parentBlockHeader.getSlot().toString(),
181
+ // Check that the parent block's slot is not greater than the proposal's slot.
182
+ if (parentBlock !== 'genesis' && parentBlock.header.getSlot() > slotNumber) {
183
+ this.log.warn(`Parent block slot is greater than proposal slot, skipping processing`, {
184
+ parentBlockSlot: parentBlock.header.getSlot().toString(),
108
185
  proposalSlot: slotNumber.toString(),
109
186
  ...proposalInfo
110
187
  });
@@ -114,7 +191,7 @@ export class BlockProposalHandler {
114
191
  };
115
192
  }
116
193
  // Compute the block number based on the parent block
117
- const blockNumber = parentBlockHeader === 'genesis' ? INITIAL_L2_BLOCK_NUM : parentBlockHeader.getBlockNumber() + 1;
194
+ const blockNumber = parentBlock === 'genesis' ? BlockNumber(INITIAL_L2_BLOCK_NUM) : BlockNumber(parentBlock.header.getBlockNumber() + 1);
118
195
  // Check that this block number does not exist already
119
196
  const existingBlock = await this.blockSource.getBlockHeader(blockNumber);
120
197
  if (existingBlock) {
@@ -131,10 +208,28 @@ export class BlockProposalHandler {
131
208
  pinnedPeer: proposalSender,
132
209
  deadline: this.getReexecutionDeadline(slotNumber, config)
133
210
  });
211
+ // If reexecution is disabled, bail. We are just interested in triggering tx collection.
212
+ if (!shouldReexecute) {
213
+ this.log.info(`Received valid block ${blockNumber} proposal at index ${proposal.indexWithinCheckpoint} on slot ${slotNumber}`, proposalInfo);
214
+ return {
215
+ isValid: true,
216
+ blockNumber
217
+ };
218
+ }
219
+ // Compute the checkpoint number for this block and validate checkpoint consistency
220
+ const checkpointResult = this.computeCheckpointNumber(proposal, parentBlock, proposalInfo);
221
+ if (checkpointResult.reason) {
222
+ return {
223
+ isValid: false,
224
+ blockNumber,
225
+ reason: checkpointResult.reason
226
+ };
227
+ }
228
+ const checkpointNumber = checkpointResult.checkpointNumber;
134
229
  // Check that I have the same set of l1ToL2Messages as the proposal
135
- const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(blockNumber);
230
+ const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
136
231
  const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
137
- const proposalInHash = proposal.payload.header.contentCommitment.inHash;
232
+ const proposalInHash = proposal.inHash;
138
233
  if (!computedInHash.equals(proposalInHash)) {
139
234
  this.log.warn(`L1 to L2 messages in hash mismatch, skipping processing`, {
140
235
  proposalInHash: proposalInHash.toString(),
@@ -159,24 +254,32 @@ export class BlockProposalHandler {
159
254
  reason: 'txs_not_available'
160
255
  };
161
256
  }
257
+ // Collect the out hashes of all the checkpoints before this one in the same epoch
258
+ const epoch = getEpochAtSlot(slotNumber, this.epochCache.getL1Constants());
259
+ const previousCheckpointOutHashes = (await this.blockSource.getCheckpointsDataForEpoch(epoch)).filter((c)=>c.checkpointNumber < checkpointNumber).map((c)=>c.checkpointOutHash);
162
260
  // Try re-executing the transactions in the proposal if needed
163
261
  let reexecutionResult;
164
- if (shouldReexecute) {
165
- try {
166
- this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
167
- reexecutionResult = await this.reexecuteTransactions(proposal, blockNumber, txs, l1ToL2Messages);
168
- } catch (error) {
169
- this.log.error(`Error reexecuting txs while processing block proposal`, error, proposalInfo);
170
- const reason = this.getReexecuteFailureReason(error);
171
- return {
172
- isValid: false,
173
- blockNumber,
174
- reason,
175
- reexecutionResult
176
- };
177
- }
262
+ try {
263
+ this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
264
+ reexecutionResult = await this.reexecuteTransactions(proposal, blockNumber, checkpointNumber, txs, l1ToL2Messages, previousCheckpointOutHashes);
265
+ } catch (error) {
266
+ this.log.error(`Error reexecuting txs while processing block proposal`, error, proposalInfo);
267
+ const reason = this.getReexecuteFailureReason(error);
268
+ return {
269
+ isValid: false,
270
+ blockNumber,
271
+ reason,
272
+ reexecutionResult
273
+ };
274
+ }
275
+ // If we succeeded, push this block into the archiver (unless disabled)
276
+ if (reexecutionResult?.block && this.config.skipPushProposedBlocksToArchiver === false) {
277
+ await this.blockSource.addBlock(reexecutionResult?.block);
178
278
  }
179
- this.log.info(`Successfully processed proposal for slot ${slotNumber}`, proposalInfo);
279
+ this.log.info(`Successfully re-executed block ${blockNumber} proposal at index ${proposal.indexWithinCheckpoint} on slot ${slotNumber}`, {
280
+ ...proposalInfo,
281
+ ...pick(reexecutionResult, 'reexecutionTimeMs', 'totalManaUsed')
282
+ });
180
283
  return {
181
284
  isValid: true,
182
285
  blockNumber,
@@ -184,9 +287,9 @@ export class BlockProposalHandler {
184
287
  };
185
288
  }
186
289
  async getParentBlock(proposal) {
187
- const parentArchive = proposal.payload.header.lastArchiveRoot;
290
+ const parentArchive = proposal.blockHeader.lastArchive.root;
188
291
  const slot = proposal.slotNumber;
189
- const config = this.blockBuilder.getConfig();
292
+ const config = this.checkpointsBuilder.getConfig();
190
293
  const { genesisArchiveRoot } = await this.blockSource.getGenesisValues();
191
294
  if (parentArchive.equals(genesisArchiveRoot)) {
192
295
  return 'genesis';
@@ -195,7 +298,7 @@ export class BlockProposalHandler {
195
298
  const currentTime = this.dateProvider.now();
196
299
  const timeoutDurationMs = deadline.getTime() - currentTime;
197
300
  try {
198
- return await this.blockSource.getBlockHeaderByArchive(parentArchive) ?? (timeoutDurationMs <= 0 ? undefined : await retryUntil(()=>this.blockSource.syncImmediate().then(()=>this.blockSource.getBlockHeaderByArchive(parentArchive)), 'force archiver sync', timeoutDurationMs / 1000, 0.5));
301
+ return await this.blockSource.getBlockDataByArchive(parentArchive) ?? (timeoutDurationMs <= 0 ? undefined : await retryUntil(()=>this.blockSource.syncImmediate().then(()=>this.blockSource.getBlockDataByArchive(parentArchive)), 'force archiver sync', timeoutDurationMs / 1000, 0.5));
199
302
  } catch (err) {
200
303
  if (err instanceof TimeoutError) {
201
304
  this.log.debug(`Timed out getting parent block by archive root`, {
@@ -209,10 +312,137 @@ export class BlockProposalHandler {
209
312
  return undefined;
210
313
  }
211
314
  }
315
+ computeCheckpointNumber(proposal, parentBlock, proposalInfo) {
316
+ if (parentBlock === 'genesis') {
317
+ // First block is in checkpoint 1
318
+ if (proposal.indexWithinCheckpoint !== 0) {
319
+ this.log.warn(`First block proposal has non-zero indexWithinCheckpoint`, proposalInfo);
320
+ return {
321
+ reason: 'invalid_proposal'
322
+ };
323
+ }
324
+ return {
325
+ checkpointNumber: CheckpointNumber.INITIAL
326
+ };
327
+ }
328
+ if (proposal.indexWithinCheckpoint === 0) {
329
+ // If this is the first block in a new checkpoint, increment the checkpoint number
330
+ if (!(proposal.blockHeader.getSlot() > parentBlock.header.getSlot())) {
331
+ this.log.warn(`Slot should be greater than parent block slot for first block in checkpoint`, proposalInfo);
332
+ return {
333
+ reason: 'invalid_proposal'
334
+ };
335
+ }
336
+ return {
337
+ checkpointNumber: CheckpointNumber(parentBlock.checkpointNumber + 1)
338
+ };
339
+ }
340
+ // Otherwise it should follow the previous block in the same checkpoint
341
+ if (proposal.indexWithinCheckpoint !== parentBlock.indexWithinCheckpoint + 1) {
342
+ this.log.warn(`Non-sequential indexWithinCheckpoint`, proposalInfo);
343
+ return {
344
+ reason: 'invalid_proposal'
345
+ };
346
+ }
347
+ if (proposal.blockHeader.getSlot() !== parentBlock.header.getSlot()) {
348
+ this.log.warn(`Slot should be equal to parent block slot for non-first block in checkpoint`, proposalInfo);
349
+ return {
350
+ reason: 'invalid_proposal'
351
+ };
352
+ }
353
+ // For non-first blocks in a checkpoint, validate global variables match parent (except blockNumber)
354
+ const validationResult = this.validateNonFirstBlockInCheckpoint(proposal, parentBlock, proposalInfo);
355
+ if (validationResult) {
356
+ return validationResult;
357
+ }
358
+ return {
359
+ checkpointNumber: parentBlock.checkpointNumber
360
+ };
361
+ }
362
+ /**
363
+ * Validates that a non-first block in a checkpoint has consistent global variables with its parent.
364
+ * For blocks with indexWithinCheckpoint > 0, all global variables except blockNumber must match the parent.
365
+ * @returns A failure result if validation fails, undefined if validation passes
366
+ */ validateNonFirstBlockInCheckpoint(proposal, parentBlock, proposalInfo) {
367
+ const proposalGlobals = proposal.blockHeader.globalVariables;
368
+ const parentGlobals = parentBlock.header.globalVariables;
369
+ // All global variables except blockNumber should match the parent
370
+ // blockNumber naturally increments between blocks
371
+ if (!proposalGlobals.chainId.equals(parentGlobals.chainId)) {
372
+ this.log.warn(`Non-first block in checkpoint has mismatched chainId`, {
373
+ ...proposalInfo,
374
+ proposalChainId: proposalGlobals.chainId.toString(),
375
+ parentChainId: parentGlobals.chainId.toString()
376
+ });
377
+ return {
378
+ reason: 'global_variables_mismatch'
379
+ };
380
+ }
381
+ if (!proposalGlobals.version.equals(parentGlobals.version)) {
382
+ this.log.warn(`Non-first block in checkpoint has mismatched version`, {
383
+ ...proposalInfo,
384
+ proposalVersion: proposalGlobals.version.toString(),
385
+ parentVersion: parentGlobals.version.toString()
386
+ });
387
+ return {
388
+ reason: 'global_variables_mismatch'
389
+ };
390
+ }
391
+ if (proposalGlobals.slotNumber !== parentGlobals.slotNumber) {
392
+ this.log.warn(`Non-first block in checkpoint has mismatched slotNumber`, {
393
+ ...proposalInfo,
394
+ proposalSlotNumber: proposalGlobals.slotNumber,
395
+ parentSlotNumber: parentGlobals.slotNumber
396
+ });
397
+ return {
398
+ reason: 'global_variables_mismatch'
399
+ };
400
+ }
401
+ if (proposalGlobals.timestamp !== parentGlobals.timestamp) {
402
+ this.log.warn(`Non-first block in checkpoint has mismatched timestamp`, {
403
+ ...proposalInfo,
404
+ proposalTimestamp: proposalGlobals.timestamp.toString(),
405
+ parentTimestamp: parentGlobals.timestamp.toString()
406
+ });
407
+ return {
408
+ reason: 'global_variables_mismatch'
409
+ };
410
+ }
411
+ if (!proposalGlobals.coinbase.equals(parentGlobals.coinbase)) {
412
+ this.log.warn(`Non-first block in checkpoint has mismatched coinbase`, {
413
+ ...proposalInfo,
414
+ proposalCoinbase: proposalGlobals.coinbase.toString(),
415
+ parentCoinbase: parentGlobals.coinbase.toString()
416
+ });
417
+ return {
418
+ reason: 'global_variables_mismatch'
419
+ };
420
+ }
421
+ if (!proposalGlobals.feeRecipient.equals(parentGlobals.feeRecipient)) {
422
+ this.log.warn(`Non-first block in checkpoint has mismatched feeRecipient`, {
423
+ ...proposalInfo,
424
+ proposalFeeRecipient: proposalGlobals.feeRecipient.toString(),
425
+ parentFeeRecipient: parentGlobals.feeRecipient.toString()
426
+ });
427
+ return {
428
+ reason: 'global_variables_mismatch'
429
+ };
430
+ }
431
+ if (!proposalGlobals.gasFees.equals(parentGlobals.gasFees)) {
432
+ this.log.warn(`Non-first block in checkpoint has mismatched gasFees`, {
433
+ ...proposalInfo,
434
+ proposalGasFees: proposalGlobals.gasFees.toInspect(),
435
+ parentGasFees: parentGlobals.gasFees.toInspect()
436
+ });
437
+ return {
438
+ reason: 'global_variables_mismatch'
439
+ };
440
+ }
441
+ return undefined;
442
+ }
212
443
  getReexecutionDeadline(slot, config) {
213
444
  const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
214
- const msNeededForPropagationAndPublishing = this.config.validatorReexecuteDeadlineMs;
215
- return new Date(nextSlotTimestampSeconds * 1000 - msNeededForPropagationAndPublishing);
445
+ return new Date(nextSlotTimestampSeconds * 1000);
216
446
  }
217
447
  getReexecuteFailureReason(err) {
218
448
  if (err instanceof ReExStateMismatchError) {
@@ -225,66 +455,97 @@ export class BlockProposalHandler {
225
455
  return 'unknown_error';
226
456
  }
227
457
  }
228
- async reexecuteTransactions(proposal, blockNumber, txs, l1ToL2Messages) {
229
- const { header } = proposal.payload;
230
- const { txHashes } = proposal;
231
- // If we do not have all of the transactions, then we should fail
232
- if (txs.length !== txHashes.length) {
233
- const foundTxHashes = txs.map((tx)=>tx.getTxHash());
234
- const missingTxHashes = txHashes.filter((txHash)=>!foundTxHashes.includes(txHash));
235
- throw new TransactionsNotAvailableError(missingTxHashes);
236
- }
237
- // Use the sequencer's block building logic to re-execute the transactions
238
- const timer = new Timer();
239
- const config = this.blockBuilder.getConfig();
240
- // We source most global variables from the proposal
241
- const globalVariables = GlobalVariables.from({
242
- slotNumber: proposal.payload.header.slotNumber,
243
- coinbase: proposal.payload.header.coinbase,
244
- feeRecipient: proposal.payload.header.feeRecipient,
245
- gasFees: proposal.payload.header.gasFees,
246
- blockNumber,
247
- timestamp: header.timestamp,
248
- chainId: new Fr(config.l1ChainId),
249
- version: new Fr(config.rollupVersion)
250
- });
251
- const { block, failedTxs } = await this.blockBuilder.buildBlock(txs, l1ToL2Messages, globalVariables, {
252
- deadline: this.getReexecutionDeadline(proposal.payload.header.slotNumber, config)
253
- });
254
- const numFailedTxs = failedTxs.length;
255
- const slot = proposal.slotNumber;
256
- this.log.verbose(`Transaction re-execution complete for slot ${slot}`, {
257
- numFailedTxs,
258
- numProposalTxs: txHashes.length,
259
- numProcessedTxs: block.body.txEffects.length,
260
- slot
261
- });
262
- if (numFailedTxs > 0) {
263
- this.metrics?.recordFailedReexecution(proposal);
264
- throw new ReExFailedTxsError(numFailedTxs);
265
- }
266
- if (block.body.txEffects.length !== txHashes.length) {
267
- this.metrics?.recordFailedReexecution(proposal);
268
- throw new ReExTimeoutError();
269
- }
270
- // Throw a ReExStateMismatchError error if state updates do not match
271
- const blockPayload = ConsensusPayload.fromBlock(block);
272
- if (!blockPayload.equals(proposal.payload)) {
273
- this.log.warn(`Re-execution state mismatch for slot ${slot}`, {
274
- expected: blockPayload.toInspect(),
275
- actual: proposal.payload.toInspect()
458
+ async reexecuteTransactions(proposal, blockNumber, checkpointNumber, txs, l1ToL2Messages, previousCheckpointOutHashes) {
459
+ const env = {
460
+ stack: [],
461
+ error: void 0,
462
+ hasError: false
463
+ };
464
+ try {
465
+ const { blockHeader, txHashes } = proposal;
466
+ // If we do not have all of the transactions, then we should fail
467
+ if (txs.length !== txHashes.length) {
468
+ const foundTxHashes = txs.map((tx)=>tx.getTxHash());
469
+ const missingTxHashes = txHashes.filter((txHash)=>!foundTxHashes.includes(txHash));
470
+ throw new TransactionsNotAvailableError(missingTxHashes);
471
+ }
472
+ const timer = new Timer();
473
+ const slot = proposal.slotNumber;
474
+ const config = this.checkpointsBuilder.getConfig();
475
+ // Get prior blocks in this checkpoint (same slot before current block)
476
+ const allBlocksInSlot = await this.blockSource.getBlocksForSlot(slot);
477
+ const priorBlocks = allBlocksInSlot.filter((b)=>b.number < blockNumber && b.header.getSlot() === slot);
478
+ // Fork before the block to be built
479
+ const parentBlockNumber = BlockNumber(blockNumber - 1);
480
+ await this.worldState.syncImmediate(parentBlockNumber);
481
+ const fork = _ts_add_disposable_resource(env, await this.worldState.fork(parentBlockNumber), true);
482
+ // Build checkpoint constants from proposal (excludes blockNumber which is per-block)
483
+ const constants = {
484
+ chainId: new Fr(config.l1ChainId),
485
+ version: new Fr(config.rollupVersion),
486
+ slotNumber: slot,
487
+ timestamp: blockHeader.globalVariables.timestamp,
488
+ coinbase: blockHeader.globalVariables.coinbase,
489
+ feeRecipient: blockHeader.globalVariables.feeRecipient,
490
+ gasFees: blockHeader.globalVariables.gasFees
491
+ };
492
+ // Create checkpoint builder with prior blocks
493
+ const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(checkpointNumber, constants, 0n, l1ToL2Messages, previousCheckpointOutHashes, fork, priorBlocks, this.log.getBindings());
494
+ // Build the new block
495
+ const deadline = this.getReexecutionDeadline(slot, config);
496
+ const maxBlockGas = this.config.validateMaxL2BlockGas !== undefined || this.config.validateMaxDABlockGas !== undefined ? new Gas(this.config.validateMaxDABlockGas ?? Infinity, this.config.validateMaxL2BlockGas ?? Infinity) : undefined;
497
+ const result = await checkpointBuilder.buildBlock(txs, blockNumber, blockHeader.globalVariables.timestamp, {
498
+ deadline,
499
+ expectedEndState: blockHeader.state,
500
+ maxTransactions: this.config.validateMaxTxsPerBlock,
501
+ maxBlockGas
276
502
  });
277
- this.metrics?.recordFailedReexecution(proposal);
278
- throw new ReExStateMismatchError(proposal.archive, block.archive.root);
503
+ const { block, failedTxs } = result;
504
+ const numFailedTxs = failedTxs.length;
505
+ this.log.verbose(`Block proposal ${blockNumber} at slot ${slot} transaction re-execution complete`, {
506
+ numFailedTxs,
507
+ numProposalTxs: txHashes.length,
508
+ numProcessedTxs: block.body.txEffects.length,
509
+ blockNumber,
510
+ slot
511
+ });
512
+ if (numFailedTxs > 0) {
513
+ this.metrics?.recordFailedReexecution(proposal);
514
+ throw new ReExFailedTxsError(numFailedTxs);
515
+ }
516
+ if (block.body.txEffects.length !== txHashes.length) {
517
+ this.metrics?.recordFailedReexecution(proposal);
518
+ throw new ReExTimeoutError();
519
+ }
520
+ // Throw a ReExStateMismatchError error if state updates do not match
521
+ // Compare the full block structure (archive and header) from the built block with the proposal
522
+ const archiveMatches = proposal.archive.equals(block.archive.root);
523
+ const headerMatches = proposal.blockHeader.equals(block.header);
524
+ if (!archiveMatches || !headerMatches) {
525
+ this.log.warn(`Re-execution state mismatch for slot ${slot}`, {
526
+ expectedArchive: block.archive.root.toString(),
527
+ actualArchive: proposal.archive.toString(),
528
+ expectedHeader: block.header.toInspect(),
529
+ actualHeader: proposal.blockHeader.toInspect()
530
+ });
531
+ this.metrics?.recordFailedReexecution(proposal);
532
+ throw new ReExStateMismatchError(proposal.archive, block.archive.root);
533
+ }
534
+ const reexecutionTimeMs = timer.ms();
535
+ const totalManaUsed = block.header.totalManaUsed.toNumber() / 1e6;
536
+ this.metrics?.recordReex(reexecutionTimeMs, txs.length, totalManaUsed);
537
+ return {
538
+ block,
539
+ failedTxs,
540
+ reexecutionTimeMs,
541
+ totalManaUsed
542
+ };
543
+ } catch (e) {
544
+ env.error = e;
545
+ env.hasError = true;
546
+ } finally{
547
+ const result = _ts_dispose_resources(env);
548
+ if (result) await result;
279
549
  }
280
- const reexecutionTimeMs = timer.ms();
281
- const totalManaUsed = block.header.totalManaUsed.toNumber() / 1e6;
282
- this.metrics?.recordReex(reexecutionTimeMs, txs.length, totalManaUsed);
283
- return {
284
- block,
285
- failedTxs,
286
- reexecutionTimeMs,
287
- totalManaUsed
288
- };
289
550
  }
290
551
  }