@aztec/validator-client 0.0.1-commit.9b94fc1 → 0.0.1-commit.9badcec54

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/README.md +324 -0
  2. package/dest/checkpoint_builder.d.ts +79 -0
  3. package/dest/checkpoint_builder.d.ts.map +1 -0
  4. package/dest/checkpoint_builder.js +251 -0
  5. package/dest/config.d.ts +1 -1
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +37 -13
  8. package/dest/duties/validation_service.d.ts +40 -13
  9. package/dest/duties/validation_service.d.ts.map +1 -1
  10. package/dest/duties/validation_service.js +93 -28
  11. package/dest/factory.d.ts +19 -11
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +6 -5
  14. package/dest/index.d.ts +3 -2
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +2 -1
  17. package/dest/key_store/ha_key_store.d.ts +99 -0
  18. package/dest/key_store/ha_key_store.d.ts.map +1 -0
  19. package/dest/key_store/ha_key_store.js +208 -0
  20. package/dest/key_store/index.d.ts +2 -1
  21. package/dest/key_store/index.d.ts.map +1 -1
  22. package/dest/key_store/index.js +1 -0
  23. package/dest/key_store/interface.d.ts +36 -6
  24. package/dest/key_store/interface.d.ts.map +1 -1
  25. package/dest/key_store/local_key_store.d.ts +10 -5
  26. package/dest/key_store/local_key_store.d.ts.map +1 -1
  27. package/dest/key_store/local_key_store.js +9 -5
  28. package/dest/key_store/node_keystore_adapter.d.ts +18 -5
  29. package/dest/key_store/node_keystore_adapter.d.ts.map +1 -1
  30. package/dest/key_store/node_keystore_adapter.js +18 -4
  31. package/dest/key_store/web3signer_key_store.d.ts +10 -5
  32. package/dest/key_store/web3signer_key_store.d.ts.map +1 -1
  33. package/dest/key_store/web3signer_key_store.js +9 -5
  34. package/dest/metrics.d.ts +16 -3
  35. package/dest/metrics.d.ts.map +1 -1
  36. package/dest/metrics.js +58 -30
  37. package/dest/proposal_handler.d.ts +108 -0
  38. package/dest/proposal_handler.d.ts.map +1 -0
  39. package/dest/proposal_handler.js +974 -0
  40. package/dest/validator.d.ts +73 -23
  41. package/dest/validator.d.ts.map +1 -1
  42. package/dest/validator.js +318 -65
  43. package/package.json +23 -13
  44. package/src/checkpoint_builder.ts +417 -0
  45. package/src/config.ts +36 -12
  46. package/src/duties/validation_service.ts +143 -33
  47. package/src/factory.ts +27 -11
  48. package/src/index.ts +2 -1
  49. package/src/key_store/ha_key_store.ts +269 -0
  50. package/src/key_store/index.ts +1 -0
  51. package/src/key_store/interface.ts +44 -5
  52. package/src/key_store/local_key_store.ts +14 -5
  53. package/src/key_store/node_keystore_adapter.ts +28 -5
  54. package/src/key_store/web3signer_key_store.ts +18 -5
  55. package/src/metrics.ts +81 -33
  56. package/src/proposal_handler.ts +1042 -0
  57. package/src/validator.ts +493 -101
  58. package/dest/block_proposal_handler.d.ts +0 -52
  59. package/dest/block_proposal_handler.d.ts.map +0 -1
  60. package/dest/block_proposal_handler.js +0 -290
  61. package/src/block_proposal_handler.ts +0 -341
