@aztec/sequencer-client 0.0.1-commit.c31f2472 → 0.0.1-commit.c52d6e7

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 (133) hide show
  1. package/README.md +281 -21
  2. package/dest/client/sequencer-client.d.ts +34 -11
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +77 -39
  5. package/dest/config.d.ts +33 -6
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +100 -46
  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 +13 -28
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +9 -66
  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/publisher/config.d.ts +51 -17
  21. package/dest/publisher/config.d.ts.map +1 -1
  22. package/dest/publisher/config.js +131 -42
  23. package/dest/publisher/index.d.ts +2 -1
  24. package/dest/publisher/index.d.ts.map +1 -1
  25. package/dest/publisher/l1_to_l2_messaging.d.ts +21 -0
  26. package/dest/publisher/l1_to_l2_messaging.d.ts.map +1 -0
  27. package/dest/publisher/l1_to_l2_messaging.js +70 -0
  28. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  29. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  30. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  31. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +98 -0
  32. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  33. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +68 -0
  34. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  35. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  36. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +36 -0
  37. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  38. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  39. package/dest/publisher/l1_tx_failed_store/index.js +3 -0
  40. package/dest/publisher/sequencer-bundle-simulator.d.ts +96 -0
  41. package/dest/publisher/sequencer-bundle-simulator.d.ts.map +1 -0
  42. package/dest/publisher/sequencer-bundle-simulator.js +198 -0
  43. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -5
  44. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  45. package/dest/publisher/sequencer-publisher-factory.js +27 -3
  46. package/dest/publisher/sequencer-publisher.d.ts +123 -68
  47. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher.js +775 -364
  49. package/dest/publisher/write_json.d.ts +11 -0
  50. package/dest/publisher/write_json.d.ts.map +1 -0
  51. package/dest/publisher/write_json.js +57 -0
  52. package/dest/sequencer/automine/automine_factory.d.ts +56 -0
  53. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  54. package/dest/sequencer/automine/automine_factory.js +85 -0
  55. package/dest/sequencer/automine/automine_sequencer.d.ts +189 -0
  56. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  57. package/dest/sequencer/automine/automine_sequencer.js +696 -0
  58. package/dest/sequencer/automine/index.d.ts +3 -0
  59. package/dest/sequencer/automine/index.d.ts.map +1 -0
  60. package/dest/sequencer/automine/index.js +2 -0
  61. package/dest/sequencer/checkpoint_proposal_job.d.ts +99 -20
  62. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  63. package/dest/sequencer/checkpoint_proposal_job.js +926 -286
  64. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  65. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  66. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  67. package/dest/sequencer/checkpoint_voter.d.ts +1 -2
  68. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -1
  69. package/dest/sequencer/checkpoint_voter.js +2 -5
  70. package/dest/sequencer/events.d.ts +62 -5
  71. package/dest/sequencer/events.d.ts.map +1 -1
  72. package/dest/sequencer/metrics.d.ts +23 -8
  73. package/dest/sequencer/metrics.d.ts.map +1 -1
  74. package/dest/sequencer/metrics.js +117 -21
  75. package/dest/sequencer/missing_committee.d.ts +72 -0
  76. package/dest/sequencer/missing_committee.d.ts.map +1 -0
  77. package/dest/sequencer/missing_committee.js +139 -0
  78. package/dest/sequencer/requests_tracker.d.ts +22 -0
  79. package/dest/sequencer/requests_tracker.d.ts.map +1 -0
  80. package/dest/sequencer/requests_tracker.js +33 -0
  81. package/dest/sequencer/sequencer.d.ts +182 -44
  82. package/dest/sequencer/sequencer.d.ts.map +1 -1
  83. package/dest/sequencer/sequencer.js +623 -216
  84. package/dest/sequencer/types.d.ts +2 -2
  85. package/dest/sequencer/types.d.ts.map +1 -1
  86. package/dest/test/index.d.ts +5 -7
  87. package/dest/test/index.d.ts.map +1 -1
  88. package/dest/test/mock_checkpoint_builder.d.ts +12 -12
  89. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  90. package/dest/test/mock_checkpoint_builder.js +45 -36
  91. package/dest/test/utils.d.ts +17 -3
  92. package/dest/test/utils.d.ts.map +1 -1
  93. package/dest/test/utils.js +28 -9
  94. package/package.json +29 -29
  95. package/src/client/sequencer-client.ts +110 -47
  96. package/src/config.ts +127 -55
  97. package/src/global_variable_builder/README.md +44 -0
  98. package/src/global_variable_builder/fee_predictor.ts +182 -0
  99. package/src/global_variable_builder/fee_provider.ts +97 -0
  100. package/src/global_variable_builder/global_builder.ts +20 -89
  101. package/src/global_variable_builder/index.ts +3 -1
  102. package/src/publisher/config.ts +173 -40
  103. package/src/publisher/index.ts +3 -0
  104. package/src/publisher/l1_to_l2_messaging.ts +85 -0
  105. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  106. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +164 -0
  107. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +47 -0
  108. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  109. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  110. package/src/publisher/sequencer-publisher-factory.ts +38 -9
  111. package/src/publisher/sequencer-publisher.ts +885 -461
  112. package/src/publisher/write_json.ts +78 -0
  113. package/src/sequencer/README.md +162 -450
  114. package/src/sequencer/automine/README.md +60 -0
  115. package/src/sequencer/automine/automine_factory.ts +152 -0
  116. package/src/sequencer/automine/automine_sequencer.ts +800 -0
  117. package/src/sequencer/automine/index.ts +6 -0
  118. package/src/sequencer/checkpoint_proposal_job.ts +1131 -325
  119. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  120. package/src/sequencer/checkpoint_voter.ts +1 -12
  121. package/src/sequencer/events.ts +66 -5
  122. package/src/sequencer/metrics.ts +132 -25
  123. package/src/sequencer/missing_committee.ts +192 -0
  124. package/src/sequencer/requests_tracker.ts +43 -0
  125. package/src/sequencer/sequencer.ts +737 -241
  126. package/src/sequencer/types.ts +1 -1
  127. package/src/test/index.ts +4 -6
  128. package/src/test/mock_checkpoint_builder.ts +65 -53
  129. package/src/test/utils.ts +64 -10
  130. package/dest/sequencer/timetable.d.ts +0 -90
  131. package/dest/sequencer/timetable.d.ts.map +0 -1
  132. package/dest/sequencer/timetable.js +0 -226
  133. package/src/sequencer/timetable.ts +0 -282
