@aztec/validator-client 0.0.1-commit.9ef841308 → 0.0.1-commit.a5db02d

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.
package/dest/validator.js CHANGED
@@ -1,28 +1,30 @@
1
+ import { getBlobsPerL1Block } from '@aztec/blob-lib';
2
+ import { CheckpointNumber } from '@aztec/foundation/branded-types';
3
+ import { FifoSet } from '@aztec/foundation/fifo-set';
1
4
  import { createLogger } from '@aztec/foundation/log';
2
5
  import { RunningPromise } from '@aztec/foundation/running-promise';
3
6
  import { sleep } from '@aztec/foundation/sleep';
4
7
  import { DateProvider } from '@aztec/foundation/timer';
5
8
  import { AuthRequest, AuthResponse, BlockProposalValidator, ReqRespSubProtocol } from '@aztec/p2p';
6
- import { OffenseType, WANT_TO_SLASH_EVENT } from '@aztec/slasher';
9
+ import { OffenseType, WANT_TO_CLEAR_SLASH_EVENT, WANT_TO_SLASH_EVENT, getOffenseTypeName } from '@aztec/slasher';
7
10
  import { getEpochAtSlot } from '@aztec/stdlib/epoch-helpers';
11
+ import { ConsensusTimetable } from '@aztec/stdlib/timetable';
8
12
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
9
13
  import { getTelemetryClient } from '@aztec/telemetry-client';
10
14
  import { createHASigner, createLocalSignerWithProtection, createSignerFromSharedDb } from '@aztec/validator-ha-signer/factory';
11
15
  import { DutyType } from '@aztec/validator-ha-signer/types';
12
16
  import { EventEmitter } from 'events';
17
+ import { DEFAULT_MAX_GOSSIP_CLOCK_DISPARITY_MS } from './config.js';
13
18
  import { ValidationService } from './duties/validation_service.js';
14
19
  import { HAKeyStore } from './key_store/ha_key_store.js';
15
20
  import { NodeKeystoreAdapter } from './key_store/node_keystore_adapter.js';
16
21
  import { ValidatorMetrics } from './metrics.js';
17
- import { ProposalHandler } from './proposal_handler.js';
22
+ import { ProposalHandler, SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT, SLASHABLE_CHECKPOINT_PROPOSAL_VALIDATION_RESULT } from './proposal_handler.js';
18
23
  // We maintain a set of proposers who have proposed invalid blocks.
19
24
  // Just cap the set to avoid unbounded growth.
20
25
  const MAX_PROPOSERS_OF_INVALID_BLOCKS = 1000;
