@aztec/validator-client 0.0.1-commit.135b523 → 0.0.1-commit.181e2d196

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 (50) hide show
  1. package/README.md +21 -18
  2. package/dest/block_proposal_handler.d.ts +2 -2
  3. package/dest/block_proposal_handler.d.ts.map +1 -1
  4. package/dest/block_proposal_handler.js +20 -34
  5. package/dest/checkpoint_builder.d.ts +8 -5
  6. package/dest/checkpoint_builder.d.ts.map +1 -1
  7. package/dest/checkpoint_builder.js +28 -18
  8. package/dest/config.d.ts +1 -1
  9. package/dest/config.d.ts.map +1 -1
  10. package/dest/config.js +5 -1
  11. package/dest/duties/validation_service.d.ts +2 -2
  12. package/dest/duties/validation_service.d.ts.map +1 -1
  13. package/dest/duties/validation_service.js +3 -3
  14. package/dest/factory.d.ts +1 -1
  15. package/dest/factory.d.ts.map +1 -1
  16. package/dest/factory.js +2 -1
  17. package/dest/index.d.ts +1 -2
  18. package/dest/index.d.ts.map +1 -1
  19. package/dest/index.js +0 -1
  20. package/dest/key_store/ha_key_store.d.ts +1 -1
  21. package/dest/key_store/ha_key_store.d.ts.map +1 -1
  22. package/dest/key_store/ha_key_store.js +2 -2
  23. package/dest/metrics.d.ts +9 -1
  24. package/dest/metrics.d.ts.map +1 -1
  25. package/dest/metrics.js +12 -0
  26. package/dest/validator.d.ts +35 -8
  27. package/dest/validator.d.ts.map +1 -1
  28. package/dest/validator.js +179 -29
  29. package/package.json +19 -19
  30. package/src/block_proposal_handler.ts +28 -48
  31. package/src/checkpoint_builder.ts +23 -6
  32. package/src/config.ts +5 -1
  33. package/src/duties/validation_service.ts +9 -2
  34. package/src/factory.ts +1 -0
  35. package/src/index.ts +0 -1
  36. package/src/key_store/ha_key_store.ts +2 -2
  37. package/src/metrics.ts +18 -0
  38. package/src/validator.ts +234 -35
  39. package/dest/tx_validator/index.d.ts +0 -3
  40. package/dest/tx_validator/index.d.ts.map +0 -1
  41. package/dest/tx_validator/index.js +0 -2
  42. package/dest/tx_validator/nullifier_cache.d.ts +0 -14
  43. package/dest/tx_validator/nullifier_cache.d.ts.map +0 -1
  44. package/dest/tx_validator/nullifier_cache.js +0 -24
  45. package/dest/tx_validator/tx_validator_factory.d.ts +0 -19
  46. package/dest/tx_validator/tx_validator_factory.d.ts.map +0 -1
  47. package/dest/tx_validator/tx_validator_factory.js +0 -54
  48. package/src/tx_validator/index.ts +0 -2
  49. package/src/tx_validator/nullifier_cache.ts +0 -30
  50. package/src/tx_validator/tx_validator_factory.ts +0 -154
package/dest/validator.js CHANGED
@@ -1,5 +1,6 @@
1
1
  import { getBlobsPerL1Block } from '@aztec/blob-lib';
2
- import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { validateFeeAssetPriceModifier } from '@aztec/ethereum/contracts';
3
+ import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
4
  import { TimeoutError } from '@aztec/foundation/error';
4
5
  import { createLogger } from '@aztec/foundation/log';
5
6
  import { retryUntil } from '@aztec/foundation/retry';
@@ -8,7 +9,7 @@ import { sleep } from '@aztec/foundation/sleep';
8
9
  import { DateProvider } from '@aztec/foundation/timer';
9
10
  import { AuthRequest, AuthResponse, BlockProposalValidator, ReqRespSubProtocol } from '@aztec/p2p';
10
11
  import { OffenseType, WANT_TO_SLASH_EVENT } from '@aztec/slasher';
11
- import { getEpochAtSlot } from '@aztec/stdlib/epoch-helpers';
12
+ import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
12
13
  import { accumulateCheckpointOutHashes } from '@aztec/stdlib/messaging';
13
14
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
14
15
  import { getTelemetryClient } from '@aztec/telemetry-client';
@@ -41,6 +42,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
41
42
  l1ToL2MessageSource;
42
43
  config;
43
44
  blobClient;
45
+ haSigner;
44
46
  dateProvider;
45
47
  tracer;
46
48
  validationService;
@@ -48,13 +50,15 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
48
50
  log;
49
51
  // Whether it has already registered handlers on the p2p client
50
52
  hasRegisteredHandlers;
51
- // Used to check if we are sending the same proposal twice
52
- previousProposal;
53
+ /** Tracks the last block proposal we created, to detect duplicate proposal attempts. */ lastProposedBlock;
54
+ /** Tracks the last checkpoint proposal we created. */ lastProposedCheckpoint;
53
55
  lastEpochForCommitteeUpdateLoop;
