@aztec/sequencer-client 0.0.1-commit.0c875d939 → 0.0.1-commit.10bd49492

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 (69) hide show
  1. package/dest/client/sequencer-client.d.ts +23 -7
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +99 -16
  4. package/dest/config.d.ts +24 -5
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +36 -20
  7. package/dest/global_variable_builder/global_builder.d.ts +2 -4
  8. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  9. package/dest/publisher/config.d.ts +35 -17
  10. package/dest/publisher/config.d.ts.map +1 -1
  11. package/dest/publisher/config.js +106 -42
  12. package/dest/publisher/index.d.ts +2 -1
  13. package/dest/publisher/index.d.ts.map +1 -1
  14. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  15. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  16. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  17. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
  18. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  19. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  20. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  21. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  22. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  23. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  24. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  25. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  26. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
  27. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  28. package/dest/publisher/sequencer-publisher-factory.js +27 -2
  29. package/dest/publisher/sequencer-publisher.d.ts +19 -7
  30. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  31. package/dest/publisher/sequencer-publisher.js +285 -25
  32. package/dest/sequencer/checkpoint_proposal_job.d.ts +2 -4
  33. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  34. package/dest/sequencer/checkpoint_proposal_job.js +99 -47
  35. package/dest/sequencer/metrics.d.ts +14 -5
  36. package/dest/sequencer/metrics.d.ts.map +1 -1
  37. package/dest/sequencer/metrics.js +61 -15
  38. package/dest/sequencer/sequencer.d.ts +24 -13
  39. package/dest/sequencer/sequencer.d.ts.map +1 -1
  40. package/dest/sequencer/sequencer.js +35 -39
  41. package/dest/sequencer/timetable.d.ts +4 -3
  42. package/dest/sequencer/timetable.d.ts.map +1 -1
  43. package/dest/sequencer/timetable.js +6 -7
  44. package/dest/sequencer/types.d.ts +2 -2
  45. package/dest/sequencer/types.d.ts.map +1 -1
  46. package/dest/test/index.d.ts +3 -5
  47. package/dest/test/index.d.ts.map +1 -1
  48. package/dest/test/mock_checkpoint_builder.d.ts +4 -6
  49. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  50. package/dest/test/mock_checkpoint_builder.js +39 -30
  51. package/package.json +28 -28
  52. package/src/client/sequencer-client.ts +135 -18
  53. package/src/config.ts +45 -27
  54. package/src/global_variable_builder/global_builder.ts +1 -1
  55. package/src/publisher/config.ts +121 -43
  56. package/src/publisher/index.ts +3 -0
  57. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  58. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  59. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  60. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  61. package/src/publisher/sequencer-publisher-factory.ts +38 -6
  62. package/src/publisher/sequencer-publisher.ts +273 -38
  63. package/src/sequencer/checkpoint_proposal_job.ts +133 -56
  64. package/src/sequencer/metrics.ts +68 -18
  65. package/src/sequencer/sequencer.ts +44 -45
  66. package/src/sequencer/timetable.ts +7 -7
  67. package/src/sequencer/types.ts +1 -1
  68. package/src/test/index.ts +2 -4
  69. package/src/test/mock_checkpoint_builder.ts +48 -45
