@aztec/sequencer-client 0.0.1-commit.86469d5 → 0.0.1-commit.8655d4a

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 (125) hide show
  1. package/README.md +282 -21
  2. package/dest/client/sequencer-client.d.ts +19 -9
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +67 -33
  5. package/dest/config.d.ts +29 -7
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +77 -37
  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 +128 -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 +58 -0
  14. package/dest/global_variable_builder/global_builder.d.ts +14 -16
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +16 -50
  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 -2
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +1 -1
  23. package/dest/publisher/config.d.ts +47 -17
  24. package/dest/publisher/config.d.ts.map +1 -1
  25. package/dest/publisher/config.js +121 -42
  26. package/dest/publisher/index.d.ts +2 -1
  27. package/dest/publisher/index.d.ts.map +1 -1
  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 +94 -67
  47. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher.js +440 -378
  49. package/dest/sequencer/automine/automine_factory.d.ts +54 -0
  50. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  51. package/dest/sequencer/automine/automine_factory.js +84 -0
  52. package/dest/sequencer/automine/automine_sequencer.d.ts +151 -0
  53. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  54. package/dest/sequencer/automine/automine_sequencer.js +506 -0
  55. package/dest/sequencer/chain_state_overrides.d.ts +61 -0
  56. package/dest/sequencer/chain_state_overrides.d.ts.map +1 -0
  57. package/dest/sequencer/chain_state_overrides.js +98 -0
  58. package/dest/sequencer/checkpoint_proposal_job.d.ts +56 -11
  59. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  60. package/dest/sequencer/checkpoint_proposal_job.js +805 -225
  61. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  62. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  63. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  64. package/dest/sequencer/checkpoint_voter.d.ts +1 -2
  65. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -1
  66. package/dest/sequencer/checkpoint_voter.js +2 -5
  67. package/dest/sequencer/events.d.ts +47 -2
  68. package/dest/sequencer/events.d.ts.map +1 -1
  69. package/dest/sequencer/index.d.ts +3 -1
  70. package/dest/sequencer/index.d.ts.map +1 -1
  71. package/dest/sequencer/index.js +2 -0
  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/sequencer.d.ts +74 -21
  76. package/dest/sequencer/sequencer.d.ts.map +1 -1
  77. package/dest/sequencer/sequencer.js +353 -136
  78. package/dest/sequencer/timetable.d.ts +17 -6
  79. package/dest/sequencer/timetable.d.ts.map +1 -1
  80. package/dest/sequencer/timetable.js +51 -46
  81. package/dest/sequencer/types.d.ts +2 -2
  82. package/dest/sequencer/types.d.ts.map +1 -1
  83. package/dest/test/index.d.ts +3 -5
  84. package/dest/test/index.d.ts.map +1 -1
  85. package/dest/test/mock_checkpoint_builder.d.ts +11 -11
  86. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  87. package/dest/test/mock_checkpoint_builder.js +45 -34
  88. package/dest/test/utils.d.ts +3 -3
  89. package/dest/test/utils.d.ts.map +1 -1
  90. package/dest/test/utils.js +10 -8
  91. package/package.json +27 -28
  92. package/src/client/sequencer-client.ts +92 -35
  93. package/src/config.ts +102 -46
  94. package/src/global_variable_builder/README.md +44 -0
  95. package/src/global_variable_builder/fee_predictor.ts +172 -0
  96. package/src/global_variable_builder/fee_provider.ts +75 -0
  97. package/src/global_variable_builder/global_builder.ts +26 -63
  98. package/src/global_variable_builder/index.ts +3 -1
  99. package/src/index.ts +10 -1
  100. package/src/publisher/config.ts +157 -45
  101. package/src/publisher/index.ts +3 -0
  102. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  103. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +57 -0
  104. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  105. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  106. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  107. package/src/publisher/sequencer-publisher-factory.ts +38 -9
  108. package/src/publisher/sequencer-publisher.ts +533 -469
  109. package/src/sequencer/README.md +152 -450
  110. package/src/sequencer/automine/README.md +46 -0
  111. package/src/sequencer/automine/automine_factory.ts +145 -0
  112. package/src/sequencer/automine/automine_sequencer.ts +592 -0
  113. package/src/sequencer/chain_state_overrides.ts +162 -0
  114. package/src/sequencer/checkpoint_proposal_job.ts +984 -245
  115. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  116. package/src/sequencer/checkpoint_voter.ts +1 -12
  117. package/src/sequencer/events.ts +50 -2
  118. package/src/sequencer/index.ts +2 -0
  119. package/src/sequencer/metrics.ts +132 -25
  120. package/src/sequencer/sequencer.ts +444 -154
  121. package/src/sequencer/timetable.ts +70 -57
  122. package/src/sequencer/types.ts +1 -1
  123. package/src/test/index.ts +2 -4
  124. package/src/test/mock_checkpoint_builder.ts +63 -49
  125. package/src/test/utils.ts +31 -10
@@ -7,7 +7,7 @@ import { PublicDataWrite } from '@aztec/stdlib/avm';
7
7
  import { CommitteeAttestation, L2Block } from '@aztec/stdlib/block';
8
8
  import { BlockProposal, CheckpointAttestation, CheckpointProposal, ConsensusPayload } from '@aztec/stdlib/p2p';
9
9
  import { CheckpointHeader } from '@aztec/stdlib/rollup';