54
56
  epochCacheUpdateLoop;
57
+ /** Tracks the last epoch in which each attester successfully submitted at least one attestation. */ lastAttestedEpochByAttester;
55
58
  proposersOfInvalidBlocks;
56
- constructor(keyStore, epochCache, p2pClient, blockProposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator')){
57
- super(), this.keyStore = keyStore, this.epochCache = epochCache, this.p2pClient = p2pClient, this.blockProposalHandler = blockProposalHandler, this.blockSource = blockSource, this.checkpointsBuilder = checkpointsBuilder, this.worldState = worldState, this.l1ToL2MessageSource = l1ToL2MessageSource, this.config = config, this.blobClient = blobClient, this.dateProvider = dateProvider, this.hasRegisteredHandlers = false, this.proposersOfInvalidBlocks = new Set();
59
+ /** Tracks the last checkpoint proposal we attested to, to prevent equivocation. */ lastAttestedProposal;
60
+ constructor(keyStore, epochCache, p2pClient, blockProposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, haSigner, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator')){
61
+ super(), this.keyStore = keyStore, this.epochCache = epochCache, this.p2pClient = p2pClient, this.blockProposalHandler = blockProposalHandler, this.blockSource = blockSource, this.checkpointsBuilder = checkpointsBuilder, this.worldState = worldState, this.l1ToL2MessageSource = l1ToL2MessageSource, this.config = config, this.blobClient = blobClient, this.haSigner = haSigner, this.dateProvider = dateProvider, this.hasRegisteredHandlers = false, this.lastAttestedEpochByAttester = new Map(), this.proposersOfInvalidBlocks = new Set();
58
62
  // Create child logger with fisherman prefix if in fisherman mode
59
63
  this.log = config.fishermanMode ? log.createChild('[FISHERMAN]') : log;
60
64
  this.tracer = telemetry.getTracer('Validator');
@@ -93,6 +97,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
93
97
  this.log.trace(`No committee found for slot`);
94
98
  return;
95
99
  }
100
+ this.metrics.setCurrentEpoch(epoch);
96
101
  if (epoch !== this.lastEpochForCommitteeUpdateLoop) {
97
102
  const me = this.getValidatorAddresses();
98
103
  const committeeSet = new Set(committee.map((v)=>v.toString()));
@@ -111,20 +116,27 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
111
116
  static async new(config, checkpointsBuilder, worldState, epochCache, p2pClient, blockSource, l1ToL2MessageSource, txProvider, keyStoreManager, blobClient, dateProvider = new DateProvider(), telemetry = getTelemetryClient()) {
112
117
  const metrics = new ValidatorMetrics(telemetry);
113
118
  const blockProposalValidator = new BlockProposalValidator(epochCache, {
114
- txsPermitted: !config.disableTransactions
119
+ txsPermitted: !config.disableTransactions,
120
+ maxTxsPerBlock: config.maxTxsPerBlock
115
121
  });
116
122
  const blockProposalHandler = new BlockProposalHandler(checkpointsBuilder, worldState, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, epochCache, config, metrics, dateProvider, telemetry);
117
- let validatorKeyStore = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
123
+ const nodeKeystoreAdapter = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
124
+ let validatorKeyStore = nodeKeystoreAdapter;
125
+ let haSigner;
118
126
  if (config.haSigningEnabled) {
119
127
  // If maxStuckDutiesAgeMs is not explicitly set, compute it from Aztec slot duration
120
128
  const haConfig = {
121
129
  ...config,
122
130
  maxStuckDutiesAgeMs: config.maxStuckDutiesAgeMs ?? epochCache.getL1Constants().slotDuration * 2 * 1000
123
131
  };
124
- const { signer } = await createHASigner(haConfig);
125
- validatorKeyStore = new HAKeyStore(validatorKeyStore, signer);
132
+ const { signer } = await createHASigner(haConfig, {
133
+ telemetryClient: telemetry,
134
+ dateProvider
135
+ });
136
+ haSigner = signer;
137
+ validatorKeyStore = new HAKeyStore(nodeKeystoreAdapter, signer);
126
138
  }
127
- const validator = new ValidatorClient(validatorKeyStore, epochCache, p2pClient, blockProposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, dateProvider, telemetry);
139
+ const validator = new ValidatorClient(validatorKeyStore, epochCache, p2pClient, blockProposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, haSigner, dateProvider, telemetry);
128
140
  return validator;
129
141
  }
130
142
  getValidatorAddresses() {
@@ -151,6 +163,20 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
151
163
  ...config
152
164
  };
153
165
  }
166
+ reloadKeystore(newManager) {
167
+ if (this.config.haSigningEnabled && !this.haSigner) {
168
+ this.log.warn('HA signing is enabled in config but was not initialized at startup. ' + 'Restart the node to enable HA signing.');
169
+ } else if (!this.config.haSigningEnabled && this.haSigner) {
170
+ this.log.warn('HA signing was disabled via config update but the HA signer is still active. ' + 'Restart the node to fully disable HA signing.');
171
+ }
172
+ const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
173
+ if (this.haSigner) {
174
+ this.keyStore = new HAKeyStore(newAdapter, this.haSigner);
175
+ } else {
176
+ this.keyStore = newAdapter;
177
+ }
178
+ this.validationService = new ValidationService(this.keyStore, this.log.createChild('validation-service'));
179
+ }
154
180
  async start() {
155
181
  if (this.epochCacheUpdateLoop.isRunning()) {
156
182
  this.log.warn(`Validator client already started`);
@@ -183,6 +209,14 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
183
209
  // and processed separately via the block handler above.
184
210
  const checkpointHandler = (checkpoint, proposalSender)=>this.attestToCheckpointProposal(checkpoint, proposalSender);
185
211
  this.p2pClient.registerCheckpointProposalHandler(checkpointHandler);
212
+ // Duplicate proposal handler - triggers slashing for equivocation
213
+ this.p2pClient.registerDuplicateProposalCallback((info)=>{
214
+ this.handleDuplicateProposal(info);
215
+ });
216
+ // Duplicate attestation handler - triggers slashing for attestation equivocation
217
+ this.p2pClient.registerDuplicateAttestationCallback((info)=>{
218
+ this.handleDuplicateAttestation(info);
219
+ });
186
220
  const myAddresses = this.getValidatorAddresses();
187
221
  this.p2pClient.registerThisValidatorAddresses(myAddresses);
188
222
  await this.p2pClient.addReqRespSubProtocol(ReqRespSubProtocol.AUTH, this.handleAuthRequest.bind(this));
@@ -203,6 +237,14 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
203
237
  this.log.warn(`Received block proposal with invalid signature for slot ${slotNumber}`);
204
238
  return false;
205
239
  }
240
+ // Ignore proposals from ourselves (may happen in HA setups)
241
+ if (this.getValidatorAddresses().some((addr)=>addr.equals(proposer))) {
242
+ this.log.warn(`Ignoring block proposal from self for slot ${slotNumber}`, {
243
+ proposer: proposer.toString(),
244
+ slotNumber
245
+ });
246
+ return false;
247
+ }
206
248
  // Check if we're in the committee (for metrics purposes)
207
249
  const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
208
250
  const partOfCommittee = inCommittee.length > 0;
@@ -274,6 +316,19 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
274
316
  this.log.warn(`Received checkpoint proposal with invalid signature for slot ${slotNumber}`);
275
317
  return undefined;
276
318
  }
319
+ // Ignore proposals from ourselves (may happen in HA setups)
320
+ if (this.getValidatorAddresses().some((addr)=>addr.equals(proposer))) {
321
+ this.log.warn(`Ignoring block proposal from self for slot ${slotNumber}`, {
322
+ proposer: proposer.toString(),
323
+ slotNumber
324
+ });
325
+ return undefined;
326
+ }
327
+ // Validate fee asset price modifier is within allowed range
328
+ if (!validateFeeAssetPriceModifier(proposal.feeAssetPriceModifier)) {
329
+ this.log.warn(`Received checkpoint proposal with invalid feeAssetPriceModifier ${proposal.feeAssetPriceModifier} for slot ${slotNumber}`);
330
+ return undefined;
331
+ }
277
332
  // Check that I have any address in current committee before attesting
278
333
  const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
279
334
  const partOfCommittee = inCommittee.length > 0;
@@ -315,6 +370,16 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
315
370
  fishermanMode: this.config.fishermanMode || false
316
371
  });