21
- // What errors from the block proposal handler result in slashing
22
- const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
23
- 'state_mismatch',
24
- 'failed_txs'
25
- ];
26
+ const MAX_TRACKED_INVALID_CHECKPOINT_PROPOSALS = 1000;
27
+ const MAX_TRACKED_BAD_ATTESTATIONS = 10_000;
26
28
  /**
27
29
  * Validator Client
28
30
  */ export class ValidatorClient extends EventEmitter {
@@ -30,6 +32,10 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
30
32
  epochCache;
31
33
  p2pClient;
32
34
  proposalHandler;
35
+ blockSource;
36
+ checkpointsBuilder;
37
+ worldState;
38
+ l1ToL2MessageSource;
33
39
  config;
34
40
  blobClient;
35
41
  slashingProtectionSigner;
@@ -46,14 +52,18 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
46
52
  epochCacheUpdateLoop;
47
53
  /** Tracks the last epoch in which each attester successfully submitted at least one attestation. */ lastAttestedEpochByAttester;
48
54
  proposersOfInvalidBlocks;
55
+ invalidCheckpointProposalOffenseKeys;
56
+ oversizedProposalOffenseKeys;
57
+ badAttestationOffenseKeys;
49
58
  /** Tracks the last checkpoint proposal we attested to, to prevent equivocation. */ lastAttestedProposal;
50
- constructor(keyStore, epochCache, p2pClient, proposalHandler, config, blobClient, slashingProtectionSigner, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator')){
51
- super(), this.keyStore = keyStore, this.epochCache = epochCache, this.p2pClient = p2pClient, this.proposalHandler = proposalHandler, this.config = config, this.blobClient = blobClient, this.slashingProtectionSigner = slashingProtectionSigner, this.dateProvider = dateProvider, this.hasRegisteredHandlers = false, this.lastAttestedEpochByAttester = new Map(), this.proposersOfInvalidBlocks = new Set();
59
+ constructor(keyStore, epochCache, p2pClient, proposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, slashingProtectionSigner, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator')){
60
+ super(), this.keyStore = keyStore, this.epochCache = epochCache, this.p2pClient = p2pClient, this.proposalHandler = proposalHandler, this.blockSource = blockSource, this.checkpointsBuilder = checkpointsBuilder, this.worldState = worldState, this.l1ToL2MessageSource = l1ToL2MessageSource, this.config = config, this.blobClient = blobClient, this.slashingProtectionSigner = slashingProtectionSigner, this.dateProvider = dateProvider, this.hasRegisteredHandlers = false, this.lastAttestedEpochByAttester = new Map(), this.proposersOfInvalidBlocks = FifoSet.withLimit(MAX_PROPOSERS_OF_INVALID_BLOCKS), this.invalidCheckpointProposalOffenseKeys = FifoSet.withLimit(MAX_TRACKED_INVALID_CHECKPOINT_PROPOSALS), this.oversizedProposalOffenseKeys = FifoSet.withLimit(MAX_TRACKED_INVALID_CHECKPOINT_PROPOSALS), this.badAttestationOffenseKeys = FifoSet.withLimit(MAX_TRACKED_BAD_ATTESTATIONS);
52
61
  // Create child logger with fisherman prefix if in fisherman mode
53
62
  this.log = config.fishermanMode ? log.createChild('[FISHERMAN]') : log;
54
63
  this.tracer = telemetry.getTracer('Validator');
55
64
  this.metrics = new ValidatorMetrics(telemetry);
56
- this.validationService = new ValidationService(keyStore, this.log.createChild('validation-service'));
65
+ this.validationService = new ValidationService(keyStore, this.getSignatureContext(), this.log.createChild('validation-service'));
66
+ this.proposalHandler.setCheckpointProposalValidationFailureCallback((proposal, result, proposalInfo)=>this.handleInvalidCheckpointProposal(proposal, result, proposalInfo));
57
67
  // Refresh epoch cache every second to trigger alert if participation in committee changes
58
68
  this.epochCacheUpdateLoop = new RunningPromise(this.handleEpochCommitteeUpdate.bind(this), this.log, 1000);
59
69
  const myAddresses = this.getValidatorAddresses();
@@ -103,13 +113,24 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
103
113
  this.log.error(`Error updating epoch committee`, err);
104
114
  }
105
115
  }
106
- static async new(config, checkpointsBuilder, worldState, epochCache, p2pClient, blockSource, l1ToL2MessageSource, txProvider, keyStoreManager, blobClient, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), slashingProtectionDb) {
116
+ static async new(config, checkpointsBuilder, worldState, epochCache, p2pClient, blockSource, l1ToL2MessageSource, txProvider, keyStoreManager, blobClient, reexecutionTracker, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), slashingProtectionDb) {
107
117
  const metrics = new ValidatorMetrics(telemetry);
108
- const blockProposalValidator = new BlockProposalValidator(epochCache, {
118
+ const consensusTimetable = new ConsensusTimetable({
119
+ l1Constants: epochCache.getL1Constants(),
120
+ blockDuration: config.blockDurationMs / 1000
121
+ });
122
+ const blockProposalValidator = new BlockProposalValidator(epochCache, consensusTimetable, {
109
123
  txsPermitted: !config.disableTransactions,
110
- maxTxsPerBlock: config.validateMaxTxsPerBlock
124
+ maxTxsPerBlock: config.validateMaxTxsPerBlock,
125
+ maxBlocksPerCheckpoint: config.maxBlocksPerCheckpoint,
126
+ skipSlotValidation: config.skipProposalSlotValidation,
127
+ signatureContext: {
128
+ chainId: config.l1ChainId,
129
+ rollupAddress: config.rollupAddress
130
+ },
131
+ clockDisparityMs: config.maxGossipClockDisparityMs ?? DEFAULT_MAX_GOSSIP_CLOCK_DISPARITY_MS
111
132
  });
112
- const proposalHandler = new ProposalHandler(checkpointsBuilder, worldState, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, epochCache, config, blobClient, metrics, dateProvider, telemetry);
133
+ const proposalHandler = new ProposalHandler(checkpointsBuilder, worldState, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, epochCache, consensusTimetable, config, blobClient, reexecutionTracker, metrics, dateProvider, telemetry, undefined);
113
134
  const nodeKeystoreAdapter = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
114
135
  let slashingProtectionSigner;
115
136
  if (slashingProtectionDb) {
@@ -138,7 +159,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
138
159
  }));
139
160
  }
140
161
  const validatorKeyStore = new HAKeyStore(nodeKeystoreAdapter, slashingProtectionSigner);
141
- const validator = new ValidatorClient(validatorKeyStore, epochCache, p2pClient, proposalHandler, config, blobClient, slashingProtectionSigner, dateProvider, telemetry);
162
+ const validator = new ValidatorClient(validatorKeyStore, epochCache, p2pClient, proposalHandler, blockSource, checkpointsBuilder, worldState, l1ToL2MessageSource, config, blobClient, slashingProtectionSigner, dateProvider, telemetry);
142
163
  return validator;
143
164
  }