@@ -1,6 +1,8 @@
1
+ import { IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
1
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { unfreeze } from '@aztec/foundation/types';
4
+ import { L2Block } from '@aztec/stdlib/block';
2
5
  import { Checkpoint } from '@aztec/stdlib/checkpoint';
3
- import { Gas } from '@aztec/stdlib/gas';
4
6
  import { CheckpointHeader } from '@aztec/stdlib/rollup';
5
7
  import { makeAppendOnlyTreeSnapshot } from '@aztec/stdlib/testing';
6
8
  /**
@@ -63,8 +65,10 @@ import { makeAppendOnlyTreeSnapshot } from '@aztec/stdlib/testing';
63
65
  let block;
64
66
  let usedTxs;
65
67
  if (this.blockProvider) {
66
- // Dynamic mode: get block from provider
67
- block = this.blockProvider();
68
+ // Dynamic mode: get block from provider, cloning to avoid shared references across multiple buildBlock calls
69
+ block = L2Block.fromBuffer(this.blockProvider().toBuffer());
70
+ block.header.globalVariables.blockNumber = blockNumber;
71
+ await block.header.recomputeHash();
68
72
  usedTxs = [];
69
73
  this.builtBlocks.push(block);
70
74
  } else {
@@ -87,61 +91,63 @@ import { makeAppendOnlyTreeSnapshot } from '@aztec/stdlib/testing';
87
91
  }
88
92
  return {
89
93
  block,
90
- publicGas: Gas.empty(),
91
94
  publicProcessorDuration: 0,
92
95
  numTxs: block?.body?.txEffects?.length ?? usedTxs.length,
93
96
  usedTxs,
94
- failedTxs: [],
95
- usedTxBlobFields: block?.body?.txEffects?.reduce((sum, tx)=>sum + tx.getNumBlobFields(), 0) ?? 0
97
+ failedTxs: []
96
98
  };
97
99
  }
98
100
  completeCheckpoint() {
99
101
  this.completeCheckpointCalled = true;
100
102
  const allBlocks = this.blockProvider ? this.builtBlocks : this.blocks;
101
- const lastBlock = allBlocks[allBlocks.length - 1];
102
- // Create a CheckpointHeader from the last block's header for testing
103
- const checkpointHeader = this.createCheckpointHeader(lastBlock);
104
- return Promise.resolve(new Checkpoint(makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1), checkpointHeader, allBlocks, this.checkpointNumber));
103
+ return this.buildCheckpoint(allBlocks);
105
104
  }
106
105
  getCheckpoint() {
107
106
  this.getCheckpointCalled = true;
108
107
  const builtBlocks = this.blockProvider ? this.builtBlocks : this.blocks.slice(0, this.blockIndex);
109
- const lastBlock = builtBlocks[builtBlocks.length - 1];
110
- if (!lastBlock) {
108
+ if (builtBlocks.length === 0) {
111
109
  throw new Error('No blocks built yet');
112
110
  }
113
- // Create a CheckpointHeader from the last block's header for testing
114
- const checkpointHeader = this.createCheckpointHeader(lastBlock);
115
- return Promise.resolve(new Checkpoint(makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1), checkpointHeader, builtBlocks, this.checkpointNumber));
116
- }
117
- /**
118
- * Creates a CheckpointHeader from a block's header for testing.
119
- * This is a simplified version that creates a minimal CheckpointHeader.
120
- */ createCheckpointHeader(block) {
121
- const header = block.header;
122
- const gv = header.globalVariables;
123
- return CheckpointHeader.empty({
124
- lastArchiveRoot: header.lastArchive.root,
111
+ return this.buildCheckpoint(builtBlocks);
112
+ }
113
+ /** Builds a structurally valid Checkpoint from a list of blocks, fixing up indexes and archive chaining. */ async buildCheckpoint(blocks) {
114
+ // Fix up indexWithinCheckpoint and archive chaining so the checkpoint passes structural validation.
115
+ for(let i = 0; i < blocks.length; i++){
116
+ blocks[i].indexWithinCheckpoint = IndexWithinCheckpoint(i);
117
+ if (i > 0) {
118
+ unfreeze(blocks[i].header).lastArchive = blocks[i - 1].archive;
119
+ await blocks[i].header.recomputeHash();
120
+ }
121
+ }
122
+ const firstBlock = blocks[0];
123
+ const lastBlock = blocks[blocks.length - 1];
124
+ const gv = firstBlock.header.globalVariables;
125
+ const checkpointHeader = CheckpointHeader.empty({
126
+ lastArchiveRoot: firstBlock.header.lastArchive.root,
125
127
  blockHeadersHash: Fr.random(),
126
128
  slotNumber: gv.slotNumber,
127
129
  timestamp: gv.timestamp,
128
130
  coinbase: gv.coinbase,
129
131
  feeRecipient: gv.feeRecipient,
130
132
  gasFees: gv.gasFees,
131
- totalManaUsed: header.totalManaUsed
133
+ totalManaUsed: lastBlock.header.totalManaUsed
132
134
  });
135
+ return new Checkpoint(makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1), checkpointHeader, blocks, this.checkpointNumber);
133
136
  }
134
- /** Reset for reuse in another test */ reset() {
135
- this.blocks = [];
137
+ /** Resets per-checkpoint state (built blocks, consumed txs) while preserving config (blockProvider, seeded blocks). */ resetCheckpointState() {
136
138
  this.builtBlocks = [];
137
- this.usedTxsPerBlock = [];
138
139
  this.blockIndex = 0;
139
- this.buildBlockCalls = [];
140
140
  this.consumedTxHashes.clear();
141
141
  this.completeCheckpointCalled = false;
142
142
  this.getCheckpointCalled = false;
143
+ }
144
+ /** Reset for reuse in another test */ reset() {
145
+ this.blocks = [];
146
+ this.usedTxsPerBlock = [];
147
+ this.buildBlockCalls = [];
143
148
  this.errorOnBuild = undefined;
144
149
  this.blockProvider = undefined;
150
+ this.resetCheckpointState();
145
151
  }
146
152
  }
147
153
  /**
@@ -175,7 +181,8 @@ import { makeAppendOnlyTreeSnapshot } from '@aztec/stdlib/testing';
175
181
  l1GenesisTime: 0n,
176
182
  slotDuration: 24,
177
183
  l1ChainId: 1,
178
- rollupVersion: 1
184
+ rollupVersion: 1,
185
+ rollupManaLimit: 200_000_000
179
186
  };
180
187
  }
181
188
  updateConfig(config) {
@@ -192,6 +199,8 @@ import { makeAppendOnlyTreeSnapshot } from '@aztec/stdlib/testing';
192
199
  if (!this.checkpointBuilder) {
193
200
  // Auto-create a builder if none was set
194
201
  this.checkpointBuilder = new MockCheckpointBuilder(constants, checkpointNumber);
202
+ } else {
203
+ this.checkpointBuilder.resetCheckpointState();
195
204
  }
196
205
  return Promise.resolve(this.checkpointBuilder);
197
206
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/sequencer-client",
3
- "version": "0.0.1-commit.0c875d939",
3
+ "version": "0.0.1-commit.10bd49492",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
@@ -26,38 +26,38 @@
26
26
  "test:integration:run": "NODE_NO_WARNINGS=1 node --experimental-vm-modules $(yarn bin jest) --no-cache --config jest.integration.config.json"
27
27
  },
28
28
  "dependencies": {
29
- "@aztec/aztec.js": "0.0.1-commit.0c875d939",
30
- "@aztec/bb-prover": "0.0.1-commit.0c875d939",
31
- "@aztec/blob-client": "0.0.1-commit.0c875d939",
32
- "@aztec/blob-lib": "0.0.1-commit.0c875d939",
33
- "@aztec/constants": "0.0.1-commit.0c875d939",
34
- "@aztec/epoch-cache": "0.0.1-commit.0c875d939",
35
- "@aztec/ethereum": "0.0.1-commit.0c875d939",
36
- "@aztec/foundation": "0.0.1-commit.0c875d939",
37
- "@aztec/l1-artifacts": "0.0.1-commit.0c875d939",
38
- "@aztec/merkle-tree": "0.0.1-commit.0c875d939",
39
- "@aztec/node-keystore": "0.0.1-commit.0c875d939",
40
- "@aztec/noir-acvm_js": "0.0.1-commit.0c875d939",
41
- "@aztec/noir-contracts.js": "0.0.1-commit.0c875d939",
42
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.0c875d939",
43
- "@aztec/noir-types": "0.0.1-commit.0c875d939",
44
- "@aztec/p2p": "0.0.1-commit.0c875d939",
45
- "@aztec/protocol-contracts": "0.0.1-commit.0c875d939",
46
- "@aztec/prover-client": "0.0.1-commit.0c875d939",
47
- "@aztec/simulator": "0.0.1-commit.0c875d939",
48
- "@aztec/slasher": "0.0.1-commit.0c875d939",
49
- "@aztec/stdlib": "0.0.1-commit.0c875d939",
50
- "@aztec/telemetry-client": "0.0.1-commit.0c875d939",
51
- "@aztec/validator-client": "0.0.1-commit.0c875d939",
52
- "@aztec/validator-ha-signer": "0.0.1-commit.0c875d939",
53
- "@aztec/world-state": "0.0.1-commit.0c875d939",
29
+ "@aztec/aztec.js": "0.0.1-commit.10bd49492",
30
+ "@aztec/bb-prover": "0.0.1-commit.10bd49492",
31
+ "@aztec/blob-client": "0.0.1-commit.10bd49492",
32
+ "@aztec/blob-lib": "0.0.1-commit.10bd49492",
33
+ "@aztec/constants": "0.0.1-commit.10bd49492",
34
+ "@aztec/epoch-cache": "0.0.1-commit.10bd49492",
35
+ "@aztec/ethereum": "0.0.1-commit.10bd49492",
36
+ "@aztec/foundation": "0.0.1-commit.10bd49492",
37
+ "@aztec/l1-artifacts": "0.0.1-commit.10bd49492",
38
+ "@aztec/merkle-tree": "0.0.1-commit.10bd49492",
39
+ "@aztec/node-keystore": "0.0.1-commit.10bd49492",
40
+ "@aztec/noir-acvm_js": "0.0.1-commit.10bd49492",
41
+ "@aztec/noir-contracts.js": "0.0.1-commit.10bd49492",
42
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.10bd49492",
43
+ "@aztec/noir-types": "0.0.1-commit.10bd49492",
44
+ "@aztec/p2p": "0.0.1-commit.10bd49492",
45
+ "@aztec/protocol-contracts": "0.0.1-commit.10bd49492",
46
+ "@aztec/prover-client": "0.0.1-commit.10bd49492",
47
+ "@aztec/simulator": "0.0.1-commit.10bd49492",
48
+ "@aztec/slasher": "0.0.1-commit.10bd49492",
49
+ "@aztec/stdlib": "0.0.1-commit.10bd49492",
50
+ "@aztec/telemetry-client": "0.0.1-commit.10bd49492",
51
+ "@aztec/validator-client": "0.0.1-commit.10bd49492",
52
+ "@aztec/validator-ha-signer": "0.0.1-commit.10bd49492",
53
+ "@aztec/world-state": "0.0.1-commit.10bd49492",
54
54
  "lodash.chunk": "^4.2.0",
55
55
  "tslib": "^2.4.0",
56
56
  "viem": "npm:@aztec/viem@2.38.2"
57
57
  },
58
58
  "devDependencies": {
59
- "@aztec/archiver": "0.0.1-commit.0c875d939",
60
- "@aztec/kv-store": "0.0.1-commit.0c875d939",
59
+ "@aztec/archiver": "0.0.1-commit.10bd49492",
60
+ "@aztec/kv-store": "0.0.1-commit.10bd49492",
61
61
  "@electric-sql/pglite": "^0.3.14",
62
62
  "@jest/globals": "^30.0.0",
63
63
  "@types/jest": "^30.0.0",
@@ -1,9 +1,10 @@
1
1
  import type { BlobClientInterface } from '@aztec/blob-client/client';
2
+ import { MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT } from '@aztec/constants';
2
3
  import { EpochCache } from '@aztec/epoch-cache';
3
4
  import { isAnvilTestChain } from '@aztec/ethereum/chain';
4
5
  import { getPublicClient } from '@aztec/ethereum/client';
5
6
  import { GovernanceProposerContract, RollupContract } from '@aztec/ethereum/contracts';
6
- import { L1TxUtilsWithBlobs } from '@aztec/ethereum/l1-tx-utils-with-blobs';
7
+ import { type Delayer, L1TxUtils } from '@aztec/ethereum/l1-tx-utils';
7
8
  import { PublisherManager } from '@aztec/ethereum/publisher-manager';
8
9
  import { EthAddress } from '@aztec/foundation/eth-address';
9
10
  import { createLogger } from '@aztec/foundation/log';
@@ -18,21 +19,27 @@ import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
18
19
  import { L1Metrics, type TelemetryClient } from '@aztec/telemetry-client';
19
20
  import { FullNodeCheckpointsBuilder, NodeKeystoreAdapter, type ValidatorClient } from '@aztec/validator-client';
20
21
 
21
- import type { SequencerClientConfig } from '../config.js';
22
+ import {
23
+ DefaultSequencerConfig,
24
+ type SequencerClientConfig,
25
+ getPublisherConfigFromSequencerConfig,
26
+ } from '../config.js';
22
27
  import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
23
28
  import { SequencerPublisherFactory } from '../publisher/sequencer-publisher-factory.js';
24
29
  import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
30
+ import { SequencerTimetable } from '../sequencer/timetable.js';
25
31
 
26
32
  /**
27
33
  * Encapsulates the full sequencer and publisher.
28
34
  */
29
35
  export class SequencerClient {
30
36
  constructor(
31
- protected publisherManager: PublisherManager<L1TxUtilsWithBlobs>,
37
+ protected publisherManager: PublisherManager<L1TxUtils>,
32
38
  protected sequencer: Sequencer,
33
39
  protected checkpointsBuilder: FullNodeCheckpointsBuilder,
34
40
  protected validatorClient?: ValidatorClient,
35
41
  private l1Metrics?: L1Metrics,
42
+ private delayer_?: Delayer,
36
43
  ) {}
37
44
 
38
45
  /**
@@ -62,7 +69,7 @@ export class SequencerClient {
62
69
  blobClient: BlobClientInterface;
63
70
  dateProvider: DateProvider;
64
71
  epochCache?: EpochCache;
65
- l1TxUtils: L1TxUtilsWithBlobs[];
72
+ l1TxUtils: L1TxUtils[];
66
73
  nodeKeyStore: KeystoreManager;
67
74
  },
68
75
  ) {
@@ -85,7 +92,11 @@ export class SequencerClient {
85
92
  publicClient,
86
93
  l1TxUtils.map(x => x.getSenderAddress()),
87
94
  );
88
- const publisherManager = new PublisherManager(l1TxUtils, config, log.getBindings());
95
+ const publisherManager = new PublisherManager(
96
+ l1TxUtils,
97
+ getPublisherConfigFromSequencerConfig(config),
98
+ log.getBindings(),
99
+ );
89
100
  const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
90
101
  const [l1GenesisTime, slotDuration, rollupVersion, rollupManaLimit] = await Promise.all([
91
102
  rollupContract.getL1GenesisTime(),
@@ -132,17 +143,14 @@ export class SequencerClient {
132
143
  });
133
144
 
134
145
  const ethereumSlotDuration = config.ethereumSlotDuration;
135
- const l1Constants = { l1GenesisTime, slotDuration: Number(slotDuration), ethereumSlotDuration };
136
-
137
- const globalsBuilder = new GlobalVariableBuilder({ ...config, ...l1Constants, rollupVersion });
138
146
 
139
- let sequencerManaLimit = config.maxL2BlockGas ?? rollupManaLimit;
140
- if (sequencerManaLimit > rollupManaLimit) {
141
- log.warn(
142
- `Provided maxL2BlockGas ${sequencerManaLimit} is greater than the max allowed by L1. Setting limit to ${rollupManaLimit}.`,
143
- );
144
- sequencerManaLimit = rollupManaLimit;
145
- }
147
+ const globalsBuilder = new GlobalVariableBuilder({
148
+ ...config,
149
+ l1GenesisTime,
150
+ slotDuration: Number(slotDuration),
151
+ ethereumSlotDuration,
152
+ rollupVersion,
153
+ });
146
154
 
147
155
  // When running in anvil, assume we can post a tx up until one second before the end of an L1 slot.
148
156
  // Otherwise, we need the full L1 slot duration for publishing to ensure inclusion.
@@ -152,6 +160,15 @@ export class SequencerClient {
152
160
  const l1PublishingTimeBasedOnChain = isAnvilTestChain(config.l1ChainId) ? 1 : ethereumSlotDuration;
153
161
  const l1PublishingTime = config.l1PublishingTime ?? l1PublishingTimeBasedOnChain;
154
162
 
163
+ const { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock } = computeBlockLimits(
164
+ config,
165
+ rollupManaLimit,
166
+ l1PublishingTime,
167
+ log,
168
+ );
169
+
170
+ const l1Constants = { l1GenesisTime, slotDuration: Number(slotDuration), ethereumSlotDuration, rollupManaLimit };
171
+
155
172
  const sequencer = new Sequencer(
156
173
  publisherFactory,
157
174
  validatorClient,
@@ -166,14 +183,17 @@ export class SequencerClient {
166
183
  deps.dateProvider,
167
184
  epochCache,
168
185
  rollupContract,
169
- { ...config, l1PublishingTime, maxL2BlockGas: sequencerManaLimit },
186
+ { ...config, l1PublishingTime, maxL2BlockGas, maxDABlockGas, maxTxsPerBlock },
170
187
  telemetryClient,
171
188
  log,
172
189
  );
173
190
 
174
- await sequencer.init();
191
+ sequencer.init();
192
+
193
+ // Extract the shared delayer from the first L1TxUtils instance (all instances share the same delayer)
194
+ const delayer = l1TxUtils[0]?.delayer;
175
195
 
176
- return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics);
196
+ return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer);
177
197
  }
178
198
 
179
199
  /**
@@ -208,6 +228,16 @@ export class SequencerClient {
208
228
  return this.sequencer;
209
229
  }
210
230
 
231
+ /** Updates the publisher factory's node keystore adapter after a keystore reload. */
232
+ public updatePublisherNodeKeyStore(adapter: NodeKeystoreAdapter): void {
233
+ this.sequencer.updatePublisherNodeKeyStore(adapter);
234
+ }
235
+
236
+ /** Returns the shared tx delayer for sequencer L1 txs, if enabled. Test-only. */
237
+ getDelayer(): Delayer | undefined {
238
+ return this.delayer_;
239
+ }
240
+
211
241
  get validatorAddresses(): EthAddress[] | undefined {
212
242
  return this.sequencer.getValidatorAddresses();
213
243
  }
@@ -216,3 +246,90 @@ export class SequencerClient {
216
246
  return this.sequencer.maxL2BlockGas;
217
247
  }
218
248
  }
249
+
250
+ /**
251
+ * Computes per-block L2 gas, DA gas, and TX count budgets based on the L1 rollup limits and the timetable.
252
+ * If the user explicitly set a limit, it is capped at the corresponding checkpoint limit.
253
+ * Otherwise, derives it as (checkpointLimit / maxBlocks) * multiplier, capped at the checkpoint limit.
254
+ */
255
+ export function computeBlockLimits(
256
+ config: SequencerClientConfig,
257
+ rollupManaLimit: number,
258
+ l1PublishingTime: number,
259
+ log: ReturnType<typeof createLogger>,
260
+ ): { maxL2BlockGas: number; maxDABlockGas: number; maxTxsPerBlock: number } {
261
+ const maxNumberOfBlocks = new SequencerTimetable({
262
+ ethereumSlotDuration: config.ethereumSlotDuration,
263
+ aztecSlotDuration: config.aztecSlotDuration,
264
+ l1PublishingTime,
265
+ p2pPropagationTime: config.attestationPropagationTime,
266
+ blockDurationMs: config.blockDurationMs,
267
+ enforce: config.enforceTimeTable ?? DefaultSequencerConfig.enforceTimeTable,
268
+ }).maxNumberOfBlocks;
269
+
270
+ const multiplier = config.perBlockAllocationMultiplier ?? DefaultSequencerConfig.perBlockAllocationMultiplier;
271
+
272
+ // Compute maxL2BlockGas
273
+ let maxL2BlockGas: number;
274
+ if (config.maxL2BlockGas !== undefined) {
275
+ if (config.maxL2BlockGas > rollupManaLimit) {
276
+ log.warn(
277
+ `Provided MAX_L2_BLOCK_GAS ${config.maxL2BlockGas} exceeds L1 rollup mana limit ${rollupManaLimit} (capping)`,
278
+ );
279
+ maxL2BlockGas = rollupManaLimit;
280
+ } else {
281
+ maxL2BlockGas = config.maxL2BlockGas;
282
+ }
283
+ } else {
284
+ maxL2BlockGas = Math.min(rollupManaLimit, Math.ceil((rollupManaLimit / maxNumberOfBlocks) * multiplier));
285
+ }
286
+
287
+ // Compute maxDABlockGas
288
+ const daCheckpointLimit = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT;
289
+ let maxDABlockGas: number;
290
+ if (config.maxDABlockGas !== undefined) {
291
+ if (config.maxDABlockGas > daCheckpointLimit) {
292
+ log.warn(
293
+ `Provided MAX_DA_BLOCK_GAS ${config.maxDABlockGas} exceeds DA checkpoint limit ${daCheckpointLimit} (capping)`,
294
+ );
295
+ maxDABlockGas = daCheckpointLimit;
296
+ } else {
297
+ maxDABlockGas = config.maxDABlockGas;
298
+ }
299
+ } else {
300
+ maxDABlockGas = Math.min(daCheckpointLimit, Math.ceil((daCheckpointLimit / maxNumberOfBlocks) * multiplier));
301
+ }
302
+
303
+ // Compute maxTxsPerBlock
304
+ const defaultMaxTxsPerBlock = 32;
305
+ let maxTxsPerBlock: number;
306
+ if (config.maxTxsPerBlock !== undefined) {
307
+ if (config.maxTxsPerCheckpoint !== undefined && config.maxTxsPerBlock > config.maxTxsPerCheckpoint) {
308
+ log.warn(
309
+ `Provided MAX_TX_PER_BLOCK ${config.maxTxsPerBlock} exceeds MAX_TX_PER_CHECKPOINT ${config.maxTxsPerCheckpoint} (capping)`,
310
+ );
311
+ maxTxsPerBlock = config.maxTxsPerCheckpoint;
312
+ } else {
313
+ maxTxsPerBlock = config.maxTxsPerBlock;
314
+ }
315
+ } else if (config.maxTxsPerCheckpoint !== undefined) {
316
+ maxTxsPerBlock = Math.min(
317
+ config.maxTxsPerCheckpoint,
318
+ Math.ceil((config.maxTxsPerCheckpoint / maxNumberOfBlocks) * multiplier),
319
+ );
320
+ } else {
321
+ maxTxsPerBlock = defaultMaxTxsPerBlock;
322
+ }
323
+
324
+ log.info(`Computed block limits L2=${maxL2BlockGas} DA=${maxDABlockGas} maxTxs=${maxTxsPerBlock}`, {
325
+ maxL2BlockGas,
326
+ maxDABlockGas,
327
+ maxTxsPerBlock,
328
+ rollupManaLimit,
329
+ daCheckpointLimit,
330
+ maxNumberOfBlocks,
331
+ multiplier,
332
+ });
333
+
334
+ return { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock };
335
+ }
package/src/config.ts CHANGED
@@ -22,10 +22,10 @@ import { DEFAULT_P2P_PROPAGATION_TIME } from '@aztec/stdlib/timetable';
22
22
  import { type ValidatorClientConfig, validatorClientConfigMappings } from '@aztec/validator-client/config';
23
23
 
24
24
  import {
25
- type PublisherConfig,
26
- type TxSenderConfig,
27
- getPublisherConfigMappings,
28
- getTxSenderConfigMappings,
25
+ type SequencerPublisherConfig,
26
+ type SequencerTxSenderConfig,
27
+ sequencerPublisherConfigMappings,
28
+ sequencerTxSenderConfigMappings,
29
29
  } from './publisher/config.js';
30
30
 
31
31
  export * from './publisher/config.js';
@@ -35,15 +35,12 @@ export type { SequencerConfig };
35
35
  * Default values for SequencerConfig.
36
36
  * Centralized location for all sequencer configuration defaults.
37
37
  */
38
- export const DefaultSequencerConfig: ResolvedSequencerConfig = {
38
+ export const DefaultSequencerConfig = {
39
39
  sequencerPollingIntervalMS: 500,
40
- maxTxsPerBlock: 32,
41
40
  minTxsPerBlock: 1,
42
41
  buildCheckpointIfEmpty: false,
43
42
  publishTxsWithProposals: false,
44
- maxL2BlockGas: 10e9,
45
- maxDABlockGas: 10e9,
46
- maxBlockSizeInBytes: 1024 * 1024,
43
+ perBlockAllocationMultiplier: 2,
47
44
  enforceTimeTable: true,
48
45
  attestationPropagationTime: DEFAULT_P2P_PROPAGATION_TIME,
49
46
  secondsBeforeInvalidatingBlockAsCommitteeMember: 144, // 12 L1 blocks
@@ -52,22 +49,25 @@ export const DefaultSequencerConfig: ResolvedSequencerConfig = {
52
49
  skipInvalidateBlockAsProposer: false,
53
50
  broadcastInvalidBlockProposal: false,
54
51
  injectFakeAttestation: false,
52
+ injectHighSValueAttestation: false,
53
+ injectUnrecoverableSignatureAttestation: false,
55
54
  fishermanMode: false,
56
55
  shuffleAttestationOrdering: false,
57
56
  skipPushProposedBlocksToArchiver: false,
58
- };
57
+ skipPublishingCheckpointsPercent: 0,
58
+ } satisfies ResolvedSequencerConfig;
59
59
 
60
60
  /**
61
61
  * Configuration settings for the SequencerClient.
62
62
  */
63
- export type SequencerClientConfig = PublisherConfig &
63
+ export type SequencerClientConfig = SequencerPublisherConfig &
64
64
  KeyStoreConfig &
65
65
  ValidatorClientConfig &
66
- TxSenderConfig &
66
+ SequencerTxSenderConfig &
67
67
  SequencerConfig &
68
68
  L1ReaderConfig &
69
69
  ChainConfig &
70
- Pick<P2PConfig, 'txPublicSetupAllowList'> &
70
+ Pick<P2PConfig, 'txPublicSetupAllowListExtend'> &
71
71
  Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
72
72
 
73
73
  export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
@@ -76,10 +76,10 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
76
76
  description: 'The number of ms to wait between polling for checking to build on the next slot.',
77
77
  ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS),
78
78
  },
79
- maxTxsPerBlock: {
80
- env: 'SEQ_MAX_TX_PER_BLOCK',
81
- description: 'The maximum number of txs to include in a block.',
82
- ...numberConfigHelper(DefaultSequencerConfig.maxTxsPerBlock),
79
+ maxTxsPerCheckpoint: {
80
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
81
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
82
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
83
83
  },
84
84
  minTxsPerBlock: {
85
85
  env: 'SEQ_MIN_TX_PER_BLOCK',
@@ -98,12 +98,19 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
98
98
  maxL2BlockGas: {
99
99
  env: 'SEQ_MAX_L2_BLOCK_GAS',
100
100
  description: 'The maximum L2 block gas.',
101
- ...numberConfigHelper(DefaultSequencerConfig.maxL2BlockGas),
101
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
102
102
  },
103
103
  maxDABlockGas: {
104
104
  env: 'SEQ_MAX_DA_BLOCK_GAS',
105
105
  description: 'The maximum DA block gas.',
106
- ...numberConfigHelper(DefaultSequencerConfig.maxDABlockGas),
106
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
107
+ },
108
+ perBlockAllocationMultiplier: {
109
+ env: 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER',
110
+ description:
111
+ 'Per-block gas budget multiplier for both L2 and DA gas. Budget per block is (checkpointLimit / maxBlocks) * multiplier.' +
112
+ ' Values greater than one allow early blocks to use more than their even share, relying on checkpoint-level capping for later blocks.',
113
+ ...numberConfigHelper(DefaultSequencerConfig.perBlockAllocationMultiplier),
107
114
  },
108
115
  coinbase: {
109
116
  env: 'COINBASE',
@@ -123,11 +130,6 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
123
130
  env: 'ACVM_BINARY_PATH',
124
131
  description: 'The path to the ACVM binary',
125
132
  },
126
- maxBlockSizeInBytes: {
127
- env: 'SEQ_MAX_BLOCK_SIZE_IN_BYTES',
128
- description: 'Max block size',
129
- ...numberConfigHelper(DefaultSequencerConfig.maxBlockSizeInBytes),
130
- },
131
133
  enforceTimeTable: {
132
134
  env: 'SEQ_ENFORCE_TIME_TABLE',
133
135
  description: 'Whether to enforce the time table when building blocks',
@@ -185,6 +187,14 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
185
187
  description: 'Inject a fake attestation (for testing only)',
186
188
  ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation),
187
189
  },
190
+ injectHighSValueAttestation: {
191
+ description: 'Inject a malleable attestation with a high-s value (for testing only)',
192
+ ...booleanConfigHelper(DefaultSequencerConfig.injectHighSValueAttestation),
193
+ },
194
+ injectUnrecoverableSignatureAttestation: {
195
+ description: 'Inject an attestation with an unrecoverable signature (for testing only)',
196
+ ...booleanConfigHelper(DefaultSequencerConfig.injectUnrecoverableSignatureAttestation),
197
+ },
188
198
  fishermanMode: {
189
199
  env: 'FISHERMAN_MODE',
190
200
  description:
@@ -205,7 +215,15 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
205
215
  description: 'Skip pushing proposed blocks to archiver (default: true)',
206
216
  ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver),
207
217
  },
208
- ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowList']),
218
+ minBlocksForCheckpoint: {
219
+ description: 'Minimum number of blocks required for a checkpoint proposal (test only)',
220
+ },
221
+ skipPublishingCheckpointsPercent: {
222
+ env: 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT',
223
+ description: 'Percent probability (0 - 100) of sequencer skipping checkpoint publishing (testing only)',
224
+ ...numberConfigHelper(DefaultSequencerConfig.skipPublishingCheckpointsPercent),
225
+ },
226
+ ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowListExtend']),
209
227
  };
210
228
 
211
229
  export const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig> = {
@@ -213,8 +231,8 @@ export const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientCo
213
231
  ...sequencerConfigMappings,
214
232
  ...keyStoreConfigMappings,
215
233
  ...l1ReaderConfigMappings,
216
- ...getTxSenderConfigMappings('SEQ'),
217
- ...getPublisherConfigMappings('SEQ'),
234
+ ...sequencerTxSenderConfigMappings,
235
+ ...sequencerPublisherConfigMappings,
218
236
  ...chainConfigMappings,
219
237
  ...pickConfigMappings(l1ContractsConfigMappings, ['ethereumSlotDuration', 'aztecSlotDuration', 'aztecEpochDuration']),
220
238
  };
@@ -120,7 +120,7 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
120
120
  coinbase: EthAddress,
121
121
  feeRecipient: AztecAddress,
122
122
  slotNumber: SlotNumber,
123
- ): Promise<CheckpointGlobalVariables & { timestamp: bigint }> {
123
+ ): Promise<CheckpointGlobalVariables> {
124
124
  const { chainId, version } = this;
125
125
 
126
126
  const timestamp = getTimestampForSlot(slotNumber, {