@aztec/sequencer-client 0.0.1-commit.e2b2873ed → 0.0.1-commit.e304674f1

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 (85) hide show
  1. package/dest/client/sequencer-client.d.ts +15 -7
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +60 -30
  4. package/dest/config.d.ts +26 -6
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +44 -21
  7. package/dest/global_variable_builder/global_builder.d.ts +15 -11
  8. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  9. package/dest/global_variable_builder/global_builder.js +29 -25
  10. package/dest/global_variable_builder/index.d.ts +2 -2
  11. package/dest/global_variable_builder/index.d.ts.map +1 -1
  12. package/dest/publisher/config.d.ts +47 -17
  13. package/dest/publisher/config.d.ts.map +1 -1
  14. package/dest/publisher/config.js +121 -42
  15. package/dest/publisher/index.d.ts +2 -1
  16. package/dest/publisher/index.d.ts.map +1 -1
  17. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  18. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  19. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  20. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
  21. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  22. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  23. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  24. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  25. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  26. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  27. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  28. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  29. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -5
  30. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  31. package/dest/publisher/sequencer-publisher-factory.js +27 -3
  32. package/dest/publisher/sequencer-publisher.d.ts +82 -37
  33. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  34. package/dest/publisher/sequencer-publisher.js +430 -118
  35. package/dest/sequencer/checkpoint_proposal_job.d.ts +36 -9
  36. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  37. package/dest/sequencer/checkpoint_proposal_job.js +361 -192
  38. package/dest/sequencer/checkpoint_voter.d.ts +1 -2
  39. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -1
  40. package/dest/sequencer/checkpoint_voter.js +2 -5
  41. package/dest/sequencer/events.d.ts +2 -1
  42. package/dest/sequencer/events.d.ts.map +1 -1
  43. package/dest/sequencer/metrics.d.ts +21 -5
  44. package/dest/sequencer/metrics.d.ts.map +1 -1
  45. package/dest/sequencer/metrics.js +97 -15
  46. package/dest/sequencer/sequencer.d.ts +40 -17
  47. package/dest/sequencer/sequencer.d.ts.map +1 -1
  48. package/dest/sequencer/sequencer.js +152 -95
  49. package/dest/sequencer/timetable.d.ts +7 -3
  50. package/dest/sequencer/timetable.d.ts.map +1 -1
  51. package/dest/sequencer/timetable.js +21 -12
  52. package/dest/sequencer/types.d.ts +2 -2
  53. package/dest/sequencer/types.d.ts.map +1 -1
  54. package/dest/test/index.d.ts +3 -5
  55. package/dest/test/index.d.ts.map +1 -1
  56. package/dest/test/mock_checkpoint_builder.d.ts +11 -11
  57. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  58. package/dest/test/mock_checkpoint_builder.js +45 -34
  59. package/dest/test/utils.d.ts +3 -3
  60. package/dest/test/utils.d.ts.map +1 -1
  61. package/dest/test/utils.js +5 -4
  62. package/package.json +27 -28
  63. package/src/client/sequencer-client.ts +76 -30
  64. package/src/config.ts +56 -27
  65. package/src/global_variable_builder/global_builder.ts +38 -27
  66. package/src/global_variable_builder/index.ts +1 -1
  67. package/src/publisher/config.ts +153 -43
  68. package/src/publisher/index.ts +3 -0
  69. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  70. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  71. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  72. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  73. package/src/publisher/sequencer-publisher-factory.ts +38 -9
  74. package/src/publisher/sequencer-publisher.ts +503 -168
  75. package/src/sequencer/README.md +81 -12
  76. package/src/sequencer/checkpoint_proposal_job.ts +471 -201
  77. package/src/sequencer/checkpoint_voter.ts +1 -12
  78. package/src/sequencer/events.ts +1 -1
  79. package/src/sequencer/metrics.ts +106 -18
  80. package/src/sequencer/sequencer.ts +216 -109
  81. package/src/sequencer/timetable.ts +26 -15
  82. package/src/sequencer/types.ts +1 -1
  83. package/src/test/index.ts +2 -4
  84. package/src/test/mock_checkpoint_builder.ts +63 -49
  85. package/src/test/utils.ts +5 -2
