@aztec/stdlib 0.0.1-commit.f504929 → 0.0.1-commit.f5a9928

package/dest/interfaces/aztec-node.js

@@ -1,103 +1,384 @@
 import { ARCHIVE_HEIGHT, L1_TO_L2_MSG_TREE_HEIGHT, NOTE_HASH_TREE_HEIGHT } from '@aztec/constants';
 import { L1ContractAddressesSchema } from '@aztec/ethereum/l1-contract-addresses';
-import { BlockNumberPositiveSchema, BlockNumberSchema, CheckpointNumberPositiveSchema, EpochNumberSchema } from '@aztec/foundation/branded-types';
+import { BlockNumberPositiveSchema, BlockNumberSchema, CheckpointNumberPositiveSchema, CheckpointNumberSchema, EpochNumberSchema, SlotNumberSchema } from '@aztec/foundation/branded-types';
 import { createSafeJsonRpcClient, makeFetch } from '@aztec/foundation/json-rpc/client';
 import { MembershipWitness, SiblingPath } from '@aztec/foundation/trees';
 import { z } from 'zod';
+import { BlockDataSchema } from '../block/block_data.js';
 import { BlockHash } from '../block/block_hash.js';
-import { BlockParameterSchema } from '../block/block_parameter.js';
-import { CheckpointedL2Block } from '../block/checkpointed_l2_block.js';
+import { BlockParameterSchema, BlockTagWithoutLatestSchema } from '../block/block_parameter.js';
 import { dataInBlockSchemaFor } from '../block/in_block.js';
-import { L2Block } from '../block/l2_block.js';
-import { L2TipsSchema } from '../block/l2_block_source.js';
-import { PublishedCheckpoint } from '../checkpoint/published_checkpoint.js';
+import { CheckpointsQuerySchema, L2TipsSchema } from '../block/l2_block_source.js';
+import { CheckpointDataSchema } from '../checkpoint/checkpoint_data.js';
 import { ContractClassPublicSchema, ContractInstanceWithAddressSchema, NodeInfoSchema, ProtocolContractAddressesSchema } from '../contract/index.js';
+import { L1RollupConstantsSchema } from '../epoch-helpers/index.js';
+import { ManaUsageEstimate } from '../gas/fee_math.js';
 import { GasFees } from '../gas/gas_fees.js';
-import { SiloedTag, Tag, TxScopedL2Log } from '../logs/index.js';
-import { LogFilterSchema } from '../logs/log_filter.js';
+import { LogResultSchema } from '../logs/log_result.js';
+import { PrivateLogsQuerySchema, PublicLogsQuerySchema } from '../logs/logs_query.js';
+import { L2ToL1MembershipWitnessSchema } from '../messaging/l2_to_l1_membership.js';
+import { CheckpointAttestation } from '../p2p/checkpoint_attestation.js';
 import { optional, schemas } from '../schemas/schemas.js';
 import { MerkleTreeId } from '../trees/merkle_tree_id.js';
 import { NullifierMembershipWitness } from '../trees/nullifier_membership_witness.js';
 import { PublicDataWitness } from '../trees/public_data_witness.js';
-import { BlockHeader, PublicSimulationOutput, Tx, TxHash, TxReceipt, TxValidationResultSchema, indexedTxSchema } from '../tx/index.js';
+import { GetTxReceiptOptionsSchema, PublicSimulationOutput, SimulationOverrides, Tx, TxHash, TxReceiptSchema, TxValidationResultSchema, indexedTxSchema } from '../tx/index.js';
 import { SingleValidatorStatsSchema, ValidatorsStatsSchema } from '../validators/schemas.js';
 import { getVersioningResponseHandler } from '../versioning/index.js';
 import { AllowedElementSchema } from './allowed_element.js';
 import { MAX_RPC_BLOCKS_LEN, MAX_RPC_CHECKPOINTS_LEN, MAX_RPC_LEN, MAX_RPC_TXS_LEN } from './api_limit.js';