@@ -1,14 +1,12 @@
1
+ import { MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT } from '@aztec/constants';
1
2
  import { EpochCache } from '@aztec/epoch-cache';
2
- import { isAnvilTestChain } from '@aztec/ethereum/chain';
3
3
  import { getPublicClient } from '@aztec/ethereum/client';
4
4
  import { GovernanceProposerContract, RollupContract } from '@aztec/ethereum/contracts';
5
5
  import { PublisherManager } from '@aztec/ethereum/publisher-manager';
6
- import { EthAddress } from '@aztec/foundation/eth-address';
7
6
  import { createLogger } from '@aztec/foundation/log';
8
- import { SlashFactoryContract } from '@aztec/stdlib/l1-contracts';
9
7
  import { L1Metrics } from '@aztec/telemetry-client';
10
8
  import { NodeKeystoreAdapter } from '@aztec/validator-client';
11
- import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
9
+ import { getPublisherConfigFromSequencerConfig } from '../config.js';
12
10
  import { SequencerPublisherFactory } from '../publisher/sequencer-publisher-factory.js';
13
11
  import { Sequencer } from '../sequencer/index.js';
14
12
  /**
@@ -19,12 +17,14 @@ import { Sequencer } from '../sequencer/index.js';
19
17
  checkpointsBuilder;
20
18
  validatorClient;
21
19
  l1Metrics;
22
- constructor(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics){
20
+ delayer_;
21
+ constructor(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer_){
23
22
  this.publisherManager = publisherManager;
24
23
  this.sequencer = sequencer;
25
24
  this.checkpointsBuilder = checkpointsBuilder;
26
25
  this.validatorClient = validatorClient;
27
26
  this.l1Metrics = l1Metrics;
27
+ this.delayer_ = delayer_;
28
28
  }
29
29
  /**
30
30
  * Initializes a new instance.
@@ -44,16 +44,18 @@ import { Sequencer } from '../sequencer/index.js';
44
44
  const publicClient = getPublicClient(config);
45
45
  const l1TxUtils = deps.l1TxUtils;
46
46
  const l1Metrics = new L1Metrics(telemetryClient.getMeter('L1PublisherMetrics'), publicClient, l1TxUtils.map((x)=>x.getSenderAddress()));
47
- const publisherManager = new PublisherManager(l1TxUtils, config, log.getBindings());
48
- const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
49
- const [l1GenesisTime, slotDuration, rollupVersion, rollupManaLimit] = 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([
50
53
  rollupContract.getL1GenesisTime(),
51
54
  rollupContract.getSlotDuration(),
52
- rollupContract.getVersion(),
53
55
  rollupContract.getManaLimit().then(Number)
54
56
  ]);
55
- const governanceProposerContract = new GovernanceProposerContract(publicClient, config.l1Contracts.governanceProposerAddress.toString());
56
- 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, {
57
59
  l1RpcUrls: rpcUrls,
58
60
  l1ChainId: chainId,
59
61
  viemPollingIntervalMS: config.viemPollingIntervalMS,
@@ -61,13 +63,11 @@ import { Sequencer } from '../sequencer/index.js';
61
63
  }, {
62
64
  dateProvider: deps.dateProvider
63
65
  });
64
- const slashFactoryContract = new SlashFactoryContract(publicClient, config.l1Contracts.slashFactoryAddress?.toString() ?? EthAddress.ZERO.toString());
65
66
  const publisherFactory = deps.publisherFactory ?? new SequencerPublisherFactory(config, {
66
67
  telemetry: telemetryClient,
67
68
  blobClient: deps.blobClient,
68
69
  epochCache,
69
70
  governanceProposerContract,
70
- slashFactoryContract,
71
71
  rollupContract,
72
72
  dateProvider: deps.dateProvider,
73
73
  publisherManager,
@@ -75,35 +75,25 @@ import { Sequencer } from '../sequencer/index.js';
75
75
  logger: log
76
76
  });
77
77
  const ethereumSlotDuration = config.ethereumSlotDuration;
78
+ const globalsBuilder = deps.globalVariableBuilder;
79
+ const { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock } = capPerBlockLimits(config, rollupManaLimit, log);
78
80
  const l1Constants = {
79
81
  l1GenesisTime,
80
82
  slotDuration: Number(slotDuration),
81
- ethereumSlotDuration
83
+ ethereumSlotDuration,
84
+ rollupManaLimit,
85
+ epochDuration: config.aztecEpochDuration
82
86
  };
83
- const globalsBuilder = new GlobalVariableBuilder({
84
- ...config,
85
- ...l1Constants,
86
- rollupVersion
87
- });
88
- let sequencerManaLimit = config.maxL2BlockGas ?? rollupManaLimit;
89
- if (sequencerManaLimit > rollupManaLimit) {
90
- log.warn(`Provided maxL2BlockGas ${sequencerManaLimit} is greater than the max allowed by L1. Setting limit to ${rollupManaLimit}.`);
91
- sequencerManaLimit = rollupManaLimit;
92
- }
93
- // When running in anvil, assume we can post a tx up until one second before the end of an L1 slot.
94
- // Otherwise, we need the full L1 slot duration for publishing to ensure inclusion.
95
- // In theory, the L1 slot has an initial 4s phase where the block is propagated, so we could
96
- // reduce the publishing time allowance. However, we prefer being conservative.
97
- // See https://www.blocknative.com/blog/anatomy-of-a-slot#7 for more info.
98
- const l1PublishingTimeBasedOnChain = isAnvilTestChain(config.l1ChainId) ? 1 : ethereumSlotDuration;
99
- const l1PublishingTime = config.l1PublishingTime ?? l1PublishingTimeBasedOnChain;
100
87
  const sequencer = new Sequencer(publisherFactory, validatorClient, globalsBuilder, p2pClient, worldStateSynchronizer, slasherClient, l2BlockSource, l1ToL2MessageSource, checkpointsBuilder, l1Constants, deps.dateProvider, epochCache, rollupContract, {
101
88
  ...config,
102
- l1PublishingTime,
103
- maxL2BlockGas: sequencerManaLimit
89
+ maxL2BlockGas,
90
+ maxDABlockGas,
91
+ maxTxsPerBlock
104
92
  }, telemetryClient, log);
105
- await sequencer.init();
106
- return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, 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);
107
97
  }
108
98
  /**
109
99
  * Updates sequencer and validator client config.
@@ -113,23 +103,46 @@ import { Sequencer } from '../sequencer/index.js';
113
103
  this.checkpointsBuilder.updateConfig(config);
114
104
  this.validatorClient?.updateConfig(config);
115
105
  }
116
- /** 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() {
117
112
  await this.validatorClient?.start();
113
+ await this.publisherManager.start();
118
114
  this.sequencer.start();
119
115
  this.l1Metrics?.start();
120
- await this.publisherManager.loadState();
121
116
  }
122
117
  /**
123
- * 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.
124
121
  */ async stop() {
125
122
  await this.sequencer.stop();
126
123
  await this.validatorClient?.stop();
127
- this.publisherManager.interrupt();
124
+ await this.publisherManager.stop();
128
125
  this.l1Metrics?.stop();
129
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
+ }
130
137
  getSequencer() {
131
138
  return this.sequencer;
132
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
+ }
133
146
  get validatorAddresses() {
134
147
  return this.sequencer.getValidatorAddresses();
135
148
  }