@@ -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';
@@ -13,13 +14,12 @@ import type { P2P } from '@aztec/p2p';
13
14
  import type { SlasherClientInterface } from '@aztec/slasher';
14
15
  import type { L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
15
16
  import type { ValidatorClientFullConfig, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
16
- import { SlashFactoryContract } from '@aztec/stdlib/l1-contracts';
17
17
  import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
18
18
  import { L1Metrics, type TelemetryClient } from '@aztec/telemetry-client';
19
19
  import { FullNodeCheckpointsBuilder, NodeKeystoreAdapter, type ValidatorClient } from '@aztec/validator-client';
20
20
 
21
- import type { SequencerClientConfig } from '../config.js';
22
- import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
21
+ import { type SequencerClientConfig, getPublisherConfigFromSequencerConfig } from '../config.js';
22
+ import type { GlobalVariableBuilder } from '../global_variable_builder/index.js';
23
23
  import { SequencerPublisherFactory } from '../publisher/sequencer-publisher-factory.js';
24
24
  import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
25
25
 
@@ -28,11 +28,12 @@ import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
28
28
  */
29
29
  export class SequencerClient {
30
30
  constructor(
31
- protected publisherManager: PublisherManager<L1TxUtilsWithBlobs>,
31
+ protected publisherManager: PublisherManager<L1TxUtils>,
32
32
  protected sequencer: Sequencer,
33
33
  protected checkpointsBuilder: FullNodeCheckpointsBuilder,
34
34
  protected validatorClient?: ValidatorClient,
35
35
  private l1Metrics?: L1Metrics,
36
+ private delayer_?: Delayer,
36
37
  ) {}
37
38
 
38
39
  /**
@@ -62,8 +63,10 @@ export class SequencerClient {
62
63
  blobClient: BlobClientInterface;
63
64
  dateProvider: DateProvider;
64
65
  epochCache?: EpochCache;
65
- l1TxUtils: L1TxUtilsWithBlobs[];
66
+ l1TxUtils: L1TxUtils[];
67
+ funderL1TxUtils?: L1TxUtils;
66
68
  nodeKeyStore: KeystoreManager;
69
+ globalVariableBuilder: GlobalVariableBuilder;
67
70
  },
68
71
  ) {
69
72
  const {
@@ -85,12 +88,14 @@ export class SequencerClient {
85
88
  publicClient,
86
89
  l1TxUtils.map(x => x.getSenderAddress()),
87
90
  );
88
- const publisherManager = new PublisherManager(l1TxUtils, config, log.getBindings());
91
+ const publisherManager = new PublisherManager(l1TxUtils, getPublisherConfigFromSequencerConfig(config), {
92
+ bindings: log.getBindings(),
93
+ funder: deps.funderL1TxUtils,
94
+ });
89
95
  const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
90
- const [l1GenesisTime, slotDuration, rollupVersion, rollupManaLimit] = await Promise.all([
96
+ const [l1GenesisTime, slotDuration, rollupManaLimit] = await Promise.all([
91
97
  rollupContract.getL1GenesisTime(),
92
98
  rollupContract.getSlotDuration(),
93
- rollupContract.getVersion(),
94
99
  rollupContract.getManaLimit().then(Number),
95
100
  ] as const);
96
101
 
@@ -107,15 +112,11 @@ export class SequencerClient {
107
112
  l1ChainId: chainId,
108
113
  viemPollingIntervalMS: config.viemPollingIntervalMS,
109
114
  ethereumSlotDuration: config.ethereumSlotDuration,
115
+ enableProposerPipelining: config.enableProposerPipelining,
110
116
  },
111
117
  { dateProvider: deps.dateProvider },
112
118
  ));
113
119
 
114
- const slashFactoryContract = new SlashFactoryContract(
115
- publicClient,
116
- config.l1Contracts.slashFactoryAddress?.toString() ?? EthAddress.ZERO.toString(),
117
- );
118
-
119
120
  const publisherFactory =
120
121
  deps.publisherFactory ??
121
122
  new SequencerPublisherFactory(config, {
@@ -123,7 +124,6 @@ export class SequencerClient {
123
124
  blobClient: deps.blobClient,
124
125
  epochCache,
125
126
  governanceProposerContract,
126
- slashFactoryContract,
127
127
  rollupContract,
128
128
  dateProvider: deps.dateProvider,
129
129
  publisherManager,
@@ -132,17 +132,8 @@ export class SequencerClient {
132
132
  });
133
133
 
134
134
  const ethereumSlotDuration = config.ethereumSlotDuration;
135
- const l1Constants = { l1GenesisTime, slotDuration: Number(slotDuration), ethereumSlotDuration };
136
135
 
137
- const globalsBuilder = new GlobalVariableBuilder({ ...config, ...l1Constants, rollupVersion });
138
-
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
- }
136
+ const globalsBuilder = deps.globalVariableBuilder;
146
137
 
147
138
  // When running in anvil, assume we can post a tx up until one second before the end of an L1 slot.
148
139
  // Otherwise, we need the full L1 slot duration for publishing to ensure inclusion.
@@ -152,6 +143,10 @@ export class SequencerClient {
152
143
  const l1PublishingTimeBasedOnChain = isAnvilTestChain(config.l1ChainId) ? 1 : ethereumSlotDuration;
153
144
  const l1PublishingTime = config.l1PublishingTime ?? l1PublishingTimeBasedOnChain;
154
145
 
146
+ const { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock } = capPerBlockLimits(config, rollupManaLimit, log);
147
+
148
+ const l1Constants = { l1GenesisTime, slotDuration: Number(slotDuration), ethereumSlotDuration, rollupManaLimit };
149
+
155
150
  const sequencer = new Sequencer(
156
151
  publisherFactory,
157
152
  validatorClient,
@@ -166,14 +161,17 @@ export class SequencerClient {
166
161
  deps.dateProvider,
167
162
  epochCache,
168
163
  rollupContract,
169
- { ...config, l1PublishingTime, maxL2BlockGas: sequencerManaLimit },
164
+ { ...config, l1PublishingTime, maxL2BlockGas, maxDABlockGas, maxTxsPerBlock },
170
165
  telemetryClient,
171
166
  log,
172
167
  );
173
168
 
174
- await sequencer.init();
169
+ sequencer.init();
175
170
 
176
- return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics);
171
+ // Extract the shared delayer from the first L1TxUtils instance (all instances share the same delayer)
172
+ const delayer = l1TxUtils[0]?.delayer;
173
+
174
+ return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer);
177
175
  }
178
176
 
179
177
  /**
@@ -191,7 +189,7 @@ export class SequencerClient {
191
189
  await this.validatorClient?.start();
192
190
  this.sequencer.start();
193
191
  this.l1Metrics?.start();
194
- await this.publisherManager.loadState();
192
+ await this.publisherManager.start();
195
193
  }
196
194
 
197
195
  /**
@@ -200,7 +198,7 @@ export class SequencerClient {
200
198
  public async stop() {
201
199
  await this.sequencer.stop();
202
200
  await this.validatorClient?.stop();
203
- this.publisherManager.interrupt();
201
+ await this.publisherManager.stop();
204
202
  this.l1Metrics?.stop();
205
203
  }
206
204
 
@@ -208,6 +206,16 @@ export class SequencerClient {
208
206
  return this.sequencer;
209
207
  }
210
208
 
209
+ /** Updates the publisher factory's node keystore adapter after a keystore reload. */
210
+ public updatePublisherNodeKeyStore(adapter: NodeKeystoreAdapter): void {
211
+ this.sequencer.updatePublisherNodeKeyStore(adapter);
212
+ }
213
+
214
+ /** Returns the shared tx delayer for sequencer L1 txs, if enabled. Test-only. */
215
+ getDelayer(): Delayer | undefined {
216
+ return this.delayer_;
217
+ }
218
+
211
219
  get validatorAddresses(): EthAddress[] | undefined {
212
220
  return this.sequencer.getValidatorAddresses();
213
221
  }
@@ -216,3 +224,41 @@ export class SequencerClient {
216
224
  return this.sequencer.maxL2BlockGas;
217
225
  }
218
226
  }
227
+
228
+ /**
229
+ * Caps operator-provided per-block limits at checkpoint-level limits.
230
+ * Returns undefined for any limit the operator didn't set — the checkpoint builder handles redistribution.
231
+ */
232
+ function capPerBlockLimits(
233
+ config: SequencerClientConfig,
234
+ rollupManaLimit: number,
235
+ log: ReturnType<typeof createLogger>,
236
+ ): { maxL2BlockGas: number | undefined; maxDABlockGas: number | undefined; maxTxsPerBlock: number | undefined } {
237
+ let maxL2BlockGas = config.maxL2BlockGas;
238
+ if (maxL2BlockGas !== undefined && maxL2BlockGas > rollupManaLimit) {
239
+ log.warn(`Provided MAX_L2_BLOCK_GAS ${maxL2BlockGas} exceeds rollup mana limit ${rollupManaLimit} (capping)`);
240
+ maxL2BlockGas = rollupManaLimit;
241
+ }
242
+
243
+ let maxDABlockGas = config.maxDABlockGas;
244
+ if (maxDABlockGas !== undefined && maxDABlockGas > MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT) {
245
+ log.warn(
246
+ `Provided MAX_DA_BLOCK_GAS ${maxDABlockGas} exceeds DA checkpoint limit ${MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT} (capping)`,
247
+ );
248
+ maxDABlockGas = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT;
249
+ }
250
+
251
+ let maxTxsPerBlock = config.maxTxsPerBlock;
252
+ if (
253
+ maxTxsPerBlock !== undefined &&
254
+ config.maxTxsPerCheckpoint !== undefined &&
255
+ maxTxsPerBlock > config.maxTxsPerCheckpoint
256
+ ) {
257
+ log.warn(
258
+ `Provided MAX_TX_PER_BLOCK ${maxTxsPerBlock} exceeds MAX_TX_PER_CHECKPOINT ${config.maxTxsPerCheckpoint} (capping)`,
259
+ );
260
+ maxTxsPerBlock = config.maxTxsPerCheckpoint;
261
+ }
262
+
263
+ return { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock };
264
+ }
package/src/config.ts CHANGED
@@ -13,8 +13,10 @@ import { type P2PConfig, p2pConfigMappings } from '@aztec/p2p/config';
13
13
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
14
14
  import {
15
15
  type ChainConfig,
16
+ type PipelineConfig,
16
17
  type SequencerConfig,
17
18
  chainConfigMappings,
19
+ pipelineConfigMappings,
18
20
  sharedSequencerConfigMappings,
19
21
  } from '@aztec/stdlib/config';
20
22
  import type { ResolvedSequencerConfig } from '@aztec/stdlib/interfaces/server';
@@ -22,10 +24,10 @@ import { DEFAULT_P2P_PROPAGATION_TIME } from '@aztec/stdlib/timetable';
22
24
  import { type ValidatorClientConfig, validatorClientConfigMappings } from '@aztec/validator-client/config';
23
25
 
24
26
  import {
25
- type PublisherConfig,
26
- type TxSenderConfig,
27
- getPublisherConfigMappings,
28
- getTxSenderConfigMappings,
27
+ type SequencerPublisherConfig,
28
+ type SequencerTxSenderConfig,
29
+ sequencerPublisherConfigMappings,
30
+ sequencerTxSenderConfigMappings,
29
31
  } from './publisher/config.js';
30
32
 
31
33
  export * from './publisher/config.js';
@@ -35,15 +37,13 @@ export type { SequencerConfig };
35
37
  * Default values for SequencerConfig.
36
38
  * Centralized location for all sequencer configuration defaults.
37
39
  */
38
- export const DefaultSequencerConfig: ResolvedSequencerConfig = {
40
+ export const DefaultSequencerConfig = {
39
41
  sequencerPollingIntervalMS: 500,
40
- maxTxsPerBlock: 32,
41
42
  minTxsPerBlock: 1,
42
43
  buildCheckpointIfEmpty: false,
43
44
  publishTxsWithProposals: false,
44
- maxL2BlockGas: 10e9,
45
- maxDABlockGas: 10e9,
46
- maxBlockSizeInBytes: 1024 * 1024,
45
+ perBlockAllocationMultiplier: 1.2,
46
+ redistributeCheckpointBudget: true,
47
47
  enforceTimeTable: true,
48
48
  attestationPropagationTime: DEFAULT_P2P_PROPAGATION_TIME,
49
49
  secondsBeforeInvalidatingBlockAsCommitteeMember: 144, // 12 L1 blocks
@@ -52,22 +52,26 @@ export const DefaultSequencerConfig: ResolvedSequencerConfig = {
52
52
  skipInvalidateBlockAsProposer: false,
53
53
  broadcastInvalidBlockProposal: false,
54
54
  injectFakeAttestation: false,
55
+ injectHighSValueAttestation: false,
56
+ injectUnrecoverableSignatureAttestation: false,
55
57
  fishermanMode: false,
56
58
  shuffleAttestationOrdering: false,
57
59
  skipPushProposedBlocksToArchiver: false,
58
- };
60
+ skipPublishingCheckpointsPercent: 0,
61
+ } satisfies ResolvedSequencerConfig;
59
62
 
60
63
  /**
61
64
  * Configuration settings for the SequencerClient.
62
65
  */
63
- export type SequencerClientConfig = PublisherConfig &
66
+ export type SequencerClientConfig = SequencerPublisherConfig &
64
67
  KeyStoreConfig &
65
68
  ValidatorClientConfig &
66
- TxSenderConfig &
69
+ SequencerTxSenderConfig &
67
70
  SequencerConfig &
68
71
  L1ReaderConfig &
69
72
  ChainConfig &
70
- Pick<P2PConfig, 'txPublicSetupAllowList'> &
73
+ PipelineConfig &
74
+ Pick<P2PConfig, 'txPublicSetupAllowListExtend'> &
71
75
  Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
72
76
 
73
77
  export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
@@ -76,10 +80,10 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
76
80
  description: 'The number of ms to wait between polling for checking to build on the next slot.',
77
81
  ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS),
78
82
  },
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),
83
+ maxTxsPerCheckpoint: {
84
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
85
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
86
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
83
87
  },