-import { GetContractClassLogsResponseSchema, GetPublicLogsResponseSchema } from './get_logs_response.js';
+import { BlockIncludeOptionsSchema, BlockResponseSchema, BlocksIncludeOptionsSchema } from './block_response.js';
+import { CheckpointTagSchema } from './chain_tips.js';
+import { CheckpointParameterSchema } from './checkpoint_parameter.js';
+import { CheckpointIncludeOptionsSchema, CheckpointResponseSchema } from './checkpoint_response.js';
+import { GetTxByHashOptionsSchema } from './get_tx_by_hash_options.js';
+import { PeerInfoSchema, ProposalsForSlotSchema } from './p2p.js';
 import { WorldStateSyncStatusSchema } from './world_state.js';
-const MAX_SIGNATURES_PER_REGISTER_CALL = 100;
-const MAX_SIGNATURE_LEN = 10000;
+export { GetTxByHashOptionsSchema } from './get_tx_by_hash_options.js';
 export const AztecNodeApiSchema = {
-    getL2Tips: z.function().args().returns(L2TipsSchema),
-    getWorldStateSyncStatus: z.function().args().returns(WorldStateSyncStatusSchema),
-    findLeavesIndexes: z.function().args(BlockParameterSchema, z.nativeEnum(MerkleTreeId), z.array(schemas.Fr).max(MAX_RPC_LEN)).returns(z.array(optional(dataInBlockSchemaFor(schemas.BigInt)))),
-    getNullifierMembershipWitness: z.function().args(BlockParameterSchema, schemas.Fr).returns(NullifierMembershipWitness.schema.optional()),
-    getLowNullifierMembershipWitness: z.function().args(BlockParameterSchema, schemas.Fr).returns(NullifierMembershipWitness.schema.optional()),
-    getPublicDataWitness: z.function().args(BlockParameterSchema, schemas.Fr).returns(PublicDataWitness.schema.optional()),
-    getBlockHashMembershipWitness: z.function().args(BlockParameterSchema, BlockHash.schema).returns(MembershipWitness.schemaFor(ARCHIVE_HEIGHT).optional()),
-    getNoteHashMembershipWitness: z.function().args(BlockParameterSchema, schemas.Fr).returns(MembershipWitness.schemaFor(NOTE_HASH_TREE_HEIGHT).optional()),
-    getL1ToL2MessageMembershipWitness: z.function().args(BlockParameterSchema, schemas.Fr).returns(z.tuple([
-        schemas.BigInt,
-        SiblingPath.schemaFor(L1_TO_L2_MSG_TREE_HEIGHT)
-    ]).optional()),
-    getL1ToL2MessageBlock: z.function().args(schemas.Fr).returns(BlockNumberSchema.optional()),
-    isL1ToL2MessageSynced: z.function().args(schemas.Fr).returns(z.boolean()),
-    getL2ToL1Messages: z.function().args(EpochNumberSchema).returns(z.array(z.array(z.array(z.array(schemas.Fr))))),
-    getBlock: z.function().args(BlockParameterSchema).returns(L2Block.schema.optional()),
-    getBlockByHash: z.function().args(BlockHash.schema).returns(L2Block.schema.optional()),
-    getBlockByArchive: z.function().args(schemas.Fr).returns(L2Block.schema.optional()),
-    getBlockNumber: z.function().returns(BlockNumberSchema),
-    getProvenBlockNumber: z.function().returns(BlockNumberSchema),
-    getCheckpointedBlockNumber: z.function().returns(BlockNumberSchema),
-    isReady: z.function().returns(z.boolean()),
-    getNodeInfo: z.function().returns(NodeInfoSchema),
-    getBlocks: z.function().args(BlockNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_BLOCKS_LEN)).returns(z.array(L2Block.schema)),
-    getCheckpoints: z.function().args(CheckpointNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_CHECKPOINTS_LEN)).returns(z.array(PublishedCheckpoint.schema)),
-    getCheckpointedBlocks: z.function().args(BlockNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_BLOCKS_LEN)).returns(z.array(CheckpointedL2Block.schema)),
-    getCurrentMinFees: z.function().returns(GasFees.schema),
-    getMaxPriorityFees: z.function().returns(GasFees.schema),
-    getNodeVersion: z.function().returns(z.string()),
-    getVersion: z.function().returns(z.number()),
-    getChainId: z.function().returns(z.number()),
-    getL1ContractAddresses: z.function().returns(L1ContractAddressesSchema),
-    getProtocolContractAddresses: z.function().returns(ProtocolContractAddressesSchema),
-    registerContractFunctionSignatures: z.function().args(z.array(z.string().max(MAX_SIGNATURE_LEN)).max(MAX_SIGNATURES_PER_REGISTER_CALL)).returns(z.void()),
-    getPublicLogs: z.function().args(LogFilterSchema).returns(GetPublicLogsResponseSchema),
-    getContractClassLogs: z.function().args(LogFilterSchema).returns(GetContractClassLogsResponseSchema),
-    getPrivateLogsByTags: z.function().args(z.array(SiloedTag.schema).max(MAX_RPC_LEN), optional(z.number().gte(0)), optional(BlockHash.schema)).returns(z.array(z.array(TxScopedL2Log.schema))),
-    getPublicLogsByTagsFromContract: z.function().args(schemas.AztecAddress, z.array(Tag.schema).max(MAX_RPC_LEN), optional(z.number().gte(0)), optional(BlockHash.schema)).returns(z.array(z.array(TxScopedL2Log.schema))),
-    sendTx: z.function().args(Tx.schema).returns(z.void()),
-    getTxReceipt: z.function().args(TxHash.schema).returns(TxReceipt.schema),
-    getTxEffect: z.function().args(TxHash.schema).returns(indexedTxSchema().optional()),
-    getPendingTxs: z.function().args(optional(z.number().gte(1).lte(MAX_RPC_TXS_LEN).default(MAX_RPC_TXS_LEN)), optional(TxHash.schema)).returns(z.array(Tx.schema)),
-    getPendingTxCount: z.function().returns(z.number()),
-    getTxByHash: z.function().args(TxHash.schema).returns(Tx.schema.optional()),
-    getTxsByHash: z.function().args(z.array(TxHash.schema).max(MAX_RPC_TXS_LEN)).returns(z.array(Tx.schema)),
-    getPublicStorageAt: z.function().args(BlockParameterSchema, schemas.AztecAddress, schemas.Fr).returns(schemas.Fr),
-    getBlockHeader: z.function().args(optional(BlockParameterSchema)).returns(BlockHeader.schema.optional()),
-    getBlockHeaderByArchive: z.function().args(schemas.Fr).returns(BlockHeader.schema.optional()),
-    getValidatorsStats: z.function().returns(ValidatorsStatsSchema),
-    getValidatorStats: z.function().args(schemas.EthAddress, optional(schemas.SlotNumber), optional(schemas.SlotNumber)).returns(SingleValidatorStatsSchema.optional()),
-    simulatePublicCalls: z.function().args(Tx.schema, optional(z.boolean())).returns(PublicSimulationOutput.schema),
-    isValidTx: z.function().args(Tx.schema, optional(z.object({
-        isSimulation: optional(z.boolean()),
-        skipFeeEnforcement: optional(z.boolean())
-    }))).returns(TxValidationResultSchema),
-    getContractClass: z.function().args(schemas.Fr).returns(ContractClassPublicSchema.optional()),
-    getContract: z.function().args(schemas.AztecAddress).returns(ContractInstanceWithAddressSchema.optional()),
-    getEncodedEnr: z.function().returns(z.string().optional()),
-    getAllowedPublicSetup: z.function().args().returns(z.array(AllowedElementSchema))
+    getWorldStateSyncStatus: z.function({
+        input: z.tuple([]),
+        output: WorldStateSyncStatusSchema
+    }),
+    findLeavesIndexes: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            z.nativeEnum(MerkleTreeId),
+            z.array(schemas.Fr).max(MAX_RPC_LEN)
+        ]),
+        output: z.array(optional(dataInBlockSchemaFor(schemas.BigInt)))
+    }),
+    getNullifierMembershipWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.Fr
+        ]),
+        output: NullifierMembershipWitness.schema.optional()
+    }),
+    getLowNullifierMembershipWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.Fr
+        ]),
+        output: NullifierMembershipWitness.schema.optional()
+    }),
+    getPublicDataWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.Fr
+        ]),
+        output: PublicDataWitness.schema.optional()
+    }),
+    getBlockHashMembershipWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            BlockHash.schema
+        ]),
+        output: MembershipWitness.schemaFor(ARCHIVE_HEIGHT).optional()
+    }),
+    getNoteHashMembershipWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.Fr
+        ]),
+        output: MembershipWitness.schemaFor(NOTE_HASH_TREE_HEIGHT).optional()
+    }),
+    getL1ToL2MessageMembershipWitness: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.Fr
+        ]),
+        output: z.tuple([
+            schemas.BigInt,
+            SiblingPath.schemaFor(L1_TO_L2_MSG_TREE_HEIGHT)
+        ]).optional()
+    }),
+    getL1ToL2MessageCheckpoint: z.function({
+        input: z.tuple([
+            schemas.Fr
+        ]),
+        output: CheckpointNumberSchema.optional()
+    }),
+    getL2ToL1Messages: z.function({
+        input: z.tuple([
+            EpochNumberSchema
+        ]),
+        output: z.array(z.array(z.array(z.array(schemas.Fr))))
+    }),
+    // Reads Outbox roots lazily, pinned to the node's synced L1 block. Caveat: cached roots that are
+    // sealed and L1-finalized are not re-validated, so a reorg deeper than L1 finality could leave the
+    // node serving a witness against a no-longer-canonical root.
+    getL2ToL1MembershipWitness: z.function({
+        input: z.tuple([
+            TxHash.schema,
+            schemas.Fr,
+            optional(schemas.Integer)
+        ]),
+        output: L2ToL1MembershipWitnessSchema.optional()
+    }),
+    getBlockNumber: z.function({
+        input: z.tuple([
+            optional(BlockTagWithoutLatestSchema)
+        ]),
+        output: BlockNumberSchema
+    }),
+    getCheckpointNumber: z.function({
+        input: z.tuple([
+            optional(CheckpointTagSchema)
+        ]),
+        output: CheckpointNumberSchema
+    }),
+    getChainTips: z.function({
+        input: z.tuple([]),
+        output: L2TipsSchema
+    }),
+    getL1Constants: z.function({
+        input: z.tuple([]),
+        output: L1RollupConstantsSchema
+    }),
+    getSyncedL2SlotNumber: z.function({
+        input: z.tuple([]),
+        output: SlotNumberSchema.optional()
+    }),
+    getSyncedL2EpochNumber: z.function({
+        input: z.tuple([]),
+        output: EpochNumberSchema.optional()
+    }),
+    getSyncedL1Timestamp: z.function({
+        input: z.tuple([]),
+        output: schemas.BigInt.optional()
+    }),
+    getCheckpointsData: z.function({
+        input: z.tuple([
+            CheckpointsQuerySchema
+        ]),
+        output: z.array(CheckpointDataSchema)
+    }),
+    getBlock: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            optional(BlockIncludeOptionsSchema)
+        ]),
+        output: BlockResponseSchema.optional()
+    }),
+    getBlockData: z.function({
+        input: z.tuple([
+            BlockParameterSchema
+        ]),
+        output: BlockDataSchema.optional()
+    }),
+    getBlocks: z.function({
+        input: z.tuple([
+            BlockNumberPositiveSchema,
+            z.number().gt(0).lte(MAX_RPC_BLOCKS_LEN),
+            optional(BlocksIncludeOptionsSchema)
+        ]),
+        output: z.array(BlockResponseSchema)
+    }),
+    getCheckpoint: z.function({
+        input: z.tuple([
+            CheckpointParameterSchema,
+            optional(CheckpointIncludeOptionsSchema)
+        ]),
+        output: CheckpointResponseSchema.optional()
+    }),
+    getCheckpoints: z.function({
+        input: z.tuple([
+            CheckpointNumberPositiveSchema,
+            z.number().gt(0).lte(MAX_RPC_CHECKPOINTS_LEN),
+            optional(CheckpointIncludeOptionsSchema)
+        ]),
+        output: z.array(CheckpointResponseSchema)
+    }),
+    isReady: z.function({
+        input: z.tuple([]),
+        output: z.boolean()
+    }),
+    getNodeInfo: z.function({
+        input: z.tuple([]),
+        output: NodeInfoSchema
+    }),
+    getCurrentMinFees: z.function({
+        input: z.tuple([]),
+        output: GasFees.schema
+    }),
+    getPredictedMinFees: z.function({
+        input: z.tuple([
+            optional(z.nativeEnum(ManaUsageEstimate))
+        ]),
+        output: z.array(GasFees.schema)
+    }),
+    getMaxPriorityFees: z.function({
+        input: z.tuple([]),
+        output: GasFees.schema
+    }),
+    getNodeVersion: z.function({
+        input: z.tuple([]),
+        output: z.string()
+    }),
+    getVersion: z.function({
+        input: z.tuple([]),
+        output: z.number()
+    }),
+    getChainId: z.function({
+        input: z.tuple([]),
+        output: z.number()
+    }),
+    getL1ContractAddresses: z.function({
+        input: z.tuple([]),
+        output: L1ContractAddressesSchema
+    }),
+    getProtocolContractAddresses: z.function({
+        input: z.tuple([]),
+        output: ProtocolContractAddressesSchema
+    }),
+    getPrivateLogsByTags: z.function({
+        input: z.tuple([
+            PrivateLogsQuerySchema
+        ]),
+        output: z.array(z.array(LogResultSchema))
+    }),
+    getPublicLogsByTags: z.function({
+        input: z.tuple([
+            PublicLogsQuerySchema
+        ]),
+        output: z.array(z.array(LogResultSchema))
+    }),
+    sendTx: z.function({
+        input: z.tuple([
+            Tx.schema
+        ]),
+        output: z.void()
+    }),
+    getTxReceipt: z.function({
+        input: z.tuple([
+            TxHash.schema,
+            optional(GetTxReceiptOptionsSchema)
+        ]),
+        output: TxReceiptSchema
+    }),
+    getTxEffect: z.function({
+        input: z.tuple([
+            TxHash.schema
+        ]),
+        output: indexedTxSchema().optional()
+    }),
+    getPendingTxs: z.function({
+        input: z.tuple([
+            optional(z.number().gte(1).lte(MAX_RPC_TXS_LEN).default(MAX_RPC_TXS_LEN)),
+            optional(TxHash.schema),
+            optional(GetTxByHashOptionsSchema)
+        ]),
+        output: z.array(Tx.schema)
+    }),
+    getPendingTxCount: z.function({
+        input: z.tuple([]),
+        output: z.number()
+    }),
+    getTxByHash: z.function({
+        input: z.tuple([
+            TxHash.schema,
+            optional(GetTxByHashOptionsSchema)
+        ]),
+        output: Tx.schema.optional()
+    }),
+    getTxsByHash: z.function({
+        input: z.tuple([
+            z.array(TxHash.schema).max(MAX_RPC_TXS_LEN),
+            optional(GetTxByHashOptionsSchema)
+        ]),
+        output: z.array(Tx.schema)
+    }),
+    getPublicStorageAt: z.function({
+        input: z.tuple([
+            BlockParameterSchema,
+            schemas.AztecAddress,
+            schemas.Fr
+        ]),
+        output: schemas.Fr
+    }),
+    getValidatorsStats: z.function({
+        input: z.tuple([]),
+        output: ValidatorsStatsSchema
+    }),
+    getValidatorStats: z.function({
+        input: z.tuple([
+            schemas.EthAddress,
+            optional(schemas.SlotNumber),
+            optional(schemas.SlotNumber)
+        ]),
+        output: SingleValidatorStatsSchema.optional()
+    }),
+    simulatePublicCalls: z.function({
+        input: z.tuple([
+            Tx.schema,
+            optional(z.boolean()),
+            optional(SimulationOverrides.schema)
+        ]),
+        output: PublicSimulationOutput.schema
+    }),
+    isValidTx: z.function({
+        input: z.tuple([
+            Tx.schema,
+            optional(z.object({
+                isSimulation: optional(z.boolean()).optional(),
+                skipFeeEnforcement: optional(z.boolean()).optional()
+            }))
+        ]),
+        output: TxValidationResultSchema
+    }),
+    getContractClass: z.function({
+        input: z.tuple([
+            schemas.Fr
+        ]),
+        output: ContractClassPublicSchema.optional()
+    }),
+    getContract: z.function({
+        input: z.tuple([
+            schemas.AztecAddress,
+            optional(BlockParameterSchema)
+        ]),
+        output: ContractInstanceWithAddressSchema.optional()
+    }),
+    getEncodedEnr: z.function({
+        input: z.tuple([]),
+        output: z.string().optional()
+    }),
+    getAllowedPublicSetup: z.function({
+        input: z.tuple([]),
+        output: z.array(AllowedElementSchema)
+    }),
+    getPeers: z.function({
+        input: z.tuple([
+            optional(z.boolean())
+        ]),
+        output: z.array(PeerInfoSchema)
+    }),
+    getCheckpointAttestationsForSlot: z.function({
+        input: z.tuple([
+            schemas.SlotNumber,
+            optional(z.string().regex(/^0x[0-9a-fA-F]+$/))
+        ]),
+        output: z.array(CheckpointAttestation.schema)
+    }),
+    getProposalsForSlot: z.function({
+        input: z.tuple([
+            schemas.SlotNumber
+        ]),
+        output: ProposalsForSlotSchema
+    })
 };
