@aztec/validator-client 0.0.1-commit.d3ec352c → 0.0.1-commit.d6f2b3f94

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 (69) hide show
  1. package/README.md +285 -0
  2. package/dest/block_proposal_handler.d.ts +21 -11
  3. package/dest/block_proposal_handler.d.ts.map +1 -1
  4. package/dest/block_proposal_handler.js +339 -83
  5. package/dest/checkpoint_builder.d.ts +66 -0
  6. package/dest/checkpoint_builder.d.ts.map +1 -0
  7. package/dest/checkpoint_builder.js +173 -0
  8. package/dest/config.d.ts +1 -1
  9. package/dest/config.d.ts.map +1 -1
  10. package/dest/config.js +16 -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 +111 -28
  14. package/dest/factory.d.ts +13 -8
  15. package/dest/factory.d.ts.map +1 -1
  16. package/dest/factory.js +2 -2
  17. package/dest/index.d.ts +3 -1
  18. package/dest/index.d.ts.map +1 -1
  19. package/dest/index.js +2 -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 +4 -3
  38. package/dest/metrics.d.ts.map +1 -1
  39. package/dest/metrics.js +34 -30
  40. package/dest/tx_validator/index.d.ts +3 -0
  41. package/dest/tx_validator/index.d.ts.map +1 -0
  42. package/dest/tx_validator/index.js +2 -0
  43. package/dest/tx_validator/nullifier_cache.d.ts +14 -0
  44. package/dest/tx_validator/nullifier_cache.d.ts.map +1 -0
  45. package/dest/tx_validator/nullifier_cache.js +24 -0
  46. package/dest/tx_validator/tx_validator_factory.d.ts +19 -0
  47. package/dest/tx_validator/tx_validator_factory.d.ts.map +1 -0
  48. package/dest/tx_validator/tx_validator_factory.js +54 -0
  49. package/dest/validator.d.ts +67 -21
  50. package/dest/validator.d.ts.map +1 -1
  51. package/dest/validator.js +416 -56
  52. package/package.json +21 -11
  53. package/src/block_proposal_handler.ts +260 -49
  54. package/src/checkpoint_builder.ts +314 -0
  55. package/src/config.ts +15 -7
  56. package/src/duties/validation_service.ts +155 -33
  57. package/src/factory.ts +17 -8
  58. package/src/index.ts +2 -0
  59. package/src/key_store/ha_key_store.ts +269 -0
  60. package/src/key_store/index.ts +1 -0
  61. package/src/key_store/interface.ts +44 -5
  62. package/src/key_store/local_key_store.ts +14 -5
  63. package/src/key_store/node_keystore_adapter.ts +28 -5
  64. package/src/key_store/web3signer_key_store.ts +18 -5
  65. package/src/metrics.ts +45 -33
  66. package/src/tx_validator/index.ts +2 -0
  67. package/src/tx_validator/nullifier_cache.ts +30 -0
  68. package/src/tx_validator/tx_validator_factory.ts +154 -0
  69. package/src/validator.ts +571 -84
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/validator-client",
3
- "version": "0.0.1-commit.d3ec352c",
3
+ "version": "0.0.1-commit.d6f2b3f94",
4
4
  "main": "dest/index.js",
5
5
  "type": "module",
6
6
  "exports": {
@@ -64,25 +64,35 @@
64
64
  ]
65
65
  },
