@aztec/sequencer-client 0.0.1-commit.a072138 → 0.0.1-commit.a5db02d

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 +32 -6
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +94 -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 +58 -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 +1 -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 +34 -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 +2 -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 +107 -67
  47. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher.js +539 -378
  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 +690 -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 +81 -19
  62. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  63. package/dest/sequencer/checkpoint_proposal_job.js +891 -282
  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/errors.d.ts +1 -8
  71. package/dest/sequencer/errors.d.ts.map +1 -1
  72. package/dest/sequencer/errors.js +0 -9
  73. package/dest/sequencer/events.d.ts +62 -5
  74. package/dest/sequencer/events.d.ts.map +1 -1
  75. package/dest/sequencer/metrics.d.ts +23 -8
  76. package/dest/sequencer/metrics.d.ts.map +1 -1
  77. package/dest/sequencer/metrics.js +117 -21
  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 +181 -44
  82. package/dest/sequencer/sequencer.d.ts.map +1 -1
  83. package/dest/sequencer/sequencer.js +614 -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 +11 -11
  89. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  90. package/dest/test/mock_checkpoint_builder.js +45 -34
  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 +28 -28
  95. package/src/client/sequencer-client.ts +110 -47
  96. package/src/config.ts +120 -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 +57 -0
  107. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -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 +628 -469
  112. package/src/publisher/write_json.ts +78 -0
  113. package/src/sequencer/automine/README.md +60 -0
  114. package/src/sequencer/automine/automine_factory.ts +152 -0
  115. package/src/sequencer/automine/automine_sequencer.ts +796 -0
  116. package/src/sequencer/automine/index.ts +6 -0
  117. package/src/sequencer/checkpoint_proposal_job.ts +1083 -305
  118. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  119. package/src/sequencer/checkpoint_voter.ts +1 -12
  120. package/src/sequencer/errors.ts +0 -15
  121. package/src/sequencer/events.ts +66 -5
  122. package/src/sequencer/metrics.ts +132 -25
  123. package/src/sequencer/requests_tracker.ts +43 -0
  124. package/src/sequencer/sequencer.ts +728 -241
  125. package/src/sequencer/types.ts +1 -1
  126. package/src/test/index.ts +4 -6
  127. package/src/test/mock_checkpoint_builder.ts +63 -49
  128. package/src/test/utils.ts +64 -10
  129. package/dest/sequencer/timetable.d.ts +0 -90
  130. package/dest/sequencer/timetable.d.ts.map +0 -1
  131. package/dest/sequencer/timetable.js +0 -226
  132. package/src/sequencer/README.md +0 -531
  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,51 @@ 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
+ shuffleAttestationOrdering: false;
40
+ skipPushProposedBlocksToArchiver: false;
41
+ skipPublishingCheckpointsPercent: number;
42
+ maxBlocksPerCheckpoint: number;
43
+ };
18
44
  /**
19
45
  * Configuration settings for the SequencerClient.
20
46
  */
21
- 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'>;
22
48
  export declare const sequencerConfigMappings: ConfigMappingsType<SequencerConfig>;
23
49
  export declare const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig>;
24
50
  /**
25
51
  * Creates an instance of SequencerClientConfig out of environment variables using sensible defaults for integration testing if not set.
26
52
  */
27
53
  export declare function getConfigEnvVars(): SequencerClientConfig;