84
88
  minTxsPerBlock: {
85
89
  env: 'SEQ_MIN_TX_PER_BLOCK',
@@ -98,12 +102,25 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
98
102
  maxL2BlockGas: {
99
103
  env: 'SEQ_MAX_L2_BLOCK_GAS',
100
104
  description: 'The maximum L2 block gas.',
101
- ...numberConfigHelper(DefaultSequencerConfig.maxL2BlockGas),
105
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
102
106
  },
103
107
  maxDABlockGas: {
104
108
  env: 'SEQ_MAX_DA_BLOCK_GAS',
105
109
  description: 'The maximum DA block gas.',
106
- ...numberConfigHelper(DefaultSequencerConfig.maxDABlockGas),
110
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
111
+ },
112
+ perBlockAllocationMultiplier: {
113
+ env: 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER',
114
+ description:
115
+ 'Per-block gas budget multiplier for both L2 and DA gas. Budget per block is (checkpointLimit / maxBlocks) * multiplier.' +
116
+ ' Values greater than one allow early blocks to use more than their even share, relying on checkpoint-level capping for later blocks.',
117
+ ...numberConfigHelper(DefaultSequencerConfig.perBlockAllocationMultiplier),
118
+ },
119
+ redistributeCheckpointBudget: {
120
+ env: 'SEQ_REDISTRIBUTE_CHECKPOINT_BUDGET',
121
+ description:
122
+ 'Redistribute remaining checkpoint budget evenly across remaining blocks instead of allowing a single block to consume the entire remaining budget.',
123
+ ...booleanConfigHelper(DefaultSequencerConfig.redistributeCheckpointBudget),
107
124
  },
108
125
  coinbase: {
109
126
  env: 'COINBASE',
@@ -123,11 +140,6 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
123
140
  env: 'ACVM_BINARY_PATH',
124
141
  description: 'The path to the ACVM binary',
125
142
  },
126
- maxBlockSizeInBytes: {
127
- env: 'SEQ_MAX_BLOCK_SIZE_IN_BYTES',
128
- description: 'Max block size',
129
- ...numberConfigHelper(DefaultSequencerConfig.maxBlockSizeInBytes),
130
- },
131
143
  enforceTimeTable: {
132
144
  env: 'SEQ_ENFORCE_TIME_TABLE',
133
145
  description: 'Whether to enforce the time table when building blocks',
@@ -185,6 +197,14 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
185
197
  description: 'Inject a fake attestation (for testing only)',
186
198
  ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation),
187
199
  },
