@aztec/sequencer-client 0.0.1-commit.f2ce05ee → 0.0.1-commit.f81dbcf

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 (54) 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 +31 -17
  10. package/dest/publisher/config.d.ts.map +1 -1
  11. package/dest/publisher/config.js +101 -42
  12. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
  13. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  14. package/dest/publisher/sequencer-publisher-factory.js +13 -2
  15. package/dest/publisher/sequencer-publisher.d.ts +16 -7
  16. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  17. package/dest/publisher/sequencer-publisher.js +41 -21
  18. package/dest/sequencer/checkpoint_proposal_job.d.ts +2 -4
  19. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  20. package/dest/sequencer/checkpoint_proposal_job.js +100 -56
  21. package/dest/sequencer/metrics.d.ts +17 -5
  22. package/dest/sequencer/metrics.d.ts.map +1 -1
  23. package/dest/sequencer/metrics.js +86 -15
  24. package/dest/sequencer/sequencer.d.ts +24 -13
  25. package/dest/sequencer/sequencer.d.ts.map +1 -1
  26. package/dest/sequencer/sequencer.js +36 -39
  27. package/dest/sequencer/timetable.d.ts +4 -3
  28. package/dest/sequencer/timetable.d.ts.map +1 -1
  29. package/dest/sequencer/timetable.js +6 -7
  30. package/dest/sequencer/types.d.ts +2 -2
  31. package/dest/sequencer/types.d.ts.map +1 -1
  32. package/dest/test/index.d.ts +3 -5
  33. package/dest/test/index.d.ts.map +1 -1
  34. package/dest/test/mock_checkpoint_builder.d.ts +14 -10
  35. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  36. package/dest/test/mock_checkpoint_builder.js +47 -34
  37. package/dest/test/utils.d.ts +3 -3
  38. package/dest/test/utils.d.ts.map +1 -1
  39. package/dest/test/utils.js +5 -4
  40. package/package.json +28 -28
  41. package/src/client/sequencer-client.ts +135 -18
  42. package/src/config.ts +45 -27
  43. package/src/global_variable_builder/global_builder.ts +1 -1
  44. package/src/publisher/config.ts +112 -43
  45. package/src/publisher/sequencer-publisher-factory.ts +23 -6
  46. package/src/publisher/sequencer-publisher.ts +63 -28
  47. package/src/sequencer/checkpoint_proposal_job.ts +150 -66
  48. package/src/sequencer/metrics.ts +92 -18
  49. package/src/sequencer/sequencer.ts +45 -45
  50. package/src/sequencer/timetable.ts +7 -7
  51. package/src/sequencer/types.ts +1 -1
  52. package/src/test/index.ts +2 -4
  53. package/src/test/mock_checkpoint_builder.ts +64 -48
  54. 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';