-export function createAztecNodeClient(url, versions = {}, fetch = makeFetch([
-    1,
-    2,
-    3
-], false), batchWindowMS = 0) {
+export function createAztecNodeClient(url, versions = {}, fetch, batchWindowMS = 0, maxBatchSize, fetchOptions = {}) {
+    const rpcFetch = fetch ?? makeFetch([
+        1,
+        2,
+        3
+    ], false, undefined, fetchOptions);
     return createSafeJsonRpcClient(url, AztecNodeApiSchema, {
-        namespaceMethods: 'node',
-        fetch,
+        namespaceMethods: 'aztec',
+        fetch: rpcFetch,
         batchWindowMS,
+        maxBatchSize,
         onResponse: getVersioningResponseHandler(versions)
     });
 }

package/dest/interfaces/block-builder.d.ts

@@ -1,6 +1,7 @@
 import type { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
 import type { Fr } from '@aztec/foundation/curves/bn254';
 import type { LoggerBindings } from '@aztec/foundation/log';
+import type { BlockHash } from '../block/block_hash.js';
 import type { L2Block } from '../block/l2_block.js';
 import type { ChainConfig, SequencerConfig } from '../config/chain-config.js';
 import type { L1RollupConstants } from '../epoch-helpers/index.js';
@@ -30,43 +31,78 @@ export interface IBlockFactory extends ProcessedTxHandler {
      */
     setBlockCompleted(expectedBlockHeader?: BlockHeader): Promise<L2Block>;
 }
-export interface PublicProcessorLimits {
+/** Limits passed to the public processor for tx processing within a block. */
+export type PublicProcessorLimits = {
+    /** Maximum number of txs to process. */
     maxTransactions?: number;
-    maxBlockSize?: number;
+    /** L2 and DA gas limits. */
     maxBlockGas?: Gas;
+    /** Maximum number of blob fields allowed. */
     maxBlobFields?: number;
+    /** Deadline for processing the txs. Processor will stop as soon as it hits this time. */
     deadline?: Date;
-}
+    /** Signal for interrupting processing before the deadline. */
+    signal?: AbortSignal;
+    /** Whether this processor is building a proposal (as opposed to re-executing one). Skipping txs due to gas or blob limits is only done during proposal building. */
+    isBuildingProposal?: boolean;
+};
+/** Base fields shared by both proposer and validator block builder options. */
+type BlockBuilderOptionsBase = PublicProcessorLimits & {
+    /** Minimum number of successfully processed txs required. Block is rejected if fewer succeed. */
+    minValidTxs: number;
+};
+/** Proposer mode: redistribution params are required. */
+type ProposerBlockBuilderOptions = BlockBuilderOptionsBase & {
+    isBuildingProposal: true;
+    /** Maximum number of blocks per checkpoint, derived from the timetable. */
+    maxBlocksPerCheckpoint: number;
+    /** Per-block gas budget multiplier. Budget = (remaining / remainingBlocks) * multiplier. */
+    perBlockAllocationMultiplier: number;
+    /** Per-block budget multiplier for DA gas and blob fields. Falls back to perBlockAllocationMultiplier when unset. */
+    perBlockDAAllocationMultiplier?: number;
+};
+/** Validator mode: no redistribution params needed. */
+type ValidatorBlockBuilderOptions = BlockBuilderOptionsBase & {
+    isBuildingProposal: false;
+};
+/** Options for building a block within a checkpoint. When proposing, redistribution params are required. */
+export type BlockBuilderOptions = ProposerBlockBuilderOptions | ValidatorBlockBuilderOptions;
 export interface PublicProcessorValidator {
     preprocessValidator?: TxValidator<Tx>;
     nullifierCache?: {
         addNullifiers: (nullifiers: Buffer[]) => void;
     };
 }
-export type FullNodeBlockBuilderConfig = Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'> & Pick<ChainConfig, 'l1ChainId' | 'rollupVersion'> & Pick<SequencerConfig, 'txPublicSetupAllowListExtend' | 'fakeProcessingDelayPerTxMs' | 'fakeThrowAfterProcessingTxCount'>;
+export type FullNodeBlockBuilderConfig = Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration' | 'rollupManaLimit'> & Pick<ChainConfig, 'l1ChainId' | 'rollupVersion'> & Pick<SequencerConfig, 'txPublicSetupAllowListExtend' | 'fakeProcessingDelayPerTxMs' | 'fakeThrowAfterProcessingTxCount' | 'maxTxsPerBlock' | 'maxTxsPerCheckpoint' | 'maxL2BlockGas' | 'maxDABlockGas'>;
 export declare const FullNodeBlockBuilderConfigKeys: (keyof FullNodeBlockBuilderConfig)[];
-/** Thrown when no valid transactions are available to include in a block after processing, and this is not the first block in a checkpoint. */
-export declare class NoValidTxsError extends Error {
+/** Thrown when the number of successfully processed transactions is below the required minimum. */
+export declare class InsufficientValidTxsError extends Error {
+    readonly processedCount: number;
+    readonly minRequired: number;
     readonly failedTxs: FailedTx[];
-    constructor(failedTxs: FailedTx[]);
+    constructor(processedCount: number, minRequired: number, failedTxs: FailedTx[]);
 }
 /** Result of building a block within a checkpoint. */
 export type BuildBlockInCheckpointResult = {
     block: L2Block;
-    publicGas: Gas;
     publicProcessorDuration: number;
     numTxs: number;
     failedTxs: FailedTx[];
     usedTxs: Tx[];
-    usedTxBlobFields: number;
 };
 /** Interface for building blocks within a checkpoint context. */
 export interface ICheckpointBlockBuilder {
-    buildBlock(pendingTxs: Iterable<Tx> | AsyncIterable<Tx>, blockNumber: BlockNumber, timestamp: bigint, opts: PublicProcessorLimits): Promise<BuildBlockInCheckpointResult>;
+    /** Builds a single block within this checkpoint. Throws InsufficientValidTxsError if fewer than minValidTxs succeed. */
+    buildBlock(pendingTxs: Iterable<Tx> | AsyncIterable<Tx>, blockNumber: BlockNumber, timestamp: bigint, opts: BlockBuilderOptions): Promise<BuildBlockInCheckpointResult>;
 }
 /** Interface for creating checkpoint builders. */
 export interface ICheckpointsBuilder {
-    getFork(blockNumber: BlockNumber): Promise<MerkleTreeWriteOperations>;
+    /**
+     * Syncs world state to `blockNumber` and returns a fork of it at that block. When `blockHash` is
+     * provided it is verified against the synced block, triggering a resync on mismatch (reorg detection).
+     */
+    getFork(blockNumber: BlockNumber, blockHash?: BlockHash): Promise<MerkleTreeWriteOperations>;
     startCheckpoint(checkpointNumber: CheckpointNumber, constants: CheckpointGlobalVariables, feeAssetPriceModifier: bigint, l1ToL2Messages: Fr[], previousCheckpointOutHashes: Fr[], fork: MerkleTreeWriteOperations, bindings?: LoggerBindings): Promise<ICheckpointBlockBuilder>;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2stYnVpbGRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYmxvY2stYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNyRixPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUU1RCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDNUYsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RSxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBFLDZGQUE2RjtBQUM3RixNQUFNLFdBQVcsYUFBYyxTQUFRLGtCQUFrQjtJQUN2RDs7OztP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
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2stYnVpbGRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYmxvY2stYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNyRixPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUU1RCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN4RCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDNUYsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RSxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBFLDZG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

package/dest/interfaces/block-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-builder.d.ts","sourceRoot":"","sources":["../../src/interfaces/block-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"block-builder.d.ts","sourceRoot":"","sources":["../../src/interfaces/block-builder.ts"],"names":[],"mappings":"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"}

package/dest/interfaces/block-builder.js

@@ -5,12 +5,19 @@ export const FullNodeBlockBuilderConfigKeys = [
     'rollupVersion',
     'txPublicSetupAllowListExtend',
     'fakeProcessingDelayPerTxMs',
-    'fakeThrowAfterProcessingTxCount'
+    'fakeThrowAfterProcessingTxCount',
+    'maxTxsPerBlock',
+    'maxTxsPerCheckpoint',
+    'maxL2BlockGas',
+    'maxDABlockGas',
+    'rollupManaLimit'
 ];
-/** Thrown when no valid transactions are available to include in a block after processing, and this is not the first block in a checkpoint. */ export class NoValidTxsError extends Error {
+/** Thrown when the number of successfully processed transactions is below the required minimum. */ export class InsufficientValidTxsError extends Error {
+    processedCount;
+    minRequired;
     failedTxs;
-    constructor(failedTxs){
-        super('No valid transactions to include in block'), this.failedTxs = failedTxs;
-        this.name = 'NoValidTxsError';
+    constructor(processedCount, minRequired, failedTxs){
+        super(`Insufficient valid txs: got ${processedCount} but need ${minRequired}`), this.processedCount = processedCount, this.minRequired = minRequired, this.failedTxs = failedTxs;
+        this.name = 'InsufficientValidTxsError';
     }
 }