200
+ injectHighSValueAttestation: {
201
+ description: 'Inject a malleable attestation with a high-s value (for testing only)',
202
+ ...booleanConfigHelper(DefaultSequencerConfig.injectHighSValueAttestation),
203
+ },
204
+ injectUnrecoverableSignatureAttestation: {
205
+ description: 'Inject an attestation with an unrecoverable signature (for testing only)',
206
+ ...booleanConfigHelper(DefaultSequencerConfig.injectUnrecoverableSignatureAttestation),
207
+ },
188
208
  fishermanMode: {
189
209
  env: 'FISHERMAN_MODE',
190
210
  description:
@@ -205,7 +225,15 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
205
225
  description: 'Skip pushing proposed blocks to archiver (default: true)',
206
226
  ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver),
207
227
  },
208
- ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowList']),
228
+ minBlocksForCheckpoint: {
229
+ description: 'Minimum number of blocks required for a checkpoint proposal (test only)',
230
+ },
231
+ skipPublishingCheckpointsPercent: {
232
+ env: 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT',
233
+ description: 'Percent probability (0 - 100) of sequencer skipping checkpoint publishing (testing only)',
234
+ ...numberConfigHelper(DefaultSequencerConfig.skipPublishingCheckpointsPercent),
235
+ },
236
+ ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowListExtend']),
209
237
  };
