@aztec/sequencer-client 0.0.1-commit.d3ec352c → 0.0.1-commit.d58ff9d0

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 (162) hide show
  1. package/README.md +281 -21
  2. package/dest/client/sequencer-client.d.ts +41 -18
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +88 -43
  5. package/dest/config.d.ts +41 -8
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +146 -55
  8. package/dest/global_variable_builder/fee_predictor.d.ts +37 -0
  9. package/dest/global_variable_builder/fee_predictor.d.ts.map +1 -0
  10. package/dest/global_variable_builder/fee_predictor.js +138 -0
  11. package/dest/global_variable_builder/fee_provider.d.ts +21 -0
  12. package/dest/global_variable_builder/fee_provider.d.ts.map +1 -0
  13. package/dest/global_variable_builder/fee_provider.js +80 -0
  14. package/dest/global_variable_builder/global_builder.d.ts +20 -26
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +28 -75
  17. package/dest/global_variable_builder/index.d.ts +4 -2
  18. package/dest/global_variable_builder/index.d.ts.map +1 -1
  19. package/dest/global_variable_builder/index.js +2 -0
  20. package/dest/index.d.ts +2 -3
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +1 -2
  23. package/dest/publisher/config.d.ts +57 -20
  24. package/dest/publisher/config.d.ts.map +1 -1
  25. package/dest/publisher/config.js +134 -39
  26. package/dest/publisher/index.d.ts +2 -1
  27. package/dest/publisher/index.d.ts.map +1 -1
  28. package/dest/publisher/l1_to_l2_messaging.d.ts +21 -0
  29. package/dest/publisher/l1_to_l2_messaging.d.ts.map +1 -0
  30. package/dest/publisher/l1_to_l2_messaging.js +70 -0
  31. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  32. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  33. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  34. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +98 -0
  35. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  36. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +68 -0
  37. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  38. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  39. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +36 -0
  40. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  41. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  42. package/dest/publisher/l1_tx_failed_store/index.js +3 -0
  43. package/dest/publisher/sequencer-bundle-simulator.d.ts +96 -0
  44. package/dest/publisher/sequencer-bundle-simulator.d.ts.map +1 -0
  45. package/dest/publisher/sequencer-bundle-simulator.js +198 -0
  46. package/dest/publisher/sequencer-publisher-factory.d.ts +15 -8
  47. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher-factory.js +28 -4
  49. package/dest/publisher/sequencer-publisher-metrics.d.ts +3 -3
  50. package/dest/publisher/sequencer-publisher-metrics.d.ts.map +1 -1
  51. package/dest/publisher/sequencer-publisher-metrics.js +23 -86
  52. package/dest/publisher/sequencer-publisher.d.ts +152 -90
  53. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  54. package/dest/publisher/sequencer-publisher.js +1257 -421
  55. package/dest/publisher/write_json.d.ts +11 -0
  56. package/dest/publisher/write_json.d.ts.map +1 -0
  57. package/dest/publisher/write_json.js +57 -0
  58. package/dest/sequencer/automine/automine_factory.d.ts +56 -0
  59. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  60. package/dest/sequencer/automine/automine_factory.js +85 -0
  61. package/dest/sequencer/automine/automine_sequencer.d.ts +189 -0
  62. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  63. package/dest/sequencer/automine/automine_sequencer.js +690 -0
  64. package/dest/sequencer/automine/index.d.ts +3 -0
  65. package/dest/sequencer/automine/index.d.ts.map +1 -0
  66. package/dest/sequencer/automine/index.js +2 -0
  67. package/dest/sequencer/checkpoint_proposal_job.d.ts +158 -0
  68. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -0
  69. package/dest/sequencer/checkpoint_proposal_job.js +1801 -0
  70. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  71. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  72. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  73. package/dest/sequencer/checkpoint_voter.d.ts +34 -0
  74. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -0
  75. package/dest/sequencer/checkpoint_voter.js +106 -0
  76. package/dest/sequencer/config.d.ts +3 -2
  77. package/dest/sequencer/config.d.ts.map +1 -1
  78. package/dest/sequencer/events.d.ts +103 -0
  79. package/dest/sequencer/events.d.ts.map +1 -0
  80. package/dest/sequencer/events.js +1 -0
  81. package/dest/sequencer/index.d.ts +4 -2
  82. package/dest/sequencer/index.d.ts.map +1 -1
  83. package/dest/sequencer/index.js +3 -1
  84. package/dest/sequencer/metrics.d.ts +42 -7
  85. package/dest/sequencer/metrics.d.ts.map +1 -1
  86. package/dest/sequencer/metrics.js +241 -72
  87. package/dest/sequencer/requests_tracker.d.ts +22 -0
  88. package/dest/sequencer/requests_tracker.d.ts.map +1 -0
  89. package/dest/sequencer/requests_tracker.js +33 -0
  90. package/dest/sequencer/sequencer.d.ts +251 -138
  91. package/dest/sequencer/sequencer.d.ts.map +1 -1
  92. package/dest/sequencer/sequencer.js +1190 -704
  93. package/dest/sequencer/types.d.ts +3 -0
  94. package/dest/sequencer/types.d.ts.map +1 -0
  95. package/dest/sequencer/types.js +1 -0
  96. package/dest/sequencer/utils.d.ts +14 -8
  97. package/dest/sequencer/utils.d.ts.map +1 -1
  98. package/dest/sequencer/utils.js +7 -4
  99. package/dest/test/index.d.ts +8 -9
  100. package/dest/test/index.d.ts.map +1 -1
  101. package/dest/test/mock_checkpoint_builder.d.ts +95 -0
  102. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -0
  103. package/dest/test/mock_checkpoint_builder.js +231 -0
  104. package/dest/test/utils.d.ts +67 -0
  105. package/dest/test/utils.d.ts.map +1 -0
  106. package/dest/test/utils.js +122 -0
  107. package/package.json +32 -29
  108. package/src/client/sequencer-client.ts +118 -66
  109. package/src/config.ts +173 -64
  110. package/src/global_variable_builder/README.md +44 -0
  111. package/src/global_variable_builder/fee_predictor.ts +182 -0
  112. package/src/global_variable_builder/fee_provider.ts +97 -0
  113. package/src/global_variable_builder/global_builder.ts +45 -110
  114. package/src/global_variable_builder/index.ts +3 -1
  115. package/src/index.ts +1 -7
  116. package/src/publisher/config.ts +182 -46
  117. package/src/publisher/index.ts +3 -0
  118. package/src/publisher/l1_to_l2_messaging.ts +85 -0
  119. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  120. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +164 -0
  121. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +47 -0
  122. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  123. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  124. package/src/publisher/sequencer-publisher-factory.ts +43 -13
  125. package/src/publisher/sequencer-publisher-metrics.ts +19 -71
  126. package/src/publisher/sequencer-publisher.ts +1042 -542
  127. package/src/publisher/write_json.ts +78 -0
  128. package/src/sequencer/README.md +243 -0
  129. package/src/sequencer/automine/README.md +60 -0
  130. package/src/sequencer/automine/automine_factory.ts +152 -0
  131. package/src/sequencer/automine/automine_sequencer.ts +796 -0
  132. package/src/sequencer/automine/index.ts +6 -0
  133. package/src/sequencer/checkpoint_proposal_job.ts +1652 -0
  134. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  135. package/src/sequencer/checkpoint_voter.ts +119 -0
  136. package/src/sequencer/config.ts +2 -1
  137. package/src/sequencer/events.ts +88 -0
  138. package/src/sequencer/index.ts +3 -1
  139. package/src/sequencer/metrics.ts +302 -83
  140. package/src/sequencer/requests_tracker.ts +43 -0
  141. package/src/sequencer/sequencer.ts +1011 -898
  142. package/src/sequencer/types.ts +6 -0
  143. package/src/sequencer/utils.ts +18 -9
  144. package/src/test/index.ts +7 -8
  145. package/src/test/mock_checkpoint_builder.ts +323 -0
  146. package/src/test/utils.ts +218 -0
  147. package/dest/sequencer/block_builder.d.ts +0 -28
  148. package/dest/sequencer/block_builder.d.ts.map +0 -1
  149. package/dest/sequencer/block_builder.js +0 -134
  150. package/dest/sequencer/timetable.d.ts +0 -50
  151. package/dest/sequencer/timetable.d.ts.map +0 -1
  152. package/dest/sequencer/timetable.js +0 -137
  153. package/dest/tx_validator/nullifier_cache.d.ts +0 -14
  154. package/dest/tx_validator/nullifier_cache.d.ts.map +0 -1
  155. package/dest/tx_validator/nullifier_cache.js +0 -24
  156. package/dest/tx_validator/tx_validator_factory.d.ts +0 -18
  157. package/dest/tx_validator/tx_validator_factory.d.ts.map +0 -1
  158. package/dest/tx_validator/tx_validator_factory.js +0 -53
  159. package/src/sequencer/block_builder.ts +0 -222
  160. package/src/sequencer/timetable.ts +0 -188
  161. package/src/tx_validator/nullifier_cache.ts +0 -30
  162. package/src/tx_validator/tx_validator_factory.ts +0 -133
