@aztec/validator-client 0.0.1-commit.87a0206 → 0.0.1-commit.88e6f9396

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 (48) hide show
  1. package/README.md +53 -10
  2. package/dest/block_proposal_handler.d.ts +5 -4
  3. package/dest/block_proposal_handler.d.ts.map +1 -1
  4. package/dest/block_proposal_handler.js +130 -62
  5. package/dest/checkpoint_builder.d.ts +21 -8
  6. package/dest/checkpoint_builder.d.ts.map +1 -1
  7. package/dest/checkpoint_builder.js +124 -46
  8. package/dest/config.d.ts +1 -1
  9. package/dest/config.d.ts.map +1 -1
  10. package/dest/config.js +26 -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 +6 -12
  14. package/dest/factory.d.ts +3 -1
  15. package/dest/factory.d.ts.map +1 -1
  16. package/dest/factory.js +3 -2
  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.js +1 -1
  21. package/dest/metrics.d.ts +9 -1
  22. package/dest/metrics.d.ts.map +1 -1
  23. package/dest/metrics.js +12 -0
  24. package/dest/validator.d.ts +32 -10
  25. package/dest/validator.d.ts.map +1 -1
  26. package/dest/validator.js +189 -46
  27. package/package.json +19 -19
  28. package/src/block_proposal_handler.ts +157 -80
  29. package/src/checkpoint_builder.ts +142 -39
  30. package/src/config.ts +26 -1
  31. package/src/duties/validation_service.ts +12 -11
  32. package/src/factory.ts +4 -0
  33. package/src/index.ts +0 -1
  34. package/src/key_store/ha_key_store.ts +1 -1
  35. package/src/metrics.ts +18 -0
  36. package/src/validator.ts +246 -56
  37. package/dest/tx_validator/index.d.ts +0 -3
  38. package/dest/tx_validator/index.d.ts.map +0 -1
  39. package/dest/tx_validator/index.js +0 -2
  40. package/dest/tx_validator/nullifier_cache.d.ts +0 -14
  41. package/dest/tx_validator/nullifier_cache.d.ts.map +0 -1
  42. package/dest/tx_validator/nullifier_cache.js +0 -24
  43. package/dest/tx_validator/tx_validator_factory.d.ts +0 -19
  44. package/dest/tx_validator/tx_validator_factory.d.ts.map +0 -1
  45. package/dest/tx_validator/tx_validator_factory.js +0 -54
  46. package/src/tx_validator/index.ts +0 -2
  47. package/src/tx_validator/nullifier_cache.ts +0 -30
  48. package/src/tx_validator/tx_validator_factory.ts +0 -154
package/src/validator.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import type { BlobClientInterface } from '@aztec/blob-client/client';
2
2
  import { type Blob, getBlobsPerL1Block } from '@aztec/blob-lib';
3
3
  import type { EpochCache } from '@aztec/epoch-cache';