66
66
  "dependencies": {
67
- "@aztec/constants": "0.0.1-commit.d3ec352c",
68
- "@aztec/epoch-cache": "0.0.1-commit.d3ec352c",
69
- "@aztec/ethereum": "0.0.1-commit.d3ec352c",
70
- "@aztec/foundation": "0.0.1-commit.d3ec352c",
71
- "@aztec/node-keystore": "0.0.1-commit.d3ec352c",
72
- "@aztec/p2p": "0.0.1-commit.d3ec352c",
73
- "@aztec/slasher": "0.0.1-commit.d3ec352c",
74
- "@aztec/stdlib": "0.0.1-commit.d3ec352c",
75
- "@aztec/telemetry-client": "0.0.1-commit.d3ec352c",
67
+ "@aztec/blob-client": "0.0.1-commit.d6f2b3f94",
68
+ "@aztec/blob-lib": "0.0.1-commit.d6f2b3f94",
69
+ "@aztec/constants": "0.0.1-commit.d6f2b3f94",
70
+ "@aztec/epoch-cache": "0.0.1-commit.d6f2b3f94",
71
+ "@aztec/ethereum": "0.0.1-commit.d6f2b3f94",
72
+ "@aztec/foundation": "0.0.1-commit.d6f2b3f94",
73
+ "@aztec/node-keystore": "0.0.1-commit.d6f2b3f94",
74
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.d6f2b3f94",
75
+ "@aztec/p2p": "0.0.1-commit.d6f2b3f94",
76
+ "@aztec/protocol-contracts": "0.0.1-commit.d6f2b3f94",
77
+ "@aztec/prover-client": "0.0.1-commit.d6f2b3f94",
78
+ "@aztec/simulator": "0.0.1-commit.d6f2b3f94",
79
+ "@aztec/slasher": "0.0.1-commit.d6f2b3f94",
80
+ "@aztec/stdlib": "0.0.1-commit.d6f2b3f94",
81
+ "@aztec/telemetry-client": "0.0.1-commit.d6f2b3f94",
82
+ "@aztec/validator-ha-signer": "0.0.1-commit.d6f2b3f94",
76
83
  "koa": "^2.16.1",
77
84
  "koa-router": "^13.1.1",
78
85
  "tslib": "^2.4.0",
79
86
  "viem": "npm:@aztec/viem@2.38.2"
80
87
  },