210
238
 
211
239
  export const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig> = {
@@ -213,9 +241,10 @@ export const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientCo
213
241
  ...sequencerConfigMappings,
214
242
  ...keyStoreConfigMappings,
215
243
  ...l1ReaderConfigMappings,
216
- ...getTxSenderConfigMappings('SEQ'),
217
- ...getPublisherConfigMappings('SEQ'),
244
+ ...sequencerTxSenderConfigMappings,
245
+ ...sequencerPublisherConfigMappings,
218
246
  ...chainConfigMappings,
247
+ ...pipelineConfigMappings,
219
248
  ...pickConfigMappings(l1ContractsConfigMappings, ['ethereumSlotDuration', 'aztecSlotDuration', 'aztecEpochDuration']),
220
249
  };
221
250
 
@@ -1,22 +1,27 @@
1
- import { createEthereumChain } from '@aztec/ethereum/chain';
2
- import type { L1ContractsConfig } from '@aztec/ethereum/config';
3
1
  import { RollupContract } from '@aztec/ethereum/contracts';
4
- import type { L1ReaderConfig } from '@aztec/ethereum/l1-reader';
2
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
5
3
  import type { ViemPublicClient } from '@aztec/ethereum/types';
6
4
  import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
7
5
  import { Fr } from '@aztec/foundation/curves/bn254';