@@ -137,3 +150,28 @@ import { Sequencer } from '../sequencer/index.js';
137
150
  return this.sequencer.maxL2BlockGas;
138
151
  }
139
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
@@ -4,25 +4,52 @@ import { type ConfigMappingsType } from '@aztec/foundation/config';
4
4
  import { type KeyStoreConfig } from '@aztec/node-keystore/config';
5
5
  import { type P2PConfig } from '@aztec/p2p/config';
6
6
  import { type ChainConfig, type SequencerConfig } from '@aztec/stdlib/config';
7
- import type { ResolvedSequencerConfig } from '@aztec/stdlib/interfaces/server';
8
7
  import { type ValidatorClientConfig } from '@aztec/validator-client/config';
9
- import { type PublisherConfig, type TxSenderConfig } from './publisher/config.js';
8
+ import { type SequencerPublisherConfig, type SequencerTxSenderConfig } from './publisher/config.js';
10
9
  export * from './publisher/config.js';
11
10
  export type { SequencerConfig };
12
- export declare const DEFAULT_ATTESTATION_PROPAGATION_TIME = 2;
13
11
  /**
14
12
  * Default values for SequencerConfig.
15
13
  * Centralized location for all sequencer configuration defaults.
16
14
  */
17
- export declare const DefaultSequencerConfig: ResolvedSequencerConfig;
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
+ governanceProposerForcePayloadVote: false;
40
+ shuffleAttestationOrdering: false;
41
+ skipPushProposedBlocksToArchiver: false;
42
+ skipPublishingCheckpointsPercent: number;
43
+ maxBlocksPerCheckpoint: number;
44
+ };
18
45
  /**
19
46
  * Configuration settings for the SequencerClient.
20
47
  */