317
372
  this.metrics.incSuccessfulAttestations(inCommittee.length);
373
+ // Track epoch participation per attester: count each (attester, epoch) pair at most once
374
+ const proposalEpoch = getEpochAtSlot(slotNumber, this.epochCache.getL1Constants());
375
+ for (const attester of inCommittee){
376
+ const key = attester.toString();
377
+ const lastEpoch = this.lastAttestedEpochByAttester.get(key);
378
+ if (lastEpoch === undefined || proposalEpoch > lastEpoch) {
379
+ this.lastAttestedEpochByAttester.set(key, proposalEpoch);
380
+ this.metrics.incAttestedEpochCount(attester);
381
+ }
382
+ }
318
383
  // Determine which validators should attest
319
384
  let attestors;
320
385
  if (partOfCommittee) {
@@ -337,11 +402,32 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
337
402
  });
338
403
  return undefined;
339
404
  }
340
- return this.createCheckpointAttestationsFromProposal(proposal, attestors);
405
+ return await this.createCheckpointAttestationsFromProposal(proposal, attestors);
406
+ }
407
+ /**
408
+ * Checks if we should attest to a slot based on equivocation prevention rules.
409
+ * @returns true if we should attest, false if we should skip
410
+ */ shouldAttestToSlot(slotNumber) {
411
+ // If attestToEquivocatedProposals is true, always allow
412
+ if (this.config.attestToEquivocatedProposals) {
413
+ return true;
414
+ }
415
+ // Check if incoming slot is strictly greater than last attested
416
+ if (this.lastAttestedProposal && slotNumber <= this.lastAttestedProposal.slotNumber) {
417
+ this.log.warn(`Refusing to process a proposal for slot ${slotNumber} given we already attested to a proposal for slot ${this.lastAttestedProposal.slotNumber}`);
418
+ return false;
419
+ }
420
+ return true;
341
421
  }