144
165
  getValidatorAddresses() {
@@ -150,6 +171,12 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
150
171
  signWithAddress(addr, msg, context) {
151
172
  return this.keyStore.signTypedDataWithAddress(addr, msg, context);
152
173
  }
174
+ getSignatureContext() {
175
+ return {
176
+ chainId: this.config.l1ChainId,
177
+ rollupAddress: this.config.rollupAddress
178
+ };
179
+ }
153
180
  getCoinbaseForAttestor(attestor) {
154
181
  return this.keyStore.getCoinbaseAddress(attestor);
155
182
  }
@@ -159,16 +186,23 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
159
186
  getConfig() {
160
187
  return this.config;
161
188
  }
189
+ hasProposalEquivocation(slotNumber) {
190
+ return this.proposalHandler.hasProposalEquivocation(slotNumber);
191
+ }
192
+ hasInvalidProposals(slotNumber) {
193
+ return this.proposalHandler.hasInvalidProposals(slotNumber);
194
+ }
162
195
  updateConfig(config) {
163
196
  this.config = {
164
197
  ...this.config,
165
198
  ...config
166
199
  };
200
+ this.proposalHandler.updateConfig(config);
167
201
  }
168
202
  reloadKeystore(newManager) {
169
203
  const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
170
204
  this.keyStore = new HAKeyStore(newAdapter, this.slashingProtectionSigner);
171
- this.validationService = new ValidationService(this.keyStore, this.log.createChild('validation-service'));
205
+ this.validationService = new ValidationService(this.keyStore, this.getSignatureContext(), this.log.createChild('validation-service'));
172
206
  }
173
207
  async start() {
174
208
  if (this.epochCacheUpdateLoop.isRunning()) {
@@ -201,15 +235,22 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
201
235
  // The checkpoint is received as CheckpointProposalCore since the lastBlock is extracted
202
236
  // and processed separately via the block handler above.
203
237
  const checkpointHandler = (checkpoint, proposalSender)=>this.attestToCheckpointProposal(checkpoint, proposalSender);
204
- this.p2pClient.registerCheckpointProposalHandler(checkpointHandler);
238
+ this.p2pClient.registerValidatorCheckpointProposalHandler(checkpointHandler);
205
239
  // Duplicate proposal handler - triggers slashing for equivocation
206
240
  this.p2pClient.registerDuplicateProposalCallback((info)=>{
207
241
  this.handleDuplicateProposal(info);
208
242
  });
243
+ // Oversized proposal handler - triggers slashing for proposals beyond the per-checkpoint block limit
244
+ this.p2pClient.registerOversizedProposalCallback((info)=>{
245
+ this.handleOversizedProposal(info);
246
+ });
209
247
  // Duplicate attestation handler - triggers slashing for attestation equivocation
210
248
  this.p2pClient.registerDuplicateAttestationCallback((info)=>{
211
249
  this.handleDuplicateAttestation(info);
212
250
  });
251
+ this.p2pClient.registerCheckpointAttestationCallback((attestation)=>{
252
+ this.handleCheckpointAttestation(attestation);
253
+ });
213
254
  const myAddresses = this.getValidatorAddresses();
214
255
  this.p2pClient.registerThisValidatorAddresses(myAddresses);
215
256
  await this.p2pClient.addReqRespSubProtocol(ReqRespSubProtocol.AUTH, this.handleAuthRequest.bind(this));
@@ -249,11 +290,8 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
249
290
  txHashes: proposal.txHashes.map((t)=>t.toString()),
250
291
  fishermanMode: this.config.fishermanMode || false
251
292
  });
252
- // Reexecute txs if we are part of the committee, or if slashing is enabled, or if we are configured to always reexecute.
253
- // In fisherman mode, we always reexecute to validate proposals.
254
- const { slashBroadcastedInvalidBlockPenalty, alwaysReexecuteBlockProposals, fishermanMode } = this.config;
255
- const shouldReexecute = fishermanMode || slashBroadcastedInvalidBlockPenalty > 0n || partOfCommittee || alwaysReexecuteBlockProposals || this.blobClient.canUpload();
256
- const validationResult = await this.proposalHandler.handleBlockProposal(proposal, proposalSender, !!shouldReexecute && !escapeHatchOpen);
293
+ // Reexecute outside the escape hatch so slashing observers can detect invalid proposals even when penalties are 0.
294
+ const validationResult = await this.proposalHandler.handleBlockProposal(proposal, proposalSender, !escapeHatchOpen);
257
295
  if (!validationResult.isValid) {
258
296
  const reason = validationResult.reason || 'unknown';
259
297
  this.log.warn(`Block proposal validation failed: ${reason}`, proposalInfo);
@@ -271,10 +309,14 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
271
309
  // Node issues so we can't validate
272
310
  this.metrics.incFailedAttestationsNodeIssue(1, reason, partOfCommittee);
273
311
  }
274
- // Slash invalid block proposals (can happen even when not in committee)
275
- if (!escapeHatchOpen && validationResult.reason && SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT.includes(validationResult.reason) && slashBroadcastedInvalidBlockPenalty > 0n) {
276
- this.log.warn(`Slashing proposer for invalid block proposal`, proposalInfo);
312
+ if (!escapeHatchOpen && validationResult.reason && SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT.includes(validationResult.reason)) {
313
+ this.log.info(`Detected invalid block proposal offense`, {
314
+ ...proposalInfo,
315
+ amount: this.config.slashBroadcastedInvalidBlockPenalty,
316
+ offenseType: getOffenseTypeName(OffenseType.BROADCASTED_INVALID_BLOCK_PROPOSAL)
317
+ });
277
318
  this.slashInvalidBlock(proposal);
319
+ this.markInvalidProposalSlot(proposal.slotNumber);
278
320
  }
279
321
  return false;
280
322
  }
@@ -303,9 +345,13 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
303
345
  this.log.warn(`Escape hatch open for slot ${proposalSlotNumber}, skipping checkpoint attestation handling`);
304
346
  return undefined;
305
347
  }