@@ -1,11 +1,12 @@
1
+ import { MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT } from '@aztec/constants';
1
2
  import { EpochCache } from '@aztec/epoch-cache';
2
- import { GovernanceProposerContract, PublisherManager, RollupContract, getPublicClient, isAnvilTestChain } from '@aztec/ethereum';
3
- import { EthAddress } from '@aztec/foundation/eth-address';
3
+ import { getPublicClient } from '@aztec/ethereum/client';
4
+ import { GovernanceProposerContract, RollupContract } from '@aztec/ethereum/contracts';
5
+ import { PublisherManager } from '@aztec/ethereum/publisher-manager';
4
6
  import { createLogger } from '@aztec/foundation/log';
5
- import { SlashFactoryContract } from '@aztec/stdlib/l1-contracts';
6
7
  import { L1Metrics } from '@aztec/telemetry-client';
7
8
  import { NodeKeystoreAdapter } from '@aztec/validator-client';
8
- import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
9
+ import { getPublisherConfigFromSequencerConfig } from '../config.js';
9
10
  import { SequencerPublisherFactory } from '../publisher/sequencer-publisher-factory.js';
10
11
  import { Sequencer } from '../sequencer/index.js';
11
12
  /**
@@ -13,15 +14,17 @@ import { Sequencer } from '../sequencer/index.js';
13
14
  */ export class SequencerClient {
14
15
  publisherManager;
15
16
  sequencer;
16
- blockBuilder;
17
+ checkpointsBuilder;
17
18
  validatorClient;
18
19
  l1Metrics;
19
- constructor(publisherManager, sequencer, blockBuilder, validatorClient, l1Metrics){
20
+ delayer_;
21
+ constructor(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer_){
20
22
  this.publisherManager = publisherManager;
21
23
  this.sequencer = sequencer;
22
- this.blockBuilder = blockBuilder;
24
+ this.checkpointsBuilder = checkpointsBuilder;
23
25
  this.validatorClient = validatorClient;
24
26
  this.l1Metrics = l1Metrics;
27
+ this.delayer_ = delayer_;
25
28
  }
26
29
  /**
27
30
  * Initializes a new instance.
@@ -35,20 +38,24 @@ import { Sequencer } from '../sequencer/index.js';
35
38
  * @param prover - An instance of a block prover
36
39
  * @returns A new running instance.
37
40
  */ static async new(config, deps) {
38
- const { validatorClient, p2pClient, worldStateSynchronizer, slasherClient, blockBuilder, l2BlockSource, l1ToL2MessageSource, telemetry: telemetryClient } = deps;
41
+ const { validatorClient, p2pClient, worldStateSynchronizer, slasherClient, checkpointsBuilder, l2BlockSource, l1ToL2MessageSource, telemetry: telemetryClient } = deps;
39
42
  const { l1RpcUrls: rpcUrls, l1ChainId: chainId } = config;
40
43
  const log = createLogger('sequencer');
41
44
  const publicClient = getPublicClient(config);
42
45
  const l1TxUtils = deps.l1TxUtils;
43
46
  const l1Metrics = new L1Metrics(telemetryClient.getMeter('L1PublisherMetrics'), publicClient, l1TxUtils.map((x)=>x.getSenderAddress()));
44
- const publisherManager = new PublisherManager(l1TxUtils, config);
45
- const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
46
- const [l1GenesisTime, slotDuration] = await Promise.all([
47
+ const publisherManager = new PublisherManager(l1TxUtils, getPublisherConfigFromSequencerConfig(config), {
48
+ bindings: log.getBindings(),
49
+ funder: deps.funderL1TxUtils
50
+ });
51
+ const rollupContract = new RollupContract(publicClient, config.rollupAddress.toString());
52
+ const [l1GenesisTime, slotDuration, rollupManaLimit] = await Promise.all([
47
53
  rollupContract.getL1GenesisTime(),
48
- rollupContract.getSlotDuration()
54
+ rollupContract.getSlotDuration(),
55
+ rollupContract.getManaLimit().then(Number)
49
56
  ]);
50
- const governanceProposerContract = new GovernanceProposerContract(publicClient, config.l1Contracts.governanceProposerAddress.toString());
51
- const epochCache = deps.epochCache ?? await EpochCache.create(config.l1Contracts.rollupAddress, {
57
+ const governanceProposerContract = new GovernanceProposerContract(publicClient, config.governanceProposerAddress.toString());
58
+ const epochCache = deps.epochCache ?? await EpochCache.create(config.rollupAddress, {
52
59
  l1RpcUrls: rpcUrls,
53
60
  l1ChainId: chainId,
54
61
  viemPollingIntervalMS: config.viemPollingIntervalMS,
@@ -56,73 +63,86 @@ import { Sequencer } from '../sequencer/index.js';
56
63
  }, {
57
64
  dateProvider: deps.dateProvider
58
65
  });
59
- const slashFactoryContract = new SlashFactoryContract(publicClient, config.l1Contracts.slashFactoryAddress?.toString() ?? EthAddress.ZERO.toString());
60
66
  const publisherFactory = deps.publisherFactory ?? new SequencerPublisherFactory(config, {
61
67
  telemetry: telemetryClient,
62
- blobSinkClient: deps.blobSinkClient,
68
+ blobClient: deps.blobClient,
63
69
  epochCache,
64
70
  governanceProposerContract,
65
- slashFactoryContract,
66
71
  rollupContract,
67
72
  dateProvider: deps.dateProvider,
68
73
  publisherManager,
69
74
  nodeKeyStore: NodeKeystoreAdapter.fromKeyStoreManager(deps.nodeKeyStore),
70
75
  logger: log
71
76
  });
72
- const globalsBuilder = new GlobalVariableBuilder(config);
73
77
  const ethereumSlotDuration = config.ethereumSlotDuration;
74
- const rollupManaLimit = Number(await rollupContract.getManaLimit());
75
- let sequencerManaLimit = config.maxL2BlockGas ?? rollupManaLimit;
76
- if (sequencerManaLimit > rollupManaLimit) {
77
- log.warn(`Provided maxL2BlockGas of ${sequencerManaLimit} is greater than the maximum allowed by the L1 (${rollupManaLimit}), setting limit to ${rollupManaLimit}`);
78
- sequencerManaLimit = rollupManaLimit;
79
- }
80
- // When running in anvil, assume we can post a tx up until one second before the end of an L1 slot.
81
- // Otherwise, assume we must have broadcasted the tx before the slot started (we use a default
82
- // maxL1TxInclusionTimeIntoSlot of zero) to get the tx into that L1 slot.
83
- // In theory, the L1 slot has an initial 4s phase where the block is propagated, so we could
84
- // make it with a propagation time into slot equal to 4s. However, we prefer being conservative.
85
- // See https://www.blocknative.com/blog/anatomy-of-a-slot#7 for more info.
86
- const maxInclusionBasedOnChain = isAnvilTestChain(config.l1ChainId) ? ethereumSlotDuration - 1 : 0;
87
- const maxL1TxInclusionTimeIntoSlot = config.maxL1TxInclusionTimeIntoSlot ?? maxInclusionBasedOnChain;
78
+ const globalsBuilder = deps.globalVariableBuilder;
79
+ const { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock } = capPerBlockLimits(config, rollupManaLimit, log);
88
80
  const l1Constants = {
89
81
  l1GenesisTime,
90
82
  slotDuration: Number(slotDuration),
91
- ethereumSlotDuration
83
+ ethereumSlotDuration,
84
+ rollupManaLimit,
85
+ epochDuration: config.aztecEpochDuration
92
86
  };
93
- const sequencer = new Sequencer(publisherFactory, validatorClient, globalsBuilder, p2pClient, worldStateSynchronizer, slasherClient, l2BlockSource, l1ToL2MessageSource, blockBuilder, l1Constants, deps.dateProvider, epochCache, rollupContract, {
87
+ const sequencer = new Sequencer(publisherFactory, validatorClient, globalsBuilder, p2pClient, worldStateSynchronizer, slasherClient, l2BlockSource, l1ToL2MessageSource, checkpointsBuilder, l1Constants, deps.dateProvider, epochCache, rollupContract, {
94
88
  ...config,
95
- maxL1TxInclusionTimeIntoSlot,
96
- maxL2BlockGas: sequencerManaLimit
89
+ maxL2BlockGas,
90
+ maxDABlockGas,
91
+ maxTxsPerBlock
97
92
  }, telemetryClient, log);
98
- await sequencer.init();
99
- return new SequencerClient(publisherManager, sequencer, blockBuilder, validatorClient, l1Metrics);
93
+ sequencer.init();
94
+ // Extract the shared delayer from the first L1TxUtils instance (all instances share the same delayer)
95
+ const delayer = l1TxUtils[0]?.delayer;
96
+ return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer);
100
97
  }
101
98
  /**
102
99
  * Updates sequencer and validator client config.
103
100
  * @param config - New parameters.
104
101
  */ updateConfig(config) {
105
102
  this.sequencer.updateConfig(config);
106
- this.blockBuilder.updateConfig(config);
103
+ this.checkpointsBuilder.updateConfig(config);
107
104
  this.validatorClient?.updateConfig(config);
108
105
  }
109
- /** Starts the sequencer. */ async start() {
106
+ /**
107
+ * Starts (or resumes) the sequencer, validator, publishers, and metrics. Each underlying start is
108
+ * idempotent, so this is safe to call after a previous {@link pause} to resume building and publishing.
109
+ * The publisher manager is started before the sequencer's poll loop so publishing is ready before the
110
+ * sequencer first tries to publish to L1.
111
+ */ async start() {
110
112
  await this.validatorClient?.start();
113
+ await this.publisherManager.start();
111
114
  this.sequencer.start();
112
115
  this.l1Metrics?.start();
113
- await this.publisherManager.loadState();
114
116
  }
115
117
  /**
116
- * Stops the sequencer from processing new txs.
118
+ * Stops the sequencer, validator, publishers, and metrics for good, draining in-flight work. This is the
119
+ * final teardown path: stopping the validator client closes its slashing-protection database. For a
120
+ * restartable pause (e.g. around a test clock warp) use {@link pause} instead.
117
121
  */ async stop() {
118
122
  await this.sequencer.stop();
119
123
  await this.validatorClient?.stop();
120
- this.publisherManager.interrupt();
124
+ await this.publisherManager.stop();
121
125
  this.l1Metrics?.stop();
122
126
  }
127
+ /**
128
+ * Gracefully pauses block production, waiting for in-flight work to finish rather than interrupting it,
129
+ * while leaving the validator, publishers, and metrics running so the sequencer can be resumed with
130
+ * {@link start}. Used by tests that pause sequencers around an L1 clock warp.
131
+ */ async pause() {
132
+ await this.sequencer.pause();
133
+ }
134
+ /** Triggers an immediate run of the sequencer, bypassing the polling interval. */ trigger() {
135
+ return this.sequencer.trigger();
136
+ }
123
137
  getSequencer() {
124
138
  return this.sequencer;
125
139
  }
140
+ /** Updates the publisher factory's node keystore adapter after a keystore reload. */ updatePublisherNodeKeyStore(adapter) {
141
+ this.sequencer.updatePublisherNodeKeyStore(adapter);
142
+ }
143
+ /** Returns the shared tx delayer for sequencer L1 txs, if enabled. Test-only. */ getDelayer() {
144
+ return this.delayer_;
145
+ }
126
146
  get validatorAddresses() {
127
147
  return this.sequencer.getValidatorAddresses();
128
148
  }
@@ -130,3 +150,28 @@ import { Sequencer } from '../sequencer/index.js';
130
150
  return this.sequencer.maxL2BlockGas;
131
151
  }
132
152
  }
153
+ /**
154
+ * Caps operator-provided per-block limits at checkpoint-level limits.
155
+ * Returns undefined for any limit the operator didn't set — the checkpoint builder handles redistribution.
156
+ */ function capPerBlockLimits(config, rollupManaLimit, log) {
157
+ let maxL2BlockGas = config.maxL2BlockGas;
158
+ if (maxL2BlockGas !== undefined && maxL2BlockGas > rollupManaLimit) {
159
+ log.warn(`Provided MAX_L2_BLOCK_GAS ${maxL2BlockGas} exceeds rollup mana limit ${rollupManaLimit} (capping)`);
160
+ maxL2BlockGas = rollupManaLimit;
161
+ }
162
+ let maxDABlockGas = config.maxDABlockGas;
163
+ if (maxDABlockGas !== undefined && maxDABlockGas > MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT) {
164
+ log.warn(`Provided MAX_DA_BLOCK_GAS ${maxDABlockGas} exceeds DA checkpoint limit ${MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT} (capping)`);
165
+ maxDABlockGas = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT;
166
+ }
167
+ let maxTxsPerBlock = config.maxTxsPerBlock;
168
+ if (maxTxsPerBlock !== undefined && config.maxTxsPerCheckpoint !== undefined && maxTxsPerBlock > config.maxTxsPerCheckpoint) {
169
+ log.warn(`Provided MAX_TX_PER_BLOCK ${maxTxsPerBlock} exceeds MAX_TX_PER_CHECKPOINT ${config.maxTxsPerCheckpoint} (capping)`);
170
+ maxTxsPerBlock = config.maxTxsPerCheckpoint;
171
+ }
172
+ return {
173
+ maxL2BlockGas,
174
+ maxDABlockGas,
175
+ maxTxsPerBlock
176
+ };
177
+ }
package/dest/config.d.ts CHANGED
@@ -1,21 +1,54 @@
1
- import { type L1ContractsConfig, type L1ReaderConfig } from '@aztec/ethereum';
1
+ import { type L1ContractsConfig } from '@aztec/ethereum/config';
2
+ import { type L1ReaderConfig } from '@aztec/ethereum/l1-reader';
2
3
  import { type ConfigMappingsType } from '@aztec/foundation/config';
3
- import { type KeyStoreConfig } from '@aztec/node-keystore';
4
- import { type P2PConfig } from '@aztec/p2p';
4
+ import { type KeyStoreConfig } from '@aztec/node-keystore/config';
5
+ import { type P2PConfig } from '@aztec/p2p/config';
5
6
  import { type ChainConfig, type SequencerConfig } from '@aztec/stdlib/config';
6
- import { type ValidatorClientConfig } from '@aztec/validator-client';
7
- import { type PublisherConfig, type TxSenderConfig } from './publisher/config.js';
7
+ import { type ValidatorClientConfig } from '@aztec/validator-client/config';
8
+ import { type SequencerPublisherConfig, type SequencerTxSenderConfig } from './publisher/config.js';
8
9
  export * from './publisher/config.js';
9
10
  export type { SequencerConfig };
10
- export declare const DEFAULT_ATTESTATION_PROPAGATION_TIME = 2;
11
+ /**
12
+ * Default values for SequencerConfig.
13
+ * Centralized location for all sequencer configuration defaults.
14
+ */
15
+ export declare const DefaultSequencerConfig: {
16
+ sequencerPollingIntervalMS: number;
17
+ minTxsPerBlock: number;
18
+ buildCheckpointIfEmpty: false;
19
+ publishTxsWithProposals: false;
20
+ perBlockAllocationMultiplier: number;
21
+ perBlockDAAllocationMultiplier: number;
22
+ redistributeCheckpointBudget: true;
23
+ blockDurationMs: number;
24
+ l1PublishingTime: number;
25
+ checkpointProposalSyncGraceSeconds: number;
26
+ attestationPropagationTime: number;
27
+ secondsBeforeInvalidatingBlockAsCommitteeMember: number;
28
+ secondsBeforeInvalidatingBlockAsNonCommitteeMember: number;
29
+ skipCollectingAttestations: false;
30
+ skipInvalidateBlockAsProposer: false;
31
+ skipWaitForValidParentCheckpointOnL1: false;
32
+ broadcastInvalidBlockProposal: false;
33
+ broadcastInvalidCheckpointProposalOnly: false;
34
+ injectFakeAttestation: false;
35
+ injectHighSValueAttestation: false;
36
+ injectUnrecoverableSignatureAttestation: false;
37
+ injectYParityAttestation: false;
38
+ fishermanMode: false;
39
+ shuffleAttestationOrdering: false;
40
+ skipPushProposedBlocksToArchiver: false;
41
+ skipPublishingCheckpointsPercent: number;
42
+ maxBlocksPerCheckpoint: number;
43
+ };
11
44
  /**
12
45
  * Configuration settings for the SequencerClient.
13
46
  */
14
- export type SequencerClientConfig = PublisherConfig & KeyStoreConfig & ValidatorClientConfig & TxSenderConfig & SequencerConfig & L1ReaderConfig & ChainConfig & Pick<P2PConfig, 'txPublicSetupAllowList'> & Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
47
+ export type SequencerClientConfig = SequencerPublisherConfig & KeyStoreConfig & ValidatorClientConfig & SequencerTxSenderConfig & SequencerConfig & L1ReaderConfig & ChainConfig & Pick<P2PConfig, 'txPublicSetupAllowListExtend'> & Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
15
48
  export declare const sequencerConfigMappings: ConfigMappingsType<SequencerConfig>;
16
49
  export declare const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig>;
17
50
  /**
18
51
  * Creates an instance of SequencerClientConfig out of environment variables using sensible defaults for integration testing if not set.
19
52
  */
20
53
  export declare function getConfigEnvVars(): SequencerClientConfig;
21
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxLQUFLLGlCQUFpQixFQUN0QixLQUFLLGNBQWMsRUFHcEIsTUFBTSxpQkFBaUIsQ0FBQztBQUN6QixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFLeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sc0JBQXNCLENBQUM7QUFDbkYsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFxQixNQUFNLFlBQVksQ0FBQztBQUUvRCxPQUFPLEVBQUUsS0FBSyxXQUFXLEVBQUUsS0FBSyxlQUFlLEVBQXVCLE1BQU0sc0JBQXNCLENBQUM7QUFDbkcsT0FBTyxFQUFFLEtBQUsscUJBQXFCLEVBQWlDLE1BQU0seUJBQXlCLENBQUM7QUFFcEcsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUNwQixLQUFLLGNBQWMsRUFHcEIsTUFBTSx1QkFBdUIsQ0FBQztBQUUvQixjQUFjLHVCQUF1QixDQUFDO0FBQ3RDLFlBQVksRUFBRSxlQUFlLEVBQUUsQ0FBQztBQUVoQyxlQUFPLE1BQU0sb0NBQW9DLElBQUksQ0FBQztBQUV0RDs7R0FFRztBQUNILE1BQU0sTUFBTSxxQkFBcUIsR0FBRyxlQUFlLEdBQ2pELGNBQWMsR0FDZCxxQkFBcUIsR0FDckIsY0FBYyxHQUNkLGVBQWUsR0FDZixjQUFjLEdBQ2QsV0FBVyxHQUNYLElBQUksQ0FBQyxTQUFTLEVBQUUsd0JBQXdCLENBQUMsR0FDekMsSUFBSSxDQUFDLGlCQUFpQixFQUFFLHNCQUFzQixHQUFHLG1CQUFtQixHQUFHLG9CQUFvQixDQUFDLENBQUM7QUFFL0YsZUFBTyxNQUFNLHVCQUF1QixFQUFFLGtCQUFrQixDQUFDLGVBQWUsQ0F5SHZFLENBQUM7QUFFRixlQUFPLE1BQU0sNkJBQTZCLEVBQUUsa0JBQWtCLENBQUMscUJBQXFCLENBU25GLENBQUM7QUFFRjs7R0FFRztBQUNILHdCQUFnQixnQkFBZ0IsSUFBSSxxQkFBcUIsQ0FFeEQifQ==
54
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBQzNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFPeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sNkJBQTZCLENBQUM7QUFDMUYsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFxQixNQUFNLG1CQUFtQixDQUFDO0FBRXRFLE9BQU8sRUFDTCxLQUFLLFdBQVcsRUFHaEIsS0FBSyxlQUFlLEVBR3JCLE1BQU0sc0JBQXNCLENBQUM7QUFJOUIsT0FBTyxFQUFFLEtBQUsscUJBQXFCLEVBQWlDLE1BQU0sZ0NBQWdDLENBQUM7QUFFM0csT0FBTyxFQUNMLEtBQUssd0JBQXdCLEVBQzdCLEtBQUssdUJBQXVCLEVBRzdCLE1BQU0sdUJBQXVCLENBQUM7QUFFL0IsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxZQUFZLEVBQUUsZUFBZSxFQUFFLENBQUM7QUFFaEM7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHNCQUFzQjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQTRCQSxDQUFDO0FBRXBDOztHQUVHO0FBQ0gsTUFBTSxNQUFNLHFCQUFxQixHQUFHLHdCQUF3QixHQUMxRCxjQUFjLEdBQ2QscUJBQXFCLEdBQ3JCLHVCQUF1QixHQUN2QixlQUFlLEdBQ2YsY0FBYyxHQUNkLFdBQVcsR0FDWCxJQUFJLENBQUMsU0FBUyxFQUFFLDhCQUE4QixDQUFDLEdBQy9DLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxzQkFBc0IsR0FBRyxtQkFBbUIsR0FBRyxvQkFBb0IsQ0FBQyxDQUFDO0FBRS9GLGVBQU8sTUFBTSx1QkFBdUIsRUFBRSxrQkFBa0IsQ0FBQyxlQUFlLENBOEx2RSxDQUFDO0FBRUYsZUFBTyxNQUFNLDZCQUE2QixFQUFFLGtCQUFrQixDQUFDLHFCQUFxQixDQVNuRixDQUFDO0FBRUY7O0dBRUc7QUFDSCx3QkFBZ0IsZ0JBQWdCLElBQUkscUJBQXFCLENBRXhEIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAGpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAuB,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,KAAK,qBAAqB,EAAiC,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GACjD,cAAc,GACd,qBAAqB,GACrB,cAAc,GACd,eAAe,GACf,cAAc,GACd,WAAW,GACX,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,GACzC,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,CAAC;AAE/F,eAAO,MAAM,uBAAuB,EAAE,kBAAkB,CAAC,eAAe,CAyHvE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,kBAAkB,CAAC,qBAAqB,CASnF,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAExD"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAA6B,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AACxF,OAAO,EACL,KAAK,kBAAkB,EAOxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EACL,KAAK,WAAW,EAGhB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,KAAK,qBAAqB,EAAiC,MAAM,gCAAgC,CAAC;AAE3G,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAG7B,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BA,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAC1D,cAAc,GACd,qBAAqB,GACrB,uBAAuB,GACvB,eAAe,GACf,cAAc,GACd,WAAW,GACX,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,GAC/C,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,CAAC;AAE/F,eAAO,MAAM,uBAAuB,EAAE,kBAAkB,CAAC,eAAe,CA8LvE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,kBAAkB,CAAC,qBAAqB,CASnF,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAExD"}
package/dest/config.js CHANGED
@@ -1,53 +1,105 @@
1
- import { l1ContractsConfigMappings, l1ReaderConfigMappings } from '@aztec/ethereum';
2
- import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper, pickConfigMappings } from '@aztec/foundation/config';
1
+ import { l1ContractsConfigMappings } from '@aztec/ethereum/config';
2
+ import { l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
3
+ import { booleanConfigHelper, floatConfigHelper, getConfigFromMappings, numberConfigHelper, optionalNumberConfigHelper, pickConfigMappings } from '@aztec/foundation/config';
3
4
  import { EthAddress } from '@aztec/foundation/eth-address';
4
- import { keyStoreConfigMappings } from '@aztec/node-keystore';
5
- import { p2pConfigMappings } from '@aztec/p2p';
5
+ import { keyStoreConfigMappings } from '@aztec/node-keystore/config';
6
+ import { p2pConfigMappings } from '@aztec/p2p/config';
6
7
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
7
- import { chainConfigMappings } from '@aztec/stdlib/config';
8
- import { validatorClientConfigMappings } from '@aztec/validator-client';
9
- import { getPublisherConfigMappings, getTxSenderConfigMappings } from './publisher/config.js';
8
+ import { DEFAULT_BLOCK_DURATION_MS, DEFAULT_MAX_BLOCKS_PER_CHECKPOINT, chainConfigMappings, sharedSequencerConfigMappings } from '@aztec/stdlib/config';
9
+ import { MIN_PER_BLOCK_ALLOCATION_MULTIPLIER, MIN_PER_BLOCK_DA_ALLOCATION_MULTIPLIER } from '@aztec/stdlib/gas';
10
+ import { DEFAULT_P2P_PROPAGATION_TIME } from '@aztec/stdlib/timetable';
11
+ import { validatorClientConfigMappings } from '@aztec/validator-client/config';
12
+ import { sequencerPublisherConfigMappings, sequencerTxSenderConfigMappings } from './publisher/config.js';
10
13
  export * from './publisher/config.js';
11
- export const DEFAULT_ATTESTATION_PROPAGATION_TIME = 2;
14
+ /**
15
+ * Default values for SequencerConfig.
16
+ * Centralized location for all sequencer configuration defaults.
17
+ */ export const DefaultSequencerConfig = {
18
+ sequencerPollingIntervalMS: 500,
19
+ minTxsPerBlock: 1,
20
+ buildCheckpointIfEmpty: false,
21
+ publishTxsWithProposals: false,
22
+ perBlockAllocationMultiplier: MIN_PER_BLOCK_ALLOCATION_MULTIPLIER,
23
+ perBlockDAAllocationMultiplier: MIN_PER_BLOCK_DA_ALLOCATION_MULTIPLIER,
24
+ redistributeCheckpointBudget: true,
25
+ blockDurationMs: DEFAULT_BLOCK_DURATION_MS,
26
+ l1PublishingTime: 12,
27
+ checkpointProposalSyncGraceSeconds: 2 * (DEFAULT_BLOCK_DURATION_MS / 1000),
28
+ attestationPropagationTime: DEFAULT_P2P_PROPAGATION_TIME,
29
+ secondsBeforeInvalidatingBlockAsCommitteeMember: 144,
30
+ secondsBeforeInvalidatingBlockAsNonCommitteeMember: 432,
31
+ skipCollectingAttestations: false,
32
+ skipInvalidateBlockAsProposer: false,
33
+ skipWaitForValidParentCheckpointOnL1: false,
34
+ broadcastInvalidBlockProposal: false,
35
+ broadcastInvalidCheckpointProposalOnly: false,
36
+ injectFakeAttestation: false,
37
+ injectHighSValueAttestation: false,
38
+ injectUnrecoverableSignatureAttestation: false,
39
+ injectYParityAttestation: false,
40
+ fishermanMode: false,
41
+ shuffleAttestationOrdering: false,
42
+ skipPushProposedBlocksToArchiver: false,
43
+ skipPublishingCheckpointsPercent: 0,
44
+ maxBlocksPerCheckpoint: DEFAULT_MAX_BLOCKS_PER_CHECKPOINT
45
+ };
12
46
  export const sequencerConfigMappings = {
13
- transactionPollingIntervalMS: {
14
- env: 'SEQ_TX_POLLING_INTERVAL_MS',
15
- description: 'The number of ms to wait between polling for pending txs.',
16
- ...numberConfigHelper(500)
47
+ sequencerPollingIntervalMS: {
48
+ env: 'SEQ_POLLING_INTERVAL_MS',
49
+ description: 'The number of ms to wait between polling for checking to build on the next slot.',
50
+ ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS)
17
51
  },
18
- maxTxsPerBlock: {
19
- env: 'SEQ_MAX_TX_PER_BLOCK',
20
- description: 'The maximum number of txs to include in a block.',
21
- ...numberConfigHelper(32)
52
+ maxTxsPerCheckpoint: {
53
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
54
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
55
+ ...optionalNumberConfigHelper()
22
56
  },
23
57
  minTxsPerBlock: {
24
58
  env: 'SEQ_MIN_TX_PER_BLOCK',
25
59
  description: 'The minimum number of txs to include in a block.',
26
- ...numberConfigHelper(1)
60
+ ...numberConfigHelper(DefaultSequencerConfig.minTxsPerBlock)
61
+ },
62
+ minValidTxsPerBlock: {
63
+ description: 'The minimum number of valid txs (after execution) to include in a block. If not set, falls back to minTxsPerBlock.'
27
64
  },
28
65
  publishTxsWithProposals: {
29
66
  env: 'SEQ_PUBLISH_TXS_WITH_PROPOSALS',
30
67
  description: 'Whether to publish txs with proposals.',
31
- ...booleanConfigHelper(false)
68
+ ...booleanConfigHelper(DefaultSequencerConfig.publishTxsWithProposals)
32
69
  },
33
70
  maxL2BlockGas: {
34
71
  env: 'SEQ_MAX_L2_BLOCK_GAS',
35
72
  description: 'The maximum L2 block gas.',
36
- ...numberConfigHelper(10e9)
73
+ ...optionalNumberConfigHelper()
37
74
  },
38
75
  maxDABlockGas: {
39
76
  env: 'SEQ_MAX_DA_BLOCK_GAS',
40
77
  description: 'The maximum DA block gas.',
41
- ...numberConfigHelper(10e9)
78
+ ...optionalNumberConfigHelper()
79
+ },
80
+ perBlockAllocationMultiplier: {
81
+ env: 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER',
82
+ description: 'Per-block gas budget multiplier for both L2 and DA gas. Budget per block is (checkpointLimit / maxBlocks) * multiplier.' + ' Values greater than one allow early blocks to use more than their even share, relying on checkpoint-level capping for later blocks.',
83
+ ...floatConfigHelper(DefaultSequencerConfig.perBlockAllocationMultiplier)
84
+ },
85
+ perBlockDAAllocationMultiplier: {
86
+ env: 'SEQ_PER_BLOCK_DA_ALLOCATION_MULTIPLIER',
87
+ description: 'Per-block budget multiplier applied to DA gas and blob fields in place of perBlockAllocationMultiplier.' + ' Defaults higher than the general multiplier so the largest contract class deploy fits a single block.',
88
+ ...floatConfigHelper(DefaultSequencerConfig.perBlockDAAllocationMultiplier)
89
+ },
90
+ redistributeCheckpointBudget: {
91
+ env: 'SEQ_REDISTRIBUTE_CHECKPOINT_BUDGET',
92
+ description: 'Redistribute remaining checkpoint budget evenly across remaining blocks instead of allowing a single block to consume the entire remaining budget.',
93
+ ...booleanConfigHelper(DefaultSequencerConfig.redistributeCheckpointBudget)
42
94
  },
43
95
  coinbase: {
44
96
  env: 'COINBASE',
45
- parseEnv: (val)=>val ? EthAddress.fromString(val) : undefined,
97
+ parseEnv: (val)=>EthAddress.fromString(val),
46
98
  description: 'Recipient of block reward.'
47
99
  },
48
100
  feeRecipient: {
49
101
  env: 'FEE_RECIPIENT',
50
- parseEnv: (val)=>AztecAddress.fromString(val),
102
+ parseEnv: (val)=>AztecAddress.fromStringUnsafe(val),
51
103
  description: 'Address to receive fees.'
52
104
  },
53
105
  acvmWorkingDirectory: {
@@ -58,83 +110,122 @@ export const sequencerConfigMappings = {
58
110
  env: 'ACVM_BINARY_PATH',
59
111
  description: 'The path to the ACVM binary'
60
112
  },
61
- maxBlockSizeInBytes: {
62
- env: 'SEQ_MAX_BLOCK_SIZE_IN_BYTES',
63
- description: 'Max block size',
64
- ...numberConfigHelper(1024 * 1024)
65
- },
66
- enforceTimeTable: {
67
- env: 'SEQ_ENFORCE_TIME_TABLE',
68
- description: 'Whether to enforce the time table when building blocks',
69
- ...booleanConfigHelper(),
70
- defaultValue: true
71
- },
72
113
  governanceProposerPayload: {
73
114
  env: 'GOVERNANCE_PROPOSER_PAYLOAD_ADDRESS',
74
115
  description: 'The address of the payload for the governanceProposer',
75
- parseEnv: (val)=>EthAddress.fromString(val),
76
- defaultValue: EthAddress.ZERO
116
+ parseEnv: (val)=>EthAddress.fromString(val)
77
117
  },
78
- maxL1TxInclusionTimeIntoSlot: {
79
- env: 'SEQ_MAX_L1_TX_INCLUSION_TIME_INTO_SLOT',
80
- description: 'How many seconds into an L1 slot we can still send a tx and get it mined.',
81
- parseEnv: (val)=>val ? parseInt(val, 10) : undefined
82
- },
83
- attestationPropagationTime: {
84
- env: 'SEQ_ATTESTATION_PROPAGATION_TIME',
85
- description: 'How many seconds it takes for proposals and attestations to travel across the p2p layer (one-way)',
86
- ...numberConfigHelper(DEFAULT_ATTESTATION_PROPAGATION_TIME)
118
+ l1PublishingTime: {
119
+ env: 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT',
120
+ description: 'How much time in seconds to allow in the slot for publishing the L1 transaction.',
121
+ ...numberConfigHelper(DefaultSequencerConfig.l1PublishingTime)
87
122
  },
88
123
  fakeProcessingDelayPerTxMs: {
89
124
  description: 'Used for testing to introduce a fake delay after processing each tx'
90
125
  },
126
+ fakeThrowAfterProcessingTxCount: {
127
+ description: 'Used for testing to throw an error after processing N txs'
128
+ },
91
129
  secondsBeforeInvalidatingBlockAsCommitteeMember: {
92
130
  env: 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_COMMITTEE_MEMBER',
93
131
  description: 'How many seconds to wait before trying to invalidate a block from the pending chain as a committee member (zero to never invalidate).' + ' The next proposer is expected to invalidate, so the committee acts as a fallback.',
94
- ...numberConfigHelper(144)
132
+ ...numberConfigHelper(DefaultSequencerConfig.secondsBeforeInvalidatingBlockAsCommitteeMember)
95
133
  },
96
134
  secondsBeforeInvalidatingBlockAsNonCommitteeMember: {
97
135
  env: 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_NON_COMMITTEE_MEMBER',
98
136
  description: 'How many seconds to wait before trying to invalidate a block from the pending chain as a non-committee member (zero to never invalidate).' + ' The next proposer is expected to invalidate, then the committee, so other sequencers act as a fallback.',
99
- ...numberConfigHelper(432)
137
+ ...numberConfigHelper(DefaultSequencerConfig.secondsBeforeInvalidatingBlockAsNonCommitteeMember)
100
138
  },
101
139
  skipCollectingAttestations: {
102
140
  description: 'Whether to skip collecting attestations from validators and only use self-attestations (for testing only)',
103
- ...booleanConfigHelper(false)
141
+ ...booleanConfigHelper(DefaultSequencerConfig.skipCollectingAttestations)
104
142
  },
105
143
  skipInvalidateBlockAsProposer: {
106
144
  description: 'Do not invalidate the previous block if invalid when we are the proposer (for testing only)',
107
- ...booleanConfigHelper(false)
145
+ ...booleanConfigHelper(DefaultSequencerConfig.skipInvalidateBlockAsProposer)
146
+ },
147
+ skipWaitForValidParentCheckpointOnL1: {
148
+ description: 'Bypass the parent checkpoint validity check before submitting a pipelined checkpoint, ' + 'allowing the proposer to publish even when the parent landed on L1 with invalid attestations (for testing only)',
149
+ ...booleanConfigHelper(DefaultSequencerConfig.skipWaitForValidParentCheckpointOnL1)
108
150
  },
109
151
  broadcastInvalidBlockProposal: {
110
152
  description: 'Broadcast invalid block proposals with corrupted state (for testing only)',
111
- ...booleanConfigHelper(false)
153
+ ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidBlockProposal)
154
+ },
155
+ invalidBlockProposalIndexWithinCheckpoint: {
156
+ description: 'Broadcast an invalid block proposal only at this indexWithinCheckpoint (for testing only)',
157
+ ...optionalNumberConfigHelper()
158
+ },
159
+ broadcastInvalidCheckpointProposalOnly: {
160
+ description: 'Broadcast invalid checkpoint proposals while keeping the underlying block proposals valid (for testing only). When unset, the checkpoint follows broadcastInvalidBlockProposal.',
161
+ ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidCheckpointProposalOnly)
112
162
  },
113
163
  injectFakeAttestation: {
114
164
  description: 'Inject a fake attestation (for testing only)',
115
- ...booleanConfigHelper(false)
165
+ ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation)
166
+ },
167
+ injectHighSValueAttestation: {
168
+ description: 'Inject a malleable attestation with a high-s value (for testing only)',
169
+ ...booleanConfigHelper(DefaultSequencerConfig.injectHighSValueAttestation)
170
+ },
171
+ injectUnrecoverableSignatureAttestation: {
172
+ description: 'Inject an attestation with an unrecoverable signature (for testing only)',
173
+ ...booleanConfigHelper(DefaultSequencerConfig.injectUnrecoverableSignatureAttestation)
174
+ },
175
+ injectYParityAttestation: {
176
+ description: 'Inject a non-proposer attestation slot in yParity form in the packed L1 tuple (for testing only)',
177
+ ...booleanConfigHelper(DefaultSequencerConfig.injectYParityAttestation)
116
178
  },
117
179
  fishermanMode: {
118
180
  env: 'FISHERMAN_MODE',
119
181
  description: 'Whether to run in fisherman mode: builds blocks on every slot for validation without publishing to L1',
120
- ...booleanConfigHelper(false)
182
+ ...booleanConfigHelper(DefaultSequencerConfig.fishermanMode)
121
183
  },
122
184
  shuffleAttestationOrdering: {
123
185
  description: 'Shuffle attestation ordering to create invalid ordering (for testing only)',
186
+ ...booleanConfigHelper(DefaultSequencerConfig.shuffleAttestationOrdering)
187
+ },
188
+ ...sharedSequencerConfigMappings,
189
+ buildCheckpointIfEmpty: {
190
+ env: 'SEQ_BUILD_CHECKPOINT_IF_EMPTY',
191
+ description: 'Have sequencer build and publish an empty checkpoint if there are no txs',
192
+ ...booleanConfigHelper(DefaultSequencerConfig.buildCheckpointIfEmpty)
193
+ },
194
+ skipPushProposedBlocksToArchiver: {
195
+ description: 'Skip pushing proposed blocks to archiver (test only)',
196
+ ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver)
197
+ },
198
+ minBlocksForCheckpoint: {
199
+ description: 'Minimum number of blocks required for a checkpoint proposal (test only)'
200
+ },
201
+ skipPublishingCheckpointsPercent: {
202
+ env: 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT',
203
+ description: 'Percent probability (0 - 100) of sequencer skipping checkpoint publishing (testing only)',
204
+ ...numberConfigHelper(DefaultSequencerConfig.skipPublishingCheckpointsPercent)
205
+ },
206
+ skipBroadcastProposals: {
207
+ description: 'Skip broadcasting checkpoint and block proposals via gossipsub when proposer (for testing only)',
208
+ ...booleanConfigHelper(false)
209
+ },
210
+ skipBroadcastCheckpointProposal: {
211
+ description: 'Skip broadcasting only the CheckpointProposal via gossipsub when proposer; the held last block is broadcast ' + 'standalone instead so peers still receive it as a proposed-but-uncheckpointed tip (for testing only)',
124
212
  ...booleanConfigHelper(false)
125
213
  },
214
+ pauseProposingForSlots: {
215
+ description: 'List of slots for which the sequencer will not produce a proposal (for testing only). Attestation paths are unaffected.'
216
+ },
126
217
  ...pickConfigMappings(p2pConfigMappings, [
127
- 'txPublicSetupAllowList'
218
+ 'txPublicSetupAllowListExtend'
128
219
  ])
129
220
  };
130
221
  export const sequencerClientConfigMappings = {
222
+ ...chainConfigMappings,
131
223
  ...validatorClientConfigMappings,
132
224
  ...sequencerConfigMappings,
133
225
  ...keyStoreConfigMappings,
134
226
  ...l1ReaderConfigMappings,
135
- ...getTxSenderConfigMappings('SEQ'),
136
- ...getPublisherConfigMappings('SEQ'),
137
- ...chainConfigMappings,
227
+ ...sequencerTxSenderConfigMappings,
228
+ ...sequencerPublisherConfigMappings,
138
229
  ...pickConfigMappings(l1ContractsConfigMappings, [
139
230
  'ethereumSlotDuration',
140
231
  'aztecSlotDuration',
@@ -0,0 +1,37 @@
1
+ import { type RollupContract } from '@aztec/ethereum/contracts';
2
+ import type { DateProvider } from '@aztec/foundation/timer';
3
+ import { GasFees, ManaUsageEstimate } from '@aztec/stdlib/gas';
4
+ /**
5
+ * Predicts min fees for LAG upcoming slots based on the L1 oracle state.
6
+ * A new oracle update can activate at startSlot + LAG, so only the first LAG entries
7
+ * are guaranteed stable. Caches L1 queries per L1 block and recomputes predictions
8
+ * for each mana usage estimate.
9
+ */
10
+ export declare class FeePredictor {
11
+ private readonly rollupContract;
12
+ private readonly publicClient;
13
+ private readonly dateProvider;
14
+ private cachedState;
15
+ private cachedL1BlockNumber;
16
+ private readonly slotDuration;
17
+ private readonly l1GenesisTime;
18
+ private readonly ethereumSlotDuration;
19
+ constructor(rollupContract: RollupContract, publicClient: {
20
+ getBlockNumber: (opts?: {
21
+ cacheTime?: number;
22
+ }) => Promise<bigint>;
23
+ }, dateProvider: DateProvider, config: {
24
+ slotDuration: number;
25
+ l1GenesisTime: bigint;
26
+ ethereumSlotDuration: number;
27
+ });
28
+ /** Returns predicted min fees for each slot in the prediction window. */
29
+ getPredictedMinFees(manaUsage: ManaUsageEstimate): Promise<GasFees[]>;
30
+ private getState;
31
+ private fetchState;
32
+ /** Computes per-slot fee predictions given cached state and a mana usage assumption. */
33
+ private computePredictions;
34
+ private getAssumedManaUsed;
35
+ private computeGasFees;
36
+ }
37
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVlX3ByZWRpY3Rvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2dsb2JhbF92YXJpYWJsZV9idWlsZGVyL2ZlZV9wcmVkaWN0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFvRCxLQUFLLGNBQWMsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBR2xILE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRTVELE9BQU8sRUFFTCxPQUFPLEVBRVAsaUJBQWlCLEVBR2xCLE1BQU0sbUJBQW1CLENBQUM7QUFlM0I7Ozs7O0dBS0c7QUFDSCxxQkFBYSxZQUFZO0lBU3JCLE9BQU8sQ0FBQyxRQUFRLENBQUMsY0FBYztJQUMvQixPQUFPLENBQUMsUUFBUSxDQUFDLFlBQVk7SUFDN0IsT0FBTyxDQUFDLFFBQVEsQ0FBQyxZQUFZO0lBVi9CLE9BQU8sQ0FBQyxXQUFXLENBQXNDO0lBQ3pELE9BQU8sQ0FBQyxtQkFBbUIsQ0FBcUI7SUFFaEQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQVM7SUFDdEMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQVM7SUFDdkMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxvQkFBb0IsQ0FBUztJQUU5QyxZQUNtQixjQUFjLEVBQUUsY0FBYyxFQUM5QixZQUFZLEVBQUU7UUFBRSxjQUFjLEVBQUUsQ0FBQyxJQUFJLENBQUMsRUFBRTtZQUFFLFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtTQUFFLEtBQUssT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFBO0tBQUUsRUFDcEYsWUFBWSxFQUFFLFlBQVksRUFDM0MsTUFBTSxFQUFFO1FBQUUsWUFBWSxFQUFFLE1BQU0sQ0FBQztRQUFDLGFBQWEsRUFBRSxNQUFNLENBQUM7UUFBQyxvQkFBb0IsRUFBRSxNQUFNLENBQUE7S0FBRSxFQUt0RjtJQUVELHlFQUF5RTtJQUNuRSxtQkFBbUIsQ0FBQyxTQUFTLEVBQUUsaUJBQWlCLEdBQUcsT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBRzFFO1lBR2EsUUFBUTtZQW1CUixVQUFVO0lBaUR4Qix3RkFBd0Y7SUFDeEYsT0FBTyxDQUFDLGtCQUFrQjtJQXVCMUIsT0FBTyxDQUFDLGtCQUFrQjtJQVcxQixPQUFPLENBQUMsY0FBYztDQW1CdkIifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fee_predictor.d.ts","sourceRoot":"","sources":["../../src/global_variable_builder/fee_predictor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAEL,OAAO,EAEP,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC;AAe3B;;;;;GAKG;AACH,qBAAa,YAAY;IASrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAV/B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAE9C,YACmB,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE;QAAE,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,EACpF,YAAY,EAAE,YAAY,EAC3C,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,EAKtF;IAED,yEAAyE;IACnE,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAG1E;YAGa,QAAQ;YAmBR,UAAU;IAiDxB,wFAAwF;IACxF,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;CAmBvB"}