342
422
  async createCheckpointAttestationsFromProposal(proposal, attestors = []) {
423
+ // Equivocation check: must happen right before signing to minimize the race window
424
+ if (!this.shouldAttestToSlot(proposal.slotNumber)) {
425
+ return undefined;
426
+ }
343
427
  const attestations = await this.validationService.attestToCheckpointProposal(proposal, attestors);
344
- await this.p2pClient.addCheckpointAttestations(attestations);
428
+ // Track the proposal we attested to (to prevent equivocation)
429
+ this.lastAttestedProposal = proposal;
430
+ await this.p2pClient.addOwnCheckpointAttestations(attestations);
345
431
  return attestations;
346
432
  }
347
433
  /**
@@ -349,7 +435,10 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
349
435
  * @returns Validation result with isValid flag and reason if invalid.
350
436
  */ async validateCheckpointProposal(proposal, proposalInfo) {
351
437
  const slot = proposal.slotNumber;
352
- const timeoutSeconds = 10; // TODO(palla/mbps): This should map to the timetable settings
438
+ // Timeout block syncing at the start of the next slot
439
+ const config = this.checkpointsBuilder.getConfig();
440
+ const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
441
+ const timeoutSeconds = Math.max(1, nextSlotTimestampSeconds - Math.floor(this.dateProvider.now() / 1000));
353
442
  // Wait for last block to sync by archive
354
443
  let lastBlockHeader;
355
444
  try {
@@ -387,6 +476,14 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
387
476
  reason: 'no_blocks_for_slot'
388
477
  };
389
478
  }
479
+ // Ensure the last block for this slot matches the archive in the checkpoint proposal
480
+ if (!blocks.at(-1)?.archive.root.equals(proposal.archive)) {
481
+ this.log.warn(`Last block archive mismatch for checkpoint proposal`, proposalInfo);
482
+ return {
483
+ isValid: false,
484
+ reason: 'last_block_archive_mismatch'
485
+ };
486
+ }
390
487
  this.log.debug(`Found ${blocks.length} blocks for slot ${slot}`, {
391
488
  ...proposalInfo,
392
489
  blockNumbers: blocks.map((b)=>b.number)
@@ -397,18 +494,15 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
397
494
  const checkpointNumber = firstBlock.checkpointNumber;
398
495
  // Get L1-to-L2 messages for this checkpoint
399
496
  const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
400
- // Compute the previous checkpoint out hashes for the epoch.
401
- // TODO: There can be a more efficient way to get the previous checkpoint out hashes without having to fetch the
402
- // actual checkpoints and the blocks/txs in them.
497
+ // Collect the out hashes of all the checkpoints before this one in the same epoch
403
498
  const epoch = getEpochAtSlot(slot, this.epochCache.getL1Constants());
404
- const previousCheckpoints = (await this.blockSource.getCheckpointsForEpoch(epoch)).filter((b)=>b.number < checkpointNumber).sort((a, b)=>a.number - b.number);
405
- const previousCheckpointOutHashes = previousCheckpoints.map((c)=>c.getCheckpointOutHash());
499
+ const previousCheckpointOutHashes = (await this.blockSource.getCheckpointsDataForEpoch(epoch)).filter((c)=>c.checkpointNumber < checkpointNumber).map((c)=>c.checkpointOutHash);
406
500
  // Fork world state at the block before the first block
407
501
  const parentBlockNumber = BlockNumber(firstBlock.number - 1);
408
502
  const fork = await this.worldState.fork(parentBlockNumber);
409
503
  try {
410
504
  // Create checkpoint builder with all existing blocks
411
- const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(checkpointNumber, constants, l1ToL2Messages, previousCheckpointOutHashes, fork, blocks, this.log.getBindings());
505
+ const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(checkpointNumber, constants, proposal.feeAssetPriceModifier, l1ToL2Messages, previousCheckpointOutHashes, fork, blocks, this.log.getBindings());
412
506
  // Complete the checkpoint to get computed values
413
507
  const computedCheckpoint = await checkpointBuilder.completeCheckpoint();
414
508
  // Compare checkpoint header with proposal
@@ -472,6 +566,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
472
566
  chainId: gv.chainId,
473
567
  version: gv.version,
474
568
  slotNumber: gv.slotNumber,
569
+ timestamp: gv.timestamp,
475
570
  coinbase: gv.coinbase,
476
571
  feeRecipient: gv.feeRecipient,
477
572
  gasFees: gv.gasFees
@@ -492,7 +587,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
492
587
  return;
493
588
  }
494
589
  const blobFields = blocks.flatMap((b)=>b.toBlobFields());
495
- const blobs = getBlobsPerL1Block(blobFields);
590
+ const blobs = await getBlobsPerL1Block(blobFields);
496
591
  await this.blobClient.sendBlobsToFilestore(blobs);
497
592
  this.log.debug(`Uploaded ${blobs.length} blobs to filestore for checkpoint at slot ${proposal.slotNumber}`, {
498
593
  ...proposalInfo,
@@ -524,23 +619,75 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
524
619
  }
525
620
  ]);
526
621
  }