21
- export type SequencerClientConfig = PublisherConfig & KeyStoreConfig & ValidatorClientConfig & TxSenderConfig & SequencerConfig & L1ReaderConfig & ChainConfig & Pick<P2PConfig, 'txPublicSetupAllowList'> & Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
48
+ export type SequencerClientConfig = SequencerPublisherConfig & KeyStoreConfig & ValidatorClientConfig & SequencerTxSenderConfig & SequencerConfig & L1ReaderConfig & ChainConfig & Pick<P2PConfig, 'txPublicSetupAllowListExtend'> & Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
22
49
  export declare const sequencerConfigMappings: ConfigMappingsType<SequencerConfig>;
23
50
  export declare const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig>;
24
51
  /**
25
52
  * Creates an instance of SequencerClientConfig out of environment variables using sensible defaults for integration testing if not set.
26
53
  */
27
54
  export declare function getConfigEnvVars(): SequencerClientConfig;
28
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBQzNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFLeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sNkJBQTZCLENBQUM7QUFDMUYsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFxQixNQUFNLG1CQUFtQixDQUFDO0FBRXRFLE9BQU8sRUFBRSxLQUFLLFdBQVcsRUFBRSxLQUFLLGVBQWUsRUFBdUIsTUFBTSxzQkFBc0IsQ0FBQztBQUNuRyxPQUFPLEtBQUssRUFBRSx1QkFBdUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQy9FLE9BQU8sRUFBRSxLQUFLLHFCQUFxQixFQUFpQyxNQUFNLGdDQUFnQyxDQUFDO0FBRTNHLE9BQU8sRUFDTCxLQUFLLGVBQWUsRUFDcEIsS0FBSyxjQUFjLEVBR3BCLE1BQU0sdUJBQXVCLENBQUM7QUFFL0IsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxZQUFZLEVBQUUsZUFBZSxFQUFFLENBQUM7QUFFaEMsZUFBTyxNQUFNLG9DQUFvQyxJQUFJLENBQUM7QUFFdEQ7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHNCQUFzQixFQUFFLHVCQW9CcEMsQ0FBQztBQUVGOztHQUVHO0FBQ0gsTUFBTSxNQUFNLHFCQUFxQixHQUFHLGVBQWUsR0FDakQsY0FBYyxHQUNkLHFCQUFxQixHQUNyQixjQUFjLEdBQ2QsZUFBZSxHQUNmLGNBQWMsR0FDZCxXQUFXLEdBQ1gsSUFBSSxDQUFDLFNBQVMsRUFBRSx3QkFBd0IsQ0FBQyxHQUN6QyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsc0JBQXNCLEdBQUcsbUJBQW1CLEdBQUcsb0JBQW9CLENBQUMsQ0FBQztBQUUvRixlQUFPLE1BQU0sdUJBQXVCLEVBQUUsa0JBQWtCLENBQUMsZUFBZSxDQThJdkUsQ0FBQztBQUVGLGVBQU8sTUFBTSw2QkFBNkIsRUFBRSxrQkFBa0IsQ0FBQyxxQkFBcUIsQ0FTbkYsQ0FBQztBQUVGOztHQUVHO0FBQ0gsd0JBQWdCLGdCQUFnQixJQUFJLHFCQUFxQixDQUV4RCJ9
55
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBQzNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFPeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sNkJBQTZCLENBQUM7QUFDMUYsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFxQixNQUFNLG1CQUFtQixDQUFDO0FBRXRFLE9BQU8sRUFDTCxLQUFLLFdBQVcsRUFHaEIsS0FBSyxlQUFlLEVBR3JCLE1BQU0sc0JBQXNCLENBQUM7QUFJOUIsT0FBTyxFQUFFLEtBQUsscUJBQXFCLEVBQWlDLE1BQU0sZ0NBQWdDLENBQUM7QUFFM0csT0FBTyxFQUNMLEtBQUssd0JBQXdCLEVBQzdCLEtBQUssdUJBQXVCLEVBRzdCLE1BQU0sdUJBQXVCLENBQUM7QUFFL0IsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxZQUFZLEVBQUUsZUFBZSxFQUFFLENBQUM7QUFFaEM7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHNCQUFzQjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Q0E2QkEsQ0FBQztBQUVwQzs7R0FFRztBQUNILE1BQU0sTUFBTSxxQkFBcUIsR0FBRyx3QkFBd0IsR0FDMUQsY0FBYyxHQUNkLHFCQUFxQixHQUNyQix1QkFBdUIsR0FDdkIsZUFBZSxHQUNmLGNBQWMsR0FDZCxXQUFXLEdBQ1gsSUFBSSxDQUFDLFNBQVMsRUFBRSw4QkFBOEIsQ0FBQyxHQUMvQyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsc0JBQXNCLEdBQUcsbUJBQW1CLEdBQUcsb0JBQW9CLENBQUMsQ0FBQztBQUUvRixlQUFPLE1BQU0sdUJBQXVCLEVBQUUsa0JBQWtCLENBQUMsZUFBZSxDQW9NdkUsQ0FBQztBQUVGLGVBQU8sTUFBTSw2QkFBNkIsRUFBRSxrQkFBa0IsQ0FBQyxxQkFBcUIsQ0FTbkYsQ0FBQztBQUVGOztHQUVHO0FBQ0gsd0JBQWdCLGdCQUFnQixJQUFJLHFCQUFxQixDQUV4RCJ9
@@ -1 +1 @@
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,EAKxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAuB,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,KAAK,qBAAqB,EAAiC,MAAM,gCAAgC,CAAC;AAE3G,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;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,uBAoBpC,CAAC;AAEF;;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,CA8IvE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BA,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,CAoMvE,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,38 +1,48 @@
1
1
  import { l1ContractsConfigMappings } from '@aztec/ethereum/config';