28
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBQzNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFLeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sNkJBQTZCLENBQUM7QUFDMUYsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFxQixNQUFNLG1CQUFtQixDQUFDO0FBRXRFLE9BQU8sRUFBRSxLQUFLLFdBQVcsRUFBRSxLQUFLLGVBQWUsRUFBdUIsTUFBTSxzQkFBc0IsQ0FBQztBQUNuRyxPQUFPLEtBQUssRUFBRSx1QkFBdUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQy9FLE9BQU8sRUFBRSxLQUFLLHFCQUFxQixFQUFpQyxNQUFNLGdDQUFnQyxDQUFDO0FBRTNHLE9BQU8sRUFDTCxLQUFLLGVBQWUsRUFDcEIsS0FBSyxjQUFjLEVBR3BCLE1BQU0sdUJBQXVCLENBQUM7QUFFL0IsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxZQUFZLEVBQUUsZUFBZSxFQUFFLENBQUM7QUFFaEMsZUFBTyxNQUFNLG9DQUFvQyxJQUFJLENBQUM7QUFFdEQ7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHNCQUFzQixFQUFFLHVCQW9CcEMsQ0FBQztBQUVGOztHQUVHO0FBQ0gsTUFBTSxNQUFNLHFCQUFxQixHQUFHLGVBQWUsR0FDakQsY0FBYyxHQUNkLHFCQUFxQixHQUNyQixjQUFjLEdBQ2QsZUFBZSxHQUNmLGNBQWMsR0FDZCxXQUFXLEdBQ1gsSUFBSSxDQUFDLFNBQVMsRUFBRSx3QkFBd0IsQ0FBQyxHQUN6QyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsc0JBQXNCLEdBQUcsbUJBQW1CLEdBQUcsb0JBQW9CLENBQUMsQ0FBQztBQUUvRixlQUFPLE1BQU0sdUJBQXVCLEVBQUUsa0JBQWtCLENBQUMsZUFBZSxDQThJdkUsQ0FBQztBQUVGLGVBQU8sTUFBTSw2QkFBNkIsRUFBRSxrQkFBa0IsQ0FBQyxxQkFBcUIsQ0FTbkYsQ0FBQztBQUVGOztHQUVHO0FBQ0gsd0JBQWdCLGdCQUFnQixJQUFJLHFCQUFxQixDQUV4RCJ9
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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,38 +1,47 @@
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,
34
41
  shuffleAttestationOrdering: false,
35
- skipPushProposedBlocksToArchiver: false
42
+ skipPushProposedBlocksToArchiver: false,
43
+ skipPublishingCheckpointsPercent: 0,
44
+ maxBlocksPerCheckpoint: DEFAULT_MAX_BLOCKS_PER_CHECKPOINT
36
45
  };
37
46
  export const sequencerConfigMappings = {
38
47
  sequencerPollingIntervalMS: {
@@ -40,10 +49,10 @@ export const sequencerConfigMappings = {
40
49
  description: 'The number of ms to wait between polling for checking to build on the next slot.',
41
50
  ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS)
42
51
  },
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)
52
+ maxTxsPerCheckpoint: {
53
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
54
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
55
+ ...optionalNumberConfigHelper()
47
56
  },