4
+ import { validateFeeAssetPriceModifier } from '@aztec/ethereum/contracts';
4
5
  import {
5
6
  BlockNumber,
6
7
  CheckpointNumber,
@@ -18,12 +19,13 @@ import { RunningPromise } from '@aztec/foundation/running-promise';
18
19
  import { sleep } from '@aztec/foundation/sleep';
19
20
  import { DateProvider } from '@aztec/foundation/timer';
20
21
  import type { KeystoreManager } from '@aztec/node-keystore';
21
- import type { DuplicateProposalInfo, P2P, PeerId } from '@aztec/p2p';
22
+ import type { DuplicateAttestationInfo, DuplicateProposalInfo, P2P, PeerId } from '@aztec/p2p';
22
23
  import { AuthRequest, AuthResponse, BlockProposalValidator, ReqRespSubProtocol } from '@aztec/p2p';
23
24
  import { OffenseType, WANT_TO_SLASH_EVENT, type Watcher, type WatcherEmitter } from '@aztec/slasher';
24
25
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
25
26
  import type { CommitteeAttestationsAndSigners, L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
26
- import { getEpochAtSlot } from '@aztec/stdlib/epoch-helpers';
27
+ import { validateCheckpoint } from '@aztec/stdlib/checkpoint';
28
+ import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
27
29
  import type {
28
30
  CreateCheckpointProposalLastBlockData,
29
31
  ITxProvider,
@@ -32,20 +34,25 @@ import type {
32
34
  WorldStateSynchronizer,
33
35
  } from '@aztec/stdlib/interfaces/server';
34
36
  import { type L1ToL2MessageSource, accumulateCheckpointOutHashes } from '@aztec/stdlib/messaging';
35
- import type {
36
- BlockProposal,
37
- BlockProposalOptions,
38
- CheckpointAttestation,
39
- CheckpointProposalCore,
40
- CheckpointProposalOptions,
37
+ import {
38
+ type BlockProposal,
39
+ type BlockProposalOptions,
40
+ type CheckpointAttestation,
41
+ CheckpointProposal,
42
+ type CheckpointProposalCore,
43
+ type CheckpointProposalOptions,
41
44
  } from '@aztec/stdlib/p2p';
42
- import { CheckpointProposal } from '@aztec/stdlib/p2p';
43
45
  import type { CheckpointHeader } from '@aztec/stdlib/rollup';
44
46
  import type { BlockHeader, CheckpointGlobalVariables, Tx } from '@aztec/stdlib/tx';
45
47
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
46
48
  import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
47
- import { createHASigner } from '@aztec/validator-ha-signer/factory';
48
- import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
49
+ import {
50
+ createHASigner,
51
+ createLocalSignerWithProtection,
52
+ createSignerFromSharedDb,
53
+ } from '@aztec/validator-ha-signer/factory';
54
+ import { DutyType, type SigningContext, type SlashingProtectionDatabase } from '@aztec/validator-ha-signer/types';
55
+ import type { ValidatorHASigner } from '@aztec/validator-ha-signer/validator-ha-signer';
49
56
 
50
57
  import { EventEmitter } from 'events';
51
58
  import type { TypedDataDefinition } from 'viem';
@@ -76,18 +83,25 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
76
83
  private validationService: ValidationService;
77
84
  private metrics: ValidatorMetrics;
78
85
  private log: Logger;
79
-
80
86
  // Whether it has already registered handlers on the p2p client
81
87
  private hasRegisteredHandlers = false;
82
88
 
83
- // Used to check if we are sending the same proposal twice
84
- private previousProposal?: BlockProposal;
89
+ /** Tracks the last block proposal we created, to detect duplicate proposal attempts. */
90
+ private lastProposedBlock?: BlockProposal;
91
+
92
+ /** Tracks the last checkpoint proposal we created. */
93
+ private lastProposedCheckpoint?: CheckpointProposal;
85
94
 
86
95
  private lastEpochForCommitteeUpdateLoop: EpochNumber | undefined;
87
96
  private epochCacheUpdateLoop: RunningPromise;
97
+ /** Tracks the last epoch in which each attester successfully submitted at least one attestation. */
98
+ private lastAttestedEpochByAttester: Map<string, EpochNumber> = new Map();
88
99
 
89
100
  private proposersOfInvalidBlocks: Set<string> = new Set();
90
101
 
102
+ /** Tracks the last checkpoint proposal we attested to, to prevent equivocation. */
103
+ private lastAttestedProposal?: CheckpointProposalCore;
104
+
91
105
  protected constructor(
92
106
  private keyStore: ExtendedValidatorKeyStore,
93
107
  private epochCache: EpochCache,
@@ -99,6 +113,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
99
113
  private l1ToL2MessageSource: L1ToL2MessageSource,
100
114
  private config: ValidatorClientFullConfig,
101
115
  private blobClient: BlobClientInterface,
116
+ private slashingProtectionSigner: ValidatorHASigner,
102
117
  private dateProvider: DateProvider = new DateProvider(),
103
118
  telemetry: TelemetryClient = getTelemetryClient(),
104
119
  log = createLogger('validator'),
@@ -152,6 +167,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
152
167
  this.log.trace(`No committee found for slot`);
153
168
  return;
154
169
  }
170
+ this.metrics.setCurrentEpoch(epoch);
155
171
  if (epoch !== this.lastEpochForCommitteeUpdateLoop) {
156
172
  const me = this.getValidatorAddresses();
157
173
  const committeeSet = new Set(committee.map(v => v.toString()));
@@ -185,10 +201,12 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
185
201
  blobClient: BlobClientInterface,
186
202
  dateProvider: DateProvider = new DateProvider(),
187
203
  telemetry: TelemetryClient = getTelemetryClient(),
204
+ slashingProtectionDb?: SlashingProtectionDatabase,
188
205
  ) {
189
206
  const metrics = new ValidatorMetrics(telemetry);
190
207
  const blockProposalValidator = new BlockProposalValidator(epochCache, {
191
208
  txsPermitted: !config.disableTransactions,
209
+ maxTxsPerBlock: config.validateMaxTxsPerBlock,
192
210
  });
193
211
  const blockProposalHandler = new BlockProposalHandler(
194
212
  checkpointsBuilder,
@@ -204,16 +222,34 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
204
222
  telemetry,
205
223
  );
206
224
 
207
- let validatorKeyStore: ExtendedValidatorKeyStore = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
208
- if (config.haSigningEnabled) {
225
+ const nodeKeystoreAdapter = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
226
+ let slashingProtectionSigner: ValidatorHASigner;
227
+ if (slashingProtectionDb) {
228
+ // Shared database mode: use a pre-existing database (e.g. for testing HA setups).
229
+ ({ signer: slashingProtectionSigner } = createSignerFromSharedDb(slashingProtectionDb, config, {
230
+ telemetryClient: telemetry,
231
+ dateProvider,
232
+ }));
233
+ } else if (config.haSigningEnabled) {
234
+ // Multi-node HA mode: use PostgreSQL-backed distributed locking.
209
235
  // If maxStuckDutiesAgeMs is not explicitly set, compute it from Aztec slot duration
210
236
  const haConfig = {
211
237
  ...config,
212
238
  maxStuckDutiesAgeMs: config.maxStuckDutiesAgeMs ?? epochCache.getL1Constants().slotDuration * 2 * 1000,
213
239
  };
214
- const { signer } = await createHASigner(haConfig);
215
- validatorKeyStore = new HAKeyStore(validatorKeyStore, signer);
240
+ ({ signer: slashingProtectionSigner } = await createHASigner(haConfig, {
241
+ telemetryClient: telemetry,
242
+ dateProvider,
243
+ }));
244
+ } else {
245
+ // Single-node mode: use LMDB-backed local signing protection.
246
+ // This prevents double-signing if the node crashes and restarts mid-proposal.
247
+ ({ signer: slashingProtectionSigner } = await createLocalSignerWithProtection(config, {
248
+ telemetryClient: telemetry,
249
+ dateProvider,
250
+ }));
216
251
  }
252
+ const validatorKeyStore: ExtendedValidatorKeyStore = new HAKeyStore(nodeKeystoreAdapter, slashingProtectionSigner);
217
253
 
218
254
  const validator = new ValidatorClient(
219
255
  validatorKeyStore,
@@ -226,6 +262,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
226
262
  l1ToL2MessageSource,
227
263
  config,
228
264
  blobClient,
265
+ slashingProtectionSigner,
229
266
  dateProvider,
230
267
  telemetry,
231
268
  );
@@ -263,6 +300,12 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
263
300
  this.config = { ...this.config, ...config };
264
301
  }
265
302
 
303
+ public reloadKeystore(newManager: KeystoreManager): void {
304
+ const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
305
+ this.keyStore = new HAKeyStore(newAdapter, this.slashingProtectionSigner);
306
+ this.validationService = new ValidationService(this.keyStore, this.log.createChild('validation-service'));
307
+ }
308
+
266
309
  public async start() {
267
310
  if (this.epochCacheUpdateLoop.isRunning()) {
268
311
  this.log.warn(`Validator client already started`);
@@ -314,6 +357,11 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
314
357
  this.handleDuplicateProposal(info);
315
358
  });
316
359
 
360
+ // Duplicate attestation handler - triggers slashing for attestation equivocation
361
+ this.p2pClient.registerDuplicateAttestationCallback((info: DuplicateAttestationInfo) => {
362
+ this.handleDuplicateAttestation(info);
363
+ });
364
+
317
365
  const myAddresses = this.getValidatorAddresses();
318
366
  this.p2pClient.registerThisValidatorAddresses(myAddresses);
319
367
 
@@ -341,6 +389,14 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
341
389
  return false;
342
390
  }
343
391
 
392
+ // Log self-proposals from HA peers (same validator key on different nodes)
393
+ if (this.getValidatorAddresses().some(addr => addr.equals(proposer))) {
394
+ this.log.verbose(`Processing block proposal from HA peer for slot ${slotNumber}`, {
395
+ proposer: proposer.toString(),
396
+ slotNumber,
397
+ });
398
+ }
399
+
344
400
  // Check if we're in the committee (for metrics purposes)
345
401
  const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
346
402
  const partOfCommittee = inCommittee.length > 0;
@@ -370,9 +426,10 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
370
426
  );
371
427
 
372
428
  if (!validationResult.isValid) {
373
- this.log.warn(`Block proposal validation failed: ${validationResult.reason}`, proposalInfo);
374
-
375
429
  const reason = validationResult.reason || 'unknown';
430
+
431
+ this.log.warn(`Block proposal validation failed: ${reason}`, proposalInfo);
432
+
376
433
  // Classify failure reason: bad proposal vs node issue
377
434
  const badProposalReasons: BlockProposalValidationFailureReason[] = [
378
435
  'invalid_proposal',
@@ -427,40 +484,55 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
427
484
  proposal: CheckpointProposalCore,
428
485
  _proposalSender: PeerId,
429
486
  ): Promise<CheckpointAttestation[] | undefined> {
430
- const slotNumber = proposal.slotNumber;
487
+ const proposalSlotNumber = proposal.slotNumber;
431
488
  const proposer = proposal.getSender();
432
489
 
433
490
  // If escape hatch is open for this slot's epoch, do not attest.
434
- if (await this.epochCache.isEscapeHatchOpenAtSlot(slotNumber)) {
435
- this.log.warn(`Escape hatch open for slot ${slotNumber}, skipping checkpoint attestation handling`);
491
+ if (await this.epochCache.isEscapeHatchOpenAtSlot(proposalSlotNumber)) {
492
+ this.log.warn(`Escape hatch open for slot ${proposalSlotNumber}, skipping checkpoint attestation handling`);
436
493
  return undefined;
437
494
  }
438
495
 
439
496
  // Reject proposals with invalid signatures
440
497
  if (!proposer) {
441
- this.log.warn(`Received checkpoint proposal with invalid signature for slot ${slotNumber}`);
498
+ this.log.warn(`Received checkpoint proposal with invalid signature for proposal slot ${proposalSlotNumber}`);
442
499
  return undefined;
443
500
  }
444
501
 
445
- // Check that I have any address in current committee before attesting
446
- const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
502
+ // Ignore proposals from ourselves (may happen in HA setups)
503
+ if (this.getValidatorAddresses().some(addr => addr.equals(proposer))) {
504
+ this.log.debug(`Ignoring block proposal from self for slot ${proposalSlotNumber}`, {
505
+ proposer: proposer.toString(),
506
+ proposalSlotNumber,
507
+ });
508
+ return undefined;
509
+ }
510
+
511
+ // Validate fee asset price modifier is within allowed range
512
+ if (!validateFeeAssetPriceModifier(proposal.feeAssetPriceModifier)) {
513
+ this.log.warn(
514
+ `Received checkpoint proposal with invalid feeAssetPriceModifier ${proposal.feeAssetPriceModifier} for slot ${proposalSlotNumber}`,
515
+ );
516
+ return undefined;
517
+ }
518
+
519
+ // Check that I have any address in the committee where this checkpoint will land before attesting
520
+ const inCommittee = await this.epochCache.filterInCommittee(proposalSlotNumber, this.getValidatorAddresses());
447
521
  const partOfCommittee = inCommittee.length > 0;
448
522
 
449
523
  const proposalInfo = {
450
- slotNumber,
524
+ proposalSlotNumber,
451
525
  archive: proposal.archive.toString(),
452
526
  proposer: proposer.toString(),
453
- txCount: proposal.txHashes.length,
454
527
  };
455
- this.log.info(`Received checkpoint proposal for slot ${slotNumber}`, {
528
+ this.log.info(`Received checkpoint proposal for slot ${proposalSlotNumber}`, {
456
529
  ...proposalInfo,
457
- txHashes: proposal.txHashes.map(t => t.toString()),
458
530
  fishermanMode: this.config.fishermanMode || false,
459
531
  });
460
532
 
461
533
  // Validate the checkpoint proposal before attesting (unless skipCheckpointProposalValidation is set)
462
534
  if (this.config.skipCheckpointProposalValidation) {
463
- this.log.warn(`Skipping checkpoint proposal validation for slot ${slotNumber}`, proposalInfo);
535
+ this.log.warn(`Skipping checkpoint proposal validation for slot ${proposalSlotNumber}`, proposalInfo);
464
536
  } else {
465
537
  const validationResult = await this.validateCheckpointProposal(proposal, proposalInfo);
466
538
  if (!validationResult.isValid) {
@@ -482,14 +554,28 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
482
554
  }
483
555
 
484
556
  // Provided all of the above checks pass, we can attest to the proposal
485
- this.log.info(`${partOfCommittee ? 'Attesting to' : 'Validated'} checkpoint proposal for slot ${slotNumber}`, {
486
- ...proposalInfo,
487
- inCommittee: partOfCommittee,
488
- fishermanMode: this.config.fishermanMode || false,
489
- });
557
+ this.log.info(
558
+ `${partOfCommittee ? 'Attesting to' : 'Validated'} checkpoint proposal for slot ${proposalSlotNumber}`,
559
+ {
560
+ ...proposalInfo,
561
+ inCommittee: partOfCommittee,
562
+ fishermanMode: this.config.fishermanMode || false,
563
+ },
564
+ );
490
565
 
491
566
  this.metrics.incSuccessfulAttestations(inCommittee.length);
492
567
 
568
+ // Track epoch participation per attester: count each (attester, epoch) pair at most once
569
+ const proposalEpoch = getEpochAtSlot(proposalSlotNumber, this.epochCache.getL1Constants());
570
+ for (const attester of inCommittee) {
571
+ const key = attester.toString();
572
+ const lastEpoch = this.lastAttestedEpochByAttester.get(key);
573
+ if (lastEpoch === undefined || proposalEpoch > lastEpoch) {
574
+ this.lastAttestedEpochByAttester.set(key, proposalEpoch);
575
+ this.metrics.incAttestedEpochCount(attester);
576
+ }
577
+ }
578
+
493
579
  // Determine which validators should attest
494
580
  let attestors: EthAddress[];
495
581
  if (partOfCommittee) {
@@ -508,21 +594,51 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
508
594
 
509
595
  if (this.config.fishermanMode) {
510
596
  // bail out early and don't save attestations to the pool in fisherman mode
511
- this.log.info(`Creating checkpoint attestations for slot ${slotNumber}`, {
597
+ this.log.info(`Creating checkpoint attestations for slot ${proposalSlotNumber}`, {
512
598
  ...proposalInfo,
513
599
  attestors: attestors.map(a => a.toString()),
514
600
  });
515
601
  return undefined;
516
602
  }
517
603
 
518
- return this.createCheckpointAttestationsFromProposal(proposal, attestors);
604
+ return await this.createCheckpointAttestationsFromProposal(proposal, attestors);
605
+ }
606
+
607
+ /**
608
+ * Checks if we should attest to a slot based on equivocation prevention rules.
609
+ * @returns true if we should attest, false if we should skip
610
+ */
611
+ private shouldAttestToSlot(slotNumber: SlotNumber): boolean {
612
+ // If attestToEquivocatedProposals is true, always allow
613
+ if (this.config.attestToEquivocatedProposals) {
614
+ return true;
615
+ }
616
+
617
+ // Check if incoming slot is strictly greater than last attested
618
+ if (this.lastAttestedProposal && slotNumber <= this.lastAttestedProposal.slotNumber) {
619
+ this.log.warn(
620
+ `Refusing to process a proposal for slot ${slotNumber} given we already attested to a proposal for slot ${this.lastAttestedProposal.slotNumber}`,
621
+ );
622
+ return false;
623
+ }
624
+
625
+ return true;
519
626
  }
520
627
 
521
628
  private async createCheckpointAttestationsFromProposal(
522
629
  proposal: CheckpointProposalCore,
523
630
  attestors: EthAddress[] = [],
524
- ): Promise<CheckpointAttestation[]> {
631
+ ): Promise<CheckpointAttestation[] | undefined> {
632
+ // Equivocation check: must happen right before signing to minimize the race window
633
+ if (!this.shouldAttestToSlot(proposal.slotNumber)) {
634
+ return undefined;
635
+ }
636
+
525
637
  const attestations = await this.validationService.attestToCheckpointProposal(proposal, attestors);
638
+
639
+ // Track the proposal we attested to (to prevent equivocation)
640
+ this.lastAttestedProposal = proposal;
641
+
526
642
  await this.p2pClient.addOwnCheckpointAttestations(attestations);
527
643
  return attestations;
528
644
  }
@@ -536,7 +652,11 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
536
652
  proposalInfo: LogData,
537
653
  ): Promise<{ isValid: true } | { isValid: false; reason: string }> {
538
654
  const slot = proposal.slotNumber;
539
- const timeoutSeconds = 10; // TODO(palla/mbps): This should map to the timetable settings
655
+
656
+ // Timeout block syncing at the start of the next slot
657
+ const config = this.checkpointsBuilder.getConfig();
658
+ const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
659
+ const timeoutSeconds = Math.max(1, nextSlotTimestampSeconds - Math.floor(this.dateProvider.now() / 1000));
540
660
 
541
661
  // Wait for last block to sync by archive
542
662
  let lastBlockHeader: BlockHeader | undefined;
@@ -571,6 +691,12 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
571
691
  return { isValid: false, reason: 'no_blocks_for_slot' };
572
692
  }
573
693
 
694
+ // Ensure the last block for this slot matches the archive in the checkpoint proposal
695
+ if (!blocks.at(-1)?.archive.root.equals(proposal.archive)) {
696
+ this.log.warn(`Last block archive mismatch for checkpoint proposal`, proposalInfo);
697
+ return { isValid: false, reason: 'last_block_archive_mismatch' };
698
+ }
699
+
574
700
  this.log.debug(`Found ${blocks.length} blocks for slot ${slot}`, {
575
701
  ...proposalInfo,
576
702
  blockNumbers: blocks.map(b => b.number),
@@ -584,14 +710,11 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
584
710
  // Get L1-to-L2 messages for this checkpoint
585
711
  const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
586
712
 
587
- // Compute the previous checkpoint out hashes for the epoch.
588
- // TODO: There can be a more efficient way to get the previous checkpoint out hashes without having to fetch the
589
- // actual checkpoints and the blocks/txs in them.
713
+ // Collect the out hashes of all the checkpoints before this one in the same epoch
590
714
  const epoch = getEpochAtSlot(slot, this.epochCache.getL1Constants());
591
- const previousCheckpoints = (await this.blockSource.getCheckpointsForEpoch(epoch))
592
- .filter(b => b.number < checkpointNumber)
593
- .sort((a, b) => a.number - b.number);
594
- const previousCheckpointOutHashes = previousCheckpoints.map(c => c.getCheckpointOutHash());
715
+ const previousCheckpointOutHashes = (await this.blockSource.getCheckpointsDataForEpoch(epoch))
716
+ .filter(c => c.checkpointNumber < checkpointNumber)
717
+ .map(c => c.checkpointOutHash);
595
718
 
596
719
  // Fork world state at the block before the first block
597
720
  const parentBlockNumber = BlockNumber(firstBlock.number - 1);
@@ -602,6 +725,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
602
725
  const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(
603
726
  checkpointNumber,
604
727
  constants,
728
+ proposal.feeAssetPriceModifier,
605
729
  l1ToL2Messages,
606
730
  previousCheckpointOutHashes,
607
731
  fork,
@@ -648,6 +772,20 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
648
772
  return { isValid: false, reason: 'out_hash_mismatch' };
649
773
  }
650
774
 
775
+ // Final round of validations on the checkpoint, just in case.
776
+ try {
777
+ validateCheckpoint(computedCheckpoint, {
778
+ rollupManaLimit: this.checkpointsBuilder.getConfig().rollupManaLimit,
779
+ maxDABlockGas: this.config.validateMaxDABlockGas,
780
+ maxL2BlockGas: this.config.validateMaxL2BlockGas,
781
+ maxTxsPerBlock: this.config.validateMaxTxsPerBlock,
782
+ maxTxsPerCheckpoint: this.config.validateMaxTxsPerCheckpoint,
783
+ });
784
+ } catch (err) {
785
+ this.log.warn(`Checkpoint validation failed: ${err}`, proposalInfo);
786
+ return { isValid: false, reason: 'checkpoint_validation_failed' };
787
+ }
788
+
651
789
  this.log.verbose(`Checkpoint proposal validation successful for slot ${slot}`, proposalInfo);
652
790
  return { isValid: true };
653
791
  } finally {
@@ -664,6 +802,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
664
802
  chainId: gv.chainId,
665
803
  version: gv.version,
666
804
  slotNumber: gv.slotNumber,
805
+ timestamp: gv.timestamp,
667
806
  coinbase: gv.coinbase,
668
807
  feeRecipient: gv.feeRecipient,
669
808
  gasFees: gv.gasFees,
@@ -673,7 +812,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
673
812
  /**
674
813
  * Uploads blobs for a checkpoint to the filestore (fire and forget).
675
814
  */
676
- private async uploadBlobsForCheckpoint(proposal: CheckpointProposalCore, proposalInfo: LogData): Promise<void> {
815
+ protected async uploadBlobsForCheckpoint(proposal: CheckpointProposalCore, proposalInfo: LogData): Promise<void> {
677
816
  try {
678
817
  const lastBlockHeader = await this.blockSource.getBlockHeaderByArchive(proposal.archive);
679
818
  if (!lastBlockHeader) {
@@ -688,7 +827,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
688
827
  }
689
828
 
690
829
  const blobFields = blocks.flatMap(b => b.toBlobFields());
691
- const blobs: Blob[] = getBlobsPerL1Block(blobFields);
830
+ const blobs: Blob[] = await getBlobsPerL1Block(blobFields);
692
831
  await this.blobClient.sendBlobsToFilestore(blobs);
693
832
  this.log.debug(`Uploaded ${blobs.length} blobs to filestore for checkpoint at slot ${proposal.slotNumber}`, {
694
833
  ...proposalInfo,
@@ -750,6 +889,28 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
750
889
  ]);
751
890
  }
752
891
 
892
+ /**
893
+ * Handle detection of a duplicate attestation (equivocation).
894
+ * Emits a slash event when an attester signs attestations for different proposals at the same slot.
895
+ */
896
+ private handleDuplicateAttestation(info: DuplicateAttestationInfo): void {
897
+ const { slot, attester } = info;
898
+
899
+ this.log.warn(`Triggering slash event for duplicate attestation from ${attester.toString()} at slot ${slot}`, {
900
+ attester: attester.toString(),
901
+ slot,
902
+ });
903
+
904
+ this.emit(WANT_TO_SLASH_EVENT, [
905
+ {
906
+ validator: attester,
907
+ amount: this.config.slashDuplicateAttestationPenalty,
908
+ offenseType: OffenseType.DUPLICATE_ATTESTATION,
909
+ epochOrSlot: BigInt(slot),
910
+ },
911
+ ]);
912
+ }
913
+
753
914
  async createBlockProposal(
754
915
  blockHeader: BlockHeader,
755
916
  indexWithinCheckpoint: IndexWithinCheckpoint,
@@ -759,11 +920,19 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
759
920
  proposerAddress: EthAddress | undefined,
760
921
  options: BlockProposalOptions = {},
761
922
  ): Promise<BlockProposal> {
762
- // TODO(palla/mbps): Prevent double proposals properly
763
- // if (this.previousProposal?.slotNumber === blockHeader.globalVariables.slotNumber) {
764
- // this.log.verbose(`Already made a proposal for the same slot, skipping proposal`);
765
- // return Promise.resolve(undefined);
766
- // }
923
+ // Validate that we're not creating a proposal for an older or equal position
924
+ if (this.lastProposedBlock) {
925
+ const lastSlot = this.lastProposedBlock.slotNumber;
926
+ const lastIndex = this.lastProposedBlock.indexWithinCheckpoint;
927
+ const newSlot = blockHeader.globalVariables.slotNumber;
928
+
929
+ if (newSlot < lastSlot || (newSlot === lastSlot && indexWithinCheckpoint <= lastIndex)) {
930
+ throw new Error(
931
+ `Cannot create block proposal for slot ${newSlot} index ${indexWithinCheckpoint}: ` +
932
+ `already proposed block for slot ${lastSlot} index ${lastIndex}`,
933
+ );
934
+ }
935
+ }
767
936
 
768
937
  this.log.info(
769
938
  `Assembling block proposal for block ${blockHeader.globalVariables.blockNumber} slot ${blockHeader.globalVariables.slotNumber}`,
@@ -780,25 +949,42 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
780
949
  broadcastInvalidBlockProposal: this.config.broadcastInvalidBlockProposal,
781
950
  },
782
951
  );
783
- this.previousProposal = newProposal;
952
+ this.lastProposedBlock = newProposal;
784
953
  return newProposal;
785
954
  }
786
955
 
787
956
  async createCheckpointProposal(
788
957
  checkpointHeader: CheckpointHeader,
789
958
  archive: Fr,
959
+ feeAssetPriceModifier: bigint,
790
960
  lastBlockInfo: CreateCheckpointProposalLastBlockData | undefined,
791
961
  proposerAddress: EthAddress | undefined,
792
962
  options: CheckpointProposalOptions = {},
793
963
  ): Promise<CheckpointProposal> {
964
+ // Validate that we're not creating a proposal for an older or equal slot
965
+ if (this.lastProposedCheckpoint) {
966
+ const lastSlot = this.lastProposedCheckpoint.slotNumber;
967
+ const newSlot = checkpointHeader.slotNumber;
968
+
969
+ if (newSlot <= lastSlot) {
970
+ throw new Error(
971
+ `Cannot create checkpoint proposal for slot ${newSlot}: ` +
972
+ `already proposed checkpoint for slot ${lastSlot}`,
973
+ );
974
+ }
975
+ }
976
+
794
977
  this.log.info(`Assembling checkpoint proposal for slot ${checkpointHeader.slotNumber}`);
795
- return await this.validationService.createCheckpointProposal(
978
+ const newProposal = await this.validationService.createCheckpointProposal(
796
979
  checkpointHeader,
797
980
  archive,
981
+ feeAssetPriceModifier,
798
982
  lastBlockInfo,
799
983
  proposerAddress,
800
984
  options,
801
985
  );
986
+ this.lastProposedCheckpoint = newProposal;
987
+ return newProposal;
802
988
  }
803
989
 
804
990
  async broadcastBlockProposal(proposal: BlockProposal): Promise<void> {
@@ -820,6 +1006,10 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
820
1006
  this.log.debug(`Collecting ${inCommittee.length} self-attestations for slot ${slot}`, { inCommittee });
821
1007
  const attestations = await this.createCheckpointAttestationsFromProposal(proposal, inCommittee);
822
1008
 
1009
+ if (!attestations) {
1010
+ return [];
1011
+ }
1012
+
823
1013
  // We broadcast our own attestations to our peers so, in case our block does not get mined on L1,
824
1014
  // other nodes can see that our validators did attest to this block proposal, and do not slash us
825
1015
  // due to inactivity for missed attestations.
@@ -1,3 +0,0 @@
1
- export * from './nullifier_cache.js';
2
- export * from './tx_validator_factory.js';
3
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eF92YWxpZGF0b3IvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLDJCQUEyQixDQUFDIn0=
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tx_validator/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}
@@ -1,2 +0,0 @@
1
- export * from './nullifier_cache.js';
2
- export * from './tx_validator_factory.js';
@@ -1,14 +0,0 @@
1
- import type { NullifierSource } from '@aztec/p2p';
2
- import type { MerkleTreeReadOperations } from '@aztec/stdlib/interfaces/server';
3
- /**
4
- * Implements a nullifier source by checking a DB and an in-memory collection.
5
- * Intended for validating transactions as they are added to a block.
6
- */
7
- export declare class NullifierCache implements NullifierSource {
8
- private db;
9
- nullifiers: Set<string>;
10
- constructor(db: MerkleTreeReadOperations);
11
- nullifiersExist(nullifiers: Buffer[]): Promise<boolean[]>;
12
- addNullifiers(nullifiers: Buffer[]): void;
13
- }
14
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnVsbGlmaWVyX2NhY2hlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHhfdmFsaWRhdG9yL251bGxpZmllcl9jYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFDbEQsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUdoRjs7O0dBR0c7QUFDSCxxQkFBYSxjQUFlLFlBQVcsZUFBZTtJQUd4QyxPQUFPLENBQUMsRUFBRTtJQUZ0QixVQUFVLEVBQUUsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBRXhCLFlBQW9CLEVBQUUsRUFBRSx3QkFBd0IsRUFFL0M7SUFFWSxlQUFlLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQU9yRTtJQUVNLGFBQWEsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLFFBSXhDO0NBQ0YifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"nullifier_cache.d.ts","sourceRoot":"","sources":["../../src/tx_validator/nullifier_cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAGhF;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IAGxC,OAAO,CAAC,EAAE;IAFtB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAExB,YAAoB,EAAE,EAAE,wBAAwB,EAE/C;IAEY,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAOrE;IAEM,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAIxC;CACF"}
@@ -1,24 +0,0 @@
1
- import { MerkleTreeId } from '@aztec/stdlib/trees';
2
- /**
3
- * Implements a nullifier source by checking a DB and an in-memory collection.
4
- * Intended for validating transactions as they are added to a block.
5
- */ export class NullifierCache {
6
- db;
7
- nullifiers;
8
- constructor(db){
9
- this.db = db;
10
- this.nullifiers = new Set();
11
- }
12
- async nullifiersExist(nullifiers) {
13
- const cacheResults = nullifiers.map((n)=>this.nullifiers.has(n.toString()));
14
- const toCheckDb = nullifiers.filter((_n, index)=>!cacheResults[index]);
15
- const dbHits = await this.db.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, toCheckDb);
16
- let dbIndex = 0;
17
- return nullifiers.map((_n, index)=>cacheResults[index] || dbHits[dbIndex++] !== undefined);
18
- }
19
- addNullifiers(nullifiers) {
20
- for (const nullifier of nullifiers){
21
- this.nullifiers.add(nullifier.toString());
22
- }
23
- }
24
- }
@@ -1,19 +0,0 @@
1
- import { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { LoggerBindings } from '@aztec/foundation/log';
3
- import type { ContractDataSource } from '@aztec/stdlib/contract';
4
- import type { GasFees } from '@aztec/stdlib/gas';
5
- import type { AllowedElement, ClientProtocolCircuitVerifier, MerkleTreeReadOperations, PublicProcessorValidator } from '@aztec/stdlib/interfaces/server';
6
- import { GlobalVariables, type Tx, type TxValidator } from '@aztec/stdlib/tx';
7
- import type { UInt64 } from '@aztec/stdlib/types';
8
- export declare function createValidatorForAcceptingTxs(db: MerkleTreeReadOperations, contractDataSource: ContractDataSource, verifier: ClientProtocolCircuitVerifier | undefined, { l1ChainId, rollupVersion, setupAllowList, gasFees, skipFeeEnforcement, timestamp, blockNumber, txsPermitted }: {
9
- l1ChainId: number;
10
- rollupVersion: number;
11
- setupAllowList: AllowedElement[];
12
- gasFees: GasFees;
13
- skipFeeEnforcement?: boolean;
14
- timestamp: UInt64;
15
- blockNumber: BlockNumber;
16
- txsPermitted: boolean;
17
- }, bindings?: LoggerBindings): TxValidator<Tx>;
18
- export declare function createValidatorForBlockBuilding(db: MerkleTreeReadOperations, contractDataSource: ContractDataSource, globalVariables: GlobalVariables, setupAllowList: AllowedElement[], bindings?: LoggerBindings): PublicProcessorValidator;
19
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfdmFsaWRhdG9yX2ZhY3RvcnkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eF92YWxpZGF0b3IvdHhfdmFsaWRhdG9yX2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBRTlELE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBaUI1RCxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2pELE9BQU8sS0FBSyxFQUNWLGNBQWMsRUFDZCw2QkFBNkIsRUFDN0Isd0JBQXdCLEVBQ3hCLHdCQUF3QixFQUN6QixNQUFNLGlDQUFpQyxDQUFDO0FBRXpDLE9BQU8sRUFBRSxlQUFlLEVBQUUsS0FBSyxFQUFFLEVBQUUsS0FBSyxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5RSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUlsRCx3QkFBZ0IsOEJBQThCLENBQzVDLEVBQUUsRUFBRSx3QkFBd0IsRUFDNUIsa0JBQWtCLEVBQUUsa0JBQWtCLEVBQ3RDLFFBQVEsRUFBRSw2QkFBNkIsR0FBRyxTQUFTLEVBQ25ELEVBQ0UsU0FBUyxFQUNULGFBQWEsRUFDYixjQUFjLEVBQ2QsT0FBTyxFQUNQLGtCQUFrQixFQUNsQixTQUFTLEVBQ1QsV0FBVyxFQUNYLFlBQVksRUFDYixFQUFFO0lBQ0QsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixhQUFhLEVBQUUsTUFBTSxDQUFDO0lBQ3RCLGNBQWMsRUFBRSxjQUFjLEVBQUUsQ0FBQztJQUNqQyxPQUFPLEVBQUUsT0FBTyxDQUFDO0lBQ2pCLGtCQUFrQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQzdCLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsV0FBVyxFQUFFLFdBQVcsQ0FBQztJQUN6QixZQUFZLEVBQUUsT0FBTyxDQUFDO0NBQ3ZCLEVBQ0QsUUFBUSxDQUFDLEVBQUUsY0FBYyxHQUN4QixXQUFXLENBQUMsRUFBRSxDQUFDLENBcUNqQjtBQUVELHdCQUFnQiwrQkFBK0IsQ0FDN0MsRUFBRSxFQUFFLHdCQUF3QixFQUM1QixrQkFBa0IsRUFBRSxrQkFBa0IsRUFDdEMsZUFBZSxFQUFFLGVBQWUsRUFDaEMsY0FBYyxFQUFFLGNBQWMsRUFBRSxFQUNoQyxRQUFRLENBQUMsRUFBRSxjQUFjLEdBQ3hCLHdCQUF3QixDQWlCMUIifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"tx_validator_factory.d.ts","sourceRoot":"","sources":["../../src/tx_validator/tx_validator_factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiB5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EACd,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,wBAAwB,EAC5B,kBAAkB,EAAE,kBAAkB,EACtC,QAAQ,EAAE,6BAA6B,GAAG,SAAS,EACnD,EACE,SAAS,EACT,aAAa,EACb,cAAc,EACd,OAAO,EACP,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,EACb,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB,EACD,QAAQ,CAAC,EAAE,cAAc,GACxB,WAAW,CAAC,EAAE,CAAC,CAqCjB;AAED,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,wBAAwB,EAC5B,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,cAAc,EAAE,EAChC,QAAQ,CAAC,EAAE,cAAc,GACxB,wBAAwB,CAiB1B"}