622
+ /**
623
+ * Handle detection of a duplicate proposal (equivocation).
624
+ * Emits a slash event when a proposer sends multiple proposals for the same position.
625
+ */ handleDuplicateProposal(info) {
626
+ const { slot, proposer, type } = info;
627
+ this.log.warn(`Triggering slash event for duplicate ${type} proposal from ${proposer.toString()} at slot ${slot}`, {
628
+ proposer: proposer.toString(),
629
+ slot,
630
+ type
631
+ });
632
+ // Emit slash event
633
+ this.emit(WANT_TO_SLASH_EVENT, [
634
+ {
635
+ validator: proposer,
636
+ amount: this.config.slashDuplicateProposalPenalty,
637
+ offenseType: OffenseType.DUPLICATE_PROPOSAL,
638
+ epochOrSlot: BigInt(slot)
639
+ }
640
+ ]);
641
+ }
642
+ /**
643
+ * Handle detection of a duplicate attestation (equivocation).
644
+ * Emits a slash event when an attester signs attestations for different proposals at the same slot.
645
+ */ handleDuplicateAttestation(info) {
646
+ const { slot, attester } = info;
647
+ this.log.warn(`Triggering slash event for duplicate attestation from ${attester.toString()} at slot ${slot}`, {
648
+ attester: attester.toString(),
649
+ slot
650
+ });
651
+ this.emit(WANT_TO_SLASH_EVENT, [
652
+ {
653
+ validator: attester,
654
+ amount: this.config.slashDuplicateAttestationPenalty,
655
+ offenseType: OffenseType.DUPLICATE_ATTESTATION,
656
+ epochOrSlot: BigInt(slot)
657
+ }
658
+ ]);
659
+ }
527
660
  async createBlockProposal(blockHeader, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, options = {}) {
528
- // TODO(palla/mbps): Prevent double proposals properly
529
- // if (this.previousProposal?.slotNumber === blockHeader.globalVariables.slotNumber) {
530
- // this.log.verbose(`Already made a proposal for the same slot, skipping proposal`);
531
- // return Promise.resolve(undefined);
532
- // }
661
+ // Validate that we're not creating a proposal for an older or equal position
662
+ if (this.lastProposedBlock) {
663
+ const lastSlot = this.lastProposedBlock.slotNumber;
664
+ const lastIndex = this.lastProposedBlock.indexWithinCheckpoint;
665
+ const newSlot = blockHeader.globalVariables.slotNumber;
666
+ if (newSlot < lastSlot || newSlot === lastSlot && indexWithinCheckpoint <= lastIndex) {
667
+ throw new Error(`Cannot create block proposal for slot ${newSlot} index ${indexWithinCheckpoint}: ` + `already proposed block for slot ${lastSlot} index ${lastIndex}`);
668
+ }
669
+ }
533
670
  this.log.info(`Assembling block proposal for block ${blockHeader.globalVariables.blockNumber} slot ${blockHeader.globalVariables.slotNumber}`);
534
671
  const newProposal = await this.validationService.createBlockProposal(blockHeader, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, {
535
672
  ...options,
536
673
  broadcastInvalidBlockProposal: this.config.broadcastInvalidBlockProposal
537
674
  });
538
- this.previousProposal = newProposal;
675
+ this.lastProposedBlock = newProposal;
539
676
  return newProposal;
540
677
  }