348
+ // Early-out for equivocation: refuses if we've already attested to a higher slot.
349
+ if (!this.shouldAttestToSlot(proposalSlotNumber)) {
350
+ return undefined;
351
+ }
306
352
  // Ignore proposals from ourselves (may happen in HA setups)
307
353
  if (proposer && this.getValidatorAddresses().some((addr)=>addr.equals(proposer))) {
308
- this.log.debug(`Ignoring block proposal from self for slot ${proposalSlotNumber}`, {
354
+ this.log.debug(`Not attesting to block proposal from self for slot ${proposalSlotNumber}`, {
309
355
  proposer: proposer.toString(),
310
356
  proposalSlotNumber
311
357
  });
@@ -323,15 +369,19 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
323
369
  ...proposalInfo,
324
370
  fishermanMode: this.config.fishermanMode || false
325
371
  });
326
- // Validate the checkpoint proposal and upload blobs (unless skipCheckpointProposalValidation is set)
372
+ // Validate the checkpoint proposal before attesting (unless skipCheckpointProposalValidation is set).
373
+ // Uses the cached result from the all-nodes callback if available (avoids double validation).
374
+ let checkpointNumber;
327
375
  if (this.config.skipCheckpointProposalValidation) {
328
376
  this.log.warn(`Skipping checkpoint proposal validation for slot ${proposalSlotNumber}`, proposalInfo);
377
+ checkpointNumber = CheckpointNumber(0);
329
378
  } else {
330
379
  const validationResult = await this.proposalHandler.handleCheckpointProposal(proposal, proposalInfo);
331
380
  if (!validationResult.isValid) {
332
381
  this.log.warn(`Checkpoint proposal validation failed: ${validationResult.reason}`, proposalInfo);
333
382
  return undefined;
334
383
  }
384
+ checkpointNumber = validationResult.checkpointNumber;
335
385
  }
336
386
  // Check that I have any address in current committee before attesting
337
387
  // In fisherman mode, we still create attestations for validation even if not in committee
@@ -378,7 +428,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
378
428
  });
379
429
  return undefined;
380
430
  }
381
- return await this.createCheckpointAttestationsFromProposal(proposal, attestors);
431
+ return await this.createCheckpointAttestationsFromProposal(proposal, attestors, checkpointNumber);
382
432
  }
383
433
  /**
384
434
  * Checks if we should attest to a slot based on equivocation prevention rules.
@@ -395,17 +445,44 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
395
445
  }
396
446
  return true;
397
447
  }
398
- async createCheckpointAttestationsFromProposal(proposal, attestors = []) {
448
+ async createCheckpointAttestationsFromProposal(proposal, attestors = [], checkpointNumber) {
399
449
  // Equivocation check: must happen right before signing to minimize the race window
400
450
  if (!this.shouldAttestToSlot(proposal.slotNumber)) {
401
451
  return undefined;
402
452
  }
403
- const attestations = await this.validationService.attestToCheckpointProposal(proposal, attestors);
453
+ const attestations = await this.validationService.attestToCheckpointProposal(proposal, attestors, checkpointNumber);
404
454
  // Track the proposal we attested to (to prevent equivocation)
405
455
  this.lastAttestedProposal = proposal;
406
456
  await this.p2pClient.addOwnCheckpointAttestations(attestations);
407
457
  return attestations;
408
458
  }
459
+ /**
460
+ * Uploads blobs for a checkpoint to the filestore (fire and forget).
461
+ */ async uploadBlobsForCheckpoint(proposal, proposalInfo) {
462
+ try {
463
+ const lastBlockHeader = (await this.blockSource.getBlockData({
464
+ archive: proposal.archive
465
+ }))?.header;
466
+ if (!lastBlockHeader) {
467
+ this.log.warn(`Failed to get last block header for blob upload`, proposalInfo);
468
+ return;
469
+ }
470
+ const blocks = await this.blockSource.getBlocksForSlot(proposal.slotNumber);
471
+ if (blocks.length === 0) {
472
+ this.log.warn(`No blocks found for blob upload`, proposalInfo);
473
+ return;
474
+ }
475
+ const blobFields = blocks.flatMap((b)=>b.toBlobFields());
476
+ const blobs = await getBlobsPerL1Block(blobFields);
477
+ await this.blobClient.sendBlobsToFilestore(blobs);
478
+ this.log.debug(`Uploaded ${blobs.length} blobs to filestore for checkpoint at slot ${proposal.slotNumber}`, {
479
+ ...proposalInfo,
480
+ numBlobs: blobs.length
481
+ });
482
+ } catch (err) {
483
+ this.log.warn(`Failed to upload blobs for checkpoint: ${err}`, proposalInfo);
484
+ }
485
+ }
409
486
  slashInvalidBlock(proposal) {
410
487
  const proposer = proposal.getSender();
411
488
  // Skip if signature is invalid (shouldn't happen since we validate earlier)
@@ -413,11 +490,6 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
413
490
  this.log.warn(`Cannot slash proposal with invalid signature`);
414
491
  return;
415
492
  }