81
88
  "devDependencies": {
89
+ "@aztec/archiver": "0.0.1-commit.d6f2b3f94",
90
+ "@aztec/world-state": "0.0.1-commit.d6f2b3f94",
91
+ "@electric-sql/pglite": "^0.3.14",
82
92
  "@jest/globals": "^30.0.0",
83
93
  "@types/jest": "^30.0.0",
84
94
  "@types/node": "^22.15.17",
85
- "@typescript/native-preview": "7.0.0-dev.20251126.1",
95
+ "@typescript/native-preview": "7.0.0-dev.20260113.1",
86
96
  "jest": "^30.0.0",
87
97
  "jest-mock-extended": "^4.0.0",
88
98
  "ts-node": "^10.9.1",
@@ -1,19 +1,24 @@
1
1
  import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
2
- import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
2
+ import type { EpochCache } from '@aztec/epoch-cache';
3
+ import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
4
+ import { chunkBy } from '@aztec/foundation/collection';
5
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
6
  import { TimeoutError } from '@aztec/foundation/error';
4
- import { Fr } from '@aztec/foundation/fields';
5
7
  import { createLogger } from '@aztec/foundation/log';
6
8
  import { retryUntil } from '@aztec/foundation/retry';
7
9
  import { DateProvider, Timer } from '@aztec/foundation/timer';
8
10
  import type { P2P, PeerId } from '@aztec/p2p';
9
- import { TxProvider } from '@aztec/p2p';
10
11
  import { BlockProposalValidator } from '@aztec/p2p/msg_validators';
11
- import type { L2Block, L2BlockSource } from '@aztec/stdlib/block';
12
- import { getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
13
- import type { IFullNodeBlockBuilder, ValidatorClientFullConfig } from '@aztec/stdlib/interfaces/server';
14
- import { type L1ToL2MessageSource, computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
15
- import { type BlockProposal, ConsensusPayload } from '@aztec/stdlib/p2p';
16
- import { BlockHeader, type FailedTx, GlobalVariables, type Tx } from '@aztec/stdlib/tx';
12
+ import type { L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
13
+ import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
14
+ import type { ITxProvider, ValidatorClientFullConfig, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
15
+ import {
16
+ type L1ToL2MessageSource,
17
+ computeCheckpointOutHash,
18
+ computeInHashFromL1ToL2Messages,
19
+ } from '@aztec/stdlib/messaging';
20
+ import type { BlockProposal } from '@aztec/stdlib/p2p';
21
+ import { BlockHeader, type CheckpointGlobalVariables, type FailedTx, type Tx } from '@aztec/stdlib/tx';
17
22
  import {
18
23
  ReExFailedTxsError,
19
24
  ReExStateMismatchError,
@@ -22,6 +27,7 @@ import {
22
27
  } from '@aztec/stdlib/validators';
23
28
  import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
24
29
 
30
+ import type { FullNodeCheckpointsBuilder } from './checkpoint_builder.js';
25
31
  import type { ValidatorMetrics } from './metrics.js';
26
32
 
27
33
  export type BlockProposalValidationFailureReason =
@@ -29,6 +35,7 @@ export type BlockProposalValidationFailureReason =
29
35
  | 'parent_block_not_found'
30
36
  | 'parent_block_wrong_slot'
31
37
  | 'in_hash_mismatch'
38
+ | 'global_variables_mismatch'
32
39
  | 'block_number_already_exists'
33
40
  | 'txs_not_available'
34
41
  | 'state_mismatch'
@@ -58,15 +65,21 @@ export type BlockProposalValidationFailureResult = {
58
65
 
59
66
  export type BlockProposalValidationResult = BlockProposalValidationSuccessResult | BlockProposalValidationFailureResult;
60
67
 
68
+ type CheckpointComputationResult =
69
+ | { checkpointNumber: CheckpointNumber; reason?: undefined }
70
+ | { checkpointNumber?: undefined; reason: 'invalid_proposal' | 'global_variables_mismatch' };
71
+
61
72
  export class BlockProposalHandler {
62
73
  public readonly tracer: Tracer;
63
74
 
64
75
  constructor(
65
- private blockBuilder: IFullNodeBlockBuilder,
66
- private blockSource: L2BlockSource,
76
+ private checkpointsBuilder: FullNodeCheckpointsBuilder,
77
+ private worldState: WorldStateSynchronizer,
78
+ private blockSource: L2BlockSource & L2BlockSink,
67
79
  private l1ToL2MessageSource: L1ToL2MessageSource,
68
- private txProvider: TxProvider,
80
+ private txProvider: ITxProvider,
69
81
  private blockProposalValidator: BlockProposalValidator,
82
+ private epochCache: EpochCache,
70
83
  private config: ValidatorClientFullConfig,
71
84
  private metrics?: ValidatorMetrics,
72
85
  private dateProvider: DateProvider = new DateProvider(),
@@ -80,7 +93,9 @@ export class BlockProposalHandler {
80
93
  }
81
94
 
82
95
  registerForReexecution(p2pClient: P2P): BlockProposalHandler {
83
- const handler = async (proposal: BlockProposal, proposalSender: PeerId) => {
96
+ // Non-validator handler that re-executes for monitoring but does not attest.
97
+ // Returns boolean indicating whether the proposal was valid.
98
+ const handler = async (proposal: BlockProposal, proposalSender: PeerId): Promise<boolean> => {
84
99
  try {
85
100
  const result = await this.handleBlockProposal(proposal, proposalSender, true);
86
101
  if (result.isValid) {
@@ -90,16 +105,18 @@ export class BlockProposalHandler {
90
105
  totalManaUsed: result.reexecutionResult?.totalManaUsed,
91
106
  numTxs: result.reexecutionResult?.block?.body?.txEffects?.length ?? 0,
92
107
  });
108
+ return true;
93
109
  } else {
94
110
  this.log.warn(`Non-validator reexecution failed for slot ${proposal.slotNumber}`, {
95
111
  blockNumber: result.blockNumber,
96
112
  reason: result.reason,
97
113
  });
114
+ return false;
98
115
  }
99
116
  } catch (error) {
100
117
  this.log.error('Error processing block proposal in non-validator handler', error);
118
+ return false;
101
119
  }
102
- return undefined; // Non-validator nodes don't return attestations
103
120
  };
104
121
 
105
122
  p2pClient.registerBlockProposalHandler(handler);
@@ -113,7 +130,7 @@ export class BlockProposalHandler {
113
130
  ): Promise<BlockProposalValidationResult> {
114
131
  const slotNumber = proposal.slotNumber;
115
132
  const proposer = proposal.getSender();
116
- const config = this.blockBuilder.getConfig();
133
+ const config = this.checkpointsBuilder.getConfig();
117
134
 
118
135
  // Reject proposals with invalid signatures
119
136
  if (!proposer) {
@@ -129,8 +146,8 @@ export class BlockProposalHandler {
129
146
 
130
147
  // Check that the proposal is from the current proposer, or the next proposer
131
148
  // This should have been handled by the p2p layer, but we double check here out of caution
132
- const invalidProposal = await this.blockProposalValidator.validate(proposal);
133
- if (invalidProposal) {
149
+ const validationResult = await this.blockProposalValidator.validate(proposal);
150
+ if (validationResult.result !== 'accept') {
134
151
  this.log.warn(`Proposal is not valid, skipping processing`, proposalInfo);
135
152
  return { isValid: false, reason: 'invalid_proposal' };
136
153
  }
@@ -142,9 +159,9 @@ export class BlockProposalHandler {
142
159
  return { isValid: false, reason: 'parent_block_not_found' };
143
160
  }
144
161
 
145
- // Check that the parent block's slot is less than the proposal's slot (should not happen, but we check anyway)
146
- if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() >= slotNumber) {
147
- this.log.warn(`Parent block slot is greater than or equal to proposal slot, skipping processing`, {
162
+ // Check that the parent block's slot is not greater than the proposal's slot.
163
+ if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() > slotNumber) {
164
+ this.log.warn(`Parent block slot is greater than proposal slot, skipping processing`, {
148
165
  parentBlockSlot: parentBlockHeader.getSlot().toString(),
149
166
  proposalSlot: slotNumber.toString(),
150
167
  ...proposalInfo,
@@ -172,10 +189,17 @@ export class BlockProposalHandler {
172
189
  deadline: this.getReexecutionDeadline(slotNumber, config),
173
190
  });
174
191
 
192
+ // Compute the checkpoint number for this block and validate checkpoint consistency
193
+ const checkpointResult = await this.computeCheckpointNumber(proposal, parentBlockHeader, proposalInfo);
194
+ if (checkpointResult.reason) {
195
+ return { isValid: false, blockNumber, reason: checkpointResult.reason };
196
+ }
197
+ const checkpointNumber = checkpointResult.checkpointNumber;
198
+
175
199
  // Check that I have the same set of l1ToL2Messages as the proposal
176
- const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(blockNumber);
200
+ const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
177
201
  const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
178
- const proposalInHash = proposal.payload.header.contentCommitment.inHash;
202
+ const proposalInHash = proposal.inHash;
179
203
  if (!computedInHash.equals(proposalInHash)) {
180
204
  this.log.warn(`L1 to L2 messages in hash mismatch, skipping processing`, {
181
205
  proposalInHash: proposalInHash.toString(),
@@ -194,9 +218,28 @@ export class BlockProposalHandler {
194
218
  // Try re-executing the transactions in the proposal if needed
195
219
  let reexecutionResult;
196
220
  if (shouldReexecute) {
221
+ // Compute the previous checkpoint out hashes for the epoch.
222
+ // TODO(leila/mbps): There can be a more efficient way to get the previous checkpoint out
223
+ // hashes without having to fetch all the blocks.
224
+ const epoch = getEpochAtSlot(slotNumber, this.epochCache.getL1Constants());
225
+ const checkpointedBlocks = (await this.blockSource.getCheckpointedBlocksForEpoch(epoch))
226
+ .filter(b => b.block.number < blockNumber)
227
+ .sort((a, b) => a.block.number - b.block.number);
228
+ const blocksByCheckpoint = chunkBy(checkpointedBlocks, b => b.checkpointNumber);
229
+ const previousCheckpointOutHashes = blocksByCheckpoint.map(checkpointBlocks =>
230
+ computeCheckpointOutHash(checkpointBlocks.map(b => b.block.body.txEffects.map(tx => tx.l2ToL1Msgs))),
231
+ );
232
+
197
233
  try {
198
234
  this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
199
- reexecutionResult = await this.reexecuteTransactions(proposal, blockNumber, txs, l1ToL2Messages);
235
+ reexecutionResult = await this.reexecuteTransactions(
236
+ proposal,
237
+ blockNumber,
238
+ checkpointNumber,
239
+ txs,
240
+ l1ToL2Messages,
241
+ previousCheckpointOutHashes,
242
+ );
200
243
  } catch (error) {
201
244
  this.log.error(`Error reexecuting txs while processing block proposal`, error, proposalInfo);
202
245
  const reason = this.getReexecuteFailureReason(error);
@@ -204,14 +247,23 @@ export class BlockProposalHandler {
204
247
  }
205
248
  }
206
249
 
207
- this.log.info(`Successfully processed proposal for slot ${slotNumber}`, proposalInfo);
250
+ // If we succeeded, push this block into the archiver (unless disabled)
251
+ if (reexecutionResult?.block && this.config.skipPushProposedBlocksToArchiver === false) {
252
+ await this.blockSource.addBlock(reexecutionResult?.block);
253
+ }
254
+
255
+ this.log.info(
256
+ `Successfully processed block ${blockNumber} proposal at index ${proposal.indexWithinCheckpoint} on slot ${slotNumber}`,
257
+ proposalInfo,
258
+ );
259
+
208
260
  return { isValid: true, blockNumber, reexecutionResult };
209
261
  }
210
262
 
211
263
  private async getParentBlock(proposal: BlockProposal): Promise<'genesis' | BlockHeader | undefined> {
212
- const parentArchive = proposal.payload.header.lastArchiveRoot;
264
+ const parentArchive = proposal.blockHeader.lastArchive.root;
213
265
  const slot = proposal.slotNumber;
214
- const config = this.blockBuilder.getConfig();
266
+ const config = this.checkpointsBuilder.getConfig();
215
267
  const { genesisArchiveRoot } = await this.blockSource.getGenesisValues();
216
268
 
217
269
  if (parentArchive.equals(genesisArchiveRoot)) {
@@ -245,10 +297,142 @@ export class BlockProposalHandler {
245
297
  }
246
298
  }
247
299
 
300
+ private async computeCheckpointNumber(
301
+ proposal: BlockProposal,
302
+ parentBlockHeader: 'genesis' | BlockHeader,
303
+ proposalInfo: object,
304
+ ): Promise<CheckpointComputationResult> {
305
+ if (parentBlockHeader === 'genesis') {
306
+ // First block is in checkpoint 1
307
+ if (proposal.indexWithinCheckpoint !== 0) {
308
+ this.log.warn(`First block proposal has non-zero indexWithinCheckpoint`, proposalInfo);
309
+ return { reason: 'invalid_proposal' };
310
+ }
311
+ return { checkpointNumber: CheckpointNumber.INITIAL };
312
+ }
313
+
314
+ // Get the parent block to find its checkpoint number
315
+ // TODO(palla/mbps): The block header should include the checkpoint number to avoid this lookup,
316
+ // or at least the L2BlockSource should return a different struct that includes it.
317
+ const parentBlockNumber = parentBlockHeader.getBlockNumber();
318
+ const parentBlock = await this.blockSource.getL2Block(parentBlockNumber);
319
+ if (!parentBlock) {
320
+ this.log.warn(`Parent block ${parentBlockNumber} not found in archiver`, proposalInfo);
321
+ return { reason: 'invalid_proposal' };
322
+ }
323
+
324
+ if (proposal.indexWithinCheckpoint === 0) {
325
+ // If this is the first block in a new checkpoint, increment the checkpoint number
326
+ if (!(proposal.blockHeader.getSlot() > parentBlockHeader.getSlot())) {
327
+ this.log.warn(`Slot should be greater than parent block slot for first block in checkpoint`, proposalInfo);
328
+ return { reason: 'invalid_proposal' };
329
+ }
330
+ return { checkpointNumber: CheckpointNumber(parentBlock.checkpointNumber + 1) };
331
+ }
332
+
333
+ // Otherwise it should follow the previous block in the same checkpoint
334
+ if (proposal.indexWithinCheckpoint !== parentBlock.indexWithinCheckpoint + 1) {
335
+ this.log.warn(`Non-sequential indexWithinCheckpoint`, proposalInfo);
336
+ return { reason: 'invalid_proposal' };
337
+ }
338
+ if (proposal.blockHeader.getSlot() !== parentBlockHeader.getSlot()) {
339
+ this.log.warn(`Slot should be equal to parent block slot for non-first block in checkpoint`, proposalInfo);
340
+ return { reason: 'invalid_proposal' };
341
+ }
342
+
343
+ // For non-first blocks in a checkpoint, validate global variables match parent (except blockNumber)
344
+ const validationResult = this.validateNonFirstBlockInCheckpoint(proposal, parentBlock, proposalInfo);
345
+ if (validationResult) {
346
+ return validationResult;
347
+ }
348
+
349
+ return { checkpointNumber: parentBlock.checkpointNumber };
350
+ }
351
+
352
+ /**
353
+ * Validates that a non-first block in a checkpoint has consistent global variables with its parent.
354
+ * For blocks with indexWithinCheckpoint > 0, all global variables except blockNumber must match the parent.
355
+ * @returns A failure result if validation fails, undefined if validation passes
356
+ */
357
+ private validateNonFirstBlockInCheckpoint(
358
+ proposal: BlockProposal,
359
+ parentBlock: L2Block,
360
+ proposalInfo: object,
361
+ ): CheckpointComputationResult | undefined {
362
+ const proposalGlobals = proposal.blockHeader.globalVariables;
363
+ const parentGlobals = parentBlock.header.globalVariables;
364
+
365
+ // All global variables except blockNumber should match the parent
366
+ // blockNumber naturally increments between blocks
367
+ if (!proposalGlobals.chainId.equals(parentGlobals.chainId)) {
368
+ this.log.warn(`Non-first block in checkpoint has mismatched chainId`, {
369
+ ...proposalInfo,
370
+ proposalChainId: proposalGlobals.chainId.toString(),
371
+ parentChainId: parentGlobals.chainId.toString(),
372
+ });
373
+ return { reason: 'global_variables_mismatch' };
374
+ }
375
+
376
+ if (!proposalGlobals.version.equals(parentGlobals.version)) {
377
+ this.log.warn(`Non-first block in checkpoint has mismatched version`, {
378
+ ...proposalInfo,
379
+ proposalVersion: proposalGlobals.version.toString(),
380
+ parentVersion: parentGlobals.version.toString(),
381
+ });
382
+ return { reason: 'global_variables_mismatch' };
383
+ }
384
+
385
+ if (proposalGlobals.slotNumber !== parentGlobals.slotNumber) {
386
+ this.log.warn(`Non-first block in checkpoint has mismatched slotNumber`, {
387
+ ...proposalInfo,
388
+ proposalSlotNumber: proposalGlobals.slotNumber,
389
+ parentSlotNumber: parentGlobals.slotNumber,
390
+ });
391
+ return { reason: 'global_variables_mismatch' };
392
+ }
393
+
394
+ if (proposalGlobals.timestamp !== parentGlobals.timestamp) {
395
+ this.log.warn(`Non-first block in checkpoint has mismatched timestamp`, {
396
+ ...proposalInfo,
397
+ proposalTimestamp: proposalGlobals.timestamp.toString(),
398
+ parentTimestamp: parentGlobals.timestamp.toString(),
399
+ });
400
+ return { reason: 'global_variables_mismatch' };
401
+ }
402
+
403
+ if (!proposalGlobals.coinbase.equals(parentGlobals.coinbase)) {
404
+ this.log.warn(`Non-first block in checkpoint has mismatched coinbase`, {
405
+ ...proposalInfo,
406
+ proposalCoinbase: proposalGlobals.coinbase.toString(),
407
+ parentCoinbase: parentGlobals.coinbase.toString(),
408
+ });
409
+ return { reason: 'global_variables_mismatch' };
410
+ }
411
+
412
+ if (!proposalGlobals.feeRecipient.equals(parentGlobals.feeRecipient)) {
413
+ this.log.warn(`Non-first block in checkpoint has mismatched feeRecipient`, {
414
+ ...proposalInfo,
415
+ proposalFeeRecipient: proposalGlobals.feeRecipient.toString(),
416
+ parentFeeRecipient: parentGlobals.feeRecipient.toString(),
417
+ });
418
+ return { reason: 'global_variables_mismatch' };
419
+ }
420
+
421
+ if (!proposalGlobals.gasFees.equals(parentGlobals.gasFees)) {
422
+ this.log.warn(`Non-first block in checkpoint has mismatched gasFees`, {
423
+ ...proposalInfo,
424
+ proposalGasFees: proposalGlobals.gasFees.toInspect(),
425
+ parentGasFees: parentGlobals.gasFees.toInspect(),
426
+ });
427
+ return { reason: 'global_variables_mismatch' };
428
+ }
429
+
430
+ return undefined;
431
+ }
432
+
248
433
  private getReexecutionDeadline(slot: SlotNumber, config: { l1GenesisTime: bigint; slotDuration: number }): Date {
249
434
  const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
250
- const msNeededForPropagationAndPublishing = this.config.validatorReexecuteDeadlineMs;
251
- return new Date(nextSlotTimestampSeconds * 1000 - msNeededForPropagationAndPublishing);
435
+ return new Date(nextSlotTimestampSeconds * 1000);
252
436
  }
253
437
 
254
438
  private getReexecuteFailureReason(err: any) {
@@ -266,11 +450,12 @@ export class BlockProposalHandler {
266
450
  async reexecuteTransactions(
267
451
  proposal: BlockProposal,
268
452
  blockNumber: BlockNumber,
453
+ checkpointNumber: CheckpointNumber,
269
454
  txs: Tx[],
270
455
  l1ToL2Messages: Fr[],
456
+ previousCheckpointOutHashes: Fr[],
271
457
  ): Promise<ReexecuteTransactionsResult> {
272
- const { header } = proposal.payload;
273
- const { txHashes } = proposal;
458
+ const { blockHeader, txHashes } = proposal;
274
459
 
275
460
  // If we do not have all of the transactions, then we should fail
276
461
  if (txs.length !== txHashes.length) {
@@ -279,28 +464,50 @@ export class BlockProposalHandler {
279
464
  throw new TransactionsNotAvailableError(missingTxHashes);
280
465
  }
281
466
 
282
- // Use the sequencer's block building logic to re-execute the transactions
283
467
  const timer = new Timer();
284
- const config = this.blockBuilder.getConfig();
285
-
286
- // We source most global variables from the proposal
287
- const globalVariables = GlobalVariables.from({
288
- slotNumber: proposal.payload.header.slotNumber, // checked in the block proposal validator
289
- coinbase: proposal.payload.header.coinbase, // set arbitrarily by the proposer
290
- feeRecipient: proposal.payload.header.feeRecipient, // set arbitrarily by the proposer
291
- gasFees: proposal.payload.header.gasFees, // validated by the rollup contract
292
- blockNumber, // computed from the parent block and checked it does not exist in archiver
293
- timestamp: header.timestamp, // checked in the rollup contract against the slot number
468
+ const slot = proposal.slotNumber;
469
+ const config = this.checkpointsBuilder.getConfig();
470
+
471
+ // Get prior blocks in this checkpoint (same slot before current block)
472
+ const allBlocksInSlot = await this.blockSource.getBlocksForSlot(slot);
473
+ const priorBlocks = allBlocksInSlot.filter(b => b.number < blockNumber && b.header.getSlot() === slot);
474
+
475
+ // Fork before the block to be built
476
+ const parentBlockNumber = BlockNumber(blockNumber - 1);
477
+ await this.worldState.syncImmediate(parentBlockNumber);
478
+ using fork = await this.worldState.fork(parentBlockNumber);
479
+
480
+ // Build checkpoint constants from proposal (excludes blockNumber and timestamp which are per-block)
481
+ const constants: CheckpointGlobalVariables = {
294
482
  chainId: new Fr(config.l1ChainId),
295
483
  version: new Fr(config.rollupVersion),
296
- });
484
+ slotNumber: slot,
485
+ coinbase: blockHeader.globalVariables.coinbase,
486
+ feeRecipient: blockHeader.globalVariables.feeRecipient,
487
+ gasFees: blockHeader.globalVariables.gasFees,
488
+ };
297
489
 
298
- const { block, failedTxs } = await this.blockBuilder.buildBlock(txs, l1ToL2Messages, globalVariables, {
299
- deadline: this.getReexecutionDeadline(proposal.payload.header.slotNumber, config),
490
+ // Create checkpoint builder with prior blocks
491
+ const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(
492
+ checkpointNumber,
493
+ constants,
494
+ l1ToL2Messages,
495
+ previousCheckpointOutHashes,
496
+ fork,
497
+ priorBlocks,
498
+ this.log.getBindings(),
499
+ );
500
+
501
+ // Build the new block
502
+ const deadline = this.getReexecutionDeadline(slot, config);
503
+ const result = await checkpointBuilder.buildBlock(txs, blockNumber, blockHeader.globalVariables.timestamp, {
504
+ deadline,
505
+ expectedEndState: blockHeader.state,
300
506
  });
301
507
 
508
+ const { block, failedTxs } = result;
302
509
  const numFailedTxs = failedTxs.length;
303
- const slot = proposal.slotNumber;
510
+
304
511
  this.log.verbose(`Transaction re-execution complete for slot ${slot}`, {
305
512
  numFailedTxs,
306
513
  numProposalTxs: txHashes.length,
@@ -319,11 +526,15 @@ export class BlockProposalHandler {
319
526
  }
320
527
 
321
528
  // Throw a ReExStateMismatchError error if state updates do not match
322
- const blockPayload = ConsensusPayload.fromBlock(block);
323
- if (!blockPayload.equals(proposal.payload)) {
529
+ // Compare the full block structure (archive and header) from the built block with the proposal
530
+ const archiveMatches = proposal.archive.equals(block.archive.root);
531
+ const headerMatches = proposal.blockHeader.equals(block.header);
532
+ if (!archiveMatches || !headerMatches) {
324
533
  this.log.warn(`Re-execution state mismatch for slot ${slot}`, {
325
- expected: blockPayload.toInspect(),
326
- actual: proposal.payload.toInspect(),
534
+ expectedArchive: block.archive.root.toString(),
535
+ actualArchive: proposal.archive.toString(),
536
+ expectedHeader: block.header.toInspect(),
537
+ actualHeader: proposal.blockHeader.toInspect(),
327
538
  });
328
539
  this.metrics?.recordFailedReexecution(proposal);
329
540
  throw new ReExStateMismatchError(proposal.archive, block.archive.root);