541
- async createCheckpointProposal(checkpointHeader, archive, lastBlockInfo, proposerAddress, options = {}) {
678
+ async createCheckpointProposal(checkpointHeader, archive, feeAssetPriceModifier, lastBlockInfo, proposerAddress, options = {}) {
679
+ // Validate that we're not creating a proposal for an older or equal slot
680
+ if (this.lastProposedCheckpoint) {
681
+ const lastSlot = this.lastProposedCheckpoint.slotNumber;
682
+ const newSlot = checkpointHeader.slotNumber;
683
+ if (newSlot <= lastSlot) {
684
+ throw new Error(`Cannot create checkpoint proposal for slot ${newSlot}: ` + `already proposed checkpoint for slot ${lastSlot}`);
685
+ }
686
+ }
542
687
  this.log.info(`Assembling checkpoint proposal for slot ${checkpointHeader.slotNumber}`);
543
- return await this.validationService.createCheckpointProposal(checkpointHeader, archive, lastBlockInfo, proposerAddress, options);
688
+ const newProposal = await this.validationService.createCheckpointProposal(checkpointHeader, archive, feeAssetPriceModifier, lastBlockInfo, proposerAddress, options);
689
+ this.lastProposedCheckpoint = newProposal;
690
+ return newProposal;
544
691
  }
545
692
  async broadcastBlockProposal(proposal) {
546
693
  await this.p2pClient.broadcastProposal(proposal);
@@ -555,6 +702,9 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
555
702
  inCommittee
556
703
  });
557
704
  const attestations = await this.createCheckpointAttestationsFromProposal(proposal, inCommittee);
705
+ if (!attestations) {
706
+ return [];
707
+ }
558
708
  // We broadcast our own attestations to our peers so, in case our block does not get mined on L1,
559
709
  // other nodes can see that our validators did attest to this block proposal, and do not slash us
560
710
  // due to inactivity for missed attestations.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/validator-client",
3
- "version": "0.0.1-commit.135b523",
3
+ "version": "0.0.1-commit.181e2d196",
4
4
  "main": "dest/index.js",
5
5
  "type": "module",
6
6
  "exports": {
@@ -64,30 +64,30 @@
64
64
  ]
65
65
  },
66
66
  "dependencies": {
67
- "@aztec/blob-client": "0.0.1-commit.135b523",
68
- "@aztec/blob-lib": "0.0.1-commit.135b523",
69
- "@aztec/constants": "0.0.1-commit.135b523",
70
- "@aztec/epoch-cache": "0.0.1-commit.135b523",
71
- "@aztec/ethereum": "0.0.1-commit.135b523",
72
- "@aztec/foundation": "0.0.1-commit.135b523",
73
- "@aztec/node-keystore": "0.0.1-commit.135b523",
74
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.135b523",
75
- "@aztec/p2p": "0.0.1-commit.135b523",
76
- "@aztec/protocol-contracts": "0.0.1-commit.135b523",
77
- "@aztec/prover-client": "0.0.1-commit.135b523",
78
- "@aztec/simulator": "0.0.1-commit.135b523",
79
- "@aztec/slasher": "0.0.1-commit.135b523",
80
- "@aztec/stdlib": "0.0.1-commit.135b523",
81
- "@aztec/telemetry-client": "0.0.1-commit.135b523",
82
- "@aztec/validator-ha-signer": "0.0.1-commit.135b523",
67
+ "@aztec/blob-client": "0.0.1-commit.181e2d196",
68
+ "@aztec/blob-lib": "0.0.1-commit.181e2d196",
69
+ "@aztec/constants": "0.0.1-commit.181e2d196",
70
+ "@aztec/epoch-cache": "0.0.1-commit.181e2d196",
71
+ "@aztec/ethereum": "0.0.1-commit.181e2d196",
72
+ "@aztec/foundation": "0.0.1-commit.181e2d196",
73
+ "@aztec/node-keystore": "0.0.1-commit.181e2d196",
74
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.181e2d196",
75
+ "@aztec/p2p": "0.0.1-commit.181e2d196",
76
+ "@aztec/protocol-contracts": "0.0.1-commit.181e2d196",
77
+ "@aztec/prover-client": "0.0.1-commit.181e2d196",
78
+ "@aztec/simulator": "0.0.1-commit.181e2d196",
79
+ "@aztec/slasher": "0.0.1-commit.181e2d196",
80
+ "@aztec/stdlib": "0.0.1-commit.181e2d196",
81
+ "@aztec/telemetry-client": "0.0.1-commit.181e2d196",
82
+ "@aztec/validator-ha-signer": "0.0.1-commit.181e2d196",
83
83
  "koa": "^2.16.1",
84
84
  "koa-router": "^13.1.1",
85
85
  "tslib": "^2.4.0",
86
86
  "viem": "npm:@aztec/viem@2.38.2"
87
87
  },
