@aztec/sequencer-client 0.0.1-commit.2ed92850 → 0.0.1-commit.343b43af6
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/client/sequencer-client.d.ts +23 -7
- package/dest/client/sequencer-client.d.ts.map +1 -1
- package/dest/client/sequencer-client.js +99 -16
- package/dest/config.d.ts +24 -6
- package/dest/config.d.ts.map +1 -1
- package/dest/config.js +40 -28
- package/dest/global_variable_builder/global_builder.d.ts +2 -4
- package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
- package/dest/publisher/config.d.ts +35 -17
- package/dest/publisher/config.d.ts.map +1 -1
- package/dest/publisher/config.js +106 -42
- package/dest/publisher/index.d.ts +2 -1
- package/dest/publisher/index.d.ts.map +1 -1
- package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
- package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
- package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
- package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
- package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
- package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
- package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
- package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
- package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
- package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
- package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
- package/dest/publisher/l1_tx_failed_store/index.js +2 -0
- package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
- package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
- package/dest/publisher/sequencer-publisher-factory.js +27 -2
- package/dest/publisher/sequencer-publisher-metrics.d.ts +1 -1
- package/dest/publisher/sequencer-publisher-metrics.d.ts.map +1 -1
- package/dest/publisher/sequencer-publisher-metrics.js +12 -4
- package/dest/publisher/sequencer-publisher.d.ts +26 -8
- package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
- package/dest/publisher/sequencer-publisher.js +338 -48
- package/dest/sequencer/checkpoint_proposal_job.d.ts +31 -10
- package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
- package/dest/sequencer/checkpoint_proposal_job.js +177 -97
- package/dest/sequencer/metrics.d.ts +17 -5
- package/dest/sequencer/metrics.d.ts.map +1 -1
- package/dest/sequencer/metrics.js +111 -30
- package/dest/sequencer/sequencer.d.ts +26 -13
- package/dest/sequencer/sequencer.d.ts.map +1 -1
- package/dest/sequencer/sequencer.js +42 -41
- package/dest/sequencer/timetable.d.ts +4 -6
- package/dest/sequencer/timetable.d.ts.map +1 -1
- package/dest/sequencer/timetable.js +7 -11
- package/dest/sequencer/types.d.ts +2 -2
- package/dest/sequencer/types.d.ts.map +1 -1
- package/dest/test/index.d.ts +3 -5
- package/dest/test/index.d.ts.map +1 -1
- package/dest/test/mock_checkpoint_builder.d.ts +10 -10
- package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
- package/dest/test/mock_checkpoint_builder.js +45 -36
- package/dest/test/utils.d.ts +3 -3
- package/dest/test/utils.d.ts.map +1 -1
- package/dest/test/utils.js +5 -4
- package/package.json +28 -28
- package/src/client/sequencer-client.ts +135 -18
- package/src/config.ts +54 -38
- package/src/global_variable_builder/global_builder.ts +1 -1
- package/src/publisher/config.ts +121 -43
- package/src/publisher/index.ts +3 -0
- package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
- package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
- package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
- package/src/publisher/l1_tx_failed_store/index.ts +3 -0
- package/src/publisher/sequencer-publisher-factory.ts +38 -6
- package/src/publisher/sequencer-publisher-metrics.ts +7 -3
- package/src/publisher/sequencer-publisher.ts +333 -60
- package/src/sequencer/checkpoint_proposal_job.ts +236 -122
- package/src/sequencer/metrics.ts +124 -32
- package/src/sequencer/sequencer.ts +53 -47
- package/src/sequencer/timetable.ts +13 -12
- package/src/sequencer/types.ts +1 -1
- package/src/test/index.ts +2 -4
- package/src/test/mock_checkpoint_builder.ts +62 -50
- package/src/test/utils.ts +5 -2
|
@@ -1,16 +1,25 @@
|
|
|
1
|
-
import { NUM_CHECKPOINT_END_MARKER_FIELDS, getNumBlockEndBlobFields } from '@aztec/blob-lib/encoding';
|
|
2
|
-
import { BLOBS_PER_CHECKPOINT, FIELDS_PER_BLOB } from '@aztec/constants';
|
|
3
1
|
import type { EpochCache } from '@aztec/epoch-cache';
|
|
4
|
-
import {
|
|
2
|
+
import {
|
|
3
|
+
BlockNumber,
|
|
4
|
+
CheckpointNumber,
|
|
5
|
+
EpochNumber,
|
|
6
|
+
IndexWithinCheckpoint,
|
|
7
|
+
SlotNumber,
|
|
8
|
+
} from '@aztec/foundation/branded-types';
|
|
5
9
|
import { randomInt } from '@aztec/foundation/crypto/random';
|
|
10
|
+
import {
|
|
11
|
+
flipSignature,
|
|
12
|
+
generateRecoverableSignature,
|
|
13
|
+
generateUnrecoverableSignature,
|
|
14
|
+
} from '@aztec/foundation/crypto/secp256k1-signer';
|
|
6
15
|
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
7
16
|
import { EthAddress } from '@aztec/foundation/eth-address';
|
|
8
17
|
import { Signature } from '@aztec/foundation/eth-signature';
|
|
9
18
|
import { filter } from '@aztec/foundation/iterator';
|
|
10
|
-
import type
|
|
19
|
+
import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
|
|
11
20
|
import { sleep, sleepUntil } from '@aztec/foundation/sleep';
|
|
12
21
|
import { type DateProvider, Timer } from '@aztec/foundation/timer';
|
|
13
|
-
import { type TypedEventEmitter, unfreeze } from '@aztec/foundation/types';
|
|
22
|
+
import { type TypedEventEmitter, isErrorClass, unfreeze } from '@aztec/foundation/types';
|
|
14
23
|
import type { P2P } from '@aztec/p2p';
|
|
15
24
|
import type { SlasherClientInterface } from '@aztec/slasher';
|
|
16
25
|
import {
|
|
@@ -21,17 +30,18 @@ import {
|
|
|
21
30
|
type L2BlockSource,
|
|
22
31
|
MaliciousCommitteeAttestationsAndSigners,
|
|
23
32
|
} from '@aztec/stdlib/block';
|
|
24
|
-
import type
|
|
33
|
+
import { type Checkpoint, validateCheckpoint } from '@aztec/stdlib/checkpoint';
|
|
25
34
|
import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
|
|
26
35
|
import { Gas } from '@aztec/stdlib/gas';
|
|
27
|
-
import
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
36
|
+
import {
|
|
37
|
+
NoValidTxsError,
|
|
38
|
+
type PublicProcessorLimits,
|
|
39
|
+
type ResolvedSequencerConfig,
|
|
40
|
+
type WorldStateSynchronizer,
|
|
31
41
|
} from '@aztec/stdlib/interfaces/server';
|
|
32
42
|
import { type L1ToL2MessageSource, computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
|
|
33
43
|
import type { BlockProposalOptions, CheckpointProposal, CheckpointProposalOptions } from '@aztec/stdlib/p2p';
|
|
34
|
-
import { orderAttestations } from '@aztec/stdlib/p2p';
|
|
44
|
+
import { orderAttestations, trimAttestations } from '@aztec/stdlib/p2p';
|
|
35
45
|
import type { L2BlockBuiltStats } from '@aztec/stdlib/stats';
|
|
36
46
|
import { type FailedTx, Tx } from '@aztec/stdlib/tx';
|
|
37
47
|
import { AttestationTimeoutError } from '@aztec/stdlib/validators';
|
|
@@ -59,6 +69,8 @@ const TXS_POLLING_MS = 500;
|
|
|
59
69
|
* the Sequencer once the check for being the proposer for the slot has succeeded.
|
|
60
70
|
*/
|
|
61
71
|
export class CheckpointProposalJob implements Traceable {
|
|
72
|
+
protected readonly log: Logger;
|
|
73
|
+
|
|
62
74
|
constructor(
|
|
63
75
|
private readonly epoch: EpochNumber,
|
|
64
76
|
private readonly slot: SlotNumber,
|
|
@@ -86,9 +98,11 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
86
98
|
private readonly metrics: SequencerMetrics,
|
|
87
99
|
private readonly eventEmitter: TypedEventEmitter<SequencerEvents>,
|
|
88
100
|
private readonly setStateFn: (state: SequencerState, slot?: SlotNumber) => void,
|
|
89
|
-
protected readonly log: Logger,
|
|
90
101
|
public readonly tracer: Tracer,
|
|
91
|
-
|
|
102
|
+
bindings?: LoggerBindings,
|
|
103
|
+
) {
|
|
104
|
+
this.log = createLogger('sequencer:checkpoint-proposal', { ...bindings, instanceId: `slot-${slot}` });
|
|
105
|
+
}
|
|
92
106
|
|
|
93
107
|
/**
|
|
94
108
|
* Executes the checkpoint proposal job.
|
|
@@ -118,7 +132,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
118
132
|
await Promise.all(votesPromises);
|
|
119
133
|
|
|
120
134
|
if (checkpoint) {
|
|
121
|
-
this.metrics.
|
|
135
|
+
this.metrics.recordCheckpointProposalSuccess();
|
|
122
136
|
}
|
|
123
137
|
|
|
124
138
|
// Do not post anything to L1 if we are fishermen, but do perform L1 fee analysis
|
|
@@ -175,21 +189,25 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
175
189
|
const inHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
|
|
176
190
|
|
|
177
191
|
// Collect the out hashes of all the checkpoints before this one in the same epoch
|
|
178
|
-
const
|
|
179
|
-
c => c.
|
|
180
|
-
|
|
181
|
-
|
|
192
|
+
const previousCheckpointOutHashes = (await this.l2BlockSource.getCheckpointsDataForEpoch(this.epoch))
|
|
193
|
+
.filter(c => c.checkpointNumber < this.checkpointNumber)
|
|
194
|
+
.map(c => c.checkpointOutHash);
|
|
195
|
+
|
|
196
|
+
// Get the fee asset price modifier from the oracle
|
|
197
|
+
const feeAssetPriceModifier = await this.publisher.getFeeAssetPriceModifier();
|
|
182
198
|
|
|
183
199
|
// Create a long-lived forked world state for the checkpoint builder
|
|
184
|
-
using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
|
|
200
|
+
await using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
|
|
185
201
|
|
|
186
202
|
// Create checkpoint builder for the entire slot
|
|
187
203
|
const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(
|
|
188
204
|
this.checkpointNumber,
|
|
189
205
|
checkpointGlobalVariables,
|
|
206
|
+
feeAssetPriceModifier,
|
|
190
207
|
l1ToL2Messages,
|
|
191
208
|
previousCheckpointOutHashes,
|
|
192
209
|
fork,
|
|
210
|
+
this.log.getBindings(),
|
|
193
211
|
);
|
|
194
212
|
|
|
195
213
|
// Options for the validator client when creating block and checkpoint proposals
|
|
@@ -205,6 +223,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
205
223
|
|
|
206
224
|
let blocksInCheckpoint: L2Block[] = [];
|
|
207
225
|
let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
|
|
226
|
+
const checkpointBuildTimer = new Timer();
|
|
208
227
|
|
|
209
228
|
try {
|
|
210
229
|
// Main loop: build blocks for the checkpoint
|
|
@@ -220,19 +239,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
220
239
|
// These errors are expected in HA mode, so we yield and let another HA node handle the slot
|
|
221
240
|
// The only distinction between the 2 errors is SlashingProtectionError throws when the payload is different,
|
|
222
241
|
// which is normal for block building (may have picked different txs)
|
|
223
|
-
if (err
|
|
224
|
-
this.log.info(`Checkpoint proposal for slot ${this.slot} already signed by another HA node, yielding`, {
|
|
225
|
-
slot: this.slot,
|
|
226
|
-
signedByNode: err.signedByNode,
|
|
227
|
-
});
|
|
228
|
-
return undefined;
|
|
229
|
-
}
|
|
230
|
-
if (err instanceof SlashingProtectionError) {
|
|
231
|
-
this.log.info(`Checkpoint proposal for slot ${this.slot} blocked by slashing protection, yielding`, {
|
|
232
|
-
slot: this.slot,
|
|
233
|
-
existingMessageHash: err.existingMessageHash,
|
|
234
|
-
attemptedMessageHash: err.attemptedMessageHash,
|
|
235
|
-
});
|
|
242
|
+
if (this.handleHASigningError(err, 'Block proposal')) {
|
|
236
243
|
return undefined;
|
|
237
244
|
}
|
|
238
245
|
throw err;
|
|
@@ -244,11 +251,44 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
244
251
|
return undefined;
|
|
245
252
|
}
|
|
246
253
|
|
|
254
|
+
const minBlocksForCheckpoint = this.config.minBlocksForCheckpoint;
|
|
255
|
+
if (minBlocksForCheckpoint !== undefined && blocksInCheckpoint.length < minBlocksForCheckpoint) {
|
|
256
|
+
this.log.warn(
|
|
257
|
+
`Checkpoint has fewer blocks than minimum (${blocksInCheckpoint.length} < ${minBlocksForCheckpoint}), skipping proposal`,
|
|
258
|
+
{ slot: this.slot, blocksBuilt: blocksInCheckpoint.length, minBlocksForCheckpoint },
|
|
259
|
+
);
|
|
260
|
+
return undefined;
|
|
261
|
+
}
|
|
262
|
+
|
|
247
263
|
// Assemble and broadcast the checkpoint proposal, including the last block that was not
|
|
248
264
|
// broadcasted yet, and wait to collect the committee attestations.
|
|
249
265
|
this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
|
|
250
266
|
const checkpoint = await checkpointBuilder.completeCheckpoint();
|
|
251
267
|
|
|
268
|
+
// Final validation round for the checkpoint before we propose it, just for safety
|
|
269
|
+
try {
|
|
270
|
+
validateCheckpoint(checkpoint, {
|
|
271
|
+
rollupManaLimit: this.l1Constants.rollupManaLimit,
|
|
272
|
+
maxL2BlockGas: this.config.maxL2BlockGas,
|
|
273
|
+
maxDABlockGas: this.config.maxDABlockGas,
|
|
274
|
+
maxTxsPerBlock: this.config.maxTxsPerBlock,
|
|
275
|
+
maxTxsPerCheckpoint: this.config.maxTxsPerCheckpoint,
|
|
276
|
+
});
|
|
277
|
+
} catch (err) {
|
|
278
|
+
this.log.error(`Built an invalid checkpoint at slot ${this.slot} (skipping proposal)`, err, {
|
|
279
|
+
checkpoint: checkpoint.header.toInspect(),
|
|
280
|
+
});
|
|
281
|
+
return undefined;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
// Record checkpoint-level build metrics
|
|
285
|
+
this.metrics.recordCheckpointBuild(
|
|
286
|
+
checkpointBuildTimer.ms(),
|
|
287
|
+
blocksInCheckpoint.length,
|
|
288
|
+
checkpoint.getStats().txCount,
|
|
289
|
+
Number(checkpoint.header.totalManaUsed.toBigInt()),
|
|
290
|
+
);
|
|
291
|
+
|
|
252
292
|
// Do not collect attestations nor publish to L1 in fisherman mode
|
|
253
293
|
if (this.config.fishermanMode) {
|
|
254
294
|
this.log.info(
|
|
@@ -275,6 +315,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
275
315
|
const proposal = await this.validatorClient.createCheckpointProposal(
|
|
276
316
|
checkpoint.header,
|
|
277
317
|
checkpoint.archive.root,
|
|
318
|
+
feeAssetPriceModifier,
|
|
278
319
|
lastBlock,
|
|
279
320
|
this.proposer,
|
|
280
321
|
checkpointProposalOptions,
|
|
@@ -301,20 +342,8 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
301
342
|
);
|
|
302
343
|
} catch (err) {
|
|
303
344
|
// We shouldn't really get here since we yield to another HA node
|
|
304
|
-
// as soon as we see these errors when creating block proposals.
|
|
305
|
-
if (err
|
|
306
|
-
this.log.info(`Attestations signature for slot ${this.slot} already signed by another HA node, yielding`, {
|
|
307
|
-
slot: this.slot,
|
|
308
|
-
signedByNode: err.signedByNode,
|
|
309
|
-
});
|
|
310
|
-
return undefined;
|
|
311
|
-
}
|
|
312
|
-
if (err instanceof SlashingProtectionError) {
|
|
313
|
-
this.log.info(`Attestations signature for slot ${this.slot} blocked by slashing protection, yielding`, {
|
|
314
|
-
slot: this.slot,
|
|
315
|
-
existingMessageHash: err.existingMessageHash,
|
|
316
|
-
attemptedMessageHash: err.attemptedMessageHash,
|
|
317
|
-
});
|
|
345
|
+
// as soon as we see these errors when creating block or checkpoint proposals.
|
|
346
|
+
if (this.handleHASigningError(err, 'Attestations signature')) {
|
|
318
347
|
return undefined;
|
|
319
348
|
}
|
|
320
349
|
throw err;
|
|
@@ -325,6 +354,21 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
325
354
|
const aztecSlotDuration = this.l1Constants.slotDuration;
|
|
326
355
|
const slotStartBuildTimestamp = this.getSlotStartBuildTimestamp();
|
|
327
356
|
const txTimeoutAt = new Date((slotStartBuildTimestamp + aztecSlotDuration) * 1000);
|
|
357
|
+
|
|
358
|
+
// If we have been configured to potentially skip publishing checkpoint then roll the dice here
|
|
359
|
+
if (
|
|
360
|
+
this.config.skipPublishingCheckpointsPercent !== undefined &&
|
|
361
|
+
this.config.skipPublishingCheckpointsPercent > 0
|
|
362
|
+
) {
|
|
363
|
+
const result = Math.max(0, randomInt(100));
|
|
364
|
+
if (result < this.config.skipPublishingCheckpointsPercent) {
|
|
365
|
+
this.log.warn(
|
|
366
|
+
`Skipping publishing proposal for checkpoint ${checkpoint.number}. Configured percentage: ${this.config.skipPublishingCheckpointsPercent}, generated value: ${result}`,
|
|
367
|
+
);
|
|
368
|
+
return checkpoint;
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
|
|
328
372
|
await this.publisher.enqueueProposeCheckpoint(checkpoint, attestations, attestationsSignature, {
|
|
329
373
|
txTimeoutAt,
|
|
330
374
|
forcePendingCheckpointNumber: this.invalidateCheckpoint?.forcePendingCheckpointNumber,
|
|
@@ -359,15 +403,12 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
359
403
|
const txHashesAlreadyIncluded = new Set<string>();
|
|
360
404
|
const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
|
|
361
405
|
|
|
362
|
-
// Remaining blob fields available for blocks (checkpoint end marker already subtracted)
|
|
363
|
-
let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
|
|
364
|
-
|
|
365
406
|
// Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
|
|
366
407
|
let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
|
|
367
408
|
|
|
368
409
|
while (true) {
|
|
369
410
|
const blocksBuilt = blocksInCheckpoint.length;
|
|
370
|
-
const indexWithinCheckpoint = blocksBuilt;
|
|
411
|
+
const indexWithinCheckpoint = IndexWithinCheckpoint(blocksBuilt);
|
|
371
412
|
const blockNumber = BlockNumber(initialBlockNumber + blocksBuilt);
|
|
372
413
|
|
|
373
414
|
const secondsIntoSlot = this.getSecondsIntoSlot();
|
|
@@ -394,9 +435,9 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
394
435
|
blockNumber,
|
|
395
436
|
indexWithinCheckpoint,
|
|
396
437
|
txHashesAlreadyIncluded,
|
|
397
|
-
remainingBlobFields,
|
|
398
438
|
});
|
|
399
439
|
|
|
440
|
+
// TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
|
|
400
441
|
if (!buildResult && timingInfo.isLastBlock) {
|
|
401
442
|
// If no block was produced due to not enough txs and this was the last subslot, exit
|
|
402
443
|
break;
|
|
@@ -419,12 +460,9 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
419
460
|
break;
|
|
420
461
|
}
|
|
421
462
|
|
|
422
|
-
const { block, usedTxs
|
|
463
|
+
const { block, usedTxs } = buildResult;
|
|
423
464
|
blocksInCheckpoint.push(block);
|
|
424
465
|
|
|
425
|
-
// Update remaining blob fields for the next block
|
|
426
|
-
remainingBlobFields = newRemainingBlobFields;
|
|
427
|
-
|
|
428
466
|
// Sync the proposed block to the archiver to make it available
|
|
429
467
|
// Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
|
|
430
468
|
// Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
|
|
@@ -483,27 +521,19 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
483
521
|
|
|
484
522
|
/** Builds a single block. Called from the main block building loop. */
|
|
485
523
|
@trackSpan('CheckpointProposalJob.buildSingleBlock')
|
|
486
|
-
|
|
524
|
+
protected async buildSingleBlock(
|
|
487
525
|
checkpointBuilder: CheckpointBuilder,
|
|
488
526
|
opts: {
|
|
489
527
|
forceCreate?: boolean;
|
|
490
528
|
blockTimestamp: bigint;
|
|
491
529
|
blockNumber: BlockNumber;
|
|
492
|
-
indexWithinCheckpoint:
|
|
530
|
+
indexWithinCheckpoint: IndexWithinCheckpoint;
|
|
493
531
|
buildDeadline: Date | undefined;
|
|
494
532
|
txHashesAlreadyIncluded: Set<string>;
|
|
495
|
-
remainingBlobFields: number;
|
|
496
533
|
},
|
|
497
|
-
): Promise<{ block: L2Block; usedTxs: Tx[]
|
|
498
|
-
const {
|
|
499
|
-
|
|
500
|
-
forceCreate,
|
|
501
|
-
blockNumber,
|
|
502
|
-
indexWithinCheckpoint,
|
|
503
|
-
buildDeadline,
|
|
504
|
-
txHashesAlreadyIncluded,
|
|
505
|
-
remainingBlobFields,
|
|
506
|
-
} = opts;
|
|
534
|
+
): Promise<{ block: L2Block; usedTxs: Tx[] } | { error: Error } | undefined> {
|
|
535
|
+
const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } =
|
|
536
|
+
opts;
|
|
507
537
|
|
|
508
538
|
this.log.verbose(
|
|
509
539
|
`Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`,
|
|
@@ -512,8 +542,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
512
542
|
|
|
513
543
|
try {
|
|
514
544
|
// Wait until we have enough txs to build the block
|
|
515
|
-
const minTxs = this.
|
|
516
|
-
const { availableTxs, canStartBuilding } = await this.waitForMinTxs(opts);
|
|
545
|
+
const { availableTxs, canStartBuilding, minTxs } = await this.waitForMinTxs(opts);
|
|
517
546
|
if (!canStartBuilding) {
|
|
518
547
|
this.log.warn(
|
|
519
548
|
`Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (got ${availableTxs} txs but needs ${minTxs})`,
|
|
@@ -527,7 +556,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
527
556
|
// Create iterator to pending txs. We filter out txs already included in previous blocks in the checkpoint
|
|
528
557
|
// just in case p2p failed to sync the provisional block and didn't get to remove those txs from the mempool yet.
|
|
529
558
|
const pendingTxs = filter(
|
|
530
|
-
this.p2pClient.
|
|
559
|
+
this.p2pClient.iterateEligiblePendingTxs(),
|
|
531
560
|
tx => !txHashesAlreadyIncluded.has(tx.txHash.toString()),
|
|
532
561
|
);
|
|
533
562
|
|
|
@@ -537,64 +566,57 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
537
566
|
);
|
|
538
567
|
this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
|
|
539
568
|
|
|
540
|
-
//
|
|
541
|
-
|
|
542
|
-
const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
|
|
543
|
-
|
|
569
|
+
// Per-block limits derived at startup by computeBlockLimits(), further capped
|
|
570
|
+
// by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
|
|
544
571
|
const blockBuilderOptions: PublicProcessorLimits = {
|
|
545
572
|
maxTransactions: this.config.maxTxsPerBlock,
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
573
|
+
maxBlockGas:
|
|
574
|
+
this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined
|
|
575
|
+
? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity)
|
|
576
|
+
: undefined,
|
|
549
577
|
deadline: buildDeadline,
|
|
578
|
+
isBuildingProposal: true,
|
|
550
579
|
};
|
|
551
580
|
|
|
552
581
|
// Actually build the block by executing txs
|
|
553
|
-
const
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
usedTxs,
|
|
561
|
-
failedTxs,
|
|
562
|
-
usedTxBlobFields,
|
|
563
|
-
} = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
|
|
564
|
-
const blockBuildDuration = workTimer.ms();
|
|
582
|
+
const buildResult = await this.buildSingleBlockWithCheckpointBuilder(
|
|
583
|
+
checkpointBuilder,
|
|
584
|
+
pendingTxs,
|
|
585
|
+
blockNumber,
|
|
586
|
+
blockTimestamp,
|
|
587
|
+
blockBuilderOptions,
|
|
588
|
+
);
|
|
565
589
|
|
|
566
590
|
// If any txs failed during execution, drop them from the mempool so we don't pick them up again
|
|
567
|
-
await this.dropFailedTxsFromP2P(failedTxs);
|
|
591
|
+
await this.dropFailedTxsFromP2P(buildResult.failedTxs);
|
|
568
592
|
|
|
569
593
|
// Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
|
|
570
594
|
// too long, then we may not get to minTxsPerBlock after executing public functions.
|
|
571
595
|
const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
|
|
572
|
-
|
|
596
|
+
const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
|
|
597
|
+
if (buildResult.status === 'no-valid-txs' || (!forceCreate && numTxs < minValidTxs)) {
|
|
573
598
|
this.log.warn(
|
|
574
|
-
`Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed
|
|
575
|
-
{ slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint },
|
|
599
|
+
`Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`,
|
|
600
|
+
{ slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint, minValidTxs, buildResult: buildResult.status },
|
|
576
601
|
);
|
|
577
|
-
this.eventEmitter.emit('block-
|
|
578
|
-
minTxs: minValidTxs,
|
|
579
|
-
availableTxs: numTxs,
|
|
580
|
-
slot: this.slot,
|
|
581
|
-
});
|
|
602
|
+
this.eventEmitter.emit('block-build-failed', { reason: `Insufficient valid txs`, slot: this.slot });
|
|
582
603
|
this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
|
|
583
604
|
return undefined;
|
|
584
605
|
}
|
|
585
606
|
|
|
586
607
|
// Block creation succeeded, emit stats and metrics
|
|
608
|
+
const { block, publicProcessorDuration, usedTxs, blockBuildDuration } = buildResult;
|
|
609
|
+
|
|
587
610
|
const blockStats = {
|
|
588
611
|
eventName: 'l2-block-built',
|
|
589
612
|
duration: blockBuildDuration,
|
|
590
613
|
publicProcessDuration: publicProcessorDuration,
|
|
591
|
-
rollupCircuitsDuration: blockBuildingTimer.ms(),
|
|
592
614
|
...block.getStats(),
|
|
593
615
|
} satisfies L2BlockBuiltStats;
|
|
594
616
|
|
|
595
617
|
const blockHash = await block.hash();
|
|
596
618
|
const txHashes = block.body.txEffects.map(tx => tx.txHash);
|
|
597
|
-
const manaPerSec =
|
|
619
|
+
const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
|
|
598
620
|
|
|
599
621
|
this.log.info(
|
|
600
622
|
`Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`,
|
|
@@ -602,9 +624,9 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
602
624
|
);
|
|
603
625
|
|
|
604
626
|
this.eventEmitter.emit('block-proposed', { blockNumber: block.number, slot: this.slot });
|
|
605
|
-
this.metrics.recordBuiltBlock(blockBuildDuration,
|
|
627
|
+
this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
|
|
606
628
|
|
|
607
|
-
return { block, usedTxs
|
|
629
|
+
return { block, usedTxs };
|
|
608
630
|
} catch (err: any) {
|
|
609
631
|
this.eventEmitter.emit('block-build-failed', { reason: err.message, slot: this.slot });
|
|
610
632
|
this.log.error(`Error building block`, err, { blockNumber, slot: this.slot });
|
|
@@ -614,17 +636,40 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
614
636
|
}
|
|
615
637
|
}
|
|
616
638
|
|
|
639
|
+
/** Uses the checkpoint builder to build a block, catching specific txs */
|
|
640
|
+
private async buildSingleBlockWithCheckpointBuilder(
|
|
641
|
+
checkpointBuilder: CheckpointBuilder,
|
|
642
|
+
pendingTxs: AsyncIterable<Tx>,
|
|
643
|
+
blockNumber: BlockNumber,
|
|
644
|
+
blockTimestamp: bigint,
|
|
645
|
+
blockBuilderOptions: PublicProcessorLimits,
|
|
646
|
+
) {
|
|
647
|
+
try {
|
|
648
|
+
const workTimer = new Timer();
|
|
649
|
+
const result = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
|
|
650
|
+
const blockBuildDuration = workTimer.ms();
|
|
651
|
+
return { ...result, blockBuildDuration, status: 'success' as const };
|
|
652
|
+
} catch (err: unknown) {
|
|
653
|
+
if (isErrorClass(err, NoValidTxsError)) {
|
|
654
|
+
return { failedTxs: err.failedTxs, status: 'no-valid-txs' as const };
|
|
655
|
+
}
|
|
656
|
+
throw err;
|
|
657
|
+
}
|
|
658
|
+
}
|
|
659
|
+
|
|
617
660
|
/** Waits until minTxs are available on the pool for building a block. */
|
|
618
661
|
@trackSpan('CheckpointProposalJob.waitForMinTxs')
|
|
619
662
|
private async waitForMinTxs(opts: {
|
|
620
663
|
forceCreate?: boolean;
|
|
621
664
|
blockNumber: BlockNumber;
|
|
622
|
-
indexWithinCheckpoint:
|
|
665
|
+
indexWithinCheckpoint: IndexWithinCheckpoint;
|
|
623
666
|
buildDeadline: Date | undefined;
|
|
624
|
-
}): Promise<{ canStartBuilding: boolean; availableTxs: number }> {
|
|
625
|
-
const minTxs = this.config.minTxsPerBlock;
|
|
667
|
+
}): Promise<{ canStartBuilding: boolean; availableTxs: number; minTxs: number }> {
|
|
626
668
|
const { indexWithinCheckpoint, blockNumber, buildDeadline, forceCreate } = opts;
|
|
627
669
|
|
|
670
|
+
// We only allow a block with 0 txs in the first block of the checkpoint
|
|
671
|
+
const minTxs = indexWithinCheckpoint > 0 && this.config.minTxsPerBlock === 0 ? 1 : this.config.minTxsPerBlock;
|
|
672
|
+
|
|
628
673
|
// Deadline is undefined if we are not enforcing the timetable, meaning we'll exit immediately when out of time
|
|
629
674
|
const startBuildingDeadline = buildDeadline
|
|
630
675
|
? new Date(buildDeadline.getTime() - this.timetable.minExecutionTime * 1000)
|
|
@@ -636,7 +681,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
636
681
|
// If we're past deadline, or we have no deadline, give up
|
|
637
682
|
const now = this.dateProvider.nowAsDate();
|
|
638
683
|
if (startBuildingDeadline === undefined || now >= startBuildingDeadline) {
|
|
639
|
-
return { canStartBuilding: false, availableTxs
|
|
684
|
+
return { canStartBuilding: false, availableTxs, minTxs };
|
|
640
685
|
}
|
|
641
686
|
|
|
642
687
|
// Wait a bit before checking again
|
|
@@ -645,11 +690,11 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
645
690
|
`Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (have ${availableTxs} but need ${minTxs})`,
|
|
646
691
|
{ blockNumber, slot: this.slot, indexWithinCheckpoint },
|
|
647
692
|
);
|
|
648
|
-
await
|
|
693
|
+
await this.waitForTxsPollingInterval();
|
|
649
694
|
availableTxs = await this.p2pClient.getPendingTxCount();
|
|
650
695
|
}
|
|
651
696
|
|
|
652
|
-
return { canStartBuilding: true, availableTxs };
|
|
697
|
+
return { canStartBuilding: true, availableTxs, minTxs };
|
|
653
698
|
}
|
|
654
699
|
|
|
655
700
|
/**
|
|
@@ -686,7 +731,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
686
731
|
const attestationTimeAllowed = this.config.enforceTimeTable
|
|
687
732
|
? this.timetable.getMaxAllowedTime(SequencerState.PUBLISHING_CHECKPOINT)!
|
|
688
733
|
: this.l1Constants.slotDuration;
|
|
689
|
-
const attestationDeadline = new Date(this.
|
|
734
|
+
const attestationDeadline = new Date((this.getSlotStartBuildTimestamp() + attestationTimeAllowed) * 1000);
|
|
690
735
|
|
|
691
736
|
this.metrics.recordRequiredAttestations(numberOfRequiredAttestations, attestationTimeAllowed);
|
|
692
737
|
|
|
@@ -701,11 +746,28 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
701
746
|
|
|
702
747
|
collectedAttestationsCount = attestations.length;
|
|
703
748
|
|
|
749
|
+
// Trim attestations to minimum required to save L1 calldata gas
|
|
750
|
+
const localAddresses = this.validatorClient.getValidatorAddresses();
|
|
751
|
+
const trimmed = trimAttestations(
|
|
752
|
+
attestations,
|
|
753
|
+
numberOfRequiredAttestations,
|
|
754
|
+
this.attestorAddress,
|
|
755
|
+
localAddresses,
|
|
756
|
+
);
|
|
757
|
+
if (trimmed.length < attestations.length) {
|
|
758
|
+
this.log.debug(`Trimmed attestations from ${attestations.length} to ${trimmed.length} for L1 submission`);
|
|
759
|
+
}
|
|
760
|
+
|
|
704
761
|
// Rollup contract requires that the signatures are provided in the order of the committee
|
|
705
|
-
const sorted = orderAttestations(
|
|
762
|
+
const sorted = orderAttestations(trimmed, committee);
|
|
706
763
|
|
|
707
764
|
// Manipulate the attestations if we've been configured to do so
|
|
708
|
-
if (
|
|
765
|
+
if (
|
|
766
|
+
this.config.injectFakeAttestation ||
|
|
767
|
+
this.config.injectHighSValueAttestation ||
|
|
768
|
+
this.config.injectUnrecoverableSignatureAttestation ||
|
|
769
|
+
this.config.shuffleAttestationOrdering
|
|
770
|
+
) {
|
|
709
771
|
return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
|
|
710
772
|
}
|
|
711
773
|
|
|
@@ -734,7 +796,11 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
734
796
|
this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)),
|
|
735
797
|
);
|
|
736
798
|
|
|
737
|
-
if (
|
|
799
|
+
if (
|
|
800
|
+
this.config.injectFakeAttestation ||
|
|
801
|
+
this.config.injectHighSValueAttestation ||
|
|
802
|
+
this.config.injectUnrecoverableSignatureAttestation
|
|
803
|
+
) {
|
|
738
804
|
// Find non-empty attestations that are not from the proposer
|
|
739
805
|
const nonProposerIndices: number[] = [];
|
|
740
806
|
for (let i = 0; i < attestations.length; i++) {
|
|
@@ -744,8 +810,20 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
744
810
|
}
|
|
745
811
|
if (nonProposerIndices.length > 0) {
|
|
746
812
|
const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
|
|
747
|
-
this.
|
|
748
|
-
|
|
813
|
+
if (this.config.injectHighSValueAttestation) {
|
|
814
|
+
this.log.warn(
|
|
815
|
+
`Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
|
|
816
|
+
);
|
|
817
|
+
unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
|
|
818
|
+
} else if (this.config.injectUnrecoverableSignatureAttestation) {
|
|
819
|
+
this.log.warn(
|
|
820
|
+
`Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
|
|
821
|
+
);
|
|
822
|
+
unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
|
|
823
|
+
} else {
|
|
824
|
+
this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
|
|
825
|
+
unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
|
|
826
|
+
}
|
|
749
827
|
}
|
|
750
828
|
return new CommitteeAttestationsAndSigners(attestations);
|
|
751
829
|
}
|
|
@@ -754,11 +832,20 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
754
832
|
this.log.warn(`Shuffling attestation ordering in checkpoint for slot ${slotNumber} (proposer #${proposerIndex})`);
|
|
755
833
|
|
|
756
834
|
const shuffled = [...attestations];
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
835
|
+
|
|
836
|
+
// Find two non-proposer positions that both have non-empty signatures to swap.
|
|
837
|
+
// This ensures the bitmap doesn't change, so the MaliciousCommitteeAttestationsAndSigners
|
|
838
|
+
// signers array stays correctly aligned with L1's committee reconstruction.
|
|
839
|
+
const swappable: number[] = [];
|
|
840
|
+
for (let k = 0; k < shuffled.length; k++) {
|
|
841
|
+
if (!shuffled[k].signature.isEmpty() && k !== proposerIndex) {
|
|
842
|
+
swappable.push(k);
|
|
843
|
+
}
|
|
844
|
+
}
|
|
845
|
+
if (swappable.length >= 2) {
|
|
846
|
+
const [i, j] = [swappable[0], swappable[1]];
|
|
847
|
+
[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
|
|
848
|
+
}
|
|
762
849
|
|
|
763
850
|
const signers = new CommitteeAttestationsAndSigners(attestations).getSigners();
|
|
764
851
|
return new MaliciousCommitteeAttestationsAndSigners(shuffled, signers);
|
|
@@ -774,7 +861,7 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
774
861
|
const failedTxData = failedTxs.map(fail => fail.tx);
|
|
775
862
|
const failedTxHashes = failedTxData.map(tx => tx.getTxHash());
|
|
776
863
|
this.log.verbose(`Dropping failed txs ${failedTxHashes.join(', ')}`);
|
|
777
|
-
await this.p2pClient.
|
|
864
|
+
await this.p2pClient.handleFailedExecution(failedTxHashes);
|
|
778
865
|
}
|
|
779
866
|
|
|
780
867
|
/**
|
|
@@ -816,12 +903,34 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
816
903
|
slot: this.slot,
|
|
817
904
|
feeAnalysisId: feeAnalysis?.id,
|
|
818
905
|
});
|
|
819
|
-
this.metrics.
|
|
906
|
+
this.metrics.recordCheckpointProposalFailed('block_build_failed');
|
|
820
907
|
}
|
|
821
908
|
|
|
822
909
|
this.publisher.clearPendingRequests();
|
|
823
910
|
}
|
|
824
911
|
|
|
912
|
+
/**
|
|
913
|
+
* Helper to handle HA double-signing errors. Returns true if the error was handled (caller should yield).
|
|
914
|
+
*/
|
|
915
|
+
private handleHASigningError(err: any, errorContext: string): boolean {
|
|
916
|
+
if (err instanceof DutyAlreadySignedError) {
|
|
917
|
+
this.log.info(`${errorContext} for slot ${this.slot} already signed by another HA node, yielding`, {
|
|
918
|
+
slot: this.slot,
|
|
919
|
+
signedByNode: err.signedByNode,
|
|
920
|
+
});
|
|
921
|
+
return true;
|
|
922
|
+
}
|
|
923
|
+
if (err instanceof SlashingProtectionError) {
|
|
924
|
+
this.log.info(`${errorContext} for slot ${this.slot} blocked by slashing protection, yielding`, {
|
|
925
|
+
slot: this.slot,
|
|
926
|
+
existingMessageHash: err.existingMessageHash,
|
|
927
|
+
attemptedMessageHash: err.attemptedMessageHash,
|
|
928
|
+
});
|
|
929
|
+
return true;
|
|
930
|
+
}
|
|
931
|
+
return false;
|
|
932
|
+
}
|
|
933
|
+
|
|
825
934
|
/** Waits until a specific time within the current slot */
|
|
826
935
|
@trackSpan('CheckpointProposalJob.waitUntilTimeInSlot')
|
|
827
936
|
protected async waitUntilTimeInSlot(targetSecondsIntoSlot: number): Promise<void> {
|
|
@@ -830,6 +939,11 @@ export class CheckpointProposalJob implements Traceable {
|
|
|
830
939
|
await sleepUntil(new Date(targetTimestamp * 1000), this.dateProvider.nowAsDate());
|
|
831
940
|
}
|
|
832
941
|
|
|
942
|
+
/** Waits the polling interval for transactions. Extracted for test overriding. */
|
|
943
|
+
protected async waitForTxsPollingInterval(): Promise<void> {
|
|
944
|
+
await sleep(TXS_POLLING_MS);
|
|
945
|
+
}
|
|
946
|
+
|
|
833
947
|
private getSlotStartBuildTimestamp(): number {
|
|
834
948
|
return getSlotStartBuildTimestamp(this.slot, this.l1Constants);
|
|
835
949
|
}
|