10
- import { makeAppendOnlyTreeSnapshot, mockTxForRollup } from '@aztec/stdlib/testing';
10
+ import { TEST_COORDINATION_SIGNATURE_CONTEXT, makeAppendOnlyTreeSnapshot, mockTxForRollup } from '@aztec/stdlib/testing';
11
11
  import { BlockHeader, makeProcessedTxFromPrivateOnlyTx } from '@aztec/stdlib/tx';
12
12
  // Re-export mock classes from their dedicated file
13
13
  export { MockCheckpointBuilder, MockCheckpointsBuilder } from './mock_checkpoint_builder.js';
@@ -36,6 +36,7 @@ export { MockCheckpointBuilder, MockCheckpointsBuilder } from './mock_checkpoint
36
36
  */ export function mockPendingTxs(p2p, txs) {
37
37
  p2p.getPendingTxCount.mockResolvedValue(txs.length);
38
38
  p2p.iteratePendingTxs.mockImplementation(()=>mockTxIterator(Promise.resolve(txs)));
39
+ p2p.iterateEligiblePendingTxs.mockImplementation(()=>mockTxIterator(Promise.resolve(txs)));
39
40
  }
40
41
  /**
41
42
  * Creates an async iterator for transactions
@@ -63,14 +64,14 @@ export { MockCheckpointBuilder, MockCheckpointsBuilder } from './mock_checkpoint
63
64
  * Creates a block proposal from a block and signature
64
65
  */ export function createBlockProposal(block, signature) {
65
66
  const txHashes = block.body.txEffects.map((tx)=>tx.txHash);
66
- return new BlockProposal(block.header, block.indexWithinCheckpoint, Fr.ZERO, block.archive.root, txHashes, signature);
67
+ return new BlockProposal(block.header, block.indexWithinCheckpoint, Fr.ZERO, block.archive.root, txHashes, signature, TEST_COORDINATION_SIGNATURE_CONTEXT);
67
68
  }