88
88
  "devDependencies": {
89
- "@aztec/archiver": "0.0.1-commit.135b523",
90
- "@aztec/world-state": "0.0.1-commit.135b523",
89
+ "@aztec/archiver": "0.0.1-commit.181e2d196",
90
+ "@aztec/world-state": "0.0.1-commit.181e2d196",
91
91
  "@electric-sql/pglite": "^0.3.14",
92
92
  "@jest/globals": "^30.0.0",
93
93
  "@types/jest": "^30.0.0",
@@ -1,7 +1,6 @@
1
1
  import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
2
2
  import type { EpochCache } from '@aztec/epoch-cache';
3
3
  import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
4
- import { chunkBy } from '@aztec/foundation/collection';
5
4
  import { Fr } from '@aztec/foundation/curves/bn254';
6
5
  import { TimeoutError } from '@aztec/foundation/error';
7
6
  import { createLogger } from '@aztec/foundation/log';
@@ -9,16 +8,12 @@ import { retryUntil } from '@aztec/foundation/retry';
9
8
  import { DateProvider, Timer } from '@aztec/foundation/timer';
10
9
  import type { P2P, PeerId } from '@aztec/p2p';
11
10
  import { BlockProposalValidator } from '@aztec/p2p/msg_validators';
12
- import type { L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
11
+ import type { BlockData, L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
13
12
  import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
14
13
  import type { ITxProvider, ValidatorClientFullConfig, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
15
- import {
16
- type L1ToL2MessageSource,
17
- computeCheckpointOutHash,
18
- computeInHashFromL1ToL2Messages,
19
- } from '@aztec/stdlib/messaging';
14
+ import { type L1ToL2MessageSource, computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
20
15
  import type { BlockProposal } from '@aztec/stdlib/p2p';
21
- import { BlockHeader, type CheckpointGlobalVariables, type FailedTx, type Tx } from '@aztec/stdlib/tx';
16
+ import type { CheckpointGlobalVariables, FailedTx, Tx } from '@aztec/stdlib/tx';
22
17
  import {
23
18
  ReExFailedTxsError,
24
19
  ReExStateMismatchError,
@@ -153,16 +148,16 @@ export class BlockProposalHandler {
153
148
  }
154
149
 
155
150
  // Check that the parent proposal is a block we know, otherwise reexecution would fail
156
- const parentBlockHeader = await this.getParentBlock(proposal);
157
- if (parentBlockHeader === undefined) {
151
+ const parentBlock = await this.getParentBlock(proposal);
152
+ if (parentBlock === undefined) {
158
153
  this.log.warn(`Parent block for proposal not found, skipping processing`, proposalInfo);
159
154
  return { isValid: false, reason: 'parent_block_not_found' };
160
155
  }
161
156
 
162
157
  // Check that the parent block's slot is not greater than the proposal's slot.
163
- if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() > slotNumber) {
158
+ if (parentBlock !== 'genesis' && parentBlock.header.getSlot() > slotNumber) {
164
159
  this.log.warn(`Parent block slot is greater than proposal slot, skipping processing`, {
165
- parentBlockSlot: parentBlockHeader.getSlot().toString(),
160
+ parentBlockSlot: parentBlock.header.getSlot().toString(),
166
161
  proposalSlot: slotNumber.toString(),
167
162
  ...proposalInfo,
168
163
  });
@@ -171,9 +166,9 @@ export class BlockProposalHandler {
171
166
 
172
167
  // Compute the block number based on the parent block
173
168
  const blockNumber =
174
- parentBlockHeader === 'genesis'
169
+ parentBlock === 'genesis'
175
170
  ? BlockNumber(INITIAL_L2_BLOCK_NUM)
176
- : BlockNumber(parentBlockHeader.getBlockNumber() + 1);
171
+ : BlockNumber(parentBlock.header.getBlockNumber() + 1);
177
172
 
178
173
  // Check that this block number does not exist already
179
174
  const existingBlock = await this.blockSource.getBlockHeader(blockNumber);
@@ -190,7 +185,7 @@ export class BlockProposalHandler {
190
185
  });
191
186
 
192
187
  // Compute the checkpoint number for this block and validate checkpoint consistency
193
- const checkpointResult = await this.computeCheckpointNumber(proposal, parentBlockHeader, proposalInfo);
188
+ const checkpointResult = this.computeCheckpointNumber(proposal, parentBlock, proposalInfo);
194
189
  if (checkpointResult.reason) {
195
190
  return { isValid: false, blockNumber, reason: checkpointResult.reason };
196
191
  }
@@ -218,17 +213,11 @@ export class BlockProposalHandler {
218
213
  // Try re-executing the transactions in the proposal if needed
219
214
  let reexecutionResult;
220
215
  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.
216
+ // Collect the out hashes of all the checkpoints before this one in the same epoch
224
217
  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
- );
218
+ const previousCheckpointOutHashes = (await this.blockSource.getCheckpointsDataForEpoch(epoch))
219
+ .filter(c => c.checkpointNumber < checkpointNumber)
220
+ .map(c => c.checkpointOutHash);
232
221
 
233
222
  try {
234
223
  this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
@@ -260,7 +249,7 @@ export class BlockProposalHandler {
260
249
  return { isValid: true, blockNumber, reexecutionResult };
261
250
  }
262
251
 
263
- private async getParentBlock(proposal: BlockProposal): Promise<'genesis' | BlockHeader | undefined> {
252
+ private async getParentBlock(proposal: BlockProposal): Promise<'genesis' | BlockData | undefined> {
264
253
  const parentArchive = proposal.blockHeader.lastArchive.root;
265
254
  const slot = proposal.slotNumber;
266
255
  const config = this.checkpointsBuilder.getConfig();
@@ -276,12 +265,11 @@ export class BlockProposalHandler {
276
265
 
277
266
  try {
278
267
  return (
279
- (await this.blockSource.getBlockHeaderByArchive(parentArchive)) ??
268
+ (await this.blockSource.getBlockDataByArchive(parentArchive)) ??
280
269
  (timeoutDurationMs <= 0
281
270
  ? undefined
282
271
  : await retryUntil(
283
- () =>
284
- this.blockSource.syncImmediate().then(() => this.blockSource.getBlockHeaderByArchive(parentArchive)),
272
+ () => this.blockSource.syncImmediate().then(() => this.blockSource.getBlockDataByArchive(parentArchive)),
285
273
  'force archiver sync',
286
274
  timeoutDurationMs / 1000,
287
275
  0.5,
@@ -297,12 +285,12 @@ export class BlockProposalHandler {
297
285
  }
298
286
  }
299
287
 
300
- private async computeCheckpointNumber(
288
+ private computeCheckpointNumber(
301
289
  proposal: BlockProposal,
302
- parentBlockHeader: 'genesis' | BlockHeader,
290
+ parentBlock: 'genesis' | BlockData,
303
291
  proposalInfo: object,
304
- ): Promise<CheckpointComputationResult> {
305
- if (parentBlockHeader === 'genesis') {
292
+ ): CheckpointComputationResult {
293
+ if (parentBlock === 'genesis') {
306
294
  // First block is in checkpoint 1
307
295
  if (proposal.indexWithinCheckpoint !== 0) {
308
296
  this.log.warn(`First block proposal has non-zero indexWithinCheckpoint`, proposalInfo);
@@ -311,19 +299,9 @@ export class BlockProposalHandler {
311
299
  return { checkpointNumber: CheckpointNumber.INITIAL };
312
300
  }
313
301
 
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
302
  if (proposal.indexWithinCheckpoint === 0) {
325
303
  // If this is the first block in a new checkpoint, increment the checkpoint number
326
- if (!(proposal.blockHeader.getSlot() > parentBlockHeader.getSlot())) {
304
+ if (!(proposal.blockHeader.getSlot() > parentBlock.header.getSlot())) {
327
305
  this.log.warn(`Slot should be greater than parent block slot for first block in checkpoint`, proposalInfo);
328
306
  return { reason: 'invalid_proposal' };
329
307
  }
@@ -335,7 +313,7 @@ export class BlockProposalHandler {
335
313
  this.log.warn(`Non-sequential indexWithinCheckpoint`, proposalInfo);
336
314
  return { reason: 'invalid_proposal' };
337
315
  }
338
- if (proposal.blockHeader.getSlot() !== parentBlockHeader.getSlot()) {
316
+ if (proposal.blockHeader.getSlot() !== parentBlock.header.getSlot()) {
339
317
  this.log.warn(`Slot should be equal to parent block slot for non-first block in checkpoint`, proposalInfo);
340
318
  return { reason: 'invalid_proposal' };
341
319
  }
@@ -356,7 +334,7 @@ export class BlockProposalHandler {
356
334
  */
357
335
  private validateNonFirstBlockInCheckpoint(
358
336
  proposal: BlockProposal,
359
- parentBlock: L2Block,
337
+ parentBlock: BlockData,
360
338
  proposalInfo: object,
361
339
  ): CheckpointComputationResult | undefined {
362
340
  const proposalGlobals = proposal.blockHeader.globalVariables;
@@ -475,13 +453,14 @@ export class BlockProposalHandler {
475
453
  // Fork before the block to be built
476
454
  const parentBlockNumber = BlockNumber(blockNumber - 1);
477
455
  await this.worldState.syncImmediate(parentBlockNumber);
478
- using fork = await this.worldState.fork(parentBlockNumber);
456
+ await using fork = await this.worldState.fork(parentBlockNumber);
479
457
 
480
- // Build checkpoint constants from proposal (excludes blockNumber and timestamp which are per-block)
458
+ // Build checkpoint constants from proposal (excludes blockNumber which is per-block)
481
459
  const constants: CheckpointGlobalVariables = {
482
460
  chainId: new Fr(config.l1ChainId),
483
461
  version: new Fr(config.rollupVersion),
484
462
  slotNumber: slot,
463
+ timestamp: blockHeader.globalVariables.timestamp,
485
464
  coinbase: blockHeader.globalVariables.coinbase,
486
465
  feeRecipient: blockHeader.globalVariables.feeRecipient,
487
466
  gasFees: blockHeader.globalVariables.gasFees,
@@ -491,6 +470,7 @@ export class BlockProposalHandler {
491
470
  const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(
492
471
  checkpointNumber,
493
472
  constants,
473
+ 0n, // only takes effect in the following checkpoint.
494
474
  l1ToL2Messages,
495
475
  previousCheckpointOutHashes,
496
476
  fork,