416
- // Trim the set if it's too big.
417
- if (this.proposersOfInvalidBlocks.size > MAX_PROPOSERS_OF_INVALID_BLOCKS) {
418
- // remove oldest proposer. `values` is guaranteed to be in insertion order.
419
- this.proposersOfInvalidBlocks.delete(this.proposersOfInvalidBlocks.values().next().value);
420
- }
421
493
  this.proposersOfInvalidBlocks.add(proposer.toString());
422
494
  this.emit(WANT_TO_SLASH_EVENT, [
423
495
  {
@@ -428,17 +500,122 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
428
500
  }
429
501
  ]);
430
502
  }
503
+ handleInvalidCheckpointProposal(proposal, result, proposalInfo) {
504
+ if (!SLASHABLE_CHECKPOINT_PROPOSAL_VALIDATION_RESULT[result.reason]) {
505
+ return;
506
+ }
507
+ // The slot is already marked invalid by the all-nodes checkpoint handler that invokes this callback,
508
+ // so we only emit the proposer slash event here.
509
+ if (this.slashInvalidCheckpointProposal(proposal)) {
510
+ this.log.info(`Detected invalid checkpoint proposal offense`, {
511
+ ...proposalInfo,
512
+ reason: result.reason,
513
+ amount: this.config.slashBroadcastedInvalidCheckpointProposalPenalty,
514
+ offenseType: getOffenseTypeName(OffenseType.BROADCASTED_INVALID_CHECKPOINT_PROPOSAL)
515
+ });
516
+ }
517
+ }
518
+ slashInvalidCheckpointProposal(proposal) {
519
+ const proposer = proposal.getSender();
520
+ if (!proposer) {
521
+ this.log.warn(`Cannot slash checkpoint proposal with invalid signature`, {
522
+ slotNumber: proposal.slotNumber,
523
+ archive: proposal.archive.toString()
524
+ });
525
+ return false;
526
+ }
527
+ const offenseType = OffenseType.BROADCASTED_INVALID_CHECKPOINT_PROPOSAL;
528
+ const offenseKey = `${proposer.toString()}:${offenseType}:${proposal.slotNumber}`;
529
+ if (!this.invalidCheckpointProposalOffenseKeys.addIfAbsent(offenseKey)) {
530
+ return false;
531
+ }
532
+ this.emit(WANT_TO_SLASH_EVENT, [
533
+ {
534
+ validator: proposer,
535
+ amount: this.config.slashBroadcastedInvalidCheckpointProposalPenalty,
536
+ offenseType,
537
+ epochOrSlot: BigInt(proposal.slotNumber)
538
+ }
539
+ ]);
540
+ return true;
541
+ }
542
+ markInvalidProposalSlot(slotNumber) {
543
+ this.proposalHandler.markInvalidProposalSlot(slotNumber);
544
+ }
545
+ handleCheckpointAttestation(attestation) {
546
+ const slotNumber = attestation.slotNumber;
547
+ if (!this.proposalHandler.hasInvalidProposals(slotNumber) || this.proposalHandler.hasProposalEquivocation(slotNumber)) {
548
+ return;
549
+ }
550
+ const attester = attestation.getSender();
551
+ if (!attester) {
552
+ this.log.warn(`Cannot slash checkpoint attestation with invalid signature`, {
553
+ slotNumber,
554
+ archive: attestation.archive.toString()
555
+ });
556
+ return;
557
+ }
558
+ this.slashAttestedToInvalidCheckpointProposal(slotNumber, attester);
559
+ }
560
+ slashAttestedToInvalidCheckpointProposal(slotNumber, attester) {
561
+ const offenseKey = `${attester.toString()}:${OffenseType.ATTESTED_TO_INVALID_CHECKPOINT_PROPOSAL}:${slotNumber}`;
562
+ if (!this.badAttestationOffenseKeys.addIfAbsent(offenseKey)) {
563
+ return;
564
+ }
565
+ this.log.info(`Detected attestation to invalid checkpoint proposal offense`, {
566
+ attester: attester.toString(),
567
+ slotNumber,
568
+ amount: this.config.slashAttestInvalidCheckpointProposalPenalty,
569
+ offenseType: getOffenseTypeName(OffenseType.ATTESTED_TO_INVALID_CHECKPOINT_PROPOSAL)
570
+ });
571
+ this.emit(WANT_TO_SLASH_EVENT, [
572
+ {
573
+ validator: attester,
574
+ amount: this.config.slashAttestInvalidCheckpointProposalPenalty,
575
+ offenseType: OffenseType.ATTESTED_TO_INVALID_CHECKPOINT_PROPOSAL,
576
+ epochOrSlot: BigInt(slotNumber)
577
+ }
578
+ ]);
579
+ }
580
+ /**
581
+ * Handle detection of an oversized block proposal: one whose index within its checkpoint lands at or
582
+ * beyond the consensus per-checkpoint block limit. A single signed proposal at an illegal index is
583
+ * self-contained evidence, so emit an invalid-block-proposal slash event for the proposer, deduped per
584
+ * (proposer, slot) since the p2p layer reports every oversized proposal it stores.
585
+ */ handleOversizedProposal(info) {
586
+ const { slot, proposer } = info;
587
+ const offenseType = OffenseType.BROADCASTED_INVALID_BLOCK_PROPOSAL;
588
+ if (!this.oversizedProposalOffenseKeys.addIfAbsent(`${proposer.toString()}:${offenseType}:${slot}`)) {
589
+ return;
590
+ }
591
+ this.log.info(`Detected oversized block proposal offense from ${proposer.toString()} at slot ${slot}`, {
592
+ proposer: proposer.toString(),
593
+ slot,
594
+ amount: this.config.slashBroadcastedInvalidBlockPenalty,
595
+ offenseType: getOffenseTypeName(offenseType)
596
+ });
597
+ this.emit(WANT_TO_SLASH_EVENT, [
598
+ {
599
+ validator: proposer,
600
+ amount: this.config.slashBroadcastedInvalidBlockPenalty,
601
+ offenseType,
602
+ epochOrSlot: BigInt(slot)
603
+ }
604
+ ]);
605
+ }
431
606
  /**
432
607
  * Handle detection of a duplicate proposal (equivocation).
433
608
  * Emits a slash event when a proposer sends multiple proposals for the same position.
434
609
  */ handleDuplicateProposal(info) {
435
610
  const { slot, proposer, type } = info;
436
- this.log.warn(`Triggering slash event for duplicate ${type} proposal from ${proposer.toString()} at slot ${slot}`, {
611
+ this.proposalHandler.markProposalEquivocation(slot);
612
+ this.log.info(`Detected duplicate ${type} proposal offense from ${proposer.toString()} at slot ${slot}`, {
437
613
  proposer: proposer.toString(),
438
614
  slot,
439
- type
615
+ type,
616
+ amount: this.config.slashDuplicateProposalPenalty,
617
+ offenseType: getOffenseTypeName(OffenseType.DUPLICATE_PROPOSAL)
440
618
  });
441
- // Emit slash event
442
619
  this.emit(WANT_TO_SLASH_EVENT, [
443
620
  {
444
621
  validator: proposer,
@@ -447,15 +624,23 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
447
624
  epochOrSlot: BigInt(slot)
448
625
  }
449
626
  ]);
627
+ this.emit(WANT_TO_CLEAR_SLASH_EVENT, [
628
+ {
629
+ offenseType: OffenseType.ATTESTED_TO_INVALID_CHECKPOINT_PROPOSAL,
630
+ epochOrSlot: BigInt(slot)
631
+ }
632
+ ]);
450
633
  }
451
634
  /**
452
635
  * Handle detection of a duplicate attestation (equivocation).
453
636
  * Emits a slash event when an attester signs attestations for different proposals at the same slot.
454
637
  */ handleDuplicateAttestation(info) {
455
638
  const { slot, attester } = info;
456
- this.log.warn(`Triggering slash event for duplicate attestation from ${attester.toString()} at slot ${slot}`, {
639
+ this.log.info(`Detected duplicate attestation offense from ${attester.toString()} at slot ${slot}`, {
457
640
  attester: attester.toString(),
458
- slot
641
+ slot,
642
+ amount: this.config.slashDuplicateAttestationPenalty,
643
+ offenseType: getOffenseTypeName(OffenseType.DUPLICATE_ATTESTATION)
459
644
  });
460
645
  this.emit(WANT_TO_SLASH_EVENT, [
461
646
  {
@@ -466,7 +651,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
466
651
  }
467
652
  ]);
468
653
  }
469
- async createBlockProposal(blockHeader, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, options = {}) {
654
+ async createBlockProposal(blockHeader, checkpointNumber, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, options = {}) {
470
655
  // Validate that we're not creating a proposal for an older or equal position
471
656
  if (this.lastProposedBlock) {
472
657
  const lastSlot = this.lastProposedBlock.slotNumber;
@@ -477,14 +662,14 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
477
662
  }
478
663
  }
479
664
  this.log.info(`Assembling block proposal for block ${blockHeader.globalVariables.blockNumber} slot ${blockHeader.globalVariables.slotNumber}`);
480
- const newProposal = await this.validationService.createBlockProposal(blockHeader, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, {
665
+ const newProposal = await this.validationService.createBlockProposal(blockHeader, checkpointNumber, indexWithinCheckpoint, inHash, archive, txs, proposerAddress, {
481
666
  ...options,
482
- broadcastInvalidBlockProposal: this.config.broadcastInvalidBlockProposal
667
+ broadcastInvalidBlockProposal: options.broadcastInvalidBlockProposal || this.config.broadcastInvalidBlockProposal
483
668
  });
484
669
  this.lastProposedBlock = newProposal;
485
670
  return newProposal;
486
671
  }
487
- async createCheckpointProposal(checkpointHeader, archive, feeAssetPriceModifier, lastBlockInfo, proposerAddress, options = {}) {
672
+ async createCheckpointProposal(checkpointHeader, archive, checkpointNumber, feeAssetPriceModifier, lastBlockProposal, proposerAddress, options = {}) {
488
673
  // Validate that we're not creating a proposal for an older or equal slot
489
674
  if (this.lastProposedCheckpoint) {
490
675
  const lastSlot = this.lastProposedCheckpoint.slotNumber;
@@ -494,23 +679,30 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
494
679
  }
495
680
  }
496
681
  this.log.info(`Assembling checkpoint proposal for slot ${checkpointHeader.slotNumber}`);
497
- const newProposal = await this.validationService.createCheckpointProposal(checkpointHeader, archive, feeAssetPriceModifier, lastBlockInfo, proposerAddress, options);
682
+ const newProposal = await this.validationService.createCheckpointProposal(checkpointHeader, archive, checkpointNumber, feeAssetPriceModifier, lastBlockProposal, proposerAddress, options);
498
683
  this.lastProposedCheckpoint = newProposal;
684
+ // Self-record this slot's outcome on the re-execution tracker. Proposers don't run their
685
+ // own proposals through `handleCheckpointProposal`, so without this call the proposer's
686
+ // sentinel would see no outcome for slots it proposed and would mis-attribute itself as
687
+ // inactive. We pass the locally-computed `archive` (not `newProposal.archive`, which may
688
+ // be intentionally corrupted under test-only flags); from the proposer's local-view
689
+ // perspective the work it just completed is valid by definition.
690
+ this.proposalHandler.recordOwnCheckpointProposalAsValid(checkpointHeader.slotNumber, archive, checkpointNumber);
499
691
  return newProposal;
500
692
  }
501
693
  async broadcastBlockProposal(proposal) {
502
694
  await this.p2pClient.broadcastProposal(proposal);
503
695
  }
504
- async signAttestationsAndSigners(attestationsAndSigners, proposer, slot, blockNumber) {
505
- return await this.validationService.signAttestationsAndSigners(attestationsAndSigners, proposer, slot, blockNumber);
696
+ async signAttestationsAndSigners(attestationsAndSigners, proposer, slot, checkpointNumber) {
697
+ return await this.validationService.signAttestationsAndSigners(attestationsAndSigners, proposer, slot, checkpointNumber);
506
698
  }
507
- async collectOwnAttestations(proposal) {
699
+ async collectOwnAttestations(proposal, checkpointNumber) {
508
700
  const slot = proposal.slotNumber;
509
701
  const inCommittee = await this.epochCache.filterInCommittee(slot, this.getValidatorAddresses());
510
702
  this.log.debug(`Collecting ${inCommittee.length} self-attestations for slot ${slot}`, {
511
703
  inCommittee
512
704
  });
513
- const attestations = await this.createCheckpointAttestationsFromProposal(proposal, inCommittee);
705
+ const attestations = await this.createCheckpointAttestationsFromProposal(proposal, inCommittee, checkpointNumber);
514
706
  if (!attestations) {
515
707
  return [];
516
708
  }
@@ -522,7 +714,7 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
522
714
  });
523
715
  return attestations;
524
716
  }
525
- async collectAttestations(proposal, required, deadline) {
717
+ async collectAttestations(proposal, required, deadline, checkpointNumber) {
526
718
  // Wait and poll the p2pClient's attestation pool for this checkpoint until we have enough attestations
527
719
  const slot = proposal.slotNumber;
528
720
  this.log.debug(`Collecting ${required} attestations for slot ${slot} with deadline ${deadline.toISOString()}`);
@@ -530,28 +722,20 @@ const SLASHABLE_BLOCK_PROPOSAL_VALIDATION_RESULT = [
530
722
  this.log.error(`Deadline ${deadline.toISOString()} for collecting ${required} attestations for slot ${slot} is in the past`);
531
723
  throw new AttestationTimeoutError(0, required, slot);
532
724
  }
533
- await this.collectOwnAttestations(proposal);
534
- const proposalId = proposal.archive.toString();
725
+ await this.collectOwnAttestations(proposal, checkpointNumber);
726
+ const proposalPayloadHash = proposal.getPayloadHash();
535
727
  const myAddresses = this.getValidatorAddresses();
536
728
  let attestations = [];
537
729
  while(true){
538
- // Filter out attestations with a mismatching archive. This should NOT happen since we have verified
539
- // the proposer signature (ie our own) before accepting the attestation into the pool via the p2p client.
540
- const collectedAttestations = (await this.p2pClient.getCheckpointAttestationsForSlot(slot, proposalId)).filter((attestation)=>{
541
- if (!attestation.archive.equals(proposal.archive)) {
542
- this.log.warn(`Received attestation for slot ${slot} with mismatched archive from ${attestation.getSender()?.toString()}`, {
543
- attestationArchive: attestation.archive.toString(),
544
- proposalArchive: proposal.archive.toString()
545
- });
546
- return false;
547
- }
548
- return true;
549
- });
730
+ // The pool already filters by proposal payload hash; if any attestation slips through with a
731
+ // mismatched payload hash, drop it defensively. Equivocations are emitted as separate slash
732
+ // events from libp2p_service.
733
+ const collectedAttestations = await this.p2pClient.getCheckpointAttestationsForSlot(slot, proposalPayloadHash);
550
734
  // Log new attestations we collected
551
735
  const oldSenders = attestations.map((attestation)=>attestation.getSender());
552
736
  for (const collected of collectedAttestations){
553
737
  const collectedSender = collected.getSender();
554
- // Skip attestations with invalid signatures
738
+ // Skip attestations with invalid signatures. Should not happen as we don't add invalid attestations to our pool.
555
739
  if (!collectedSender) {
556
740
  this.log.warn(`Skipping attestation with invalid signature for slot ${slot}`);
557
741
  continue;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/validator-client",
3
- "version": "0.0.1-commit.9ef841308",
3
+ "version": "0.0.1-commit.a5db02d",
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.9ef841308",
68
- "@aztec/blob-lib": "0.0.1-commit.9ef841308",
69
- "@aztec/constants": "0.0.1-commit.9ef841308",
70
- "@aztec/epoch-cache": "0.0.1-commit.9ef841308",
71
- "@aztec/ethereum": "0.0.1-commit.9ef841308",
72
- "@aztec/foundation": "0.0.1-commit.9ef841308",
73
- "@aztec/node-keystore": "0.0.1-commit.9ef841308",
74
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.9ef841308",
75
- "@aztec/p2p": "0.0.1-commit.9ef841308",
76
- "@aztec/protocol-contracts": "0.0.1-commit.9ef841308",
77
- "@aztec/prover-client": "0.0.1-commit.9ef841308",
78
- "@aztec/simulator": "0.0.1-commit.9ef841308",
79
- "@aztec/slasher": "0.0.1-commit.9ef841308",
80
- "@aztec/stdlib": "0.0.1-commit.9ef841308",
81
- "@aztec/telemetry-client": "0.0.1-commit.9ef841308",
82
- "@aztec/validator-ha-signer": "0.0.1-commit.9ef841308",
67
+ "@aztec/blob-client": "0.0.1-commit.a5db02d",
68
+ "@aztec/blob-lib": "0.0.1-commit.a5db02d",
69
+ "@aztec/constants": "0.0.1-commit.a5db02d",
70
+ "@aztec/epoch-cache": "0.0.1-commit.a5db02d",
71
+ "@aztec/ethereum": "0.0.1-commit.a5db02d",
72
+ "@aztec/foundation": "0.0.1-commit.a5db02d",
73
+ "@aztec/node-keystore": "0.0.1-commit.a5db02d",
74
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.a5db02d",
75
+ "@aztec/p2p": "0.0.1-commit.a5db02d",
76
+ "@aztec/protocol-contracts": "0.0.1-commit.a5db02d",
77
+ "@aztec/prover-client": "0.0.1-commit.a5db02d",
78
+ "@aztec/simulator": "0.0.1-commit.a5db02d",
79
+ "@aztec/slasher": "0.0.1-commit.a5db02d",
80
+ "@aztec/stdlib": "0.0.1-commit.a5db02d",
81
+ "@aztec/telemetry-client": "0.0.1-commit.a5db02d",
82
+ "@aztec/validator-ha-signer": "0.0.1-commit.a5db02d",
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.9ef841308",
90
- "@aztec/world-state": "0.0.1-commit.9ef841308",
89
+ "@aztec/archiver": "0.0.1-commit.a5db02d",
90
+ "@aztec/world-state": "0.0.1-commit.a5db02d",
91
91
  "@electric-sql/pglite": "^0.3.14",
92
92
  "@jest/globals": "^30.0.0",
93
93
  "@types/jest": "^30.0.0",
@@ -219,10 +219,12 @@ export class CheckpointBuilder implements ICheckpointBlockBuilder {
219
219
  if (opts.isBuildingProposal) {
220
220
  const remainingBlocks = Math.max(1, opts.maxBlocksPerCheckpoint - existingBlocks.length);
221
221
  const multiplier = opts.perBlockAllocationMultiplier;
222
+ // DA gas and blob fields use a higher multiplier so the largest contract class deploy fits a block.
223
+ const daMultiplier = opts.perBlockDAAllocationMultiplier ?? multiplier;
222
224
 
223
225
  cappedL2Gas = Math.min(cappedL2Gas, Math.ceil((remainingMana / remainingBlocks) * multiplier));
224
- cappedDAGas = Math.min(cappedDAGas, Math.ceil((remainingDAGas / remainingBlocks) * multiplier));
225
- cappedBlobFields = Math.min(cappedBlobFields, Math.ceil((maxBlobFieldsForTxs / remainingBlocks) * multiplier));
226
+ cappedDAGas = Math.min(cappedDAGas, Math.ceil((remainingDAGas / remainingBlocks) * daMultiplier));
227
+ cappedBlobFields = Math.min(cappedBlobFields, Math.ceil((maxBlobFieldsForTxs / remainingBlocks) * daMultiplier));
226
228
  cappedMaxTransactions = Math.min(cappedMaxTransactions, Math.ceil((remainingTxs / remainingBlocks) * multiplier));
227
229
  }
228
230