2
2
  import { l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
3
- import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper, pickConfigMappings } from '@aztec/foundation/config';
3
+ import { booleanConfigHelper, floatConfigHelper, getConfigFromMappings, numberConfigHelper, optionalNumberConfigHelper, pickConfigMappings } from '@aztec/foundation/config';
4
4
  import { EthAddress } from '@aztec/foundation/eth-address';
5
5
  import { keyStoreConfigMappings } from '@aztec/node-keystore/config';
6
6
  import { p2pConfigMappings } from '@aztec/p2p/config';
7
7
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
8
- import { chainConfigMappings } from '@aztec/stdlib/config';
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';
9
11
  import { validatorClientConfigMappings } from '@aztec/validator-client/config';
10
- import { getPublisherConfigMappings, getTxSenderConfigMappings } from './publisher/config.js';
12
+ import { sequencerPublisherConfigMappings, sequencerTxSenderConfigMappings } from './publisher/config.js';
11
13
  export * from './publisher/config.js';
12
- export const DEFAULT_ATTESTATION_PROPAGATION_TIME = 2;
13
14
  /**
14
15
  * Default values for SequencerConfig.
15
16
  * Centralized location for all sequencer configuration defaults.
16
17
  */ export const DefaultSequencerConfig = {
17
18
  sequencerPollingIntervalMS: 500,
18
- maxTxsPerBlock: 32,
19
19
  minTxsPerBlock: 1,
20
20
  buildCheckpointIfEmpty: false,
21
21
  publishTxsWithProposals: false,
22
- maxL2BlockGas: 10e9,
23
- maxDABlockGas: 10e9,
24
- maxBlockSizeInBytes: 1024 * 1024,
25
- enforceTimeTable: true,
26
- attestationPropagationTime: DEFAULT_ATTESTATION_PROPAGATION_TIME,
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,
27
29
  secondsBeforeInvalidatingBlockAsCommitteeMember: 144,
28
30
  secondsBeforeInvalidatingBlockAsNonCommitteeMember: 432,
29
31
  skipCollectingAttestations: false,
30
32
  skipInvalidateBlockAsProposer: false,
33
+ skipWaitForValidParentCheckpointOnL1: false,
31
34
  broadcastInvalidBlockProposal: false,
35
+ broadcastInvalidCheckpointProposalOnly: false,
32
36
  injectFakeAttestation: false,
37
+ injectHighSValueAttestation: false,
38
+ injectUnrecoverableSignatureAttestation: false,
39
+ injectYParityAttestation: false,
33
40
  fishermanMode: false,
41
+ governanceProposerForcePayloadVote: false,
34
42
  shuffleAttestationOrdering: false,
35
- skipPushProposedBlocksToArchiver: false
43
+ skipPushProposedBlocksToArchiver: false,
44
+ skipPublishingCheckpointsPercent: 0,
45
+ maxBlocksPerCheckpoint: DEFAULT_MAX_BLOCKS_PER_CHECKPOINT
36
46
  };
