@aztec/sequencer-client 0.87.6 → 1.0.0-nightly.20250604

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/sequencer-client",
-  "version": "0.87.6",
+  "version": "1.0.0-nightly.20250604",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
@@ -26,36 +26,37 @@
     "test:integration:run": "NODE_NO_WARNINGS=1 node --experimental-vm-modules $(yarn bin jest) --no-cache --config jest.integration.config.json"
   },
   "dependencies": {
-    "@aztec/aztec.js": "0.87.6",
-    "@aztec/bb-prover": "0.87.6",
-    "@aztec/blob-lib": "0.87.6",
-    "@aztec/blob-sink": "0.87.6",
-    "@aztec/constants": "0.87.6",
-    "@aztec/epoch-cache": "0.87.6",
-    "@aztec/ethereum": "0.87.6",
-    "@aztec/foundation": "0.87.6",
-    "@aztec/l1-artifacts": "0.87.6",
-    "@aztec/merkle-tree": "0.87.6",
-    "@aztec/noir-acvm_js": "0.87.6",
-    "@aztec/noir-contracts.js": "0.87.6",
-    "@aztec/noir-protocol-circuits-types": "0.87.6",
-    "@aztec/noir-types": "0.87.6",
-    "@aztec/p2p": "0.87.6",
-    "@aztec/protocol-contracts": "0.87.6",
-    "@aztec/prover-client": "0.87.6",
-    "@aztec/simulator": "0.87.6",
-    "@aztec/stdlib": "0.87.6",
-    "@aztec/telemetry-client": "0.87.6",
-    "@aztec/validator-client": "0.87.6",
-    "@aztec/world-state": "0.87.6",
+    "@aztec/aztec.js": "1.0.0-nightly.20250604",
+    "@aztec/bb-prover": "1.0.0-nightly.20250604",
+    "@aztec/blob-lib": "1.0.0-nightly.20250604",
+    "@aztec/blob-sink": "1.0.0-nightly.20250604",
+    "@aztec/constants": "1.0.0-nightly.20250604",
+    "@aztec/epoch-cache": "1.0.0-nightly.20250604",
+    "@aztec/ethereum": "1.0.0-nightly.20250604",
+    "@aztec/foundation": "1.0.0-nightly.20250604",
+    "@aztec/l1-artifacts": "1.0.0-nightly.20250604",
+    "@aztec/merkle-tree": "1.0.0-nightly.20250604",
+    "@aztec/noir-acvm_js": "1.0.0-nightly.20250604",
+    "@aztec/noir-contracts.js": "1.0.0-nightly.20250604",
+    "@aztec/noir-protocol-circuits-types": "1.0.0-nightly.20250604",
+    "@aztec/noir-types": "1.0.0-nightly.20250604",
+    "@aztec/p2p": "1.0.0-nightly.20250604",
+    "@aztec/protocol-contracts": "1.0.0-nightly.20250604",
+    "@aztec/prover-client": "1.0.0-nightly.20250604",
+    "@aztec/simulator": "1.0.0-nightly.20250604",
+    "@aztec/slasher": "1.0.0-nightly.20250604",
+    "@aztec/stdlib": "1.0.0-nightly.20250604",
+    "@aztec/telemetry-client": "1.0.0-nightly.20250604",
+    "@aztec/validator-client": "1.0.0-nightly.20250604",
+    "@aztec/world-state": "1.0.0-nightly.20250604",
     "lodash.chunk": "^4.2.0",
     "lodash.pick": "^4.4.0",
     "tslib": "^2.4.0",
     "viem": "2.23.7"
   },
   "devDependencies": {
-    "@aztec/archiver": "0.87.6",
-    "@aztec/kv-store": "0.87.6",
+    "@aztec/archiver": "1.0.0-nightly.20250604",
+    "@aztec/kv-store": "1.0.0-nightly.20250604",
     "@jest/globals": "^29.5.0",
     "@types/jest": "^29.5.0",
     "@types/lodash.chunk": "^4.2.7",

package/src/client/sequencer-client.ts

@@ -14,12 +14,10 @@ import { EthAddress } from '@aztec/foundation/eth-address';
 import { createLogger } from '@aztec/foundation/log';
 import type { DateProvider } from '@aztec/foundation/timer';
 import type { P2P } from '@aztec/p2p';
-import { LightweightBlockBuilderFactory } from '@aztec/prover-client/block-builder';
-import { PublicProcessorFactory } from '@aztec/simulator/server';
+import type { SlasherClient } from '@aztec/slasher';
 import type { AztecAddress } from '@aztec/stdlib/aztec-address';
 import type { L2BlockSource } from '@aztec/stdlib/block';
-import type { ContractDataSource } from '@aztec/stdlib/contract';
-import type { WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
+import type { IFullNodeBlockBuilder, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
 import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
 import type { TelemetryClient } from '@aztec/telemetry-client';
 import type { ValidatorClient } from '@aztec/validator-client';
@@ -28,7 +26,6 @@ import type { SequencerClientConfig } from '../config.js';
 import { GlobalVariableBuilder } from '../global_variable_builder/index.js';
 import { SequencerPublisher } from '../publisher/index.js';
 import { Sequencer, type SequencerConfig } from '../sequencer/index.js';
-import type { SlasherClient } from '../slasher/index.js';
 
 /**
  * Encapsulates the full sequencer and publisher.
@@ -55,7 +52,7 @@ export class SequencerClient {
       p2pClient: P2P;
       worldStateSynchronizer: WorldStateSynchronizer;
       slasherClient: SlasherClient;
-      contractDataSource: ContractDataSource;
+      blockBuilder: IFullNodeBlockBuilder;
       l2BlockSource: L2BlockSource;
       l1ToL2MessageSource: L1ToL2MessageSource;
       telemetry: TelemetryClient;
@@ -71,7 +68,7 @@ export class SequencerClient {
       p2pClient,
       worldStateSynchronizer,
       slasherClient,
-      contractDataSource,
+      blockBuilder,
       l2BlockSource,
       l1ToL2MessageSource,
       telemetry: telemetryClient,
@@ -93,12 +90,7 @@ export class SequencerClient {
             config.customForwarderContractAddress.toString(),
             config.l1Contracts.rollupAddress.toString(),
           )
-        : await ForwarderContract.create(
-            l1Client.account.address,
-            l1Client,
-            log,
-            config.l1Contracts.rollupAddress.toString(),
-          );
+        : await ForwarderContract.create(l1Client, log, config.l1Contracts.rollupAddress.toString());
 
     const governanceProposerContract = new GovernanceProposerContract(
       l1Client,
@@ -136,8 +128,6 @@ export class SequencerClient {
       });
     const globalsBuilder = new GlobalVariableBuilder(config);
 
-    const publicProcessorFactory = new PublicProcessorFactory(contractDataSource, deps.dateProvider, telemetryClient);
-
     const ethereumSlotDuration = config.ethereumSlotDuration;
 
     const rollupManaLimit = Number(await rollupContract.getManaLimit());
@@ -171,11 +161,9 @@ export class SequencerClient {
       p2pClient,
       worldStateSynchronizer,
       slasherClient,
-      new LightweightBlockBuilderFactory(telemetryClient),
       l2BlockSource,
       l1ToL2MessageSource,
-      publicProcessorFactory,
-      contractDataSource,
+      blockBuilder,
       l1Constants,
       deps.dateProvider,
       { ...config, maxL1TxInclusionTimeIntoSlot, maxL2BlockGas: sequencerManaLimit },
@@ -213,6 +201,10 @@ export class SequencerClient {
     this.sequencer.restart();
   }
 
+  public getSequencer(): Sequencer {
+    return this.sequencer;
+  }
+
   get coinbase(): EthAddress {
     return this.sequencer.coinbase;
   }
@@ -225,8 +217,8 @@ export class SequencerClient {
     return this.sequencer.getForwarderAddress();
   }
 
-  get validatorAddress(): EthAddress | undefined {
-    return this.sequencer.getValidatorAddress();
+  get validatorAddresses(): EthAddress[] | undefined {
+    return this.sequencer.getValidatorAddresses();
   }
 
   get maxL2BlockGas(): number | undefined {

package/src/global_variable_builder/global_builder.ts

@@ -20,6 +20,8 @@ import { createPublicClient, fallback, http } from 'viem';
  */
 export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
   private log = createLogger('sequencer:global_variable_builder');
+  private currentBaseFees: Promise<GasFees> = Promise.resolve(new GasFees(Fr.ZERO, Fr.ZERO));
+  private currentL1BlockNumber: bigint | undefined = undefined;
 
   private readonly rollupContract: RollupContract;
   private readonly publicClient: ViemPublicClient;
@@ -46,9 +48,9 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
 
   /**
    * Computes the "current" base fees, e.g., the price that you currently should pay to get include in the next block
-   * @returns Base fees for the expected next block
+   * @returns Base fees for the next block
    */
-  public async getCurrentBaseFees(): Promise<GasFees> {
+  private async computeCurrentBaseFees(): Promise<GasFees> {
     // Since this might be called in the middle of a slot where a block might have been published,
     // we need to fetch the last block written, and estimate the earliest timestamp for the next block.
     // The timestamp of that last block will act as a lower bound for the next block.
@@ -61,6 +63,18 @@ export class GlobalVariableBuilder implements GlobalVariableBuilderInterface {
     return new GasFees(Fr.ZERO, new Fr(await this.rollupContract.getManaBaseFeeAt(timestamp, true)));
   }
 
+  public async getCurrentBaseFees(): Promise<GasFees> {
+    // Get the current block number
+    const blockNumber = await this.publicClient.getBlockNumber();
+
+    // If the L1 block number has changed then chain a new promise to get the current base fees
+    if (this.currentL1BlockNumber === undefined || blockNumber > this.currentL1BlockNumber) {
+      this.currentL1BlockNumber = blockNumber;
+      this.currentBaseFees = this.currentBaseFees.then(() => this.computeCurrentBaseFees());
+    }
+    return this.currentBaseFees;
+  }
+
   public async getGlobalConstantVariables(): Promise<Pick<GlobalVariables, 'chainId' | 'version'>> {
     if (!this.chainId) {
       this.chainId = new Fr(this.publicClient.chain.id);

package/src/index.ts

@@ -1,9 +1,8 @@
 export * from './client/index.js';
 export * from './config.js';
 export * from './publisher/index.js';
+export { FullNodeBlockBuilder as BlockBuilder, Sequencer, SequencerState } from './sequencer/index.js';
 export * from './tx_validator/tx_validator_factory.js';
-export * from './slasher/index.js';
-export { Sequencer, SequencerState } from './sequencer/index.js';
 
 // Used by the node to simulate public parts of transactions. Should these be moved to a shared library?
 // ISSUE(#9832)

package/src/publisher/config.ts

@@ -50,7 +50,7 @@ export const getTxSenderConfigMappings: (
     description: 'The private key to be used by the publisher.',
     parseEnv: (val: string) => (val ? `0x${val.replace('0x', '')}` : NULL_KEY),
     defaultValue: NULL_KEY,
-    fallback: ['VALIDATOR_PRIVATE_KEY'],
+    // fallback: ['VALIDATOR_PRIVATE_KEY'],
   },
 });
 

package/src/publisher/sequencer-publisher.ts

@@ -20,10 +20,10 @@ import {
 import type { L1TxUtilsWithBlobs } from '@aztec/ethereum/l1-tx-utils-with-blobs';
 import { toHex as toPaddedHex } from '@aztec/foundation/bigint-buffer';
 import { EthAddress } from '@aztec/foundation/eth-address';
-import type { Signature } from '@aztec/foundation/eth-signature';
 import { createLogger } from '@aztec/foundation/log';
 import { Timer } from '@aztec/foundation/timer';
 import { ForwarderAbi, RollupAbi } from '@aztec/l1-artifacts';
+import { CommitteeAttestation } from '@aztec/stdlib/block';
 import { ConsensusPayload, SignatureDomainSeparator, getHashedSignaturePayload } from '@aztec/stdlib/p2p';
 import type { L1PublishBlockStats } from '@aztec/stdlib/stats';
 import { type ProposedBlockHeader, TxHash } from '@aztec/stdlib/tx';
@@ -48,7 +48,7 @@ type L1ProcessArgs = {
   /** L2 block tx hashes */
   txHashes: TxHash[];
   /** Attestations */
-  attestations?: Signature[];
+  attestations?: CommitteeAttestation[];
 };
 
 export enum VoteType {
@@ -74,7 +74,7 @@ interface RequestWithExpiry {
 export class SequencerPublisher {
   private interrupted = false;
   private metrics: SequencerPublisherMetrics;
-  private epochCache: EpochCache;
+  public epochCache: EpochCache;
   private forwarderContract: ForwarderContract;
 
   protected governanceLog = createLogger('sequencer:publisher:governance');
@@ -264,7 +264,9 @@ export class SequencerPublisher {
    * @returns The slot and block number if it is possible to propose, undefined otherwise
    */
   public canProposeAtNextEthBlock(tipArchive: Buffer) {
+    // TODO: #14291 - should loop through multiple keys to check if any of them can propose
     const ignoredErrors = ['SlotAlreadyInChain', 'InvalidProposer', 'InvalidArchive'];
+
     return this.rollupContract
       .canProposeAtNextEthBlock(tipArchive, this.getForwarderAddress().toString(), this.ethereumSlotDuration)
       .catch(err => {
@@ -288,19 +290,29 @@ export class SequencerPublisher {
    */
   public async validateBlockForSubmission(
     header: ProposedBlockHeader,
-    attestationData: { digest: Buffer; signatures: Signature[] } = {
+    attestationData: { digest: Buffer; attestations: CommitteeAttestation[] } = {
       digest: Buffer.alloc(32),
-      signatures: [],
+      attestations: [],
     },
   ): Promise<bigint> {
     const ts = BigInt((await this.l1TxUtils.getBlock()).timestamp + this.ethereumSlotDuration);
 
-    const formattedSignatures = attestationData.signatures.map(attest => attest.toViemSignature());
-    const flags = { ignoreDA: true, ignoreSignatures: formattedSignatures.length == 0 };
+    // If we have no attestations, we still need to provide the empty attestations
+    // so that the committee is recalculated correctly
+    const ignoreSignatures = attestationData.attestations.length === 0;
+    if (ignoreSignatures) {
+      const committee = await this.epochCache.getCommittee(header.slotNumber.toBigInt());
+      attestationData.attestations = committee.committee.map(committeeMember =>
+        CommitteeAttestation.fromAddress(committeeMember),
+      );
+    }
+
+    const formattedAttestations = attestationData.attestations.map(attest => attest.toViem());
+    const flags = { ignoreDA: true, ignoreSignatures };
 
     const args = [
       toHex(header.toBuffer()),
-      formattedSignatures,
+      formattedAttestations,
       toHex(attestationData.digest),
       ts,
       toHex(header.contentCommitment.blobsHash),
@@ -330,14 +342,8 @@ export class SequencerPublisher {
       return false;
     }
     const round = await base.computeRound(slotNumber);
-    const [proposer, roundInfo] = await Promise.all([
-      this.rollupContract.getProposerAt(timestamp),
-      base.getRoundInfo(this.rollupContract.address, round),
-    ]);
+    const roundInfo = await base.getRoundInfo(this.rollupContract.address, round);
 
-    if (proposer.toLowerCase() !== this.getForwarderAddress().toString().toLowerCase()) {
-      return false;
-    }
     if (roundInfo.lastVote >= slotNumber) {
       return false;
     }
@@ -347,9 +353,15 @@ export class SequencerPublisher {
 
     const action = voteType === VoteType.GOVERNANCE ? 'governance-vote' : 'slashing-vote';
 
+    const request = await base.createVoteRequestWithSignature(payload.toString(), this.l1TxUtils.client);
+    this.log.debug(`Created ${action} request with signature`, {
+      request,
+      signer: this.l1TxUtils.client.account?.address,
+    });
+
     this.addRequest({
       action,
-      request: base.createVoteRequest(payload.toString()),
+      request,
       lastValidL2Slot: slotNumber,
       onResult: (_request, result) => {
         if (!result || result.receipt.status !== 'success') {
@@ -376,6 +388,7 @@ export class SequencerPublisher {
       if (!slashPayload) {
         return undefined;
       }
+      this.log.info(`Slash payload: ${slashPayload}`);
       return { payload: slashPayload, base: this.slashingProposerContract };
     }
     throw new Error('Unreachable: Invalid vote type');
@@ -405,7 +418,7 @@ export class SequencerPublisher {
    */
   public async enqueueProposeL2Block(
     block: L2Block,
-    attestations?: Signature[],
+    attestations?: CommitteeAttestation[],
     txHashes?: TxHash[],
     opts: { txTimeoutAt?: Date } = {},
   ): Promise<boolean> {
@@ -431,7 +444,7 @@ export class SequencerPublisher {
     //        make time consistency checks break.
     const ts = await this.validateBlockForSubmission(proposedBlockHeader, {
       digest: digest.toBuffer(),
-      signatures: attestations ?? [],
+      attestations: attestations ?? [],
     });
 
     this.log.debug(`Submitting propose transaction`);
@@ -486,9 +499,7 @@ export class SequencerPublisher {
         throw new Error('Failed to validate blobs');
       });
 
-    const attestations = encodedData.attestations
-      ? encodedData.attestations.map(attest => attest.toViemSignature())
-      : [];
+    const attestations = encodedData.attestations ? encodedData.attestations.map(attest => attest.toViem()) : [];
     const txHashes = encodedData.txHashes ? encodedData.txHashes.map(txHash => txHash.toString()) : [];
     const args = [
       {

package/src/sequencer/block_builder.ts

@@ -0,0 +1,192 @@
+import { elapsed } from '@aztec/aztec.js';
+import { createLogger } from '@aztec/foundation/log';
+import { retryUntil } from '@aztec/foundation/retry';
+import { DateProvider, Timer } from '@aztec/foundation/timer';
+import { LightweightBlockFactory } from '@aztec/prover-client/block-factory';
+import {
+  GuardedMerkleTreeOperations,
+  PublicContractsDB,
+  PublicProcessor,
+  TelemetryPublicTxSimulator,
+} from '@aztec/simulator/server';
+import type { ChainConfig } from '@aztec/stdlib/config';
+import type { ContractDataSource } from '@aztec/stdlib/contract';
+import { type L1RollupConstants, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
+import { Gas } from '@aztec/stdlib/gas';
+import type {
+  BuildBlockOptions,
+  BuildBlockResult,
+  IFullNodeBlockBuilder,
+  MerkleTreeWriteOperations,
+  PublicProcessorValidator,
+  WorldStateSynchronizer,
+} from '@aztec/stdlib/interfaces/server';
+import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
+import { GlobalVariables, Tx } from '@aztec/stdlib/tx';
+import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-client';
+
+import { createValidatorForBlockBuilding } from '../tx_validator/tx_validator_factory.js';
+
+const log = createLogger('sequencer:block-builder');
+
+export async function buildBlock(
+  pendingTxs: Iterable<Tx> | AsyncIterable<Tx>,
+  newGlobalVariables: GlobalVariables,
+  opts: BuildBlockOptions = {},
+  l1ToL2MessageSource: L1ToL2MessageSource,
+  worldStateFork: MerkleTreeWriteOperations,
+  processor: PublicProcessor,
+  validator: PublicProcessorValidator,
+  l1Constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'>,
+  dateProvider: DateProvider,
+  telemetryClient: TelemetryClient = getTelemetryClient(),
+): Promise<BuildBlockResult> {
+  const blockBuildingTimer = new Timer();
+  const blockNumber = newGlobalVariables.blockNumber.toNumber();
+  const slot = newGlobalVariables.slotNumber.toBigInt();
+  log.debug(`Requesting L1 to L2 messages from contract for block ${blockNumber}`);
+  const l1ToL2Messages = await l1ToL2MessageSource.getL1ToL2Messages(BigInt(blockNumber));
+  const msgCount = l1ToL2Messages.length;
+
+  log.verbose(`Building block ${blockNumber} for slot ${slot}`, {
+    slot,
+    slotStart: new Date(Number(getTimestampForSlot(slot, l1Constants)) * 1000),
+    now: new Date(dateProvider.now()),
+    blockNumber,
+    msgCount,
+    opts,
+  });
+
+  try {
+    const blockFactory = new LightweightBlockFactory(worldStateFork, telemetryClient);
+    await blockFactory.startNewBlock(newGlobalVariables, l1ToL2Messages);
+
+    const [publicProcessorDuration, [processedTxs, failedTxs, usedTxs]] = await elapsed(() =>
+      processor.process(pendingTxs, opts, validator),
+    );
+
+    // All real transactions have been added, set the block as full and pad if needed
+    await blockFactory.addTxs(processedTxs);
+    const block = await blockFactory.setBlockCompleted();
+
+    // How much public gas was processed
+    const publicGas = processedTxs.reduce((acc, tx) => acc.add(tx.gasUsed.publicGas), Gas.empty());
+
+    const res = {
+      block,
+      publicGas,
+      publicProcessorDuration,
+      numMsgs: l1ToL2Messages.length,
+      numTxs: processedTxs.length,
+      failedTxs: failedTxs,
+      blockBuildingTimer,
+      usedTxs,
+    };
+    log.trace('Built block', res.block.header);
+    return res;
+  } finally {
+    // We wait a bit to close the forks since the processor may still be working on a dangling tx
+    // which was interrupted due to the processingDeadline being hit.
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    setTimeout(async () => {
+      try {
+        await worldStateFork.close();
+      } catch (err) {
+        // This can happen if the sequencer is stopped before we hit this timeout.
+        log.warn(`Error closing forks for block processing`, err);
+      }
+    }, 5000);
+  }
+}
+
+export class FullNodeBlockBuilder implements IFullNodeBlockBuilder {
+  constructor(
+    private config: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'> &
+      Pick<ChainConfig, 'l1ChainId' | 'rollupVersion'>,
+    private l1ToL2MessageSource: L1ToL2MessageSource,
+    private worldState: WorldStateSynchronizer,
+    private contractDataSource: ContractDataSource,
+    private dateProvider: DateProvider,
+    private telemetryClient: TelemetryClient = getTelemetryClient(),
+  ) {}
+
+  public getConfig() {
+    return {
+      l1GenesisTime: this.config.l1GenesisTime,
+      slotDuration: this.config.slotDuration,
+      l1ChainId: this.config.l1ChainId,
+      rollupVersion: this.config.rollupVersion,
+    };
+  }
+
+  public async makeBlockBuilderDeps(globalVariables: GlobalVariables, opts: BuildBlockOptions) {
+    const publicProcessorDBFork = await this.worldState.fork();
+    const contractsDB = new PublicContractsDB(this.contractDataSource);
+    const guardedFork = new GuardedMerkleTreeOperations(publicProcessorDBFork);
+
+    const publicTxSimulator = new TelemetryPublicTxSimulator(
+      guardedFork,
+      contractsDB,
+      globalVariables,
+      /*doMerkleOperations=*/ true,
+      /*skipFeeEnforcement=*/ true,
+      /*clientInitiatedSimulation=*/ false,
+      this.telemetryClient,
+    );
+
+    const processor = new PublicProcessor(
+      globalVariables,
+      guardedFork,
+      contractsDB,
+      publicTxSimulator,
+      this.dateProvider,
+      this.telemetryClient,
+    );
+    const validator = createValidatorForBlockBuilding(
+      publicProcessorDBFork,
+      this.contractDataSource,
+      globalVariables,
+      opts.txPublicSetupAllowList ?? [],
+    );
+
+    return {
+      publicProcessorDBFork,
+      processor,
+      validator,
+    };
+  }
+
+  private async syncToPreviousBlock(parentBlockNumber: number, timeout: number | undefined) {
+    await retryUntil(
+      () => this.worldState.syncImmediate(parentBlockNumber, true).then(syncedTo => syncedTo >= parentBlockNumber),
+      'sync to previous block',
+      timeout,
+      0.1,
+    );
+    log.debug(`Synced to previous block ${parentBlockNumber}`);
+  }
+
+  async buildBlock(
+    pendingTxs: Iterable<Tx> | AsyncIterable<Tx>,
+    globalVariables: GlobalVariables,
+    opts: BuildBlockOptions,
+  ): Promise<BuildBlockResult> {
+    const parentBlockNumber = globalVariables.blockNumber.toNumber() - 1;
+    const syncTimeout = opts.deadline ? (opts.deadline.getTime() - this.dateProvider.now()) / 1000 : undefined;
+    await this.syncToPreviousBlock(parentBlockNumber, syncTimeout);
+    const { publicProcessorDBFork, processor, validator } = await this.makeBlockBuilderDeps(globalVariables, opts);
+
+    return buildBlock(
+      pendingTxs,
+      globalVariables,
+      opts,
+      this.l1ToL2MessageSource,
+      publicProcessorDBFork,
+      processor,
+      validator,
+      this.config,
+      this.dateProvider,
+      this.telemetryClient,
+    );
+  }
+}

package/src/sequencer/index.ts

@@ -1,2 +1,3 @@
+export * from './block_builder.js';
 export * from './config.js';
 export * from './sequencer.js';