@aztec/validator-client 0.0.1-commit.3469e52 → 0.0.1-commit.381b1a9
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/README.md +64 -19
- package/dest/block_proposal_handler.d.ts +9 -10
- package/dest/block_proposal_handler.d.ts.map +1 -1
- package/dest/block_proposal_handler.js +129 -82
- package/dest/checkpoint_builder.d.ts +23 -13
- package/dest/checkpoint_builder.d.ts.map +1 -1
- package/dest/checkpoint_builder.js +127 -46
- package/dest/config.d.ts +1 -1
- package/dest/config.d.ts.map +1 -1
- package/dest/config.js +28 -6
- package/dest/duties/validation_service.d.ts +2 -2
- package/dest/duties/validation_service.d.ts.map +1 -1
- package/dest/duties/validation_service.js +6 -12
- package/dest/factory.d.ts +1 -1
- package/dest/factory.d.ts.map +1 -1
- package/dest/factory.js +2 -1
- package/dest/index.d.ts +1 -2
- package/dest/index.d.ts.map +1 -1
- package/dest/index.js +0 -1
- package/dest/key_store/ha_key_store.d.ts +1 -1
- package/dest/key_store/ha_key_store.d.ts.map +1 -1
- package/dest/key_store/ha_key_store.js +3 -3
- package/dest/metrics.d.ts +12 -3
- package/dest/metrics.d.ts.map +1 -1
- package/dest/metrics.js +46 -5
- package/dest/validator.d.ts +40 -14
- package/dest/validator.d.ts.map +1 -1
- package/dest/validator.js +211 -55
- package/package.json +19 -17
- package/src/block_proposal_handler.ts +159 -109
- package/src/checkpoint_builder.ts +172 -52
- package/src/config.ts +28 -6
- package/src/duties/validation_service.ts +12 -11
- package/src/factory.ts +1 -0
- package/src/index.ts +0 -1
- package/src/key_store/ha_key_store.ts +3 -3
- package/src/metrics.ts +63 -6
- package/src/validator.ts +270 -68
- package/dest/tx_validator/index.d.ts +0 -3
- package/dest/tx_validator/index.d.ts.map +0 -1
- package/dest/tx_validator/index.js +0 -2
- package/dest/tx_validator/nullifier_cache.d.ts +0 -14
- package/dest/tx_validator/nullifier_cache.d.ts.map +0 -1
- package/dest/tx_validator/nullifier_cache.js +0 -24
- package/dest/tx_validator/tx_validator_factory.d.ts +0 -18
- package/dest/tx_validator/tx_validator_factory.d.ts.map +0 -1
- package/dest/tx_validator/tx_validator_factory.js +0 -54
- package/src/tx_validator/index.ts +0 -2
- package/src/tx_validator/nullifier_cache.ts +0 -30
- package/src/tx_validator/tx_validator_factory.ts +0 -135
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,33 +19,36 @@ 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 { P2P, PeerId
|
|
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
|
-
import type { CommitteeAttestationsAndSigners,
|
|
26
|
-
import {
|
|
26
|
+
import type { CommitteeAttestationsAndSigners, L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
|
|
27
|
+
import { validateCheckpoint } from '@aztec/stdlib/checkpoint';
|
|
28
|
+
import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
|
|
27
29
|
import type {
|
|
28
30
|
CreateCheckpointProposalLastBlockData,
|
|
31
|
+
ITxProvider,
|
|
29
32
|
Validator,
|
|
30
33
|
ValidatorClientFullConfig,
|
|
31
34
|
WorldStateSynchronizer,
|
|
32
35
|
} from '@aztec/stdlib/interfaces/server';
|
|
33
|
-
import type
|
|
34
|
-
import
|
|
35
|
-
BlockProposal,
|
|
36
|
-
BlockProposalOptions,
|
|
37
|
-
CheckpointAttestation,
|
|
38
|
-
|
|
39
|
-
|
|
36
|
+
import { type L1ToL2MessageSource, accumulateCheckpointOutHashes } from '@aztec/stdlib/messaging';
|
|
37
|
+
import {
|
|
38
|
+
type BlockProposal,
|
|
39
|
+
type BlockProposalOptions,
|
|
40
|
+
type CheckpointAttestation,
|
|
41
|
+
CheckpointProposal,
|
|
42
|
+
type CheckpointProposalCore,
|
|
43
|
+
type CheckpointProposalOptions,
|
|
40
44
|
} from '@aztec/stdlib/p2p';
|
|
41
|
-
import { CheckpointProposal } from '@aztec/stdlib/p2p';
|
|
42
45
|
import type { CheckpointHeader } from '@aztec/stdlib/rollup';
|
|
43
46
|
import type { BlockHeader, CheckpointGlobalVariables, Tx } from '@aztec/stdlib/tx';
|
|
44
47
|
import { AttestationTimeoutError } from '@aztec/stdlib/validators';
|
|
45
48
|
import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
|
|
46
49
|
import { createHASigner } from '@aztec/validator-ha-signer/factory';
|
|
47
50
|
import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
|
|
51
|
+
import type { ValidatorHASigner } from '@aztec/validator-ha-signer/validator-ha-signer';
|
|
48
52
|
|
|
49
53
|
import { EventEmitter } from 'events';
|
|
50
54
|
import type { TypedDataDefinition } from 'viem';
|
|
@@ -75,22 +79,24 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
75
79
|
private validationService: ValidationService;
|
|
76
80
|
private metrics: ValidatorMetrics;
|
|
77
81
|
private log: Logger;
|
|
78
|
-
|
|
79
82
|
// Whether it has already registered handlers on the p2p client
|
|
80
83
|
private hasRegisteredHandlers = false;
|
|
81
84
|
|
|
82
|
-
|
|
83
|
-
private
|
|
85
|
+
/** Tracks the last block proposal we created, to detect duplicate proposal attempts. */
|
|
86
|
+
private lastProposedBlock?: BlockProposal;
|
|
87
|
+
|
|
88
|
+
/** Tracks the last checkpoint proposal we created. */
|
|
89
|
+
private lastProposedCheckpoint?: CheckpointProposal;
|
|
84
90
|
|
|
85
91
|
private lastEpochForCommitteeUpdateLoop: EpochNumber | undefined;
|
|
86
92
|
private epochCacheUpdateLoop: RunningPromise;
|
|
93
|
+
/** Tracks the last epoch in which each attester successfully submitted at least one attestation. */
|
|
94
|
+
private lastAttestedEpochByAttester: Map<string, EpochNumber> = new Map();
|
|
87
95
|
|
|
88
96
|
private proposersOfInvalidBlocks: Set<string> = new Set();
|
|
89
97
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
// eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
|
|
93
|
-
private validatedBlockSlots: Set<SlotNumber> = new Set();
|
|
98
|
+
/** Tracks the last checkpoint proposal we attested to, to prevent equivocation. */
|
|
99
|
+
private lastAttestedProposal?: CheckpointProposalCore;
|
|
94
100
|
|
|
95
101
|
protected constructor(
|
|
96
102
|
private keyStore: ExtendedValidatorKeyStore,
|
|
@@ -103,6 +109,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
103
109
|
private l1ToL2MessageSource: L1ToL2MessageSource,
|
|
104
110
|
private config: ValidatorClientFullConfig,
|
|
105
111
|
private blobClient: BlobClientInterface,
|
|
112
|
+
private haSigner: ValidatorHASigner | undefined,
|
|
106
113
|
private dateProvider: DateProvider = new DateProvider(),
|
|
107
114
|
telemetry: TelemetryClient = getTelemetryClient(),
|
|
108
115
|
log = createLogger('validator'),
|
|
@@ -156,6 +163,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
156
163
|
this.log.trace(`No committee found for slot`);
|
|
157
164
|
return;
|
|
158
165
|
}
|
|
166
|
+
this.metrics.setCurrentEpoch(epoch);
|
|
159
167
|
if (epoch !== this.lastEpochForCommitteeUpdateLoop) {
|
|
160
168
|
const me = this.getValidatorAddresses();
|
|
161
169
|
const committeeSet = new Set(committee.map(v => v.toString()));
|
|
@@ -184,7 +192,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
184
192
|
p2pClient: P2P,
|
|
185
193
|
blockSource: L2BlockSource & L2BlockSink,
|
|
186
194
|
l1ToL2MessageSource: L1ToL2MessageSource,
|
|
187
|
-
txProvider:
|
|
195
|
+
txProvider: ITxProvider,
|
|
188
196
|
keyStoreManager: KeystoreManager,
|
|
189
197
|
blobClient: BlobClientInterface,
|
|
190
198
|
dateProvider: DateProvider = new DateProvider(),
|
|
@@ -193,6 +201,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
193
201
|
const metrics = new ValidatorMetrics(telemetry);
|
|
194
202
|
const blockProposalValidator = new BlockProposalValidator(epochCache, {
|
|
195
203
|
txsPermitted: !config.disableTransactions,
|
|
204
|
+
maxTxsPerBlock: config.validateMaxTxsPerBlock,
|
|
196
205
|
});
|
|
197
206
|
const blockProposalHandler = new BlockProposalHandler(
|
|
198
207
|
checkpointsBuilder,
|
|
@@ -208,7 +217,9 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
208
217
|
telemetry,
|
|
209
218
|
);
|
|
210
219
|
|
|
211
|
-
|
|
220
|
+
const nodeKeystoreAdapter = NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager);
|
|
221
|
+
let validatorKeyStore: ExtendedValidatorKeyStore = nodeKeystoreAdapter;
|
|
222
|
+
let haSigner: ValidatorHASigner | undefined;
|
|
212
223
|
if (config.haSigningEnabled) {
|
|
213
224
|
// If maxStuckDutiesAgeMs is not explicitly set, compute it from Aztec slot duration
|
|
214
225
|
const haConfig = {
|
|
@@ -216,7 +227,8 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
216
227
|
maxStuckDutiesAgeMs: config.maxStuckDutiesAgeMs ?? epochCache.getL1Constants().slotDuration * 2 * 1000,
|
|
217
228
|
};
|
|
218
229
|
const { signer } = await createHASigner(haConfig);
|
|
219
|
-
|
|
230
|
+
haSigner = signer;
|
|
231
|
+
validatorKeyStore = new HAKeyStore(nodeKeystoreAdapter, signer);
|
|
220
232
|
}
|
|
221
233
|
|
|
222
234
|
const validator = new ValidatorClient(
|
|
@@ -230,6 +242,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
230
242
|
l1ToL2MessageSource,
|
|
231
243
|
config,
|
|
232
244
|
blobClient,
|
|
245
|
+
haSigner,
|
|
233
246
|
dateProvider,
|
|
234
247
|
telemetry,
|
|
235
248
|
);
|
|
@@ -267,6 +280,28 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
267
280
|
this.config = { ...this.config, ...config };
|
|
268
281
|
}
|
|
269
282
|
|
|
283
|
+
public reloadKeystore(newManager: KeystoreManager): void {
|
|
284
|
+
if (this.config.haSigningEnabled && !this.haSigner) {
|
|
285
|
+
this.log.warn(
|
|
286
|
+
'HA signing is enabled in config but was not initialized at startup. ' +
|
|
287
|
+
'Restart the node to enable HA signing.',
|
|
288
|
+
);
|
|
289
|
+
} else if (!this.config.haSigningEnabled && this.haSigner) {
|
|
290
|
+
this.log.warn(
|
|
291
|
+
'HA signing was disabled via config update but the HA signer is still active. ' +
|
|
292
|
+
'Restart the node to fully disable HA signing.',
|
|
293
|
+
);
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
|
|
297
|
+
if (this.haSigner) {
|
|
298
|
+
this.keyStore = new HAKeyStore(newAdapter, this.haSigner);
|
|
299
|
+
} else {
|
|
300
|
+
this.keyStore = newAdapter;
|
|
301
|
+
}
|
|
302
|
+
this.validationService = new ValidationService(this.keyStore, this.log.createChild('validation-service'));
|
|
303
|
+
}
|
|
304
|
+
|
|
270
305
|
public async start() {
|
|
271
306
|
if (this.epochCacheUpdateLoop.isRunning()) {
|
|
272
307
|
this.log.warn(`Validator client already started`);
|
|
@@ -313,6 +348,16 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
313
348
|
): Promise<CheckpointAttestation[] | undefined> => this.attestToCheckpointProposal(checkpoint, proposalSender);
|
|
314
349
|
this.p2pClient.registerCheckpointProposalHandler(checkpointHandler);
|
|
315
350
|
|
|
351
|
+
// Duplicate proposal handler - triggers slashing for equivocation
|
|
352
|
+
this.p2pClient.registerDuplicateProposalCallback((info: DuplicateProposalInfo) => {
|
|
353
|
+
this.handleDuplicateProposal(info);
|
|
354
|
+
});
|
|
355
|
+
|
|
356
|
+
// Duplicate attestation handler - triggers slashing for attestation equivocation
|
|
357
|
+
this.p2pClient.registerDuplicateAttestationCallback((info: DuplicateAttestationInfo) => {
|
|
358
|
+
this.handleDuplicateAttestation(info);
|
|
359
|
+
});
|
|
360
|
+
|
|
316
361
|
const myAddresses = this.getValidatorAddresses();
|
|
317
362
|
this.p2pClient.registerThisValidatorAddresses(myAddresses);
|
|
318
363
|
|
|
@@ -340,6 +385,15 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
340
385
|
return false;
|
|
341
386
|
}
|
|
342
387
|
|
|
388
|
+
// Ignore proposals from ourselves (may happen in HA setups)
|
|
389
|
+
if (this.getValidatorAddresses().some(addr => addr.equals(proposer))) {
|
|
390
|
+
this.log.debug(`Ignoring block proposal from self for slot ${slotNumber}`, {
|
|
391
|
+
proposer: proposer.toString(),
|
|
392
|
+
slotNumber,
|
|
393
|
+
});
|
|
394
|
+
return false;
|
|
395
|
+
}
|
|
396
|
+
|
|
343
397
|
// Check if we're in the committee (for metrics purposes)
|
|
344
398
|
const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
|
|
345
399
|
const partOfCommittee = inCommittee.length > 0;
|
|
@@ -369,9 +423,10 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
369
423
|
);
|
|
370
424
|
|
|
371
425
|
if (!validationResult.isValid) {
|
|
372
|
-
this.log.warn(`Block proposal validation failed: ${validationResult.reason}`, proposalInfo);
|
|
373
|
-
|
|
374
426
|
const reason = validationResult.reason || 'unknown';
|
|
427
|
+
|
|
428
|
+
this.log.warn(`Block proposal validation failed: ${reason}`, proposalInfo);
|
|
429
|
+
|
|
375
430
|
// Classify failure reason: bad proposal vs node issue
|
|
376
431
|
const badProposalReasons: BlockProposalValidationFailureReason[] = [
|
|
377
432
|
'invalid_proposal',
|
|
@@ -413,10 +468,6 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
413
468
|
return false;
|
|
414
469
|
}
|
|
415
470
|
|
|
416
|
-
// TODO(palla/mbps): Remove this once checkpoint validation is stable.
|
|
417
|
-
// Track that we successfully validated a block for this slot, so we can attest to checkpoint proposals for it.
|
|
418
|
-
this.validatedBlockSlots.add(slotNumber);
|
|
419
|
-
|
|
420
471
|
return true;
|
|
421
472
|
}
|
|
422
473
|
|
|
@@ -445,6 +496,23 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
445
496
|
return undefined;
|
|
446
497
|
}
|
|
447
498
|
|
|
499
|
+
// Ignore proposals from ourselves (may happen in HA setups)
|
|
500
|
+
if (this.getValidatorAddresses().some(addr => addr.equals(proposer))) {
|
|
501
|
+
this.log.debug(`Ignoring block proposal from self for slot ${slotNumber}`, {
|
|
502
|
+
proposer: proposer.toString(),
|
|
503
|
+
slotNumber,
|
|
504
|
+
});
|
|
505
|
+
return undefined;
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
// Validate fee asset price modifier is within allowed range
|
|
509
|
+
if (!validateFeeAssetPriceModifier(proposal.feeAssetPriceModifier)) {
|
|
510
|
+
this.log.warn(
|
|
511
|
+
`Received checkpoint proposal with invalid feeAssetPriceModifier ${proposal.feeAssetPriceModifier} for slot ${slotNumber}`,
|
|
512
|
+
);
|
|
513
|
+
return undefined;
|
|
514
|
+
}
|
|
515
|
+
|
|
448
516
|
// Check that I have any address in current committee before attesting
|
|
449
517
|
const inCommittee = await this.epochCache.filterInCommittee(slotNumber, this.getValidatorAddresses());
|
|
450
518
|
const partOfCommittee = inCommittee.length > 0;
|
|
@@ -453,25 +521,15 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
453
521
|
slotNumber,
|
|
454
522
|
archive: proposal.archive.toString(),
|
|
455
523
|
proposer: proposer.toString(),
|
|
456
|
-
txCount: proposal.txHashes.length,
|
|
457
524
|
};
|
|
458
525
|
this.log.info(`Received checkpoint proposal for slot ${slotNumber}`, {
|
|
459
526
|
...proposalInfo,
|
|
460
|
-
txHashes: proposal.txHashes.map(t => t.toString()),
|
|
461
527
|
fishermanMode: this.config.fishermanMode || false,
|
|
462
528
|
});
|
|
463
529
|
|
|
464
|
-
// TODO(palla/mbps): Remove this once checkpoint validation is stable.
|
|
465
|
-
// Check that we have successfully validated a block for this slot before attesting to the checkpoint.
|
|
466
|
-
if (!this.validatedBlockSlots.has(slotNumber)) {
|
|
467
|
-
this.log.warn(`No validated block found for slot ${slotNumber}, refusing to attest to checkpoint`, proposalInfo);
|
|
468
|
-
return undefined;
|
|
469
|
-
}
|
|
470
|
-
|
|
471
530
|
// Validate the checkpoint proposal before attesting (unless skipCheckpointProposalValidation is set)
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
this.log.verbose(`Skipping checkpoint proposal validation for slot ${slotNumber}`, proposalInfo);
|
|
531
|
+
if (this.config.skipCheckpointProposalValidation) {
|
|
532
|
+
this.log.warn(`Skipping checkpoint proposal validation for slot ${slotNumber}`, proposalInfo);
|
|
475
533
|
} else {
|
|
476
534
|
const validationResult = await this.validateCheckpointProposal(proposal, proposalInfo);
|
|
477
535
|
if (!validationResult.isValid) {
|
|
@@ -501,6 +559,17 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
501
559
|
|
|
502
560
|
this.metrics.incSuccessfulAttestations(inCommittee.length);
|
|
503
561
|
|
|
562
|
+
// Track epoch participation per attester: count each (attester, epoch) pair at most once
|
|
563
|
+
const proposalEpoch = getEpochAtSlot(slotNumber, this.epochCache.getL1Constants());
|
|
564
|
+
for (const attester of inCommittee) {
|
|
565
|
+
const key = attester.toString();
|
|
566
|
+
const lastEpoch = this.lastAttestedEpochByAttester.get(key);
|
|
567
|
+
if (lastEpoch === undefined || proposalEpoch > lastEpoch) {
|
|
568
|
+
this.lastAttestedEpochByAttester.set(key, proposalEpoch);
|
|
569
|
+
this.metrics.incAttestedEpochCount(attester);
|
|
570
|
+
}
|
|
571
|
+
}
|
|
572
|
+
|
|
504
573
|
// Determine which validators should attest
|
|
505
574
|
let attestors: EthAddress[];
|
|
506
575
|
if (partOfCommittee) {
|
|
@@ -526,15 +595,45 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
526
595
|
return undefined;
|
|
527
596
|
}
|
|
528
597
|
|
|
529
|
-
return this.createCheckpointAttestationsFromProposal(proposal, attestors);
|
|
598
|
+
return await this.createCheckpointAttestationsFromProposal(proposal, attestors);
|
|
599
|
+
}
|
|
600
|
+
|
|
601
|
+
/**
|
|
602
|
+
* Checks if we should attest to a slot based on equivocation prevention rules.
|
|
603
|
+
* @returns true if we should attest, false if we should skip
|
|
604
|
+
*/
|
|
605
|
+
private shouldAttestToSlot(slotNumber: SlotNumber): boolean {
|
|
606
|
+
// If attestToEquivocatedProposals is true, always allow
|
|
607
|
+
if (this.config.attestToEquivocatedProposals) {
|
|
608
|
+
return true;
|
|
609
|
+
}
|
|
610
|
+
|
|
611
|
+
// Check if incoming slot is strictly greater than last attested
|
|
612
|
+
if (this.lastAttestedProposal && slotNumber <= this.lastAttestedProposal.slotNumber) {
|
|
613
|
+
this.log.warn(
|
|
614
|
+
`Refusing to process a proposal for slot ${slotNumber} given we already attested to a proposal for slot ${this.lastAttestedProposal.slotNumber}`,
|
|
615
|
+
);
|
|
616
|
+
return false;
|
|
617
|
+
}
|
|
618
|
+
|
|
619
|
+
return true;
|
|
530
620
|
}
|
|
531
621
|
|
|
532
622
|
private async createCheckpointAttestationsFromProposal(
|
|
533
623
|
proposal: CheckpointProposalCore,
|
|
534
624
|
attestors: EthAddress[] = [],
|
|
535
|
-
): Promise<CheckpointAttestation[]> {
|
|
625
|
+
): Promise<CheckpointAttestation[] | undefined> {
|
|
626
|
+
// Equivocation check: must happen right before signing to minimize the race window
|
|
627
|
+
if (!this.shouldAttestToSlot(proposal.slotNumber)) {
|
|
628
|
+
return undefined;
|
|
629
|
+
}
|
|
630
|
+
|
|
536
631
|
const attestations = await this.validationService.attestToCheckpointProposal(proposal, attestors);
|
|
537
|
-
|
|
632
|
+
|
|
633
|
+
// Track the proposal we attested to (to prevent equivocation)
|
|
634
|
+
this.lastAttestedProposal = proposal;
|
|
635
|
+
|
|
636
|
+
await this.p2pClient.addOwnCheckpointAttestations(attestations);
|
|
538
637
|
return attestations;
|
|
539
638
|
}
|
|
540
639
|
|
|
@@ -547,7 +646,11 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
547
646
|
proposalInfo: LogData,
|
|
548
647
|
): Promise<{ isValid: true } | { isValid: false; reason: string }> {
|
|
549
648
|
const slot = proposal.slotNumber;
|
|
550
|
-
|
|
649
|
+
|
|
650
|
+
// Timeout block syncing at the start of the next slot
|
|
651
|
+
const config = this.checkpointsBuilder.getConfig();
|
|
652
|
+
const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
|
|
653
|
+
const timeoutSeconds = Math.max(1, nextSlotTimestampSeconds - Math.floor(this.dateProvider.now() / 1000));
|
|
551
654
|
|
|
552
655
|
// Wait for last block to sync by archive
|
|
553
656
|
let lastBlockHeader: BlockHeader | undefined;
|
|
@@ -582,6 +685,12 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
582
685
|
return { isValid: false, reason: 'no_blocks_for_slot' };
|
|
583
686
|
}
|
|
584
687
|
|
|
688
|
+
// Ensure the last block for this slot matches the archive in the checkpoint proposal
|
|
689
|
+
if (!blocks.at(-1)?.archive.root.equals(proposal.archive)) {
|
|
690
|
+
this.log.warn(`Last block archive mismatch for checkpoint proposal`, proposalInfo);
|
|
691
|
+
return { isValid: false, reason: 'last_block_archive_mismatch' };
|
|
692
|
+
}
|
|
693
|
+
|
|
585
694
|
this.log.debug(`Found ${blocks.length} blocks for slot ${slot}`, {
|
|
586
695
|
...proposalInfo,
|
|
587
696
|
blockNumbers: blocks.map(b => b.number),
|
|
@@ -595,14 +704,11 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
595
704
|
// Get L1-to-L2 messages for this checkpoint
|
|
596
705
|
const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
|
|
597
706
|
|
|
598
|
-
//
|
|
599
|
-
// TODO: There can be a more efficient way to get the previous checkpoint out hashes without having to fetch the
|
|
600
|
-
// actual checkpoints and the blocks/txs in them.
|
|
707
|
+
// Collect the out hashes of all the checkpoints before this one in the same epoch
|
|
601
708
|
const epoch = getEpochAtSlot(slot, this.epochCache.getL1Constants());
|
|
602
|
-
const
|
|
603
|
-
.filter(
|
|
604
|
-
.
|
|
605
|
-
const previousCheckpointOutHashes = previousCheckpoints.map(c => c.getCheckpointOutHash());
|
|
709
|
+
const previousCheckpointOutHashes = (await this.blockSource.getCheckpointsDataForEpoch(epoch))
|
|
710
|
+
.filter(c => c.checkpointNumber < checkpointNumber)
|
|
711
|
+
.map(c => c.checkpointOutHash);
|
|
606
712
|
|
|
607
713
|
// Fork world state at the block before the first block
|
|
608
714
|
const parentBlockNumber = BlockNumber(firstBlock.number - 1);
|
|
@@ -613,10 +719,12 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
613
719
|
const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(
|
|
614
720
|
checkpointNumber,
|
|
615
721
|
constants,
|
|
722
|
+
proposal.feeAssetPriceModifier,
|
|
616
723
|
l1ToL2Messages,
|
|
617
724
|
previousCheckpointOutHashes,
|
|
618
725
|
fork,
|
|
619
726
|
blocks,
|
|
727
|
+
this.log.getBindings(),
|
|
620
728
|
);
|
|
621
729
|
|
|
622
730
|
// Complete the checkpoint to get computed values
|
|
@@ -642,18 +750,36 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
642
750
|
return { isValid: false, reason: 'archive_mismatch' };
|
|
643
751
|
}
|
|
644
752
|
|
|
645
|
-
// Check that the accumulated out hash matches the value in the proposal.
|
|
646
|
-
|
|
647
|
-
const
|
|
648
|
-
|
|
753
|
+
// Check that the accumulated epoch out hash matches the value in the proposal.
|
|
754
|
+
// The epoch out hash is the accumulated hash of all checkpoint out hashes in the epoch.
|
|
755
|
+
const checkpointOutHash = computedCheckpoint.getCheckpointOutHash();
|
|
756
|
+
const computedEpochOutHash = accumulateCheckpointOutHashes([...previousCheckpointOutHashes, checkpointOutHash]);
|
|
757
|
+
const proposalEpochOutHash = proposal.checkpointHeader.epochOutHash;
|
|
758
|
+
if (!computedEpochOutHash.equals(proposalEpochOutHash)) {
|
|
649
759
|
this.log.warn(`Epoch out hash mismatch`, {
|
|
650
|
-
|
|
651
|
-
|
|
760
|
+
proposalEpochOutHash: proposalEpochOutHash.toString(),
|
|
761
|
+
computedEpochOutHash: computedEpochOutHash.toString(),
|
|
762
|
+
checkpointOutHash: checkpointOutHash.toString(),
|
|
763
|
+
previousCheckpointOutHashes: previousCheckpointOutHashes.map(h => h.toString()),
|
|
652
764
|
...proposalInfo,
|
|
653
765
|
});
|
|
654
766
|
return { isValid: false, reason: 'out_hash_mismatch' };
|
|
655
767
|
}
|
|
656
768
|
|
|
769
|
+
// Final round of validations on the checkpoint, just in case.
|
|
770
|
+
try {
|
|
771
|
+
validateCheckpoint(computedCheckpoint, {
|
|
772
|
+
rollupManaLimit: this.checkpointsBuilder.getConfig().rollupManaLimit,
|
|
773
|
+
maxDABlockGas: this.config.validateMaxDABlockGas,
|
|
774
|
+
maxL2BlockGas: this.config.validateMaxL2BlockGas,
|
|
775
|
+
maxTxsPerBlock: this.config.validateMaxTxsPerBlock,
|
|
776
|
+
maxTxsPerCheckpoint: this.config.validateMaxTxsPerCheckpoint,
|
|
777
|
+
});
|
|
778
|
+
} catch (err) {
|
|
779
|
+
this.log.warn(`Checkpoint validation failed: ${err}`, proposalInfo);
|
|
780
|
+
return { isValid: false, reason: 'checkpoint_validation_failed' };
|
|
781
|
+
}
|
|
782
|
+
|
|
657
783
|
this.log.verbose(`Checkpoint proposal validation successful for slot ${slot}`, proposalInfo);
|
|
658
784
|
return { isValid: true };
|
|
659
785
|
} finally {
|
|
@@ -664,12 +790,13 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
664
790
|
/**
|
|
665
791
|
* Extract checkpoint global variables from a block.
|
|
666
792
|
*/
|
|
667
|
-
private extractCheckpointConstants(block:
|
|
793
|
+
private extractCheckpointConstants(block: L2Block): CheckpointGlobalVariables {
|
|
668
794
|
const gv = block.header.globalVariables;
|
|
669
795
|
return {
|
|
670
796
|
chainId: gv.chainId,
|
|
671
797
|
version: gv.version,
|
|
672
798
|
slotNumber: gv.slotNumber,
|
|
799
|
+
timestamp: gv.timestamp,
|
|
673
800
|
coinbase: gv.coinbase,
|
|
674
801
|
feeRecipient: gv.feeRecipient,
|
|
675
802
|
gasFees: gv.gasFees,
|
|
@@ -679,7 +806,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
679
806
|
/**
|
|
680
807
|
* Uploads blobs for a checkpoint to the filestore (fire and forget).
|
|
681
808
|
*/
|
|
682
|
-
|
|
809
|
+
protected async uploadBlobsForCheckpoint(proposal: CheckpointProposalCore, proposalInfo: LogData): Promise<void> {
|
|
683
810
|
try {
|
|
684
811
|
const lastBlockHeader = await this.blockSource.getBlockHeaderByArchive(proposal.archive);
|
|
685
812
|
if (!lastBlockHeader) {
|
|
@@ -694,7 +821,7 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
694
821
|
}
|
|
695
822
|
|
|
696
823
|
const blobFields = blocks.flatMap(b => b.toBlobFields());
|
|
697
|
-
const blobs: Blob[] = getBlobsPerL1Block(blobFields);
|
|
824
|
+
const blobs: Blob[] = await getBlobsPerL1Block(blobFields);
|
|
698
825
|
await this.blobClient.sendBlobsToFilestore(blobs);
|
|
699
826
|
this.log.debug(`Uploaded ${blobs.length} blobs to filestore for checkpoint at slot ${proposal.slotNumber}`, {
|
|
700
827
|
...proposalInfo,
|
|
@@ -732,6 +859,52 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
732
859
|
]);
|
|
733
860
|
}
|
|
734
861
|
|
|
862
|
+
/**
|
|
863
|
+
* Handle detection of a duplicate proposal (equivocation).
|
|
864
|
+
* Emits a slash event when a proposer sends multiple proposals for the same position.
|
|
865
|
+
*/
|
|
866
|
+
private handleDuplicateProposal(info: DuplicateProposalInfo): void {
|
|
867
|
+
const { slot, proposer, type } = info;
|
|
868
|
+
|
|
869
|
+
this.log.warn(`Triggering slash event for duplicate ${type} proposal from ${proposer.toString()} at slot ${slot}`, {
|
|
870
|
+
proposer: proposer.toString(),
|
|
871
|
+
slot,
|
|
872
|
+
type,
|
|
873
|
+
});
|
|
874
|
+
|
|
875
|
+
// Emit slash event
|
|
876
|
+
this.emit(WANT_TO_SLASH_EVENT, [
|
|
877
|
+
{
|
|
878
|
+
validator: proposer,
|
|
879
|
+
amount: this.config.slashDuplicateProposalPenalty,
|
|
880
|
+
offenseType: OffenseType.DUPLICATE_PROPOSAL,
|
|
881
|
+
epochOrSlot: BigInt(slot),
|
|
882
|
+
},
|
|
883
|
+
]);
|
|
884
|
+
}
|
|
885
|
+
|
|
886
|
+
/**
|
|
887
|
+
* Handle detection of a duplicate attestation (equivocation).
|
|
888
|
+
* Emits a slash event when an attester signs attestations for different proposals at the same slot.
|
|
889
|
+
*/
|
|
890
|
+
private handleDuplicateAttestation(info: DuplicateAttestationInfo): void {
|
|
891
|
+
const { slot, attester } = info;
|
|
892
|
+
|
|
893
|
+
this.log.warn(`Triggering slash event for duplicate attestation from ${attester.toString()} at slot ${slot}`, {
|
|
894
|
+
attester: attester.toString(),
|
|
895
|
+
slot,
|
|
896
|
+
});
|
|
897
|
+
|
|
898
|
+
this.emit(WANT_TO_SLASH_EVENT, [
|
|
899
|
+
{
|
|
900
|
+
validator: attester,
|
|
901
|
+
amount: this.config.slashDuplicateAttestationPenalty,
|
|
902
|
+
offenseType: OffenseType.DUPLICATE_ATTESTATION,
|
|
903
|
+
epochOrSlot: BigInt(slot),
|
|
904
|
+
},
|
|
905
|
+
]);
|
|
906
|
+
}
|
|
907
|
+
|
|
735
908
|
async createBlockProposal(
|
|
736
909
|
blockHeader: BlockHeader,
|
|
737
910
|
indexWithinCheckpoint: IndexWithinCheckpoint,
|
|
@@ -739,13 +912,21 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
739
912
|
archive: Fr,
|
|
740
913
|
txs: Tx[],
|
|
741
914
|
proposerAddress: EthAddress | undefined,
|
|
742
|
-
options: BlockProposalOptions,
|
|
915
|
+
options: BlockProposalOptions = {},
|
|
743
916
|
): Promise<BlockProposal> {
|
|
744
|
-
//
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
917
|
+
// Validate that we're not creating a proposal for an older or equal position
|
|
918
|
+
if (this.lastProposedBlock) {
|
|
919
|
+
const lastSlot = this.lastProposedBlock.slotNumber;
|
|
920
|
+
const lastIndex = this.lastProposedBlock.indexWithinCheckpoint;
|
|
921
|
+
const newSlot = blockHeader.globalVariables.slotNumber;
|
|
922
|
+
|
|
923
|
+
if (newSlot < lastSlot || (newSlot === lastSlot && indexWithinCheckpoint <= lastIndex)) {
|
|
924
|
+
throw new Error(
|
|
925
|
+
`Cannot create block proposal for slot ${newSlot} index ${indexWithinCheckpoint}: ` +
|
|
926
|
+
`already proposed block for slot ${lastSlot} index ${lastIndex}`,
|
|
927
|
+
);
|
|
928
|
+
}
|
|
929
|
+
}
|
|
749
930
|
|
|
750
931
|
this.log.info(
|
|
751
932
|
`Assembling block proposal for block ${blockHeader.globalVariables.blockNumber} slot ${blockHeader.globalVariables.slotNumber}`,
|
|
@@ -762,25 +943,42 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
762
943
|
broadcastInvalidBlockProposal: this.config.broadcastInvalidBlockProposal,
|
|
763
944
|
},
|
|
764
945
|
);
|
|
765
|
-
this.
|
|
946
|
+
this.lastProposedBlock = newProposal;
|
|
766
947
|
return newProposal;
|
|
767
948
|
}
|
|
768
949
|
|
|
769
950
|
async createCheckpointProposal(
|
|
770
951
|
checkpointHeader: CheckpointHeader,
|
|
771
952
|
archive: Fr,
|
|
953
|
+
feeAssetPriceModifier: bigint,
|
|
772
954
|
lastBlockInfo: CreateCheckpointProposalLastBlockData | undefined,
|
|
773
955
|
proposerAddress: EthAddress | undefined,
|
|
774
|
-
options: CheckpointProposalOptions,
|
|
956
|
+
options: CheckpointProposalOptions = {},
|
|
775
957
|
): Promise<CheckpointProposal> {
|
|
958
|
+
// Validate that we're not creating a proposal for an older or equal slot
|
|
959
|
+
if (this.lastProposedCheckpoint) {
|
|
960
|
+
const lastSlot = this.lastProposedCheckpoint.slotNumber;
|
|
961
|
+
const newSlot = checkpointHeader.slotNumber;
|
|
962
|
+
|
|
963
|
+
if (newSlot <= lastSlot) {
|
|
964
|
+
throw new Error(
|
|
965
|
+
`Cannot create checkpoint proposal for slot ${newSlot}: ` +
|
|
966
|
+
`already proposed checkpoint for slot ${lastSlot}`,
|
|
967
|
+
);
|
|
968
|
+
}
|
|
969
|
+
}
|
|
970
|
+
|
|
776
971
|
this.log.info(`Assembling checkpoint proposal for slot ${checkpointHeader.slotNumber}`);
|
|
777
|
-
|
|
972
|
+
const newProposal = await this.validationService.createCheckpointProposal(
|
|
778
973
|
checkpointHeader,
|
|
779
974
|
archive,
|
|
975
|
+
feeAssetPriceModifier,
|
|
780
976
|
lastBlockInfo,
|
|
781
977
|
proposerAddress,
|
|
782
978
|
options,
|
|
783
979
|
);
|
|
980
|
+
this.lastProposedCheckpoint = newProposal;
|
|
981
|
+
return newProposal;
|
|
784
982
|
}
|
|
785
983
|
|
|
786
984
|
async broadcastBlockProposal(proposal: BlockProposal): Promise<void> {
|
|
@@ -802,6 +1000,10 @@ export class ValidatorClient extends (EventEmitter as new () => WatcherEmitter)
|
|
|
802
1000
|
this.log.debug(`Collecting ${inCommittee.length} self-attestations for slot ${slot}`, { inCommittee });
|
|
803
1001
|
const attestations = await this.createCheckpointAttestationsFromProposal(proposal, inCommittee);
|
|
804
1002
|
|
|
1003
|
+
if (!attestations) {
|
|
1004
|
+
return [];
|
|
1005
|
+
}
|
|
1006
|
+
|
|
805
1007
|
// We broadcast our own attestations to our peers so, in case our block does not get mined on L1,
|
|
806
1008
|
// other nodes can see that our validators did attest to this block proposal, and do not slash us
|
|
807
1009
|
// 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,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"}
|