@aztec/validator-client 0.0.1-commit.b655e406 → 0.0.1-commit.c2595eba
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 +282 -0
- package/dest/block_proposal_handler.d.ts +24 -13
- package/dest/block_proposal_handler.d.ts.map +1 -1
- package/dest/block_proposal_handler.js +349 -89
- package/dest/checkpoint_builder.d.ts +70 -0
- package/dest/checkpoint_builder.d.ts.map +1 -0
- package/dest/checkpoint_builder.js +167 -0
- package/dest/config.d.ts +1 -1
- package/dest/config.d.ts.map +1 -1
- package/dest/config.js +16 -7
- package/dest/duties/validation_service.d.ts +42 -13
- package/dest/duties/validation_service.d.ts.map +1 -1
- package/dest/duties/validation_service.js +113 -31
- package/dest/factory.d.ts +13 -8
- package/dest/factory.d.ts.map +1 -1
- package/dest/factory.js +2 -2
- package/dest/index.d.ts +3 -1
- package/dest/index.d.ts.map +1 -1
- package/dest/index.js +2 -0
- package/dest/key_store/ha_key_store.d.ts +99 -0
- package/dest/key_store/ha_key_store.d.ts.map +1 -0
- package/dest/key_store/ha_key_store.js +208 -0
- package/dest/key_store/index.d.ts +2 -1
- package/dest/key_store/index.d.ts.map +1 -1
- package/dest/key_store/index.js +1 -0
- package/dest/key_store/interface.d.ts +36 -6
- package/dest/key_store/interface.d.ts.map +1 -1
- package/dest/key_store/local_key_store.d.ts +10 -5
- package/dest/key_store/local_key_store.d.ts.map +1 -1
- package/dest/key_store/local_key_store.js +9 -5
- package/dest/key_store/node_keystore_adapter.d.ts +18 -5
- package/dest/key_store/node_keystore_adapter.d.ts.map +1 -1
- package/dest/key_store/node_keystore_adapter.js +18 -4
- package/dest/key_store/web3signer_key_store.d.ts +10 -11
- package/dest/key_store/web3signer_key_store.d.ts.map +1 -1
- package/dest/key_store/web3signer_key_store.js +9 -5
- package/dest/metrics.d.ts +4 -3
- package/dest/metrics.d.ts.map +1 -1
- package/dest/metrics.js +34 -30
- package/dest/tx_validator/index.d.ts +3 -0
- package/dest/tx_validator/index.d.ts.map +1 -0
- package/dest/tx_validator/index.js +2 -0
- package/dest/tx_validator/nullifier_cache.d.ts +14 -0
- package/dest/tx_validator/nullifier_cache.d.ts.map +1 -0
- package/dest/tx_validator/nullifier_cache.js +24 -0
- package/dest/tx_validator/tx_validator_factory.d.ts +19 -0
- package/dest/tx_validator/tx_validator_factory.d.ts.map +1 -0
- package/dest/tx_validator/tx_validator_factory.js +54 -0
- package/dest/validator.d.ts +48 -20
- package/dest/validator.d.ts.map +1 -1
- package/dest/validator.js +359 -63
- package/package.json +24 -14
- package/src/block_proposal_handler.ts +278 -66
- package/src/checkpoint_builder.ts +310 -0
- package/src/config.ts +16 -6
- package/src/duties/validation_service.ts +157 -38
- package/src/factory.ts +17 -8
- package/src/index.ts +2 -0
- package/src/key_store/ha_key_store.ts +269 -0
- package/src/key_store/index.ts +1 -0
- package/src/key_store/interface.ts +44 -5
- package/src/key_store/local_key_store.ts +14 -5
- package/src/key_store/node_keystore_adapter.ts +28 -5
- package/src/key_store/web3signer_key_store.ts +18 -5
- package/src/metrics.ts +45 -33
- package/src/tx_validator/index.ts +2 -0
- package/src/tx_validator/nullifier_cache.ts +30 -0
- package/src/tx_validator/tx_validator_factory.ts +154 -0
- package/src/validator.ts +483 -95
|
@@ -1,19 +1,24 @@
|
|
|
1
1
|
import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
|
|
2
|
+
import type { EpochCache } from '@aztec/epoch-cache';
|
|
3
|
+
import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
|
|
4
|
+
import { chunkBy } from '@aztec/foundation/collection';
|
|
5
|
+
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
2
6
|
import { TimeoutError } from '@aztec/foundation/error';
|
|
3
|
-
import { Fr } from '@aztec/foundation/fields';
|
|
4
7
|
import { createLogger } from '@aztec/foundation/log';
|
|
5
8
|
import { retryUntil } from '@aztec/foundation/retry';
|
|
6
9
|
import { DateProvider, Timer } from '@aztec/foundation/timer';
|
|
7
10
|
import type { P2P, PeerId } from '@aztec/p2p';
|
|
8
|
-
import { TxProvider } from '@aztec/p2p';
|
|
9
11
|
import { BlockProposalValidator } from '@aztec/p2p/msg_validators';
|
|
10
|
-
import {
|
|
11
|
-
import
|
|
12
|
-
import {
|
|
13
|
-
import
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
12
|
+
import type { L2Block, L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
|
|
13
|
+
import { getEpochAtSlot, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
|
|
14
|
+
import type { ITxProvider, ValidatorClientFullConfig, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
|
|
15
|
+
import {
|
|
16
|
+
type L1ToL2MessageSource,
|
|
17
|
+
computeCheckpointOutHash,
|
|
18
|
+
computeInHashFromL1ToL2Messages,
|
|
19
|
+
} from '@aztec/stdlib/messaging';
|
|
20
|
+
import type { BlockProposal } from '@aztec/stdlib/p2p';
|
|
21
|
+
import { BlockHeader, type CheckpointGlobalVariables, type FailedTx, type Tx } from '@aztec/stdlib/tx';
|
|
17
22
|
import {
|
|
18
23
|
ReExFailedTxsError,
|
|
19
24
|
ReExStateMismatchError,
|
|
@@ -22,6 +27,7 @@ import {
|
|
|
22
27
|
} from '@aztec/stdlib/validators';
|
|
23
28
|
import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
|
|
24
29
|
|
|
30
|
+
import type { FullNodeCheckpointsBuilder } from './checkpoint_builder.js';
|
|
25
31
|
import type { ValidatorMetrics } from './metrics.js';
|
|
26
32
|
|
|
27
33
|
export type BlockProposalValidationFailureReason =
|
|
@@ -29,6 +35,7 @@ export type BlockProposalValidationFailureReason =
|
|
|
29
35
|
| 'parent_block_not_found'
|
|
30
36
|
| 'parent_block_wrong_slot'
|
|
31
37
|
| 'in_hash_mismatch'
|
|
38
|
+
| 'global_variables_mismatch'
|
|
32
39
|
| 'block_number_already_exists'
|
|
33
40
|
| 'txs_not_available'
|
|
34
41
|
| 'state_mismatch'
|
|
@@ -45,58 +52,71 @@ type ReexecuteTransactionsResult = {
|
|
|
45
52
|
|
|
46
53
|
export type BlockProposalValidationSuccessResult = {
|
|
47
54
|
isValid: true;
|
|
48
|
-
blockNumber:
|
|
55
|
+
blockNumber: BlockNumber;
|
|
49
56
|
reexecutionResult?: ReexecuteTransactionsResult;
|
|
50
57
|
};
|
|
51
58
|
|
|
52
59
|
export type BlockProposalValidationFailureResult = {
|
|
53
60
|
isValid: false;
|
|
54
61
|
reason: BlockProposalValidationFailureReason;
|
|
55
|
-
blockNumber?:
|
|
62
|
+
blockNumber?: BlockNumber;
|
|
56
63
|
reexecutionResult?: ReexecuteTransactionsResult;
|
|
57
64
|
};
|
|
58
65
|
|
|
59
66
|
export type BlockProposalValidationResult = BlockProposalValidationSuccessResult | BlockProposalValidationFailureResult;
|
|
60
67
|
|
|
68
|
+
type CheckpointComputationResult =
|
|
69
|
+
| { checkpointNumber: CheckpointNumber; reason?: undefined }
|
|
70
|
+
| { checkpointNumber?: undefined; reason: 'invalid_proposal' | 'global_variables_mismatch' };
|
|
71
|
+
|
|
61
72
|
export class BlockProposalHandler {
|
|
62
73
|
public readonly tracer: Tracer;
|
|
63
74
|
|
|
64
75
|
constructor(
|
|
65
|
-
private
|
|
66
|
-
private
|
|
76
|
+
private checkpointsBuilder: FullNodeCheckpointsBuilder,
|
|
77
|
+
private worldState: WorldStateSynchronizer,
|
|
78
|
+
private blockSource: L2BlockSource & L2BlockSink,
|
|
67
79
|
private l1ToL2MessageSource: L1ToL2MessageSource,
|
|
68
|
-
private txProvider:
|
|
80
|
+
private txProvider: ITxProvider,
|
|
69
81
|
private blockProposalValidator: BlockProposalValidator,
|
|
82
|
+
private epochCache: EpochCache,
|
|
70
83
|
private config: ValidatorClientFullConfig,
|
|
71
84
|
private metrics?: ValidatorMetrics,
|
|
72
85
|
private dateProvider: DateProvider = new DateProvider(),
|
|
73
86
|
telemetry: TelemetryClient = getTelemetryClient(),
|
|
74
87
|
private log = createLogger('validator:block-proposal-handler'),
|
|
75
88
|
) {
|
|
89
|
+
if (config.fishermanMode) {
|
|
90
|
+
this.log = this.log.createChild('[FISHERMAN]');
|
|
91
|
+
}
|
|
76
92
|
this.tracer = telemetry.getTracer('BlockProposalHandler');
|
|
77
93
|
}
|
|
78
94
|
|
|
79
95
|
registerForReexecution(p2pClient: P2P): BlockProposalHandler {
|
|
80
|
-
|
|
96
|
+
// Non-validator handler that re-executes for monitoring but does not attest.
|
|
97
|
+
// Returns boolean indicating whether the proposal was valid.
|
|
98
|
+
const handler = async (proposal: BlockProposal, proposalSender: PeerId): Promise<boolean> => {
|
|
81
99
|
try {
|
|
82
100
|
const result = await this.handleBlockProposal(proposal, proposalSender, true);
|
|
83
101
|
if (result.isValid) {
|
|
84
|
-
this.log.info(`Non-validator reexecution completed for slot ${proposal.slotNumber
|
|
102
|
+
this.log.info(`Non-validator reexecution completed for slot ${proposal.slotNumber}`, {
|
|
85
103
|
blockNumber: result.blockNumber,
|
|
86
104
|
reexecutionTimeMs: result.reexecutionResult?.reexecutionTimeMs,
|
|
87
105
|
totalManaUsed: result.reexecutionResult?.totalManaUsed,
|
|
88
106
|
numTxs: result.reexecutionResult?.block?.body?.txEffects?.length ?? 0,
|
|
89
107
|
});
|
|
108
|
+
return true;
|
|
90
109
|
} else {
|
|
91
|
-
this.log.warn(`Non-validator reexecution failed for slot ${proposal.slotNumber
|
|
110
|
+
this.log.warn(`Non-validator reexecution failed for slot ${proposal.slotNumber}`, {
|
|
92
111
|
blockNumber: result.blockNumber,
|
|
93
112
|
reason: result.reason,
|
|
94
113
|
});
|
|
114
|
+
return false;
|
|
95
115
|
}
|
|
96
116
|
} catch (error) {
|
|
97
117
|
this.log.error('Error processing block proposal in non-validator handler', error);
|
|
118
|
+
return false;
|
|
98
119
|
}
|
|
99
|
-
return undefined; // Non-validator nodes don't return attestations
|
|
100
120
|
};
|
|
101
121
|
|
|
102
122
|
p2pClient.registerBlockProposalHandler(handler);
|
|
@@ -108,9 +128,9 @@ export class BlockProposalHandler {
|
|
|
108
128
|
proposalSender: PeerId,
|
|
109
129
|
shouldReexecute: boolean,
|
|
110
130
|
): Promise<BlockProposalValidationResult> {
|
|
111
|
-
const slotNumber = proposal.slotNumber
|
|
131
|
+
const slotNumber = proposal.slotNumber;
|
|
112
132
|
const proposer = proposal.getSender();
|
|
113
|
-
const config = this.
|
|
133
|
+
const config = this.checkpointsBuilder.getConfig();
|
|
114
134
|
|
|
115
135
|
// Reject proposals with invalid signatures
|
|
116
136
|
if (!proposer) {
|
|
@@ -126,8 +146,8 @@ export class BlockProposalHandler {
|
|
|
126
146
|
|
|
127
147
|
// Check that the proposal is from the current proposer, or the next proposer
|
|
128
148
|
// This should have been handled by the p2p layer, but we double check here out of caution
|
|
129
|
-
const
|
|
130
|
-
if (
|
|
149
|
+
const validationResult = await this.blockProposalValidator.validate(proposal);
|
|
150
|
+
if (validationResult.result !== 'accept') {
|
|
131
151
|
this.log.warn(`Proposal is not valid, skipping processing`, proposalInfo);
|
|
132
152
|
return { isValid: false, reason: 'invalid_proposal' };
|
|
133
153
|
}
|
|
@@ -139,9 +159,9 @@ export class BlockProposalHandler {
|
|
|
139
159
|
return { isValid: false, reason: 'parent_block_not_found' };
|
|
140
160
|
}
|
|
141
161
|
|
|
142
|
-
// Check that the parent block's slot is
|
|
143
|
-
if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot()
|
|
144
|
-
this.log.warn(`Parent block slot is greater than
|
|
162
|
+
// Check that the parent block's slot is not greater than the proposal's slot.
|
|
163
|
+
if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() > slotNumber) {
|
|
164
|
+
this.log.warn(`Parent block slot is greater than proposal slot, skipping processing`, {
|
|
145
165
|
parentBlockSlot: parentBlockHeader.getSlot().toString(),
|
|
146
166
|
proposalSlot: slotNumber.toString(),
|
|
147
167
|
...proposalInfo,
|
|
@@ -150,7 +170,10 @@ export class BlockProposalHandler {
|
|
|
150
170
|
}
|
|
151
171
|
|
|
152
172
|
// Compute the block number based on the parent block
|
|
153
|
-
const blockNumber =
|
|
173
|
+
const blockNumber =
|
|
174
|
+
parentBlockHeader === 'genesis'
|
|
175
|
+
? BlockNumber(INITIAL_L2_BLOCK_NUM)
|
|
176
|
+
: BlockNumber(parentBlockHeader.getBlockNumber() + 1);
|
|
154
177
|
|
|
155
178
|
// Check that this block number does not exist already
|
|
156
179
|
const existingBlock = await this.blockSource.getBlockHeader(blockNumber);
|
|
@@ -166,10 +189,17 @@ export class BlockProposalHandler {
|
|
|
166
189
|
deadline: this.getReexecutionDeadline(slotNumber, config),
|
|
167
190
|
});
|
|
168
191
|
|
|
192
|
+
// Compute the checkpoint number for this block and validate checkpoint consistency
|
|
193
|
+
const checkpointResult = await this.computeCheckpointNumber(proposal, parentBlockHeader, proposalInfo);
|
|
194
|
+
if (checkpointResult.reason) {
|
|
195
|
+
return { isValid: false, blockNumber, reason: checkpointResult.reason };
|
|
196
|
+
}
|
|
197
|
+
const checkpointNumber = checkpointResult.checkpointNumber;
|
|
198
|
+
|
|
169
199
|
// Check that I have the same set of l1ToL2Messages as the proposal
|
|
170
|
-
const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(
|
|
171
|
-
const computedInHash =
|
|
172
|
-
const proposalInHash = proposal.
|
|
200
|
+
const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(checkpointNumber);
|
|
201
|
+
const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
|
|
202
|
+
const proposalInHash = proposal.inHash;
|
|
173
203
|
if (!computedInHash.equals(proposalInHash)) {
|
|
174
204
|
this.log.warn(`L1 to L2 messages in hash mismatch, skipping processing`, {
|
|
175
205
|
proposalInHash: proposalInHash.toString(),
|
|
@@ -188,9 +218,28 @@ export class BlockProposalHandler {
|
|
|
188
218
|
// Try re-executing the transactions in the proposal if needed
|
|
189
219
|
let reexecutionResult;
|
|
190
220
|
if (shouldReexecute) {
|
|
221
|
+
// Compute the previous checkpoint out hashes for the epoch.
|
|
222
|
+
// TODO(leila/mbps): There can be a more efficient way to get the previous checkpoint out
|
|
223
|
+
// hashes without having to fetch all the blocks.
|
|
224
|
+
const epoch = getEpochAtSlot(slotNumber, this.epochCache.getL1Constants());
|
|
225
|
+
const checkpointedBlocks = (await this.blockSource.getCheckpointedBlocksForEpoch(epoch))
|
|
226
|
+
.filter(b => b.block.number < blockNumber)
|
|
227
|
+
.sort((a, b) => a.block.number - b.block.number);
|
|
228
|
+
const blocksByCheckpoint = chunkBy(checkpointedBlocks, b => b.checkpointNumber);
|
|
229
|
+
const previousCheckpointOutHashes = blocksByCheckpoint.map(checkpointBlocks =>
|
|
230
|
+
computeCheckpointOutHash(checkpointBlocks.map(b => b.block.body.txEffects.map(tx => tx.l2ToL1Msgs))),
|
|
231
|
+
);
|
|
232
|
+
|
|
191
233
|
try {
|
|
192
234
|
this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
|
|
193
|
-
reexecutionResult = await this.reexecuteTransactions(
|
|
235
|
+
reexecutionResult = await this.reexecuteTransactions(
|
|
236
|
+
proposal,
|
|
237
|
+
blockNumber,
|
|
238
|
+
checkpointNumber,
|
|
239
|
+
txs,
|
|
240
|
+
l1ToL2Messages,
|
|
241
|
+
previousCheckpointOutHashes,
|
|
242
|
+
);
|
|
194
243
|
} catch (error) {
|
|
195
244
|
this.log.error(`Error reexecuting txs while processing block proposal`, error, proposalInfo);
|
|
196
245
|
const reason = this.getReexecuteFailureReason(error);
|
|
@@ -198,14 +247,23 @@ export class BlockProposalHandler {
|
|
|
198
247
|
}
|
|
199
248
|
}
|
|
200
249
|
|
|
201
|
-
this
|
|
250
|
+
// If we succeeded, push this block into the archiver (unless disabled)
|
|
251
|
+
if (reexecutionResult?.block && this.config.skipPushProposedBlocksToArchiver === false) {
|
|
252
|
+
await this.blockSource.addBlock(reexecutionResult?.block);
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
this.log.info(
|
|
256
|
+
`Successfully processed block ${blockNumber} proposal at index ${proposal.indexWithinCheckpoint} on slot ${slotNumber}`,
|
|
257
|
+
proposalInfo,
|
|
258
|
+
);
|
|
259
|
+
|
|
202
260
|
return { isValid: true, blockNumber, reexecutionResult };
|
|
203
261
|
}
|
|
204
262
|
|
|
205
263
|
private async getParentBlock(proposal: BlockProposal): Promise<'genesis' | BlockHeader | undefined> {
|
|
206
|
-
const parentArchive = proposal.
|
|
207
|
-
const slot = proposal.slotNumber
|
|
208
|
-
const config = this.
|
|
264
|
+
const parentArchive = proposal.blockHeader.lastArchive.root;
|
|
265
|
+
const slot = proposal.slotNumber;
|
|
266
|
+
const config = this.checkpointsBuilder.getConfig();
|
|
209
267
|
const { genesisArchiveRoot } = await this.blockSource.getGenesisValues();
|
|
210
268
|
|
|
211
269
|
if (parentArchive.equals(genesisArchiveRoot)) {
|
|
@@ -239,10 +297,142 @@ export class BlockProposalHandler {
|
|
|
239
297
|
}
|
|
240
298
|
}
|
|
241
299
|
|
|
242
|
-
private
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
300
|
+
private async computeCheckpointNumber(
|
|
301
|
+
proposal: BlockProposal,
|
|
302
|
+
parentBlockHeader: 'genesis' | BlockHeader,
|
|
303
|
+
proposalInfo: object,
|
|
304
|
+
): Promise<CheckpointComputationResult> {
|
|
305
|
+
if (parentBlockHeader === 'genesis') {
|
|
306
|
+
// First block is in checkpoint 1
|
|
307
|
+
if (proposal.indexWithinCheckpoint !== 0) {
|
|
308
|
+
this.log.warn(`First block proposal has non-zero indexWithinCheckpoint`, proposalInfo);
|
|
309
|
+
return { reason: 'invalid_proposal' };
|
|
310
|
+
}
|
|
311
|
+
return { checkpointNumber: CheckpointNumber.INITIAL };
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
// Get the parent block to find its checkpoint number
|
|
315
|
+
// TODO(palla/mbps): The block header should include the checkpoint number to avoid this lookup,
|
|
316
|
+
// or at least the L2BlockSource should return a different struct that includes it.
|
|
317
|
+
const parentBlockNumber = parentBlockHeader.getBlockNumber();
|
|
318
|
+
const parentBlock = await this.blockSource.getL2Block(parentBlockNumber);
|
|
319
|
+
if (!parentBlock) {
|
|
320
|
+
this.log.warn(`Parent block ${parentBlockNumber} not found in archiver`, proposalInfo);
|
|
321
|
+
return { reason: 'invalid_proposal' };
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
if (proposal.indexWithinCheckpoint === 0) {
|
|
325
|
+
// If this is the first block in a new checkpoint, increment the checkpoint number
|
|
326
|
+
if (!(proposal.blockHeader.getSlot() > parentBlockHeader.getSlot())) {
|
|
327
|
+
this.log.warn(`Slot should be greater than parent block slot for first block in checkpoint`, proposalInfo);
|
|
328
|
+
return { reason: 'invalid_proposal' };
|
|
329
|
+
}
|
|
330
|
+
return { checkpointNumber: CheckpointNumber(parentBlock.checkpointNumber + 1) };
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
// Otherwise it should follow the previous block in the same checkpoint
|
|
334
|
+
if (proposal.indexWithinCheckpoint !== parentBlock.indexWithinCheckpoint + 1) {
|
|
335
|
+
this.log.warn(`Non-sequential indexWithinCheckpoint`, proposalInfo);
|
|
336
|
+
return { reason: 'invalid_proposal' };
|
|
337
|
+
}
|
|
338
|
+
if (proposal.blockHeader.getSlot() !== parentBlockHeader.getSlot()) {
|
|
339
|
+
this.log.warn(`Slot should be equal to parent block slot for non-first block in checkpoint`, proposalInfo);
|
|
340
|
+
return { reason: 'invalid_proposal' };
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
// For non-first blocks in a checkpoint, validate global variables match parent (except blockNumber)
|
|
344
|
+
const validationResult = this.validateNonFirstBlockInCheckpoint(proposal, parentBlock, proposalInfo);
|
|
345
|
+
if (validationResult) {
|
|
346
|
+
return validationResult;
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
return { checkpointNumber: parentBlock.checkpointNumber };
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
/**
|
|
353
|
+
* Validates that a non-first block in a checkpoint has consistent global variables with its parent.
|
|
354
|
+
* For blocks with indexWithinCheckpoint > 0, all global variables except blockNumber must match the parent.
|
|
355
|
+
* @returns A failure result if validation fails, undefined if validation passes
|
|
356
|
+
*/
|
|
357
|
+
private validateNonFirstBlockInCheckpoint(
|
|
358
|
+
proposal: BlockProposal,
|
|
359
|
+
parentBlock: L2Block,
|
|
360
|
+
proposalInfo: object,
|
|
361
|
+
): CheckpointComputationResult | undefined {
|
|
362
|
+
const proposalGlobals = proposal.blockHeader.globalVariables;
|
|
363
|
+
const parentGlobals = parentBlock.header.globalVariables;
|
|
364
|
+
|
|
365
|
+
// All global variables except blockNumber should match the parent
|
|
366
|
+
// blockNumber naturally increments between blocks
|
|
367
|
+
if (!proposalGlobals.chainId.equals(parentGlobals.chainId)) {
|
|
368
|
+
this.log.warn(`Non-first block in checkpoint has mismatched chainId`, {
|
|
369
|
+
...proposalInfo,
|
|
370
|
+
proposalChainId: proposalGlobals.chainId.toString(),
|
|
371
|
+
parentChainId: parentGlobals.chainId.toString(),
|
|
372
|
+
});
|
|
373
|
+
return { reason: 'global_variables_mismatch' };
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
if (!proposalGlobals.version.equals(parentGlobals.version)) {
|
|
377
|
+
this.log.warn(`Non-first block in checkpoint has mismatched version`, {
|
|
378
|
+
...proposalInfo,
|
|
379
|
+
proposalVersion: proposalGlobals.version.toString(),
|
|
380
|
+
parentVersion: parentGlobals.version.toString(),
|
|
381
|
+
});
|
|
382
|
+
return { reason: 'global_variables_mismatch' };
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
if (proposalGlobals.slotNumber !== parentGlobals.slotNumber) {
|
|
386
|
+
this.log.warn(`Non-first block in checkpoint has mismatched slotNumber`, {
|
|
387
|
+
...proposalInfo,
|
|
388
|
+
proposalSlotNumber: proposalGlobals.slotNumber,
|
|
389
|
+
parentSlotNumber: parentGlobals.slotNumber,
|
|
390
|
+
});
|
|
391
|
+
return { reason: 'global_variables_mismatch' };
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
if (proposalGlobals.timestamp !== parentGlobals.timestamp) {
|
|
395
|
+
this.log.warn(`Non-first block in checkpoint has mismatched timestamp`, {
|
|
396
|
+
...proposalInfo,
|
|
397
|
+
proposalTimestamp: proposalGlobals.timestamp.toString(),
|
|
398
|
+
parentTimestamp: parentGlobals.timestamp.toString(),
|
|
399
|
+
});
|
|
400
|
+
return { reason: 'global_variables_mismatch' };
|
|
401
|
+
}
|
|
402
|
+
|
|
403
|
+
if (!proposalGlobals.coinbase.equals(parentGlobals.coinbase)) {
|
|
404
|
+
this.log.warn(`Non-first block in checkpoint has mismatched coinbase`, {
|
|
405
|
+
...proposalInfo,
|
|
406
|
+
proposalCoinbase: proposalGlobals.coinbase.toString(),
|
|
407
|
+
parentCoinbase: parentGlobals.coinbase.toString(),
|
|
408
|
+
});
|
|
409
|
+
return { reason: 'global_variables_mismatch' };
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
if (!proposalGlobals.feeRecipient.equals(parentGlobals.feeRecipient)) {
|
|
413
|
+
this.log.warn(`Non-first block in checkpoint has mismatched feeRecipient`, {
|
|
414
|
+
...proposalInfo,
|
|
415
|
+
proposalFeeRecipient: proposalGlobals.feeRecipient.toString(),
|
|
416
|
+
parentFeeRecipient: parentGlobals.feeRecipient.toString(),
|
|
417
|
+
});
|
|
418
|
+
return { reason: 'global_variables_mismatch' };
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
if (!proposalGlobals.gasFees.equals(parentGlobals.gasFees)) {
|
|
422
|
+
this.log.warn(`Non-first block in checkpoint has mismatched gasFees`, {
|
|
423
|
+
...proposalInfo,
|
|
424
|
+
proposalGasFees: proposalGlobals.gasFees.toInspect(),
|
|
425
|
+
parentGasFees: parentGlobals.gasFees.toInspect(),
|
|
426
|
+
});
|
|
427
|
+
return { reason: 'global_variables_mismatch' };
|
|
428
|
+
}
|
|
429
|
+
|
|
430
|
+
return undefined;
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
private getReexecutionDeadline(slot: SlotNumber, config: { l1GenesisTime: bigint; slotDuration: number }): Date {
|
|
434
|
+
const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
|
|
435
|
+
return new Date(nextSlotTimestampSeconds * 1000);
|
|
246
436
|
}
|
|
247
437
|
|
|
248
438
|
private getReexecuteFailureReason(err: any) {
|
|
@@ -259,12 +449,13 @@ export class BlockProposalHandler {
|
|
|
259
449
|
|
|
260
450
|
async reexecuteTransactions(
|
|
261
451
|
proposal: BlockProposal,
|
|
262
|
-
blockNumber:
|
|
452
|
+
blockNumber: BlockNumber,
|
|
453
|
+
checkpointNumber: CheckpointNumber,
|
|
263
454
|
txs: Tx[],
|
|
264
455
|
l1ToL2Messages: Fr[],
|
|
456
|
+
previousCheckpointOutHashes: Fr[],
|
|
265
457
|
): Promise<ReexecuteTransactionsResult> {
|
|
266
|
-
const {
|
|
267
|
-
const { txHashes } = proposal;
|
|
458
|
+
const { blockHeader, txHashes } = proposal;
|
|
268
459
|
|
|
269
460
|
// If we do not have all of the transactions, then we should fail
|
|
270
461
|
if (txs.length !== txHashes.length) {
|
|
@@ -273,28 +464,50 @@ export class BlockProposalHandler {
|
|
|
273
464
|
throw new TransactionsNotAvailableError(missingTxHashes);
|
|
274
465
|
}
|
|
275
466
|
|
|
276
|
-
// Use the sequencer's block building logic to re-execute the transactions
|
|
277
467
|
const timer = new Timer();
|
|
278
|
-
const
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
468
|
+
const slot = proposal.slotNumber;
|
|
469
|
+
const config = this.checkpointsBuilder.getConfig();
|
|
470
|
+
|
|
471
|
+
// Get prior blocks in this checkpoint (same slot before current block)
|
|
472
|
+
const allBlocksInSlot = await this.blockSource.getBlocksForSlot(slot);
|
|
473
|
+
const priorBlocks = allBlocksInSlot.filter(b => b.number < blockNumber && b.header.getSlot() === slot);
|
|
474
|
+
|
|
475
|
+
// Fork before the block to be built
|
|
476
|
+
const parentBlockNumber = BlockNumber(blockNumber - 1);
|
|
477
|
+
await this.worldState.syncImmediate(parentBlockNumber);
|
|
478
|
+
using fork = await this.worldState.fork(parentBlockNumber);
|
|
479
|
+
|
|
480
|
+
// Build checkpoint constants from proposal (excludes blockNumber and timestamp which are per-block)
|
|
481
|
+
const constants: CheckpointGlobalVariables = {
|
|
288
482
|
chainId: new Fr(config.l1ChainId),
|
|
289
483
|
version: new Fr(config.rollupVersion),
|
|
290
|
-
|
|
484
|
+
slotNumber: slot,
|
|
485
|
+
coinbase: blockHeader.globalVariables.coinbase,
|
|
486
|
+
feeRecipient: blockHeader.globalVariables.feeRecipient,
|
|
487
|
+
gasFees: blockHeader.globalVariables.gasFees,
|
|
488
|
+
};
|
|
291
489
|
|
|
292
|
-
|
|
293
|
-
|
|
490
|
+
// Create checkpoint builder with prior blocks
|
|
491
|
+
const checkpointBuilder = await this.checkpointsBuilder.openCheckpoint(
|
|
492
|
+
checkpointNumber,
|
|
493
|
+
constants,
|
|
494
|
+
l1ToL2Messages,
|
|
495
|
+
previousCheckpointOutHashes,
|
|
496
|
+
fork,
|
|
497
|
+
priorBlocks,
|
|
498
|
+
this.log.getBindings(),
|
|
499
|
+
);
|
|
500
|
+
|
|
501
|
+
// Build the new block
|
|
502
|
+
const deadline = this.getReexecutionDeadline(slot, config);
|
|
503
|
+
const result = await checkpointBuilder.buildBlock(txs, blockNumber, blockHeader.globalVariables.timestamp, {
|
|
504
|
+
deadline,
|
|
505
|
+
expectedEndState: blockHeader.state,
|
|
294
506
|
});
|
|
295
507
|
|
|
508
|
+
const { block, failedTxs } = result;
|
|
296
509
|
const numFailedTxs = failedTxs.length;
|
|
297
|
-
|
|
510
|
+
|
|
298
511
|
this.log.verbose(`Transaction re-execution complete for slot ${slot}`, {
|
|
299
512
|
numFailedTxs,
|
|
300
513
|
numProposalTxs: txHashes.length,
|
|
@@ -313,19 +526,18 @@ export class BlockProposalHandler {
|
|
|
313
526
|
}
|
|
314
527
|
|
|
315
528
|
// Throw a ReExStateMismatchError error if state updates do not match
|
|
316
|
-
|
|
317
|
-
|
|
529
|
+
// Compare the full block structure (archive and header) from the built block with the proposal
|
|
530
|
+
const archiveMatches = proposal.archive.equals(block.archive.root);
|
|
531
|
+
const headerMatches = proposal.blockHeader.equals(block.header);
|
|
532
|
+
if (!archiveMatches || !headerMatches) {
|
|
318
533
|
this.log.warn(`Re-execution state mismatch for slot ${slot}`, {
|
|
319
|
-
|
|
320
|
-
|
|
534
|
+
expectedArchive: block.archive.root.toString(),
|
|
535
|
+
actualArchive: proposal.archive.toString(),
|
|
536
|
+
expectedHeader: block.header.toInspect(),
|
|
537
|
+
actualHeader: proposal.blockHeader.toInspect(),
|
|
321
538
|
});
|
|
322
539
|
this.metrics?.recordFailedReexecution(proposal);
|
|
323
|
-
throw new ReExStateMismatchError(
|
|
324
|
-
proposal.archive,
|
|
325
|
-
block.archive.root,
|
|
326
|
-
proposal.payload.stateReference,
|
|
327
|
-
block.header.state,
|
|
328
|
-
);
|
|
540
|
+
throw new ReExStateMismatchError(proposal.archive, block.archive.root);
|
|
329
541
|
}
|
|
330
542
|
|
|
331
543
|
const reexecutionTimeMs = timer.ms();
|