8
6
  import type { EthAddress } from '@aztec/foundation/eth-address';
9
7
  import { createLogger } from '@aztec/foundation/log';
8
+ import type { DateProvider } from '@aztec/foundation/timer';
10
9
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
11
- import { type L1RollupConstants, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
10
+ import { type L1RollupConstants, getNextL1SlotTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
12
11
  import { GasFees } from '@aztec/stdlib/gas';
13
12
  import type {
13
+ BuildCheckpointGlobalVariablesOpts,
14
14
  CheckpointGlobalVariables,
15
15
  GlobalVariableBuilder as GlobalVariableBuilderInterface,
16
16
  } from '@aztec/stdlib/tx';
17
17
  import { GlobalVariables } from '@aztec/stdlib/tx';
18
18
 
19
- import { createPublicClient, fallback, http } from 'viem';
19
+ /** Configuration for the GlobalVariableBuilder (excludes L1 client config). */
20
+ export type GlobalVariableBuilderConfig = {
21
+ l1Contracts: Pick<L1ContractAddresses, 'rollupAddress'>;
22
+ ethereumSlotDuration: number;
23
+ rollupVersion: bigint;
24
+ } & Pick<L1RollupConstants, 'slotDuration' | 'l1GenesisTime'>;
20
25
 
21
26
  /**
22
27
  * Simple global variables builder.
@@ -27,7 +32,6 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
27
32
  private currentL1BlockNumber: bigint | undefined = undefined;
28
33
 
29
34
  private readonly rollupContract: RollupContract;
30
- private readonly publicClient: ViemPublicClient;
31
35
  private readonly ethereumSlotDuration: number;
32
36
  private readonly aztecSlotDuration: number;
33
37
  private readonly l1GenesisTime: bigint;
@@ -36,28 +40,18 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
36
40
  private version: Fr;
37
41
 
38
42
  constructor(
39
- config: L1ReaderConfig &
40
- Pick<L1ContractsConfig, 'ethereumSlotDuration'> &
41
- Pick<L1RollupConstants, 'slotDuration' | 'l1GenesisTime'> & { rollupVersion: bigint },
43
+ private readonly dateProvider: DateProvider,
44
+ private readonly publicClient: ViemPublicClient,
45
+ config: GlobalVariableBuilderConfig,
42
46
  ) {
43
- const { l1RpcUrls, l1ChainId: chainId, l1Contracts } = config;
44
-
45
- const chain = createEthereumChain(l1RpcUrls, chainId);
46
-
47
47
  this.version = new Fr(config.rollupVersion);
48
- this.chainId = new Fr(chainId);
48
+ this.chainId = new Fr(this.publicClient.chain!.id);
49
49
 
50
50
  this.ethereumSlotDuration = config.ethereumSlotDuration;
51
51
  this.aztecSlotDuration = config.slotDuration;
52
52
  this.l1GenesisTime = config.l1GenesisTime;
53
53
 
54
- this.publicClient = createPublicClient({
55
- chain: chain.chainInfo,
56
- transport: fallback(chain.rpcUrls.map(url => http(url, { batch: false }))),
57
- pollingInterval: config.viemPollingIntervalMS,
58
- });
59
-
60
- this.rollupContract = new RollupContract(this.publicClient, l1Contracts.rollupAddress);
54
+ this.rollupContract = new RollupContract(this.publicClient, config.l1Contracts.rollupAddress);
61
55
  }
62
56
 
63
57
  /**
@@ -73,7 +67,10 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
73
67
  const earliestTimestamp = await this.rollupContract.getTimestampForSlot(
74
68
  SlotNumber.fromBigInt(BigInt(lastCheckpoint.slotNumber) + 1n),
75
69
  );
76
- const nextEthTimestamp = BigInt((await this.publicClient.getBlock()).timestamp + BigInt(this.ethereumSlotDuration));
70
+ const nextEthTimestamp = getNextL1SlotTimestamp(this.dateProvider.nowInSeconds(), {
71
+ l1GenesisTime: this.l1GenesisTime,
72
+ ethereumSlotDuration: this.ethereumSlotDuration,
73
+ });
77
74
  const timestamp = earliestTimestamp > nextEthTimestamp ? earliestTimestamp : nextEthTimestamp;
78
75
 
79
76
  return new GasFees(0, await this.rollupContract.getManaMinFeeAt(timestamp, true));
@@ -108,7 +105,10 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
108
105
  const slot: SlotNumber =
109
106
  maybeSlot ??
110
107
  (await this.rollupContract.getSlotAt(
111
- BigInt((await this.publicClient.getBlock()).timestamp + BigInt(this.ethereumSlotDuration)),
108
+ getNextL1SlotTimestamp(this.dateProvider.nowInSeconds(), {
109
+ l1GenesisTime: this.l1GenesisTime,
110
+ ethereumSlotDuration: this.ethereumSlotDuration,
111
+ }),
112
112
  ));
113
113
 
114
114
  const checkpointGlobalVariables = await this.buildCheckpointGlobalVariables(coinbase, feeRecipient, slot);
@@ -120,7 +120,8 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
120
120
  coinbase: EthAddress,
121
121
  feeRecipient: AztecAddress,
122
122
  slotNumber: SlotNumber,
123
- ): Promise<CheckpointGlobalVariables & { timestamp: bigint }> {
123
+ opts?: BuildCheckpointGlobalVariablesOpts,
124
+ ): Promise<CheckpointGlobalVariables> {
124
125
  const { chainId, version } = this;
125
126
 
126
127
  const timestamp = getTimestampForSlot(slotNumber, {
@@ -128,9 +129,19 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
128
129
  l1GenesisTime: this.l1GenesisTime,
129
130
  });
130
131
 
131
- // We can skip much of the logic in getCurrentMinFees since it we already check that we are not within a slot elsewhere.
132
- // TODO(palla/mbps): Can we use a cached value here?
133
- const gasFees = new GasFees(0, await this.rollupContract.getManaMinFeeAt(timestamp, true));
132
+ // When pipelining, force the proposed checkpoint number and fee header to the parent so that
133
+ // the fee computation matches what L1 will see when the previous pipelined checkpoint has landed.
134
+ const pendingNumberOverride = await this.rollupContract.makePendingCheckpointNumberOverride(
135
+ opts?.forcePendingCheckpointNumber,
136
+ );
137
+ const feeHeaderOverride = opts?.forceProposedFeeHeader
138
+ ? await this.rollupContract.makeFeeHeaderOverride(
139
+ opts.forceProposedFeeHeader.checkpointNumber,
140
+ opts.forceProposedFeeHeader.feeHeader,
141
+ )
142
+ : [];
143
+ const stateOverride = RollupContract.mergeStateOverrides(pendingNumberOverride, feeHeaderOverride);
144
+ const gasFees = new GasFees(0, await this.rollupContract.getManaMinFeeAt(timestamp, true, stateOverride));
134
145
 
135
146
  return { chainId, version, slotNumber, timestamp, coinbase, feeRecipient, gasFees };
136
147
  }
@@ -1 +1 @@
1
- export { GlobalVariableBuilder } from './global_builder.js';
1
+ export { GlobalVariableBuilder, type GlobalVariableBuilderConfig } from './global_builder.js';