68
69
  /**
69
70
  * Creates a checkpoint proposal from a block and signature
70
- */ export function createCheckpointProposal(block, checkpointSignature, blockSignature) {
71
+ */ export function createCheckpointProposal(block, checkpointSignature, blockSignature, feeAssetPriceModifier = 0n) {
71
72
  const txHashes = block.body.txEffects.map((tx)=>tx.txHash);
72
73
  const checkpointHeader = createCheckpointHeaderFromBlock(block);
73
- return new CheckpointProposal(checkpointHeader, block.archive.root, checkpointSignature, {
74
+ return new CheckpointProposal(checkpointHeader, block.archive.root, feeAssetPriceModifier, checkpointSignature, TEST_COORDINATION_SIGNATURE_CONTEXT, {
74
75
  blockHeader: block.header,
75
76
  indexWithinCheckpoint: block.indexWithinCheckpoint,
76
77
  txHashes,
@@ -81,12 +82,13 @@ export { MockCheckpointBuilder, MockCheckpointsBuilder } from './mock_checkpoint
81
82
  * Creates a checkpoint attestation from a block and signature.
82
83
  * Note: We manually set the sender since we use random signatures in tests.
83
84
  * In production, the sender is recovered from the signature.
84
- */ export function createCheckpointAttestation(block, signature, sender) {
85
+ */ export function createCheckpointAttestation(block, signature, sender, feeAssetPriceModifier = 0n) {
85
86
  const checkpointHeader = createCheckpointHeaderFromBlock(block);
86
- const payload = new ConsensusPayload(checkpointHeader, block.archive.root);
87
+ const payload = new ConsensusPayload(checkpointHeader, block.archive.root, feeAssetPriceModifier, TEST_COORDINATION_SIGNATURE_CONTEXT);
87
88
  const attestation = new CheckpointAttestation(payload, signature, signature);
88
- // Set sender directly for testing (bypasses signature recovery)
89
- attestation.sender = sender;
89
+ // Bypass signature recovery for testing since we use random signatures
90
+ attestation.getSender = ()=>sender;
91
+ attestation.getProposer = ()=>sender;
90
92
  return attestation;
91
93
  }
92
94
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/sequencer-client",
3
- "version": "0.0.1-commit.86469d5",
3
+ "version": "0.0.1-commit.8655d4a",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
@@ -26,38 +26,37 @@
26
26
  "test:integration:run": "NODE_NO_WARNINGS=1 node --experimental-vm-modules $(yarn bin jest) --no-cache --config jest.integration.config.json"
27
27
  },
28
28
  "dependencies": {
29
- "@aztec/aztec.js": "0.0.1-commit.86469d5",
30
- "@aztec/bb-prover": "0.0.1-commit.86469d5",
31
- "@aztec/blob-client": "0.0.1-commit.86469d5",
32
- "@aztec/blob-lib": "0.0.1-commit.86469d5",
33
- "@aztec/constants": "0.0.1-commit.86469d5",
34
- "@aztec/epoch-cache": "0.0.1-commit.86469d5",
35
- "@aztec/ethereum": "0.0.1-commit.86469d5",
36
- "@aztec/foundation": "0.0.1-commit.86469d5",
37
- "@aztec/l1-artifacts": "0.0.1-commit.86469d5",
38
- "@aztec/merkle-tree": "0.0.1-commit.86469d5",
39
- "@aztec/node-keystore": "0.0.1-commit.86469d5",
40
- "@aztec/noir-acvm_js": "0.0.1-commit.86469d5",
41
- "@aztec/noir-contracts.js": "0.0.1-commit.86469d5",
42
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.86469d5",
43
- "@aztec/noir-types": "0.0.1-commit.86469d5",
44
- "@aztec/p2p": "0.0.1-commit.86469d5",
45
- "@aztec/protocol-contracts": "0.0.1-commit.86469d5",
46
- "@aztec/prover-client": "0.0.1-commit.86469d5",
47
- "@aztec/simulator": "0.0.1-commit.86469d5",
48
- "@aztec/slasher": "0.0.1-commit.86469d5",
49
- "@aztec/stdlib": "0.0.1-commit.86469d5",
50
- "@aztec/telemetry-client": "0.0.1-commit.86469d5",
51
- "@aztec/validator-client": "0.0.1-commit.86469d5",
52
- "@aztec/validator-ha-signer": "0.0.1-commit.86469d5",
53
- "@aztec/world-state": "0.0.1-commit.86469d5",
29
+ "@aztec/aztec.js": "0.0.1-commit.8655d4a",
30
+ "@aztec/bb-prover": "0.0.1-commit.8655d4a",
31
+ "@aztec/blob-client": "0.0.1-commit.8655d4a",
32
+ "@aztec/blob-lib": "0.0.1-commit.8655d4a",
33
+ "@aztec/constants": "0.0.1-commit.8655d4a",
34
+ "@aztec/epoch-cache": "0.0.1-commit.8655d4a",
35
+ "@aztec/ethereum": "0.0.1-commit.8655d4a",
36
+ "@aztec/foundation": "0.0.1-commit.8655d4a",
37
+ "@aztec/l1-artifacts": "0.0.1-commit.8655d4a",
38
+ "@aztec/node-keystore": "0.0.1-commit.8655d4a",
39
+ "@aztec/noir-acvm_js": "0.0.1-commit.8655d4a",
40
+ "@aztec/noir-contracts.js": "0.0.1-commit.8655d4a",
41
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.8655d4a",
42
+ "@aztec/noir-types": "0.0.1-commit.8655d4a",
43
+ "@aztec/p2p": "0.0.1-commit.8655d4a",
44
+ "@aztec/protocol-contracts": "0.0.1-commit.8655d4a",
45
+ "@aztec/prover-client": "0.0.1-commit.8655d4a",
46
+ "@aztec/simulator": "0.0.1-commit.8655d4a",
47
+ "@aztec/slasher": "0.0.1-commit.8655d4a",
48
+ "@aztec/stdlib": "0.0.1-commit.8655d4a",
49
+ "@aztec/telemetry-client": "0.0.1-commit.8655d4a",
50
+ "@aztec/validator-client": "0.0.1-commit.8655d4a",
51
+ "@aztec/validator-ha-signer": "0.0.1-commit.8655d4a",
52
+ "@aztec/world-state": "0.0.1-commit.8655d4a",
54
53
  "lodash.chunk": "^4.2.0",
55
54
  "tslib": "^2.4.0",
56
55
  "viem": "npm:@aztec/viem@2.38.2"
57
56
  },
58
57
  "devDependencies": {
59
- "@aztec/archiver": "0.0.1-commit.86469d5",
60
- "@aztec/kv-store": "0.0.1-commit.86469d5",
58
+ "@aztec/archiver": "0.0.1-commit.8655d4a",
59
+ "@aztec/kv-store": "0.0.1-commit.8655d4a",
61
60
  "@electric-sql/pglite": "^0.3.14",
62
61
  "@jest/globals": "^30.0.0",
63
62
  "@types/jest": "^30.0.0",
@@ -1,9 +1,10 @@
1
1
  import type { BlobClientInterface } from '@aztec/blob-client/client';
2
+ import { MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT } from '@aztec/constants';
2
3
  import { EpochCache } from '@aztec/epoch-cache';
3
4
  import { isAnvilTestChain } from '@aztec/ethereum/chain';
4
5
  import { getPublicClient } from '@aztec/ethereum/client';
5
6
  import { GovernanceProposerContract, RollupContract } from '@aztec/ethereum/contracts';
6
- import { L1TxUtilsWithBlobs } from '@aztec/ethereum/l1-tx-utils-with-blobs';
7
+ import { type Delayer, L1TxUtils } from '@aztec/ethereum/l1-tx-utils';
7
8
  import { PublisherManager } from '@aztec/ethereum/publisher-manager';
8
9
  import { EthAddress } from '@aztec/foundation/eth-address';
9
10
  import { createLogger } from '@aztec/foundation/log';
@@ -11,15 +12,14 @@ import type { DateProvider } from '@aztec/foundation/timer';
11
12
  import type { KeystoreManager } from '@aztec/node-keystore';
12
13
  import type { P2P } from '@aztec/p2p';
13
14
  import type { SlasherClientInterface } from '@aztec/slasher';
14
- import type { L2BlockSink, L2BlockSource } from '@aztec/stdlib/block';
15
+ import type { L2BlockSink, L2BlockSource, ProposedCheckpointSink } from '@aztec/stdlib/block';
15
16
  import type { ValidatorClientFullConfig, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
16
- import { SlashFactoryContract } from '@aztec/stdlib/l1-contracts';
17
17
  import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
18
18
  import { L1Metrics, type TelemetryClient } from '@aztec/telemetry-client';
19
19
  import { FullNodeCheckpointsBuilder, NodeKeystoreAdapter, type ValidatorClient } from '@aztec/validator-client';
20
20
 
21
- import type { SequencerClientConfig } from '../config.js';
22
- import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
21
+ import { type SequencerClientConfig, getPublisherConfigFromSequencerConfig } from '../config.js';
22
+ import type { GlobalVariableBuilder } from '../global_variable_builder/index.js';
23
23
  import { SequencerPublisherFactory } from '../publisher/sequencer-publisher-factory.js';
24
24
  import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
25
25
 
@@ -28,11 +28,12 @@ import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
28
28
  */
29
29
  export class SequencerClient {
30
30
  constructor(
31
- protected publisherManager: PublisherManager<L1TxUtilsWithBlobs>,
31
+ protected publisherManager: PublisherManager<L1TxUtils>,
32
32
  protected sequencer: Sequencer,
33
33
  protected checkpointsBuilder: FullNodeCheckpointsBuilder,
34
34
  protected validatorClient?: ValidatorClient,
35
35
  private l1Metrics?: L1Metrics,
36
+ private delayer_?: Delayer,
36
37
  ) {}
37
38
 
38
39
  /**
@@ -55,15 +56,17 @@ export class SequencerClient {
55
56
  worldStateSynchronizer: WorldStateSynchronizer;
56
57
  slasherClient: SlasherClientInterface | undefined;
57
58
  checkpointsBuilder: FullNodeCheckpointsBuilder;
58
- l2BlockSource: L2BlockSource & L2BlockSink;
59
+ l2BlockSource: L2BlockSource & L2BlockSink & ProposedCheckpointSink;
59
60
  l1ToL2MessageSource: L1ToL2MessageSource;
60
61
  telemetry: TelemetryClient;
61
62
  publisherFactory?: SequencerPublisherFactory;
62
63
  blobClient: BlobClientInterface;
63
64
  dateProvider: DateProvider;
64
65
  epochCache?: EpochCache;
65
- l1TxUtils: L1TxUtilsWithBlobs[];
66
+ l1TxUtils: L1TxUtils[];
67
+ funderL1TxUtils?: L1TxUtils;
66
68
  nodeKeyStore: KeystoreManager;
69
+ globalVariableBuilder: GlobalVariableBuilder;
67
70
  },
68
71
  ) {
69
72
  const {
@@ -85,37 +88,35 @@ export class SequencerClient {
85
88
  publicClient,
86
89
  l1TxUtils.map(x => x.getSenderAddress()),
87
90
  );
88
- const publisherManager = new PublisherManager(l1TxUtils, config, log.getBindings());
89
- const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
90
- const [l1GenesisTime, slotDuration, rollupVersion, rollupManaLimit] = await Promise.all([
91
+ const publisherManager = new PublisherManager(l1TxUtils, getPublisherConfigFromSequencerConfig(config), {
92
+ bindings: log.getBindings(),
93
+ funder: deps.funderL1TxUtils,
94
+ });
95
+ const rollupContract = new RollupContract(publicClient, config.rollupAddress.toString());
96
+ const [l1GenesisTime, slotDuration, rollupManaLimit] = await Promise.all([
91
97
  rollupContract.getL1GenesisTime(),
92
98
  rollupContract.getSlotDuration(),
93
- rollupContract.getVersion(),
94
99
  rollupContract.getManaLimit().then(Number),
95
100
  ] as const);
96
101
 
97
102
  const governanceProposerContract = new GovernanceProposerContract(
98
103
  publicClient,
99
- config.l1Contracts.governanceProposerAddress.toString(),
104
+ config.governanceProposerAddress.toString(),
100
105
  );
101
106
  const epochCache =
102
107
  deps.epochCache ??
103
108
  (await EpochCache.create(
104
- config.l1Contracts.rollupAddress,
109
+ config.rollupAddress,
105
110
  {
106
111
  l1RpcUrls: rpcUrls,
107
112
  l1ChainId: chainId,
108
113
  viemPollingIntervalMS: config.viemPollingIntervalMS,
109
114
  ethereumSlotDuration: config.ethereumSlotDuration,
115
+ enableProposerPipelining: config.enableProposerPipelining,
110
116
  },
111
117
  { dateProvider: deps.dateProvider },
112
118
  ));
113
119
 
114
- const slashFactoryContract = new SlashFactoryContract(
115
- publicClient,
116
- config.l1Contracts.slashFactoryAddress?.toString() ?? EthAddress.ZERO.toString(),
117
- );
118
-
119
120
  const publisherFactory =
120
121
  deps.publisherFactory ??
121
122
  new SequencerPublisherFactory(config, {
@@ -123,7 +124,6 @@ export class SequencerClient {
123
124
  blobClient: deps.blobClient,
124
125
  epochCache,
125
126
  governanceProposerContract,
126
- slashFactoryContract,
127
127
  rollupContract,
128
128
  dateProvider: deps.dateProvider,
129
129
  publisherManager,
@@ -132,17 +132,8 @@ export class SequencerClient {
132
132
  });
133
133
 
134
134
  const ethereumSlotDuration = config.ethereumSlotDuration;
135
- const l1Constants = { l1GenesisTime, slotDuration: Number(slotDuration), ethereumSlotDuration };
136
-
137
- const globalsBuilder = new GlobalVariableBuilder({ ...config, ...l1Constants, rollupVersion });
138
135
 
139
- let sequencerManaLimit = config.maxL2BlockGas ?? rollupManaLimit;
140
- if (sequencerManaLimit > rollupManaLimit) {
141
- log.warn(
142
- `Provided maxL2BlockGas ${sequencerManaLimit} is greater than the max allowed by L1. Setting limit to ${rollupManaLimit}.`,
143
- );
144
- sequencerManaLimit = rollupManaLimit;
145
- }
136
+ const globalsBuilder = deps.globalVariableBuilder;
146
137
 
147
138
  // When running in anvil, assume we can post a tx up until one second before the end of an L1 slot.
148
139
  // Otherwise, we need the full L1 slot duration for publishing to ensure inclusion.
@@ -152,6 +143,16 @@ export class SequencerClient {
152
143
  const l1PublishingTimeBasedOnChain = isAnvilTestChain(config.l1ChainId) ? 1 : ethereumSlotDuration;
153
144
  const l1PublishingTime = config.l1PublishingTime ?? l1PublishingTimeBasedOnChain;
154
145
 
146
+ const { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock } = capPerBlockLimits(config, rollupManaLimit, log);
147
+
148
+ const l1Constants = {
149
+ l1GenesisTime,
150
+ slotDuration: Number(slotDuration),
151
+ ethereumSlotDuration,
152
+ rollupManaLimit,
153
+ epochDuration: config.aztecEpochDuration,
154
+ };
155
+
155
156
  const sequencer = new Sequencer(
156
157
  publisherFactory,
157
158
  validatorClient,
@@ -166,14 +167,17 @@ export class SequencerClient {
166
167
  deps.dateProvider,
167
168
  epochCache,
168
169
  rollupContract,
169
- { ...config, l1PublishingTime, maxL2BlockGas: sequencerManaLimit },
170
+ { ...config, l1PublishingTime, maxL2BlockGas, maxDABlockGas, maxTxsPerBlock },
170
171
  telemetryClient,
171
172
  log,
172
173
  );
173
174
 
174
- await sequencer.init();
175
+ sequencer.init();
176
+
177
+ // Extract the shared delayer from the first L1TxUtils instance (all instances share the same delayer)
178
+ const delayer = l1TxUtils[0]?.delayer;
175
179
 
176
- return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics);
180
+ return new SequencerClient(publisherManager, sequencer, checkpointsBuilder, validatorClient, l1Metrics, delayer);
177
181
  }
178
182
 
179
183
  /**
@@ -191,7 +195,7 @@ export class SequencerClient {
191
195
  await this.validatorClient?.start();
192
196
  this.sequencer.start();
193
197
  this.l1Metrics?.start();
194
- await this.publisherManager.loadState();
198
+ await this.publisherManager.start();
195
199
  }
196
200
 
197
201
  /**
@@ -200,14 +204,29 @@ export class SequencerClient {
200
204
  public async stop() {
201
205
  await this.sequencer.stop();
202
206
  await this.validatorClient?.stop();
203
- this.publisherManager.interrupt();
207
+ await this.publisherManager.stop();
204
208
  this.l1Metrics?.stop();
205
209
  }
206
210
 
211
+ /** Triggers an immediate run of the sequencer, bypassing the polling interval. */
212
+ public trigger() {
213
+ return this.sequencer.trigger();
214
+ }
215
+
207
216
  public getSequencer(): Sequencer {
208
217
  return this.sequencer;
209
218
  }
210
219
 
220
+ /** Updates the publisher factory's node keystore adapter after a keystore reload. */
221
+ public updatePublisherNodeKeyStore(adapter: NodeKeystoreAdapter): void {
222
+ this.sequencer.updatePublisherNodeKeyStore(adapter);
223
+ }
224
+
225
+ /** Returns the shared tx delayer for sequencer L1 txs, if enabled. Test-only. */
226
+ getDelayer(): Delayer | undefined {
227
+ return this.delayer_;
228
+ }
229
+
211
230
  get validatorAddresses(): EthAddress[] | undefined {
212
231
  return this.sequencer.getValidatorAddresses();
213
232
  }
@@ -216,3 +235,41 @@ export class SequencerClient {
216
235
  return this.sequencer.maxL2BlockGas;
217
236
  }
218
237
  }
238
+
239
+ /**
240
+ * Caps operator-provided per-block limits at checkpoint-level limits.
241
+ * Returns undefined for any limit the operator didn't set — the checkpoint builder handles redistribution.
242
+ */
243
+ function capPerBlockLimits(
244
+ config: SequencerClientConfig,
245
+ rollupManaLimit: number,
246
+ log: ReturnType<typeof createLogger>,
247
+ ): { maxL2BlockGas: number | undefined; maxDABlockGas: number | undefined; maxTxsPerBlock: number | undefined } {
248
+ let maxL2BlockGas = config.maxL2BlockGas;
249
+ if (maxL2BlockGas !== undefined && maxL2BlockGas > rollupManaLimit) {
250
+ log.warn(`Provided MAX_L2_BLOCK_GAS ${maxL2BlockGas} exceeds rollup mana limit ${rollupManaLimit} (capping)`);
251
+ maxL2BlockGas = rollupManaLimit;
252
+ }
253
+
254
+ let maxDABlockGas = config.maxDABlockGas;
255
+ if (maxDABlockGas !== undefined && maxDABlockGas > MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT) {
256
+ log.warn(
257
+ `Provided MAX_DA_BLOCK_GAS ${maxDABlockGas} exceeds DA checkpoint limit ${MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT} (capping)`,
258
+ );
259
+ maxDABlockGas = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT;
260
+ }
261
+
262
+ let maxTxsPerBlock = config.maxTxsPerBlock;
263
+ if (
264
+ maxTxsPerBlock !== undefined &&
265
+ config.maxTxsPerCheckpoint !== undefined &&
266
+ maxTxsPerBlock > config.maxTxsPerCheckpoint
267
+ ) {
268
+ log.warn(
269
+ `Provided MAX_TX_PER_BLOCK ${maxTxsPerBlock} exceeds MAX_TX_PER_CHECKPOINT ${config.maxTxsPerCheckpoint} (capping)`,
270
+ );
271
+ maxTxsPerBlock = config.maxTxsPerCheckpoint;
272
+ }
273
+
274
+ return { maxL2BlockGas, maxDABlockGas, maxTxsPerBlock };
275
+ }
package/src/config.ts CHANGED
@@ -5,65 +5,78 @@ import {
5
5
  booleanConfigHelper,
6
6
  getConfigFromMappings,
7
7
  numberConfigHelper,
8
+ optionalNumberConfigHelper,
8
9
  pickConfigMappings,
9
10
  } from '@aztec/foundation/config';
10
11
  import { EthAddress } from '@aztec/foundation/eth-address';
11
12
  import { type KeyStoreConfig, keyStoreConfigMappings } from '@aztec/node-keystore/config';
12
13
  import { type P2PConfig, p2pConfigMappings } from '@aztec/p2p/config';
13
14
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
14
- import { type ChainConfig, type SequencerConfig, chainConfigMappings } from '@aztec/stdlib/config';
15
+ import {
16
+ type ChainConfig,
17
+ DEFAULT_MAX_BLOCKS_PER_CHECKPOINT,
18
+ type PipelineConfig,
19
+ type SequencerConfig,
20
+ chainConfigMappings,
21
+ pipelineConfigMappings,
22
+ sharedSequencerConfigMappings,
23
+ } from '@aztec/stdlib/config';
15
24
  import type { ResolvedSequencerConfig } from '@aztec/stdlib/interfaces/server';
25
+ import { DEFAULT_P2P_PROPAGATION_TIME } from '@aztec/stdlib/timetable';
16
26
  import { type ValidatorClientConfig, validatorClientConfigMappings } from '@aztec/validator-client/config';
17
27
 
18
28
  import {
19
- type PublisherConfig,
20
- type TxSenderConfig,
21
- getPublisherConfigMappings,
22
- getTxSenderConfigMappings,
29
+ type SequencerPublisherConfig,
30
+ type SequencerTxSenderConfig,
31
+ sequencerPublisherConfigMappings,
32
+ sequencerTxSenderConfigMappings,
23
33
  } from './publisher/config.js';
24
34
 
25
35
  export * from './publisher/config.js';
26
36
  export type { SequencerConfig };
27
37
 
28
- export const DEFAULT_ATTESTATION_PROPAGATION_TIME = 2;
29
-
30
38
  /**
31
39
  * Default values for SequencerConfig.
32
40
  * Centralized location for all sequencer configuration defaults.
33
41
  */
34
- export const DefaultSequencerConfig: ResolvedSequencerConfig = {
42
+ export const DefaultSequencerConfig = {
35
43
  sequencerPollingIntervalMS: 500,
36
- maxTxsPerBlock: 32,
37
44
  minTxsPerBlock: 1,
38
45
  buildCheckpointIfEmpty: false,
39
46
  publishTxsWithProposals: false,
40
- maxL2BlockGas: 10e9,
41
- maxDABlockGas: 10e9,
42
- maxBlockSizeInBytes: 1024 * 1024,
47
+ perBlockAllocationMultiplier: 1.2,
48
+ redistributeCheckpointBudget: true,
43
49
  enforceTimeTable: true,
44
- attestationPropagationTime: DEFAULT_ATTESTATION_PROPAGATION_TIME,
50
+ attestationPropagationTime: DEFAULT_P2P_PROPAGATION_TIME,
45
51
  secondsBeforeInvalidatingBlockAsCommitteeMember: 144, // 12 L1 blocks
46
52
  secondsBeforeInvalidatingBlockAsNonCommitteeMember: 432, // 36 L1 blocks
47
53
  skipCollectingAttestations: false,
48
54
  skipInvalidateBlockAsProposer: false,
55
+ skipWaitForValidParentCheckpointOnL1: false,
49
56
  broadcastInvalidBlockProposal: false,
57
+ broadcastInvalidCheckpointProposalOnly: false,
50
58
  injectFakeAttestation: false,
59
+ injectHighSValueAttestation: false,
60
+ injectUnrecoverableSignatureAttestation: false,
51
61
  fishermanMode: false,
52
62
  shuffleAttestationOrdering: false,
53
63
  skipPushProposedBlocksToArchiver: false,
54
- };
64
+ skipPublishingCheckpointsPercent: 0,
65
+ maxBlocksPerCheckpoint: DEFAULT_MAX_BLOCKS_PER_CHECKPOINT,
66
+ } satisfies ResolvedSequencerConfig;
55
67
 
56
68
  /**
57
69
  * Configuration settings for the SequencerClient.
58
70
  */
59
- export type SequencerClientConfig = PublisherConfig &
71
+ export type SequencerClientConfig = SequencerPublisherConfig &
60
72
  KeyStoreConfig &
61
73
  ValidatorClientConfig &
62
- TxSenderConfig &
74
+ SequencerTxSenderConfig &
63
75
  SequencerConfig &
64
76
  L1ReaderConfig &
65
77
  ChainConfig &
66
- Pick<P2PConfig, 'txPublicSetupAllowList'> &
78
+ PipelineConfig &
79
+ Pick<P2PConfig, 'txPublicSetupAllowListExtend'> &
67
80
  Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration' | 'aztecEpochDuration'>;
68
81
 
69
82
  export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
@@ -72,10 +85,10 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
72
85
  description: 'The number of ms to wait between polling for checking to build on the next slot.',
73
86
  ...numberConfigHelper(DefaultSequencerConfig.sequencerPollingIntervalMS),
74
87
  },
75
- maxTxsPerBlock: {
76
- env: 'SEQ_MAX_TX_PER_BLOCK',
77
- description: 'The maximum number of txs to include in a block.',
78
- ...numberConfigHelper(DefaultSequencerConfig.maxTxsPerBlock),
88
+ maxTxsPerCheckpoint: {
89
+ env: 'SEQ_MAX_TX_PER_CHECKPOINT',
90
+ description: 'The maximum number of txs across all blocks in a checkpoint.',
91
+ ...optionalNumberConfigHelper(),
79
92
  },
80
93
  minTxsPerBlock: {
81
94
  env: 'SEQ_MIN_TX_PER_BLOCK',
@@ -94,16 +107,29 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
94
107
  maxL2BlockGas: {
95
108
  env: 'SEQ_MAX_L2_BLOCK_GAS',
96
109
  description: 'The maximum L2 block gas.',
97
- ...numberConfigHelper(DefaultSequencerConfig.maxL2BlockGas),
110
+ ...optionalNumberConfigHelper(),
98
111
  },
99
112
  maxDABlockGas: {
100
113
  env: 'SEQ_MAX_DA_BLOCK_GAS',
101
114
  description: 'The maximum DA block gas.',
102
- ...numberConfigHelper(DefaultSequencerConfig.maxDABlockGas),
115
+ ...optionalNumberConfigHelper(),
116
+ },
117
+ perBlockAllocationMultiplier: {
118
+ env: 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER',
119
+ description:
120
+ 'Per-block gas budget multiplier for both L2 and DA gas. Budget per block is (checkpointLimit / maxBlocks) * multiplier.' +
121
+ ' Values greater than one allow early blocks to use more than their even share, relying on checkpoint-level capping for later blocks.',
122
+ ...numberConfigHelper(DefaultSequencerConfig.perBlockAllocationMultiplier),
123
+ },
124
+ redistributeCheckpointBudget: {
125
+ env: 'SEQ_REDISTRIBUTE_CHECKPOINT_BUDGET',
126
+ description:
127
+ 'Redistribute remaining checkpoint budget evenly across remaining blocks instead of allowing a single block to consume the entire remaining budget.',
128
+ ...booleanConfigHelper(DefaultSequencerConfig.redistributeCheckpointBudget),
103
129
  },
104
130
  coinbase: {
105
131
  env: 'COINBASE',
106
- parseEnv: (val: string) => (val ? EthAddress.fromString(val) : undefined),
132
+ parseEnv: (val: string) => EthAddress.fromString(val),
107
133
  description: 'Recipient of block reward.',
108
134
  },
109
135
  feeRecipient: {
@@ -119,11 +145,6 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
119
145
  env: 'ACVM_BINARY_PATH',
120
146
  description: 'The path to the ACVM binary',
121
147
  },
122
- maxBlockSizeInBytes: {
123
- env: 'SEQ_MAX_BLOCK_SIZE_IN_BYTES',
124
- description: 'Max block size',
125
- ...numberConfigHelper(DefaultSequencerConfig.maxBlockSizeInBytes),
126
- },
127
148
  enforceTimeTable: {
128
149
  env: 'SEQ_ENFORCE_TIME_TABLE',
129
150
  description: 'Whether to enforce the time table when building blocks',
@@ -137,12 +158,7 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
137
158
  l1PublishingTime: {
138
159
  env: 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT',
139
160
  description: 'How much time (in seconds) we allow in the slot for publishing the L1 tx (defaults to 1 L1 slot).',
140
- parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
141
- },
142
- attestationPropagationTime: {
143
- env: 'SEQ_ATTESTATION_PROPAGATION_TIME',
144
- description: 'How many seconds it takes for proposals and attestations to travel across the p2p layer (one-way)',
145
- ...numberConfigHelper(DefaultSequencerConfig.attestationPropagationTime),
161
+ ...optionalNumberConfigHelper(),
146
162
  },
147
163
  fakeProcessingDelayPerTxMs: {
148
164
  description: 'Used for testing to introduce a fake delay after processing each tx',
@@ -173,14 +189,37 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
173
189
  description: 'Do not invalidate the previous block if invalid when we are the proposer (for testing only)',
174
190
  ...booleanConfigHelper(DefaultSequencerConfig.skipInvalidateBlockAsProposer),
175
191
  },
192
+ skipWaitForValidParentCheckpointOnL1: {
193
+ description:
194
+ 'Bypass the parent checkpoint validity check before submitting a pipelined checkpoint, ' +
195
+ 'allowing the proposer to publish even when the parent landed on L1 with invalid attestations (for testing only)',
196
+ ...booleanConfigHelper(DefaultSequencerConfig.skipWaitForValidParentCheckpointOnL1),
197
+ },
176
198
  broadcastInvalidBlockProposal: {
177
199
  description: 'Broadcast invalid block proposals with corrupted state (for testing only)',
178
200
  ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidBlockProposal),
179
201
  },
202
+ invalidBlockProposalIndexWithinCheckpoint: {
203
+ description: 'Broadcast an invalid block proposal only at this indexWithinCheckpoint (for testing only)',
204
+ ...optionalNumberConfigHelper(),
205
+ },
206
+ broadcastInvalidCheckpointProposalOnly: {
207
+ description:
208
+ 'Broadcast invalid checkpoint proposals while keeping the underlying block proposals valid (for testing only). When unset, the checkpoint follows broadcastInvalidBlockProposal.',
209
+ ...booleanConfigHelper(DefaultSequencerConfig.broadcastInvalidCheckpointProposalOnly),
210
+ },
180
211
  injectFakeAttestation: {
181
212
  description: 'Inject a fake attestation (for testing only)',
182
213
  ...booleanConfigHelper(DefaultSequencerConfig.injectFakeAttestation),
183
214
  },
215
+ injectHighSValueAttestation: {
216
+ description: 'Inject a malleable attestation with a high-s value (for testing only)',
217
+ ...booleanConfigHelper(DefaultSequencerConfig.injectHighSValueAttestation),
218
+ },
219
+ injectUnrecoverableSignatureAttestation: {
220
+ description: 'Inject an attestation with an unrecoverable signature (for testing only)',
221
+ ...booleanConfigHelper(DefaultSequencerConfig.injectUnrecoverableSignatureAttestation),
222
+ },
184
223
  fishermanMode: {
185
224
  env: 'FISHERMAN_MODE',
186
225
  description:
@@ -191,13 +230,7 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
191
230
  description: 'Shuffle attestation ordering to create invalid ordering (for testing only)',
192
231
  ...booleanConfigHelper(DefaultSequencerConfig.shuffleAttestationOrdering),
193
232
  },
194
- blockDurationMs: {
195
- env: 'SEQ_BLOCK_DURATION_MS',
196
- description:
197
- 'Duration per block in milliseconds when building multiple blocks per slot. ' +
198
- 'If undefined (default), builds a single block per slot using the full slot duration.',
199
- parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
200
- },
233
+ ...sharedSequencerConfigMappings,
201
234
  buildCheckpointIfEmpty: {
202
235
  env: 'SEQ_BUILD_CHECKPOINT_IF_EMPTY',
203
236
  description: 'Have sequencer build and publish an empty checkpoint if there are no txs',
@@ -207,17 +240,40 @@ export const sequencerConfigMappings: ConfigMappingsType<SequencerConfig> = {
207
240
  description: 'Skip pushing proposed blocks to archiver (default: true)',
208
241
  ...booleanConfigHelper(DefaultSequencerConfig.skipPushProposedBlocksToArchiver),
209
242
  },
210
- ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowList']),
243
+ minBlocksForCheckpoint: {
244
+ description: 'Minimum number of blocks required for a checkpoint proposal (test only)',
245
+ },
246
+ skipPublishingCheckpointsPercent: {
247
+ env: 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT',
248
+ description: 'Percent probability (0 - 100) of sequencer skipping checkpoint publishing (testing only)',
249
+ ...numberConfigHelper(DefaultSequencerConfig.skipPublishingCheckpointsPercent),
250
+ },
251
+ skipBroadcastProposals: {
252
+ description: 'Skip broadcasting checkpoint and block proposals via gossipsub when proposer (for testing only)',
253
+ ...booleanConfigHelper(false),
254
+ },
255
+ skipBroadcastCheckpointProposal: {
256
+ description:
257
+ 'Skip broadcasting only the CheckpointProposal via gossipsub when proposer; the held last block is broadcast ' +
258
+ 'standalone instead so peers still receive it as a proposed-but-uncheckpointed tip (for testing only)',
259
+ ...booleanConfigHelper(false),
260
+ },
261
+ pauseProposingForSlots: {
262
+ description:
263
+ 'List of slots for which the sequencer will not produce a proposal (for testing only). Attestation paths are unaffected.',
264
+ },
265
+ ...pickConfigMappings(p2pConfigMappings, ['txPublicSetupAllowListExtend']),
211
266
  };
212
267
 
213
268
  export const sequencerClientConfigMappings: ConfigMappingsType<SequencerClientConfig> = {
269
+ ...chainConfigMappings,
214
270
  ...validatorClientConfigMappings,
215
271
  ...sequencerConfigMappings,
216
272
  ...keyStoreConfigMappings,
217
273
  ...l1ReaderConfigMappings,
218
- ...getTxSenderConfigMappings('SEQ'),
219
- ...getPublisherConfigMappings('SEQ'),
220
- ...chainConfigMappings,
274
+ ...sequencerTxSenderConfigMappings,
275
+ ...sequencerPublisherConfigMappings,
276
+ ...pipelineConfigMappings,
221
277
  ...pickConfigMappings(l1ContractsConfigMappings, ['ethereumSlotDuration', 'aztecSlotDuration', 'aztecEpochDuration']),
222
278
  };
223
279