48
57
  minTxsPerBlock: {
49
58
  env: 'SEQ_MIN_TX_PER_BLOCK',
@@ -61,21 +70,36 @@ export const sequencerConfigMappings = {
61
70
  maxL2BlockGas: {
62
71
  env: 'SEQ_MAX_L2_BLOCK_GAS',
63
72
  description: 'The maximum L2 block gas.',
64
- ...numberConfigHelper(DefaultSequencerConfig.maxL2BlockGas)
73
+ ...optionalNumberConfigHelper()
65
74
  },
66
75
  maxDABlockGas: {
67
76
  env: 'SEQ_MAX_DA_BLOCK_GAS',
68
77
  description: 'The maximum DA block gas.',
69
- ...numberConfigHelper(DefaultSequencerConfig.maxDABlockGas)
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)
70
94
  },
71
95
  coinbase: {
72
96
  env: 'COINBASE',
73
- parseEnv: (val)=>val ? EthAddress.fromString(val) : undefined,
97
+ parseEnv: (val)=>EthAddress.fromString(val),
74
98
  description: 'Recipient of block reward.'
75
99
  },
76
100
  feeRecipient: {
77
101
  env: 'FEE_RECIPIENT',
78
- parseEnv: (val)=>AztecAddress.fromString(val),
102
+ parseEnv: (val)=>AztecAddress.fromStringUnsafe(val),
79
103
  description: 'Address to receive fees.'
80
104
  },
81
105
  acvmWorkingDirectory: {
@@ -86,16 +110,6 @@ export const sequencerConfigMappings = {
86
110
  env: 'ACVM_BINARY_PATH',
87
111
  description: 'The path to the ACVM binary'
88
112
  },
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
113
  governanceProposerPayload: {
100
114
  env: 'GOVERNANCE_PROPOSER_PAYLOAD_ADDRESS',
101
115
  description: 'The address of the payload for the governanceProposer',
@@ -103,13 +117,8 @@ export const sequencerConfigMappings = {
103
117
  },
104
118
  l1PublishingTime: {
105
119
  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)
120
+ description: 'How much time in seconds to allow in the slot for publishing the L1 transaction.',
121
+ ...numberConfigHelper(DefaultSequencerConfig.l1PublishingTime)
113
122
  },
114
123
  fakeProcessingDelayPerTxMs: {
115
124
  description: 'Used for testing to introduce a fake delay after processing each tx'
@@ -135,14 +144,38 @@ export const sequencerConfigMappings = {
135
144
  description: 'Do not invalidate the previous block if invalid when we are the proposer (for testing only)',
136
145
  ...booleanConfigHelper(DefaultSequencerConfig.skipInvalidateBlockAsProposer)
137
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)
150
+ },
138
151
  broadcastInvalidBlockProposal: {
139
152
  description: 'Broadcast invalid block proposals with corrupted state (for testing only)',
140
153
  ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidBlockProposal)
141
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)
162
+ },
142
163
  injectFakeAttestation: {
143
164
  description: 'Inject a fake attestation (for testing only)',
144
165
  ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation)
145
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)
178
+ },
146
179
  fishermanMode: {
147
180
  env: 'FISHERMAN_MODE',
148
181
  description: 'Whether to run in fisherman mode: builds blocks on every slot for validation without publishing to L1',
@@ -152,32 +185,47 @@ export const sequencerConfigMappings = {
152
185
  description: 'Shuffle attestation ordering to create invalid ordering (for testing only)',
153
186
  ...booleanConfigHelper(DefaultSequencerConfig.shuffleAttestationOrdering)
154
187
  },
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
- },
188
+ ...sharedSequencerConfigMappings,
160
189
  buildCheckpointIfEmpty: {
161
190
  env: 'SEQ_BUILD_CHECKPOINT_IF_EMPTY',
162
191
  description: 'Have sequencer build and publish an empty checkpoint if there are no txs',
163
192
  ...booleanConfigHelper(DefaultSequencerConfig.buildCheckpointIfEmpty)
164
193
  },
165
194
  skipPushProposedBlocksToArchiver: {
166
- description: 'Skip pushing proposed blocks to archiver (default: true)',
195
+ description: 'Skip pushing proposed blocks to archiver (test only)',
167
196
  ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver)
168
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)',
212
+ ...booleanConfigHelper(false)
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
+ },
169
217
  ...pickConfigMappings(p2pConfigMappings, [
170
- 'txPublicSetupAllowList'
218
+ 'txPublicSetupAllowListExtend'
171
219
  ])
172
220
  };
173
221
  export const sequencerClientConfigMappings = {
222
+ ...chainConfigMappings,
174
223
  ...validatorClientConfigMappings,
175
224
  ...sequencerConfigMappings,
176
225
  ...keyStoreConfigMappings,
177
226
  ...l1ReaderConfigMappings,
178
- ...getTxSenderConfigMappings('SEQ'),
179
- ...getPublisherConfigMappings('SEQ'),
180
- ...chainConfigMappings,
227
+ ...sequencerTxSenderConfigMappings,
228
+ ...sequencerPublisherConfigMappings,
181
229
  ...pickConfigMappings(l1ContractsConfigMappings, [
182
230
  'ethereumSlotDuration',
183
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"}