@@ -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: 1.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, {
@@ -1,32 +1,45 @@
1
1
  import { type BlobClientConfig, blobClientConfigMapping } from '@aztec/blob-client/client/config';
2
2
  import { type L1ReaderConfig, l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
3
3
  import { type L1TxUtilsConfig, l1TxUtilsConfigMappings } from '@aztec/ethereum/l1-tx-utils/config';
4
- import {
5
- type ConfigMappingsType,
6
- SecretValue,
7
- booleanConfigHelper,
8
- getConfigFromMappings,
9
- } from '@aztec/foundation/config';
4
+ import { type ConfigMappingsType, SecretValue, booleanConfigHelper } from '@aztec/foundation/config';
10
5
  import { EthAddress } from '@aztec/foundation/eth-address';
11
6
 
12
- /**
13
- * The configuration of the rollup transaction publisher.
14
- */
7
+ /** Configuration of the transaction publisher. */
15
8
  export type TxSenderConfig = L1ReaderConfig & {
16
- /**
17
- * The private key to be used by the publisher.
18
- */
9
+ /** The private key to be used by the publisher. */
19
10
  publisherPrivateKeys?: SecretValue<`0x${string}`>[];
20
11
 
21
- /**
22
- * Publisher addresses to be used with a remote signer
23
- */
12
+ /** Publisher addresses to be used with a remote signer */
24
13
  publisherAddresses?: EthAddress[];
25
14
  };
26
15
 
27
- /**
28
- * Configuration of the L1Publisher.
29
- */
16
+ export type ProverTxSenderConfig = L1ReaderConfig & {
17
+ proverPublisherPrivateKeys?: SecretValue<`0x${string}`>[];
18
+ proverPublisherAddresses?: EthAddress[];
19
+ };
20
+
21
+ export type SequencerTxSenderConfig = L1ReaderConfig & {
22
+ sequencerPublisherPrivateKeys?: SecretValue<`0x${string}`>[];
23
+ sequencerPublisherAddresses?: EthAddress[];
24
+ };
25
+
26
+ export function getTxSenderConfigFromProverConfig(config: ProverTxSenderConfig): TxSenderConfig {
27
+ return {
28
+ ...config,
29
+ publisherPrivateKeys: config.proverPublisherPrivateKeys,
30
+ publisherAddresses: config.proverPublisherAddresses,
31
+ };
32
+ }
33
+
34
+ export function getTxSenderConfigFromSequencerConfig(config: SequencerTxSenderConfig): TxSenderConfig {
35
+ return {
36
+ ...config,
37
+ publisherPrivateKeys: config.sequencerPublisherPrivateKeys,
38
+ publisherAddresses: config.sequencerPublisherAddresses,
39
+ };
40
+ }
41
+
42
+ /** Configuration of the L1Publisher. */
30
43
  export type PublisherConfig = L1TxUtilsConfig &
31
44
  BlobClientConfig & {
32
45
  /** True to use publishers in invalid states (timed out, cancelled, etc) if no other is available */
@@ -37,35 +50,76 @@ export type PublisherConfig = L1TxUtilsConfig &
37
50
  publisherForwarderAddress?: EthAddress;
38
51
  };
39
52
 
40
- export const getTxSenderConfigMappings: (
41
- scope: 'PROVER' | 'SEQ',
42
- ) => ConfigMappingsType<Omit<TxSenderConfig, 'l1Contracts'>> = (scope: 'PROVER' | 'SEQ') => ({
53
+ export type ProverPublisherConfig = L1TxUtilsConfig &
54
+ BlobClientConfig & {
55
+ fishermanMode?: boolean;
56
+ proverPublisherAllowInvalidStates?: boolean;
57
+ proverPublisherForwarderAddress?: EthAddress;
58
+ };
59
+
60
+ export type SequencerPublisherConfig = L1TxUtilsConfig &
61
+ BlobClientConfig & {
62
+ fishermanMode?: boolean;
63
+ sequencerPublisherAllowInvalidStates?: boolean;
64
+ sequencerPublisherForwarderAddress?: EthAddress;
65
+ };
66
+
67
+ export function getPublisherConfigFromProverConfig(config: ProverPublisherConfig): PublisherConfig {
68
+ return {
69
+ ...config,
70
+ publisherAllowInvalidStates: config.proverPublisherAllowInvalidStates,
71
+ publisherForwarderAddress: config.proverPublisherForwarderAddress,
72
+ };
73
+ }
74
+
75
+ export function getPublisherConfigFromSequencerConfig(config: SequencerPublisherConfig): PublisherConfig {
76
+ return {
77
+ ...config,
78
+ publisherAllowInvalidStates: config.sequencerPublisherAllowInvalidStates,
79
+ publisherForwarderAddress: config.sequencerPublisherForwarderAddress,
80
+ };
81
+ }
82
+
83
+ export const proverTxSenderConfigMappings: ConfigMappingsType<Omit<ProverTxSenderConfig, 'l1Contracts'>> = {
43
84
  ...l1ReaderConfigMappings,
44
- publisherPrivateKeys: {
45
- env: scope === 'PROVER' ? `PROVER_PUBLISHER_PRIVATE_KEYS` : `SEQ_PUBLISHER_PRIVATE_KEYS`,
46
- description: 'The private keys to be used by the publisher.',
85
+ proverPublisherPrivateKeys: {
86
+ env: `PROVER_PUBLISHER_PRIVATE_KEYS`,
87
+ description: 'The private keys to be used by the prover publisher.',
47
88
  parseEnv: (val: string) => val.split(',').map(key => new SecretValue(`0x${key.replace('0x', '')}`)),
48
89
  defaultValue: [],
49
- fallback: [scope === 'PROVER' ? `PROVER_PUBLISHER_PRIVATE_KEY` : `SEQ_PUBLISHER_PRIVATE_KEY`],
90
+ fallback: [`PROVER_PUBLISHER_PRIVATE_KEY`],
50
91
  },
51
- publisherAddresses: {
52
- env: scope === 'PROVER' ? `PROVER_PUBLISHER_ADDRESSES` : `SEQ_PUBLISHER_ADDRESSES`,
92
+ proverPublisherAddresses: {
93
+ env: `PROVER_PUBLISHER_ADDRESSES`,
53
94
  description: 'The addresses of the publishers to use with remote signers',
54
95
  parseEnv: (val: string) => val.split(',').map(address => EthAddress.fromString(address)),
55
96
  defaultValue: [],
56
97
  },
57
- });
98
+ };
58
99
 
59
- export function getTxSenderConfigFromEnv(scope: 'PROVER' | 'SEQ'): Omit<TxSenderConfig, 'l1Contracts'> {
60
- return getConfigFromMappings(getTxSenderConfigMappings(scope));
61
- }
100
+ export const sequencerTxSenderConfigMappings: ConfigMappingsType<Omit<SequencerTxSenderConfig, 'l1Contracts'>> = {
101
+ ...l1ReaderConfigMappings,
102
+ sequencerPublisherPrivateKeys: {
103
+ env: `SEQ_PUBLISHER_PRIVATE_KEYS`,
104
+ description: 'The private keys to be used by the sequencer publisher.',
105
+ parseEnv: (val: string) => val.split(',').map(key => new SecretValue(`0x${key.replace('0x', '')}`)),
106
+ defaultValue: [],
107
+ fallback: [`SEQ_PUBLISHER_PRIVATE_KEY`],
108
+ },
109
+ sequencerPublisherAddresses: {
110
+ env: `SEQ_PUBLISHER_ADDRESSES`,
111
+ description: 'The addresses of the publishers to use with remote signers',
112
+ parseEnv: (val: string) => val.split(',').map(address => EthAddress.fromString(address)),
113
+ defaultValue: [],
114
+ },
115
+ };
62
116
 
63
- export const getPublisherConfigMappings: (
64
- scope: 'PROVER' | 'SEQ',
65
- ) => ConfigMappingsType<PublisherConfig & L1TxUtilsConfig> = scope => ({
66
- publisherAllowInvalidStates: {
117
+ export const sequencerPublisherConfigMappings: ConfigMappingsType<SequencerPublisherConfig & L1TxUtilsConfig> = {
118
+ ...l1TxUtilsConfigMappings,
119
+ ...blobClientConfigMapping,
120
+ sequencerPublisherAllowInvalidStates: {
121
+ env: `SEQ_PUBLISHER_ALLOW_INVALID_STATES`,
67
122
  description: 'True to use publishers in invalid states (timed out, cancelled, etc) if no other is available',
68
- env: scope === `PROVER` ? `PROVER_PUBLISHER_ALLOW_INVALID_STATES` : `SEQ_PUBLISHER_ALLOW_INVALID_STATES`,
69
123
  ...booleanConfigHelper(true),
70
124
  },
71
125
  fishermanMode: {
@@ -74,15 +128,30 @@ export const getPublisherConfigMappings: (
74
128
  'Whether to run in fisherman mode: builds blocks on every slot for validation without publishing to L1',
75
129
  ...booleanConfigHelper(false),
76
130
  },
77
- publisherForwarderAddress: {
78
- env: scope === `PROVER` ? `PROVER_PUBLISHER_FORWARDER_ADDRESS` : `SEQ_PUBLISHER_FORWARDER_ADDRESS`,
131
+ sequencerPublisherForwarderAddress: {
132
+ env: `SEQ_PUBLISHER_FORWARDER_ADDRESS`,
79
133
  description: 'Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)',
80
134
  parseEnv: (val: string) => (val ? EthAddress.fromString(val) : undefined),
81
135
  },
136
+ };
137
+
138
+ export const proverPublisherConfigMappings: ConfigMappingsType<ProverPublisherConfig & L1TxUtilsConfig> = {
82
139
  ...l1TxUtilsConfigMappings,
83
140
  ...blobClientConfigMapping,
84
- });
85
-
86
- export function getPublisherConfigFromEnv(scope: 'PROVER' | 'SEQ'): PublisherConfig {
87
- return getConfigFromMappings(getPublisherConfigMappings(scope));
88
- }
141
+ proverPublisherAllowInvalidStates: {
142
+ env: `PROVER_PUBLISHER_ALLOW_INVALID_STATES`,
143
+ description: 'True to use publishers in invalid states (timed out, cancelled, etc) if no other is available',
144
+ ...booleanConfigHelper(true),
145
+ },
146
+ fishermanMode: {
147
+ env: 'FISHERMAN_MODE',
148
+ description:
149
+ 'Whether to run in fisherman mode: builds blocks on every slot for validation without publishing to L1',
150
+ ...booleanConfigHelper(false),
151
+ },
152
+ proverPublisherForwarderAddress: {
153
+ env: `PROVER_PUBLISHER_FORWARDER_ADDRESS`,
154
+ description: 'Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)',
155
+ parseEnv: (val: string) => (val ? EthAddress.fromString(val) : undefined),
156
+ },
157
+ };
@@ -3,7 +3,7 @@ import { type Logger, createLogger } from '@aztec/aztec.js/log';
3
3
  import type { BlobClientInterface } from '@aztec/blob-client/client';
4
4
  import type { EpochCache } from '@aztec/epoch-cache';
5
5
  import type { GovernanceProposerContract, RollupContract } from '@aztec/ethereum/contracts';
6
- import type { L1TxUtilsWithBlobs } from '@aztec/ethereum/l1-tx-utils-with-blobs';
6
+ import type { L1TxUtils } from '@aztec/ethereum/l1-tx-utils';
7
7
  import type { PublisherFilter, PublisherManager } from '@aztec/ethereum/publisher-manager';
8
8
  import { SlotNumber } from '@aztec/foundation/branded-types';
9
9
  import type { DateProvider } from '@aztec/foundation/timer';
@@ -26,13 +26,15 @@ export class SequencerPublisherFactory {
26
26
  /** Stores the last slot in which every action was carried out by a publisher */
27
27
  private lastActions: Partial<Record<Action, SlotNumber>> = {};
28
28
 
29
+ private nodeKeyStore: NodeKeystoreAdapter;
30
+
29
31
  private logger: Logger;
30
32
 
31
33
  constructor(
32
34
  private sequencerConfig: SequencerClientConfig,
33
35
  private deps: {
34
36
  telemetry: TelemetryClient;
35
- publisherManager: PublisherManager<L1TxUtilsWithBlobs>;
37
+ publisherManager: PublisherManager<L1TxUtils>;
36
38
  blobClient: BlobClientInterface;
37
39
  dateProvider: DateProvider;
38
40
  epochCache: EpochCache;
@@ -45,7 +47,17 @@ export class SequencerPublisherFactory {
45
47
  ) {
46
48
  this.publisherMetrics = new SequencerPublisherMetrics(deps.telemetry, 'SequencerPublisher');
47
49
  this.logger = deps.logger ?? createLogger('sequencer');
50
+ this.nodeKeyStore = this.deps.nodeKeyStore;
51
+ }
52
+
53
+ /**
54
+ * Updates the node keystore adapter used for publisher lookups.
55
+ * Called when the keystore is reloaded at runtime to reflect new validator-publisher mappings.
56
+ */
57
+ public updateNodeKeyStore(adapter: NodeKeystoreAdapter): void {
58
+ this.nodeKeyStore = adapter;
48
59
  }
60
+
49
61
  /**
50
62
  * Creates a new SequencerPublisher instance.
51
63
  * @param _validatorAddress - The address of the validator that will be using the publisher.
@@ -54,17 +66,17 @@ export class SequencerPublisherFactory {
54
66
  public async create(validatorAddress?: EthAddress): Promise<AttestorPublisherPair> {
55
67
  // If we have been given an attestor address we must only allow publishers permitted for that attestor
56
68
 
57
- const allowedPublishers = !validatorAddress ? [] : this.deps.nodeKeyStore.getPublisherAddresses(validatorAddress);
58
- const filter: PublisherFilter<L1TxUtilsWithBlobs> = !validatorAddress
69
+ const allowedPublishers = !validatorAddress ? [] : this.nodeKeyStore.getPublisherAddresses(validatorAddress);
70
+ const filter: PublisherFilter<L1TxUtils> = !validatorAddress
59
71
  ? () => true
60
- : (utils: L1TxUtilsWithBlobs) => {
72
+ : (utils: L1TxUtils) => {
61
73
  const publisherAddress = utils.getSenderAddress();
62
74
  return allowedPublishers.some(allowedPublisher => allowedPublisher.equals(publisherAddress));
63
75
  };
64
76
 
65
77
  const l1Publisher = await this.deps.publisherManager.getAvailablePublisher(filter);
66
78
  const attestorAddress =
67
- validatorAddress ?? this.deps.nodeKeyStore.getAttestorForPublisher(l1Publisher.getSenderAddress());
79
+ validatorAddress ?? this.nodeKeyStore.getAttestorForPublisher(l1Publisher.getSenderAddress());
68
80
 
69
81
  const rollup = this.deps.rollupContract;
70
82
  const slashingProposerContract = await rollup.getSlashingProposer();
@@ -89,4 +101,9 @@ export class SequencerPublisherFactory {
89
101
  publisher,
90
102
  };
91
103
  }
104
+
105
+ /** Interrupts all publishers managed by this factory. Used during sequencer shutdown. */
106
+ public interruptAll(): void {
107
+ this.deps.publisherManager.interrupt();
108
+ }
92
109
  }