37
47
  export const sequencerConfigMappings = {
38
48
  sequencerPollingIntervalMS: {
@@ -40,10 +50,10 @@ export const sequencerConfigMappings = {
40
50
  description: 'The number of ms to wait between polling for checking to build on the next slot.',
41
51
  ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS)
42
52
  },
43
- maxTxsPerBlock: {
44
- env: 'SEQ_MAX_TX_PER_BLOCK',
45
- description: 'The maximum number of txs to include in a block.',
46
- ...numberConfigHelper(DefaultSequencerConfig.maxTxsPerBlock)
53
+ maxTxsPerCheckpoint: {
54
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
55
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
56
+ ...optionalNumberConfigHelper()
47
57
  },
48
58
  minTxsPerBlock: {
49
59
  env: 'SEQ_MIN_TX_PER_BLOCK',
@@ -61,21 +71,36 @@ export const sequencerConfigMappings = {
61
71
  maxL2BlockGas: {
62
72
  env: 'SEQ_MAX_L2_BLOCK_GAS',
63
73
  description: 'The maximum L2 block gas.',
64
- ...numberConfigHelper(DefaultSequencerConfig.maxL2BlockGas)
74
+ ...optionalNumberConfigHelper()
65
75
  },
66
76
  maxDABlockGas: {
67
77
  env: 'SEQ_MAX_DA_BLOCK_GAS',
68
78
  description: 'The maximum DA block gas.',
69
- ...numberConfigHelper(DefaultSequencerConfig.maxDABlockGas)
79
+ ...optionalNumberConfigHelper()
80
+ },
81
+ perBlockAllocationMultiplier: {
82
+ env: 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER',
83
+ 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.',
84
+ ...floatConfigHelper(DefaultSequencerConfig.perBlockAllocationMultiplier)
85
+ },
86
+ perBlockDAAllocationMultiplier: {
87
+ env: 'SEQ_PER_BLOCK_DA_ALLOCATION_MULTIPLIER',
88
+ 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.',
89
+ ...floatConfigHelper(DefaultSequencerConfig.perBlockDAAllocationMultiplier)
90
+ },
91
+ redistributeCheckpointBudget: {
92
+ env: 'SEQ_REDISTRIBUTE_CHECKPOINT_BUDGET',
93
+ description: 'Redistribute remaining checkpoint budget evenly across remaining blocks instead of allowing a single block to consume the entire remaining budget.',
94
+ ...booleanConfigHelper(DefaultSequencerConfig.redistributeCheckpointBudget)
70
95
  },
71
96
  coinbase: {
72
97
  env: 'COINBASE',
73
- parseEnv: (val)=>val ? EthAddress.fromString(val) : undefined,
98
+ parseEnv: (val)=>EthAddress.fromString(val),
74
99
  description: 'Recipient of block reward.'
75
100
  },
76
101
  feeRecipient: {
77
102
  env: 'FEE_RECIPIENT',
78
- parseEnv: (val)=>AztecAddress.fromString(val),
103
+ parseEnv: (val)=>AztecAddress.fromStringUnsafe(val),
79
104
  description: 'Address to receive fees.'
80
105
  },
81
106
  acvmWorkingDirectory: {
@@ -86,30 +111,20 @@ export const sequencerConfigMappings = {
86
111
  env: 'ACVM_BINARY_PATH',
87
112
  description: 'The path to the ACVM binary'
88
113
  },
89
- maxBlockSizeInBytes: {
90
- env: 'SEQ_MAX_BLOCK_SIZE_IN_BYTES',
91
- description: 'Max block size',
92
- ...numberConfigHelper(DefaultSequencerConfig.maxBlockSizeInBytes)
93
- },
94
- enforceTimeTable: {
95
- env: 'SEQ_ENFORCE_TIME_TABLE',
96
- description: 'Whether to enforce the time table when building blocks',
97
- ...booleanConfigHelper(DefaultSequencerConfig.enforceTimeTable)
98
- },
99
114
  governanceProposerPayload: {
100
115
  env: 'GOVERNANCE_PROPOSER_PAYLOAD_ADDRESS',
101
116
  description: 'The address of the payload for the governanceProposer',
102
117
  parseEnv: (val)=>EthAddress.fromString(val)
103
118
  },
119
+ governanceProposerForcePayloadVote: {
120
+ env: 'GOVERNANCE_PROPOSER_FORCE_PAYLOAD_VOTE',
121
+ description: 'Keep signalling the configured governance payload even if a proposal referencing it was already executed.',
122
+ ...booleanConfigHelper(DefaultSequencerConfig.governanceProposerForcePayloadVote)
123
+ },
104
124
  l1PublishingTime: {
105
125
  env: 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT',
106
- description: 'How much time (in seconds) we allow in the slot for publishing the L1 tx (defaults to 1 L1 slot).',
107
- parseEnv: (val)=>val ? parseInt(val, 10) : undefined
108
- },
109
- attestationPropagationTime: {
110
- env: 'SEQ_ATTESTATION_PROPAGATION_TIME',
111
- description: 'How many seconds it takes for proposals and attestations to travel across the p2p layer (one-way)',
112
- ...numberConfigHelper(DefaultSequencerConfig.attestationPropagationTime)
126
+ description: 'How much time in seconds to allow in the slot for publishing the L1 transaction.',
127
+ ...numberConfigHelper(DefaultSequencerConfig.l1PublishingTime)
113
128
  },
114
129
  fakeProcessingDelayPerTxMs: {
115
130
  description: 'Used for testing to introduce a fake delay after processing each tx'
@@ -135,14 +150,38 @@ export const sequencerConfigMappings = {
135
150
  description: 'Do not invalidate the previous block if invalid when we are the proposer (for testing only)',
136
151
  ...booleanConfigHelper(DefaultSequencerConfig.skipInvalidateBlockAsProposer)
137
152
  },
153
+ skipWaitForValidParentCheckpointOnL1: {
154
+ 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)',
155
+ ...booleanConfigHelper(DefaultSequencerConfig.skipWaitForValidParentCheckpointOnL1)
156
+ },
138
157
  broadcastInvalidBlockProposal: {
139
158
  description: 'Broadcast invalid block proposals with corrupted state (for testing only)',
140
159
  ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidBlockProposal)
141
160
  },
161
+ invalidBlockProposalIndexWithinCheckpoint: {
162
+ description: 'Broadcast an invalid block proposal only at this indexWithinCheckpoint (for testing only)',
163
+ ...optionalNumberConfigHelper()
164
+ },
165
+ broadcastInvalidCheckpointProposalOnly: {
166
+ description: 'Broadcast invalid checkpoint proposals while keeping the underlying block proposals valid (for testing only). When unset, the checkpoint follows broadcastInvalidBlockProposal.',
167
+ ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidCheckpointProposalOnly)
168
+ },
142
169
  injectFakeAttestation: {
143
170
  description: 'Inject a fake attestation (for testing only)',
144
171
  ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation)
145
172
  },
173
+ injectHighSValueAttestation: {
174
+ description: 'Inject a malleable attestation with a high-s value (for testing only)',
175
+ ...booleanConfigHelper(DefaultSequencerConfig.injectHighSValueAttestation)
176
+ },
177
+ injectUnrecoverableSignatureAttestation: {
178
+ description: 'Inject an attestation with an unrecoverable signature (for testing only)',
179
+ ...booleanConfigHelper(DefaultSequencerConfig.injectUnrecoverableSignatureAttestation)
180
+ },
181
+ injectYParityAttestation: {
182
+ description: 'Inject a non-proposer attestation slot in yParity form in the packed L1 tuple (for testing only)',
183
+ ...booleanConfigHelper(DefaultSequencerConfig.injectYParityAttestation)
184
+ },
146
185
  fishermanMode: {
147
186
  env: 'FISHERMAN_MODE',
148
187
  description: 'Whether to run in fisherman mode: builds blocks on every slot for validation without publishing to L1',
@@ -152,32 +191,47 @@ export const sequencerConfigMappings = {
152
191
  description: 'Shuffle attestation ordering to create invalid ordering (for testing only)',
153
192
  ...booleanConfigHelper(DefaultSequencerConfig.shuffleAttestationOrdering)
154
193
  },
155
- blockDurationMs: {
156
- env: 'SEQ_BLOCK_DURATION_MS',
157
- description: 'Duration per block in milliseconds when building multiple blocks per slot. ' + 'If undefined (default), builds a single block per slot using the full slot duration.',
158
- parseEnv: (val)=>val ? parseInt(val, 10) : undefined
159
- },
194
+ ...sharedSequencerConfigMappings,
160
195
  buildCheckpointIfEmpty: {
161
196
  env: 'SEQ_BUILD_CHECKPOINT_IF_EMPTY',
162
197
  description: 'Have sequencer build and publish an empty checkpoint if there are no txs',
163
198
  ...booleanConfigHelper(DefaultSequencerConfig.buildCheckpointIfEmpty)
164
199
  },
165
200
  skipPushProposedBlocksToArchiver: {
166
- description: 'Skip pushing proposed blocks to archiver (default: true)',
201
+ description: 'Skip pushing proposed blocks to archiver (test only)',
167
202
  ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver)
168
203
  },
204
+ minBlocksForCheckpoint: {
205
+ description: 'Minimum number of blocks required for a checkpoint proposal (test only)'
206
+ },
207
+ skipPublishingCheckpointsPercent: {
208
+ env: 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT',
209
+ description: 'Percent probability (0 - 100) of sequencer skipping checkpoint publishing (testing only)',
210
+ ...numberConfigHelper(DefaultSequencerConfig.skipPublishingCheckpointsPercent)
211
+ },
212
+ skipBroadcastProposals: {
213
+ description: 'Skip broadcasting checkpoint and block proposals via gossipsub when proposer (for testing only)',
214
+ ...booleanConfigHelper(false)
215
+ },
216
+ skipBroadcastCheckpointProposal: {
217
+ 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)',
218
+ ...booleanConfigHelper(false)
219
+ },
220
+ pauseProposingForSlots: {
221
+ description: 'List of slots for which the sequencer will not produce a proposal (for testing only). Attestation paths are unaffected.'
222
+ },
169
223
  ...pickConfigMappings(p2pConfigMappings, [
170
- 'txPublicSetupAllowList'
224
+ 'txPublicSetupAllowListExtend'
171
225
  ])
172
226
  };
173
227
  export const sequencerClientConfigMappings = {
228
+ ...chainConfigMappings,
174
229
  ...validatorClientConfigMappings,
175
230
  ...sequencerConfigMappings,
176
231
  ...keyStoreConfigMappings,
177
232
  ...l1ReaderConfigMappings,
178
- ...getTxSenderConfigMappings('SEQ'),
179
- ...getPublisherConfigMappings('SEQ'),
180
- ...chainConfigMappings,
233
+ ...sequencerTxSenderConfigMappings,
234
+ ...sequencerPublisherConfigMappings,
181
235
  ...pickConfigMappings(l1ContractsConfigMappings, [
182
236
  'ethereumSlotDuration',
183
237
  '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"}