@@ -1,52 +0,0 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
- import { DateProvider } from '@aztec/foundation/timer';
3
- import type { P2P, PeerId } from '@aztec/p2p';
4
- import { TxProvider } from '@aztec/p2p';
5
- import { BlockProposalValidator } from '@aztec/p2p/msg_validators';
6
- import type { L2Block, L2BlockSource } from '@aztec/stdlib/block';
7
- import type { IFullNodeBlockBuilder, ValidatorClientFullConfig } from '@aztec/stdlib/interfaces/server';
8
- import { type L1ToL2MessageSource } from '@aztec/stdlib/messaging';
9
- import { type BlockProposal } from '@aztec/stdlib/p2p';
10
- import { type FailedTx, type Tx } from '@aztec/stdlib/tx';
11
- import { type TelemetryClient, type Tracer } from '@aztec/telemetry-client';
12
- import type { ValidatorMetrics } from './metrics.js';
13
- export type BlockProposalValidationFailureReason = 'invalid_proposal' | 'parent_block_not_found' | 'parent_block_wrong_slot' | 'in_hash_mismatch' | 'block_number_already_exists' | 'txs_not_available' | 'state_mismatch' | 'failed_txs' | 'timeout' | 'unknown_error';
14
- type ReexecuteTransactionsResult = {
15
- block: L2Block;
16
- failedTxs: FailedTx[];
17
- reexecutionTimeMs: number;
18
- totalManaUsed: number;
19
- };
20
- export type BlockProposalValidationSuccessResult = {
21
- isValid: true;
22
- blockNumber: number;
23
- reexecutionResult?: ReexecuteTransactionsResult;
24
- };
25
- export type BlockProposalValidationFailureResult = {
26
- isValid: false;
27
- reason: BlockProposalValidationFailureReason;
28
- blockNumber?: number;
29
- reexecutionResult?: ReexecuteTransactionsResult;
30
- };
31
- export type BlockProposalValidationResult = BlockProposalValidationSuccessResult | BlockProposalValidationFailureResult;
32
- export declare class BlockProposalHandler {
33
- private blockBuilder;
34
- private blockSource;
35
- private l1ToL2MessageSource;
36
- private txProvider;
37
- private blockProposalValidator;
38
- private config;
39
- private metrics?;
40
- private dateProvider;
41
- private log;
42
- readonly tracer: Tracer;
43
- constructor(blockBuilder: IFullNodeBlockBuilder, blockSource: L2BlockSource, l1ToL2MessageSource: L1ToL2MessageSource, txProvider: TxProvider, blockProposalValidator: BlockProposalValidator, config: ValidatorClientFullConfig, metrics?: ValidatorMetrics | undefined, dateProvider?: DateProvider, telemetry?: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
44
- registerForReexecution(p2pClient: P2P): BlockProposalHandler;
45
- handleBlockProposal(proposal: BlockProposal, proposalSender: PeerId, shouldReexecute: boolean): Promise<BlockProposalValidationResult>;
46
- private getParentBlock;
47
- private getReexecutionDeadline;
48
- private getReexecuteFailureReason;
49
- reexecuteTransactions(proposal: BlockProposal, blockNumber: number, txs: Tx[], l1ToL2Messages: Fr[]): Promise<ReexecuteTransactionsResult>;
50
- }
51
- export {};
52
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfcHJvcG9zYWxfaGFuZGxlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Jsb2NrX3Byb3Bvc2FsX2hhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRzlDLE9BQU8sRUFBRSxZQUFZLEVBQVMsTUFBTSx5QkFBeUIsQ0FBQztBQUM5RCxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzlDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFDeEMsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRWxFLE9BQU8sS0FBSyxFQUFFLHFCQUFxQixFQUFFLHlCQUF5QixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDeEcsT0FBTyxFQUFFLEtBQUssbUJBQW1CLEVBQW1DLE1BQU0seUJBQXlCLENBQUM7QUFDcEcsT0FBTyxFQUFFLEtBQUssYUFBYSxFQUFvQixNQUFNLG1CQUFtQixDQUFDO0FBQ3pFLE9BQU8sRUFBZSxLQUFLLFFBQVEsRUFBbUIsS0FBSyxFQUFFLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQU94RixPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQUUsS0FBSyxNQUFNLEVBQXNCLE1BQU0seUJBQXlCLENBQUM7QUFFaEcsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFckQsTUFBTSxNQUFNLG9DQUFvQyxHQUM1QyxrQkFBa0IsR0FDbEIsd0JBQXdCLEdBQ3hCLHlCQUF5QixHQUN6QixrQkFBa0IsR0FDbEIsNkJBQTZCLEdBQzdCLG1CQUFtQixHQUNuQixnQkFBZ0IsR0FDaEIsWUFBWSxHQUNaLFNBQVMsR0FDVCxlQUFlLENBQUM7QUFFcEIsS0FBSywyQkFBMkIsR0FBRztJQUNqQyxLQUFLLEVBQUUsT0FBTyxDQUFDO0lBQ2YsU0FBUyxFQUFFLFFBQVEsRUFBRSxDQUFDO0lBQ3RCLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUMxQixhQUFhLEVBQUUsTUFBTSxDQUFDO0NBQ3ZCLENBQUM7QUFFRixNQUFNLE1BQU0sb0NBQW9DLEdBQUc7SUFDakQsT0FBTyxFQUFFLElBQUksQ0FBQztJQUNkLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsaUJBQWlCLENBQUMsRUFBRSwyQkFBMkIsQ0FBQztDQUNqRCxDQUFDO0FBRUYsTUFBTSxNQUFNLG9DQUFvQyxHQUFHO0lBQ2pELE9BQU8sRUFBRSxLQUFLLENBQUM7SUFDZixNQUFNLEVBQUUsb0NBQW9DLENBQUM7SUFDN0MsV0FBVyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLGlCQUFpQixDQUFDLEVBQUUsMkJBQTJCLENBQUM7Q0FDakQsQ0FBQztBQUVGLE1BQU0sTUFBTSw2QkFBNkIsR0FBRyxvQ0FBb0MsR0FBRyxvQ0FBb0MsQ0FBQztBQUV4SCxxQkFBYSxvQkFBb0I7SUFJN0IsT0FBTyxDQUFDLFlBQVk7SUFDcEIsT0FBTyxDQUFDLFdBQVc7SUFDbkIsT0FBTyxDQUFDLG1CQUFtQjtJQUMzQixPQUFPLENBQUMsVUFBVTtJQUNsQixPQUFPLENBQUMsc0JBQXNCO0lBQzlCLE9BQU8sQ0FBQyxNQUFNO0lBQ2QsT0FBTyxDQUFDLE9BQU8sQ0FBQztJQUNoQixPQUFPLENBQUMsWUFBWTtJQUVwQixPQUFPLENBQUMsR0FBRztJQVpiLFNBQWdCLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFFL0IsWUFDVSxZQUFZLEVBQUUscUJBQXFCLEVBQ25DLFdBQVcsRUFBRSxhQUFhLEVBQzFCLG1CQUFtQixFQUFFLG1CQUFtQixFQUN4QyxVQUFVLEVBQUUsVUFBVSxFQUN0QixzQkFBc0IsRUFBRSxzQkFBc0IsRUFDOUMsTUFBTSxFQUFFLHlCQUF5QixFQUNqQyxPQUFPLENBQUMsOEJBQWtCLEVBQzFCLFlBQVksR0FBRSxZQUFpQyxFQUN2RCxTQUFTLEdBQUUsZUFBc0MsRUFDekMsR0FBRyx5Q0FBbUQsRUFNL0Q7SUFFRCxzQkFBc0IsQ0FBQyxTQUFTLEVBQUUsR0FBRyxHQUFHLG9CQUFvQixDQXlCM0Q7SUFFSyxtQkFBbUIsQ0FDdkIsUUFBUSxFQUFFLGFBQWEsRUFDdkIsY0FBYyxFQUFFLE1BQU0sRUFDdEIsZUFBZSxFQUFFLE9BQU8sR0FDdkIsT0FBTyxDQUFDLDZCQUE2QixDQUFDLENBNkZ4QztZQUVhLGNBQWM7SUFxQzVCLE9BQU8sQ0FBQyxzQkFBc0I7SUFNOUIsT0FBTyxDQUFDLHlCQUF5QjtJQVkzQixxQkFBcUIsQ0FDekIsUUFBUSxFQUFFLGFBQWEsRUFDdkIsV0FBVyxFQUFFLE1BQU0sRUFDbkIsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUNULGNBQWMsRUFBRSxFQUFFLEVBQUUsR0FDbkIsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBd0V0QztDQUNGIn0=
@@ -1 +0,0 @@
1
- {"version":3,"file":"block_proposal_handler.d.ts","sourceRoot":"","sources":["../src/block_proposal_handler.ts"],"names":[],"mappings":"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"}
@@ -1,290 +0,0 @@
1
- import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
2
- import { SlotNumber } from '@aztec/foundation/branded-types';
3
- import { TimeoutError } from '@aztec/foundation/error';
4
- import { Fr } from '@aztec/foundation/fields';
5
- import { createLogger } from '@aztec/foundation/log';
6
- import { retryUntil } from '@aztec/foundation/retry';
7
- import { DateProvider, Timer } from '@aztec/foundation/timer';
8
- import { getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
9
- import { computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
10
- import { ConsensusPayload } from '@aztec/stdlib/p2p';
11
- import { GlobalVariables } from '@aztec/stdlib/tx';
12
- import { ReExFailedTxsError, ReExStateMismatchError, ReExTimeoutError, TransactionsNotAvailableError } from '@aztec/stdlib/validators';
13
- import { getTelemetryClient } from '@aztec/telemetry-client';
14
- export class BlockProposalHandler {
15
- blockBuilder;
16
- blockSource;
17
- l1ToL2MessageSource;
18
- txProvider;
19
- blockProposalValidator;
20
- config;
21
- metrics;
22
- dateProvider;
23
- log;
24
- tracer;
25
- constructor(blockBuilder, blockSource, l1ToL2MessageSource, txProvider, blockProposalValidator, config, metrics, dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('validator:block-proposal-handler')){
26
- this.blockBuilder = blockBuilder;
27
- this.blockSource = blockSource;
28
- this.l1ToL2MessageSource = l1ToL2MessageSource;
29
- this.txProvider = txProvider;
30
- this.blockProposalValidator = blockProposalValidator;
31
- this.config = config;
32
- this.metrics = metrics;
33
- this.dateProvider = dateProvider;
34
- this.log = log;
35
- if (config.fishermanMode) {
36
- this.log = this.log.createChild('[FISHERMAN]');
37
- }
38
- this.tracer = telemetry.getTracer('BlockProposalHandler');
39
- }
40
- registerForReexecution(p2pClient) {
41
- const handler = async (proposal, proposalSender)=>{
42
- try {
43
- const result = await this.handleBlockProposal(proposal, proposalSender, true);
44
- if (result.isValid) {
45
- this.log.info(`Non-validator reexecution completed for slot ${proposal.slotNumber}`, {
46
- blockNumber: result.blockNumber,
47
- reexecutionTimeMs: result.reexecutionResult?.reexecutionTimeMs,
48
- totalManaUsed: result.reexecutionResult?.totalManaUsed,
49
- numTxs: result.reexecutionResult?.block?.body?.txEffects?.length ?? 0
50
- });
51
- } else {
52
- this.log.warn(`Non-validator reexecution failed for slot ${proposal.slotNumber}`, {
53
- blockNumber: result.blockNumber,
54
- reason: result.reason
55
- });
56
- }
57
- } catch (error) {
58
- this.log.error('Error processing block proposal in non-validator handler', error);
59
- }
60
- return undefined; // Non-validator nodes don't return attestations
61
- };
62
- p2pClient.registerBlockProposalHandler(handler);
63
- return this;
64
- }
65
- async handleBlockProposal(proposal, proposalSender, shouldReexecute) {
66
- const slotNumber = proposal.slotNumber;
67
- const proposer = proposal.getSender();
68
- const config = this.blockBuilder.getConfig();
69
- // Reject proposals with invalid signatures
70
- if (!proposer) {
71
- this.log.warn(`Received proposal with invalid signature for slot ${slotNumber}`);
72
- return {
73
- isValid: false,
74
- reason: 'invalid_proposal'
75
- };
76
- }
77
- const proposalInfo = {
78
- ...proposal.toBlockInfo(),
79
- proposer: proposer.toString()
80
- };
81
- this.log.info(`Processing proposal for slot ${slotNumber}`, {
82
- ...proposalInfo,
83
- txHashes: proposal.txHashes.map((t)=>t.toString())
84
- });
85
- // Check that the proposal is from the current proposer, or the next proposer
86
- // This should have been handled by the p2p layer, but we double check here out of caution
87
- const invalidProposal = await this.blockProposalValidator.validate(proposal);
88
- if (invalidProposal) {
89
- this.log.warn(`Proposal is not valid, skipping processing`, proposalInfo);
90
- return {
91
- isValid: false,
92
- reason: 'invalid_proposal'
93
- };
94
- }
95
- // Check that the parent proposal is a block we know, otherwise reexecution would fail
96
- const parentBlockHeader = await this.getParentBlock(proposal);
97
- if (parentBlockHeader === undefined) {
98
- this.log.warn(`Parent block for proposal not found, skipping processing`, proposalInfo);
99
- return {
100
- isValid: false,
101
- reason: 'parent_block_not_found'
102
- };
103
- }
104
- // Check that the parent block's slot is less than the proposal's slot (should not happen, but we check anyway)
105
- if (parentBlockHeader !== 'genesis' && parentBlockHeader.getSlot() >= slotNumber) {
106
- this.log.warn(`Parent block slot is greater than or equal to proposal slot, skipping processing`, {
107
- parentBlockSlot: parentBlockHeader.getSlot().toString(),
108
- proposalSlot: slotNumber.toString(),
109
- ...proposalInfo
110
- });
111
- return {
112
- isValid: false,
113
- reason: 'parent_block_wrong_slot'
114
- };
115
- }
116
- // Compute the block number based on the parent block
117
- const blockNumber = parentBlockHeader === 'genesis' ? INITIAL_L2_BLOCK_NUM : parentBlockHeader.getBlockNumber() + 1;
118
- // Check that this block number does not exist already
119
- const existingBlock = await this.blockSource.getBlockHeader(blockNumber);
120
- if (existingBlock) {
121
- this.log.warn(`Block number ${blockNumber} already exists, skipping processing`, proposalInfo);
122
- return {
123
- isValid: false,
124
- blockNumber,
125
- reason: 'block_number_already_exists'
126
- };
127
- }
128
- // Collect txs from the proposal. We start doing this as early as possible,
129
- // and we do it even if we don't plan to re-execute the txs, so that we have them if another node needs them.
130
- const { txs, missingTxs } = await this.txProvider.getTxsForBlockProposal(proposal, blockNumber, {
131
- pinnedPeer: proposalSender,
132
- deadline: this.getReexecutionDeadline(slotNumber, config)
133
- });
134
- // Check that I have the same set of l1ToL2Messages as the proposal
135
- const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(blockNumber);
136
- const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
137
- const proposalInHash = proposal.payload.header.contentCommitment.inHash;
138
- if (!computedInHash.equals(proposalInHash)) {
139
- this.log.warn(`L1 to L2 messages in hash mismatch, skipping processing`, {
140
- proposalInHash: proposalInHash.toString(),
141
- computedInHash: computedInHash.toString(),
142
- ...proposalInfo
143
- });
144
- return {
145
- isValid: false,
146
- blockNumber,
147
- reason: 'in_hash_mismatch'
148
- };
149
- }
150
- // Check that all of the transactions in the proposal are available
151
- if (missingTxs.length > 0) {
152
- this.log.warn(`Missing ${missingTxs.length} txs to process proposal`, {
153
- ...proposalInfo,
154
- missingTxs
155
- });
156
- return {
157
- isValid: false,
158
- blockNumber,
159
- reason: 'txs_not_available'
160
- };
161
- }
162
- // Try re-executing the transactions in the proposal if needed
163
- let reexecutionResult;
164
- if (shouldReexecute) {
165
- try {
166
- this.log.verbose(`Re-executing transactions in the proposal`, proposalInfo);
167
- reexecutionResult = await this.reexecuteTransactions(proposal, blockNumber, txs, l1ToL2Messages);
168
- } catch (error) {
169
- this.log.error(`Error reexecuting txs while processing block proposal`, error, proposalInfo);
170
- const reason = this.getReexecuteFailureReason(error);
171
- return {
172
- isValid: false,
173
- blockNumber,
174
- reason,
175
- reexecutionResult
176
- };
177
- }
178
- }
179
- this.log.info(`Successfully processed proposal for slot ${slotNumber}`, proposalInfo);
180
- return {
181
- isValid: true,
182
- blockNumber,
183
- reexecutionResult
184
- };
185
- }
186
- async getParentBlock(proposal) {
187
- const parentArchive = proposal.payload.header.lastArchiveRoot;
188
- const slot = proposal.slotNumber;
189
- const config = this.blockBuilder.getConfig();
190
- const { genesisArchiveRoot } = await this.blockSource.getGenesisValues();
191
- if (parentArchive.equals(genesisArchiveRoot)) {
192
- return 'genesis';
193
- }
194
- const deadline = this.getReexecutionDeadline(slot, config);
195
- const currentTime = this.dateProvider.now();
196
- const timeoutDurationMs = deadline.getTime() - currentTime;
197
- try {
198
- return await this.blockSource.getBlockHeaderByArchive(parentArchive) ?? (timeoutDurationMs <= 0 ? undefined : await retryUntil(()=>this.blockSource.syncImmediate().then(()=>this.blockSource.getBlockHeaderByArchive(parentArchive)), 'force archiver sync', timeoutDurationMs / 1000, 0.5));
199
- } catch (err) {
200
- if (err instanceof TimeoutError) {
201
- this.log.debug(`Timed out getting parent block by archive root`, {
202
- parentArchive
203
- });
204
- } else {
205
- this.log.error('Error getting parent block by archive root', err, {
206
- parentArchive
207
- });
208
- }
209
- return undefined;
210
- }
211
- }
212
- getReexecutionDeadline(slot, config) {
213
- const nextSlotTimestampSeconds = Number(getTimestampForSlot(SlotNumber(slot + 1), config));
214
- const msNeededForPropagationAndPublishing = this.config.validatorReexecuteDeadlineMs;
215
- return new Date(nextSlotTimestampSeconds * 1000 - msNeededForPropagationAndPublishing);
216
- }
217
- getReexecuteFailureReason(err) {
218
- if (err instanceof ReExStateMismatchError) {
219
- return 'state_mismatch';
220
- } else if (err instanceof ReExFailedTxsError) {
221
- return 'failed_txs';
222
- } else if (err instanceof ReExTimeoutError) {
223
- return 'timeout';
224
- } else {
225
- return 'unknown_error';
226
- }
227
- }
228
- async reexecuteTransactions(proposal, blockNumber, txs, l1ToL2Messages) {
229
- const { header } = proposal.payload;
230
- const { txHashes } = proposal;
231
- // If we do not have all of the transactions, then we should fail
232
- if (txs.length !== txHashes.length) {
233
- const foundTxHashes = txs.map((tx)=>tx.getTxHash());
234
- const missingTxHashes = txHashes.filter((txHash)=>!foundTxHashes.includes(txHash));
235
- throw new TransactionsNotAvailableError(missingTxHashes);
236
- }
237
- // Use the sequencer's block building logic to re-execute the transactions
238
- const timer = new Timer();
239
- const config = this.blockBuilder.getConfig();
240
- // We source most global variables from the proposal
241
- const globalVariables = GlobalVariables.from({
242
- slotNumber: proposal.payload.header.slotNumber,
243
- coinbase: proposal.payload.header.coinbase,
244
- feeRecipient: proposal.payload.header.feeRecipient,
245
- gasFees: proposal.payload.header.gasFees,
246
- blockNumber,
247
- timestamp: header.timestamp,
248
- chainId: new Fr(config.l1ChainId),
249
- version: new Fr(config.rollupVersion)
250
- });
251
- const { block, failedTxs } = await this.blockBuilder.buildBlock(txs, l1ToL2Messages, globalVariables, {
252
- deadline: this.getReexecutionDeadline(proposal.payload.header.slotNumber, config)
253
- });
254
- const numFailedTxs = failedTxs.length;
255
- const slot = proposal.slotNumber;
256
- this.log.verbose(`Transaction re-execution complete for slot ${slot}`, {
257
- numFailedTxs,
258
- numProposalTxs: txHashes.length,
259
- numProcessedTxs: block.body.txEffects.length,
260
- slot
261
- });
262
- if (numFailedTxs > 0) {
263
- this.metrics?.recordFailedReexecution(proposal);
264
- throw new ReExFailedTxsError(numFailedTxs);
265
- }
266
- if (block.body.txEffects.length !== txHashes.length) {
267
- this.metrics?.recordFailedReexecution(proposal);
268
- throw new ReExTimeoutError();
269
- }
270
- // Throw a ReExStateMismatchError error if state updates do not match
271
- const blockPayload = ConsensusPayload.fromBlock(block);
272
- if (!blockPayload.equals(proposal.payload)) {
273
- this.log.warn(`Re-execution state mismatch for slot ${slot}`, {
274
- expected: blockPayload.toInspect(),
275
- actual: proposal.payload.toInspect()
276
- });
277
- this.metrics?.recordFailedReexecution(proposal);
278
- throw new ReExStateMismatchError(proposal.archive, block.archive.root);
279
- }
280
- const reexecutionTimeMs = timer.ms();
281
- const totalManaUsed = block.header.totalManaUsed.toNumber() / 1e6;
282
- this.metrics?.recordReex(reexecutionTimeMs, txs.length, totalManaUsed);
283
- return {
284
- block,
285
- failedTxs,
286
- reexecutionTimeMs,
287
- totalManaUsed
288
- };
289
- }
290
- }