@aztec/stdlib 0.0.0-test.1 → 0.0.1-commit.001888fc

package/dest/interfaces/validator.d.ts

@@ -0,0 +1,368 @@
+import type { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import type { SecretValue } from '@aztec/foundation/config';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import type { Signature } from '@aztec/foundation/eth-signature';
+import type { SequencerConfig, SlasherConfig } from '@aztec/stdlib/interfaces/server';
+import type { BlockProposal, BlockProposalOptions, CheckpointAttestation, CheckpointLastBlockData, CheckpointProposal, CheckpointProposalOptions } from '@aztec/stdlib/p2p';
+import type { CheckpointHeader } from '@aztec/stdlib/rollup';
+import type { BlockHeader, Tx } from '@aztec/stdlib/tx';
+import type { PeerId } from '@libp2p/interface';
+import { z } from 'zod';
+import type { CommitteeAttestationsAndSigners } from '../block/index.js';
+import { type LocalSignerConfig, type ValidatorHASignerConfig } from '../ha-signing/index.js';
+/**
+ * Validator client configuration
+ */
+export type ValidatorClientConfig = ValidatorHASignerConfig & LocalSignerConfig & {
+    /** The private keys of the validators participating in attestation duties */
+    validatorPrivateKeys?: SecretValue<`0x${string}`[]>;
+    /** The addresses of the validators to use with remote signers */
+    validatorAddresses?: EthAddress[];
+    /** Do not run the validator */
+    disableValidator: boolean;
+    /** Temporarily disable these specific validator addresses */
+    disabledValidators: EthAddress[];
+    /** Interval between polling for new attestations from peers */
+    attestationPollingIntervalMs: number;
+    /** Whether to re-execute transactions in a block proposal before attesting */
+    validatorReexecute: boolean;
+    /** Whether to always reexecute block proposals, even for non-validator nodes or when out of the currnet committee */
+    alwaysReexecuteBlockProposals?: boolean;
+    /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
+    fishermanMode?: boolean;
+    /** Skip checkpoint proposal validation and always attest (default: false) */
+    skipCheckpointProposalValidation?: boolean;
+    /** Skip pushing re-executed blocks to archiver (default: false) */
+    skipPushProposedBlocksToArchiver?: boolean;
+    /** Agree to attest to equivocated checkpoint proposals (for testing purposes only) */
+    attestToEquivocatedProposals?: boolean;
+    /** Maximum L2 gas per block for validation. Proposals exceeding this limit are rejected. */
+    validateMaxL2BlockGas?: number;
+    /** Maximum DA gas per block for validation. Proposals exceeding this limit are rejected. */
+    validateMaxDABlockGas?: number;
+    /** Maximum transactions per block for validation. Proposals exceeding this limit are rejected. */
+    validateMaxTxsPerBlock?: number;
+    /** Maximum transactions per checkpoint for validation. Proposals exceeding this limit are rejected. */
+    validateMaxTxsPerCheckpoint?: number;
+};
+export type ValidatorClientFullConfig = ValidatorClientConfig & Pick<SequencerConfig, 'txPublicSetupAllowListExtend' | 'broadcastInvalidBlockProposal'> & Pick<SlasherConfig, 'slashBroadcastedInvalidBlockPenalty' | 'slashDuplicateProposalPenalty' | 'slashDuplicateAttestationPenalty'> & {
+    /**
+     * Whether transactions are disabled for this node
+     * @remarks This should match the property in P2PConfig. It's not picked from there to avoid circular dependencies.
+     */
+    disableTransactions?: boolean;
+};
+export declare const ValidatorClientConfigSchema: z.ZodObject<{
+    haSigningEnabled: z.ZodBoolean;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    poolMaxCount: z.ZodOptional<z.ZodNumber>;
+    poolMinCount: z.ZodOptional<z.ZodNumber>;
+    poolIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    poolConnectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+} & {
+    l1Contracts: z.ZodObject<{
+        rollupAddress: z.ZodType<EthAddress, z.ZodTypeDef, EthAddress>;
+    }, "strip", z.ZodTypeAny, {
+        rollupAddress: EthAddress;
+    }, {
+        rollupAddress: EthAddress;
+    }>;
+    nodeId: z.ZodString;
+    pollingIntervalMs: z.ZodNumber;
+    signingTimeoutMs: z.ZodNumber;
+    maxStuckDutiesAgeMs: z.ZodOptional<z.ZodNumber>;
+    cleanupOldDutiesAfterHours: z.ZodOptional<z.ZodNumber>;
+    dataDirectory: z.ZodOptional<z.ZodString>;
+    dataStoreMapSizeKb: z.ZodNumber;
+    signingProtectionMapSizeKb: z.ZodOptional<z.ZodNumber>;
+} & {
+    validatorAddresses: z.ZodOptional<z.ZodArray<z.ZodType<EthAddress, any, string>, "many">>;
+    disableValidator: z.ZodBoolean;
+    disabledValidators: z.ZodArray<z.ZodType<EthAddress, any, string>, "many">;
+    attestationPollingIntervalMs: z.ZodNumber;
+    validatorReexecute: z.ZodBoolean;
+    alwaysReexecuteBlockProposals: z.ZodOptional<z.ZodBoolean>;
+    fishermanMode: z.ZodOptional<z.ZodBoolean>;
+    skipCheckpointProposalValidation: z.ZodOptional<z.ZodBoolean>;
+    skipPushProposedBlocksToArchiver: z.ZodOptional<z.ZodBoolean>;
+    attestToEquivocatedProposals: z.ZodOptional<z.ZodBoolean>;
+    validateMaxL2BlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxDABlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerCheckpoint: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    l1Contracts: {
+        rollupAddress: EthAddress;
+    };
+    nodeId: string;
+    pollingIntervalMs: number;
+    signingTimeoutMs: number;
+    maxStuckDutiesAgeMs?: number | undefined;
+    cleanupOldDutiesAfterHours?: number | undefined;
+    haSigningEnabled: boolean;
+    databaseUrl?: string | undefined;
+    poolMaxCount?: number | undefined;
+    poolMinCount?: number | undefined;
+    poolIdleTimeoutMs?: number | undefined;
+    poolConnectionTimeoutMs?: number | undefined;
+    dataDirectory?: string | undefined;
+    dataStoreMapSizeKb: number;
+    signingProtectionMapSizeKb?: number | undefined;
+    validatorAddresses?: EthAddress[] | undefined;
+    disableValidator: boolean;
+    disabledValidators: EthAddress[];
+    attestationPollingIntervalMs: number;
+    validatorReexecute: boolean;
+    alwaysReexecuteBlockProposals?: boolean | undefined;
+    fishermanMode?: boolean | undefined;
+    skipCheckpointProposalValidation?: boolean | undefined;
+    skipPushProposedBlocksToArchiver?: boolean | undefined;
+    attestToEquivocatedProposals?: boolean | undefined;
+    validateMaxL2BlockGas?: number | undefined;
+    validateMaxDABlockGas?: number | undefined;
+    validateMaxTxsPerBlock?: number | undefined;
+    validateMaxTxsPerCheckpoint?: number | undefined;
+}, {
+    l1Contracts: {
+        rollupAddress: EthAddress;
+    };
+    nodeId: string;
+    pollingIntervalMs: number;
+    signingTimeoutMs: number;
+    maxStuckDutiesAgeMs?: number | undefined;
+    cleanupOldDutiesAfterHours?: number | undefined;
+    haSigningEnabled: boolean;
+    databaseUrl?: string | undefined;
+    poolMaxCount?: number | undefined;
+    poolMinCount?: number | undefined;
+    poolIdleTimeoutMs?: number | undefined;
+    poolConnectionTimeoutMs?: number | undefined;
+    dataDirectory?: string | undefined;
+    dataStoreMapSizeKb: number;
+    signingProtectionMapSizeKb?: number | undefined;
+    validatorAddresses?: string[] | undefined;
+    disableValidator: boolean;
+    disabledValidators: string[];
+    attestationPollingIntervalMs: number;
+    validatorReexecute: boolean;
+    alwaysReexecuteBlockProposals?: boolean | undefined;
+    fishermanMode?: boolean | undefined;
+    skipCheckpointProposalValidation?: boolean | undefined;
+    skipPushProposedBlocksToArchiver?: boolean | undefined;
+    attestToEquivocatedProposals?: boolean | undefined;
+    validateMaxL2BlockGas?: number | undefined;
+    validateMaxDABlockGas?: number | undefined;
+    validateMaxTxsPerBlock?: number | undefined;
+    validateMaxTxsPerCheckpoint?: number | undefined;
+}>;
+export declare const ValidatorClientFullConfigSchema: z.ZodObject<{
+    haSigningEnabled: z.ZodBoolean;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    poolMaxCount: z.ZodOptional<z.ZodNumber>;
+    poolMinCount: z.ZodOptional<z.ZodNumber>;
+    poolIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    poolConnectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+} & {
+    l1Contracts: z.ZodObject<{
+        rollupAddress: z.ZodType<EthAddress, z.ZodTypeDef, EthAddress>;
+    }, "strip", z.ZodTypeAny, {
+        rollupAddress: EthAddress;
+    }, {
+        rollupAddress: EthAddress;
+    }>;
+    nodeId: z.ZodString;
+    pollingIntervalMs: z.ZodNumber;
+    signingTimeoutMs: z.ZodNumber;
+    maxStuckDutiesAgeMs: z.ZodOptional<z.ZodNumber>;
+    cleanupOldDutiesAfterHours: z.ZodOptional<z.ZodNumber>;
+    dataDirectory: z.ZodOptional<z.ZodString>;
+    dataStoreMapSizeKb: z.ZodNumber;
+    signingProtectionMapSizeKb: z.ZodOptional<z.ZodNumber>;
+} & {
+    validatorAddresses: z.ZodOptional<z.ZodArray<z.ZodType<EthAddress, any, string>, "many">>;
+    disableValidator: z.ZodBoolean;
+    disabledValidators: z.ZodArray<z.ZodType<EthAddress, any, string>, "many">;
+    attestationPollingIntervalMs: z.ZodNumber;
+    validatorReexecute: z.ZodBoolean;
+    alwaysReexecuteBlockProposals: z.ZodOptional<z.ZodBoolean>;
+    fishermanMode: z.ZodOptional<z.ZodBoolean>;
+    skipCheckpointProposalValidation: z.ZodOptional<z.ZodBoolean>;
+    skipPushProposedBlocksToArchiver: z.ZodOptional<z.ZodBoolean>;
+    attestToEquivocatedProposals: z.ZodOptional<z.ZodBoolean>;
+    validateMaxL2BlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxDABlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerCheckpoint: z.ZodOptional<z.ZodNumber>;
+} & {
+    txPublicSetupAllowListExtend: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        address: import("@aztec/foundation/schemas").ZodFor<import("../aztec-address/index.js").AztecAddress>;
+        selector: import("@aztec/foundation/schemas").ZodFor<import("../abi/function_selector.js").FunctionSelector>;
+        onlySelf: z.ZodOptional<z.ZodBoolean>;
+        rejectNullMsgSender: z.ZodOptional<z.ZodBoolean>;
+        calldataLength: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        address: import("../aztec-address/index.js").AztecAddress;
+        selector: import("../abi/function_selector.js").FunctionSelector;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    }, {
+        address?: any;
+        selector?: any;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    }>, z.ZodObject<{
+        classId: import("@aztec/foundation/schemas").ZodFor<Fr>;
+        selector: import("@aztec/foundation/schemas").ZodFor<import("../abi/function_selector.js").FunctionSelector>;
+        onlySelf: z.ZodOptional<z.ZodBoolean>;
+        rejectNullMsgSender: z.ZodOptional<z.ZodBoolean>;
+        calldataLength: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        classId: Fr;
+        selector: import("../abi/function_selector.js").FunctionSelector;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    }, {
+        classId?: any;
+        selector?: any;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    }>]>, "many">>;
+    broadcastInvalidBlockProposal: z.ZodOptional<z.ZodBoolean>;
+    slashBroadcastedInvalidBlockPenalty: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
+    slashDuplicateProposalPenalty: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
+    slashDuplicateAttestationPenalty: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
+    disableTransactions: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    l1Contracts: {
+        rollupAddress: EthAddress;
+    };
+    nodeId: string;
+    pollingIntervalMs: number;
+    signingTimeoutMs: number;
+    maxStuckDutiesAgeMs?: number | undefined;
+    cleanupOldDutiesAfterHours?: number | undefined;
+    haSigningEnabled: boolean;
+    databaseUrl?: string | undefined;
+    poolMaxCount?: number | undefined;
+    poolMinCount?: number | undefined;
+    poolIdleTimeoutMs?: number | undefined;
+    poolConnectionTimeoutMs?: number | undefined;
+    dataDirectory?: string | undefined;
+    dataStoreMapSizeKb: number;
+    signingProtectionMapSizeKb?: number | undefined;
+    validatorAddresses?: EthAddress[] | undefined;
+    disableValidator: boolean;
+    disabledValidators: EthAddress[];
+    attestationPollingIntervalMs: number;
+    validatorReexecute: boolean;
+    alwaysReexecuteBlockProposals?: boolean | undefined;
+    fishermanMode?: boolean | undefined;
+    skipCheckpointProposalValidation?: boolean | undefined;
+    skipPushProposedBlocksToArchiver?: boolean | undefined;
+    attestToEquivocatedProposals?: boolean | undefined;
+    validateMaxL2BlockGas?: number | undefined;
+    validateMaxDABlockGas?: number | undefined;
+    validateMaxTxsPerBlock?: number | undefined;
+    validateMaxTxsPerCheckpoint?: number | undefined;
+    txPublicSetupAllowListExtend?: ({
+        address: import("../aztec-address/index.js").AztecAddress;
+        selector: import("../abi/function_selector.js").FunctionSelector;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    } | {
+        classId: Fr;
+        selector: import("../abi/function_selector.js").FunctionSelector;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    })[] | undefined;
+    broadcastInvalidBlockProposal?: boolean | undefined;
+    slashBroadcastedInvalidBlockPenalty: bigint;
+    slashDuplicateProposalPenalty: bigint;
+    slashDuplicateAttestationPenalty: bigint;
+    disableTransactions?: boolean | undefined;
+}, {
+    l1Contracts: {
+        rollupAddress: EthAddress;
+    };
+    nodeId: string;
+    pollingIntervalMs: number;
+    signingTimeoutMs: number;
+    maxStuckDutiesAgeMs?: number | undefined;
+    cleanupOldDutiesAfterHours?: number | undefined;
+    haSigningEnabled: boolean;
+    databaseUrl?: string | undefined;
+    poolMaxCount?: number | undefined;
+    poolMinCount?: number | undefined;
+    poolIdleTimeoutMs?: number | undefined;
+    poolConnectionTimeoutMs?: number | undefined;
+    dataDirectory?: string | undefined;
+    dataStoreMapSizeKb: number;
+    signingProtectionMapSizeKb?: number | undefined;
+    validatorAddresses?: string[] | undefined;
+    disableValidator: boolean;
+    disabledValidators: string[];
+    attestationPollingIntervalMs: number;
+    validatorReexecute: boolean;
+    alwaysReexecuteBlockProposals?: boolean | undefined;
+    fishermanMode?: boolean | undefined;
+    skipCheckpointProposalValidation?: boolean | undefined;
+    skipPushProposedBlocksToArchiver?: boolean | undefined;
+    attestToEquivocatedProposals?: boolean | undefined;
+    validateMaxL2BlockGas?: number | undefined;
+    validateMaxDABlockGas?: number | undefined;
+    validateMaxTxsPerBlock?: number | undefined;
+    validateMaxTxsPerCheckpoint?: number | undefined;
+    txPublicSetupAllowListExtend?: ({
+        address?: any;
+        selector?: any;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    } | {
+        classId?: any;
+        selector?: any;
+        onlySelf?: boolean | undefined;
+        rejectNullMsgSender?: boolean | undefined;
+        calldataLength?: number | undefined;
+    })[] | undefined;
+    broadcastInvalidBlockProposal?: boolean | undefined;
+    slashBroadcastedInvalidBlockPenalty: string | number | bigint;
+    slashDuplicateProposalPenalty: string | number | bigint;
+    slashDuplicateAttestationPenalty: string | number | bigint;
+    disableTransactions?: boolean | undefined;
+}>;
+export type CreateCheckpointProposalLastBlockData = Omit<CheckpointLastBlockData, 'txHashes'> & {
+    txs: Tx[];
+};
+export interface Validator {
+    start(): Promise<void>;
+    updateConfig(config: Partial<ValidatorClientFullConfig>): void;
+    createBlockProposal(blockHeader: BlockHeader, indexWithinCheckpoint: number, inHash: Fr, archive: Fr, txs: Tx[], proposerAddress: EthAddress | undefined, options: BlockProposalOptions): Promise<BlockProposal | undefined>;
+    /** Creates a checkpoint proposal for the last block in a checkpoint */
+    createCheckpointProposal(checkpointHeader: CheckpointHeader, archive: Fr, feeAssetPriceModifier: bigint, lastBlockInfo: CreateCheckpointProposalLastBlockData | undefined, proposerAddress: EthAddress | undefined, options: CheckpointProposalOptions): Promise<CheckpointProposal>;
+    /**
+     * Validate a block proposal from a peer.
+     * Note: Validators do NOT attest to individual blocks - attestations are only for checkpoint proposals.
+     * @returns true if the proposal is valid, false otherwise
+     */
+    validateBlockProposal(proposal: BlockProposal, sender: PeerId): Promise<boolean>;
+    /**
+     * Validate and attest to a checkpoint proposal from a peer.
+     * @returns Checkpoint attestations if valid, undefined otherwise
+     */
+    attestToCheckpointProposal(proposal: CheckpointProposal, sender: PeerId): Promise<CheckpointAttestation[] | undefined>;
+    broadcastBlockProposal(proposal: BlockProposal): Promise<void>;
+    /** Collect own attestations for a checkpoint proposal (used when skipping p2p attestation collection) */
+    collectOwnAttestations(proposal: CheckpointProposal): Promise<CheckpointAttestation[]>;
+    /** Collect attestations from the p2p network for a checkpoint proposal */
+    collectAttestations(proposal: CheckpointProposal, required: number, deadline: Date): Promise<CheckpointAttestation[]>;
+    signAttestationsAndSigners(attestationsAndSigners: CommitteeAttestationsAndSigners, proposer: EthAddress, slot: SlotNumber, blockNumber: BlockNumber | CheckpointNumber): Promise<Signature>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdG9yLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW50ZXJmYWNlcy92YWxpZGF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLGdCQUFnQixFQUFFLFVBQVUsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pHLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzVELE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUVqRSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsYUFBYSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDdEYsT0FBTyxLQUFLLEVBQ1YsYUFBYSxFQUNiLG9CQUFvQixFQUNwQixxQkFBcUIsRUFDckIsdUJBQXVCLEVBQ3ZCLGtCQUFrQixFQUNsQix5QkFBeUIsRUFDMUIsTUFBTSxtQkFBbUIsQ0FBQztBQUMzQixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQzdELE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxFQUFFLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUV4RCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNoRCxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sS0FBSyxFQUFFLCtCQUErQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDekUsT0FBTyxFQUNMLEtBQUssaUJBQWlCLEVBRXRCLEtBQUssdUJBQXVCLEVBRTdCLE1BQU0sd0JBQXdCLENBQUM7QUFHaEM7O0dBRUc7QUFDSCxNQUFNLE1BQU0scUJBQXFCLEdBQUcsdUJBQXVCLEdBQ3pELGlCQUFpQixHQUFHO0lBQ2xCLDZFQUE2RTtJQUM3RSxvQkFBb0IsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQztJQUVwRCxpRUFBaUU7SUFDakUsa0JBQWtCLENBQUMsRUFBRSxVQUFVLEVBQUUsQ0FBQztJQUVsQywrQkFBK0I7SUFDL0IsZ0JBQWdCLEVBQUUsT0FBTyxDQUFDO0lBRTFCLDZEQUE2RDtJQUM3RCxrQkFBa0IsRUFBRSxVQUFVLEVBQUUsQ0FBQztJQUVqQywrREFBK0Q7SUFDL0QsNEJBQTRCLEVBQUUsTUFBTSxDQUFDO0lBRXJDLDhFQUE4RTtJQUM5RSxrQkFBa0IsRUFBRSxPQUFPLENBQUM7SUFFNUIscUhBQXFIO0lBQ3JILDZCQUE2QixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBRXhDLGlKQUFpSjtJQUNqSixhQUFhLENBQUMsRUFBRSxPQUFPLENBQUM7SUFFeEIsNkVBQTZFO0lBQzdFLGdDQUFnQyxDQUFDLEVBQUUsT0FBTyxDQUFDO0lBRTNDLG1FQUFtRTtJQUNuRSxnQ0FBZ0MsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUUzQyxzRkFBc0Y7SUFDdEYsNEJBQTRCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFFdkMsNEZBQTRGO0lBQzVGLHFCQUFxQixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBRS9CLDRGQUE0RjtJQUM1RixxQkFBcUIsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUUvQixrR0FBa0c7SUFDbEcsc0JBQXNCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFFaEMsdUdBQXVHO0lBQ3ZHLDJCQUEyQixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ3RDLENBQUM7QUFFSixNQUFNLE1BQU0seUJBQXlCLEdBQUcscUJBQXFCLEdBQzNELElBQUksQ0FBQyxlQUFlLEVBQUUsOEJBQThCLEdBQUcsK0JBQStCLENBQUMsR0FDdkYsSUFBSSxDQUNGLGFBQWEsRUFDYixxQ0FBcUMsR0FBRywrQkFBK0IsR0FBRyxrQ0FBa0MsQ0FDN0csR0FBRztJQUNGOzs7T0FHRztJQUNILG1CQUFtQixDQUFDLEVBQUUsT0FBTyxDQUFDO0NBQy9CLENBQUM7QUFFSixlQUFPLE1BQU0sMkJBQTJCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFpQnZDLENBQUM7QUFFRixlQUFPLE1BQU0sK0JBQStCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0VBUzNDLENBQUM7QUFFRixNQUFNLE1BQU0scUNBQXFDLEdBQUcsSUFBSSxDQUFDLHVCQUF1QixFQUFFLFVBQVUsQ0FBQyxHQUFHO0lBQUUsR0FBRyxFQUFFLEVBQUUsRUFBRSxDQUFBO0NBQUUsQ0FBQztBQUU5RyxNQUFNLFdBQVcsU0FBUztJQUN4QixLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3ZCLFlBQVksQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLHlCQUF5QixDQUFDLEdBQUcsSUFBSSxDQUFDO0lBRy9ELG1CQUFtQixDQUNqQixXQUFXLEVBQUUsV0FBVyxFQUN4QixxQkFBcUIsRUFBRSxNQUFNLEVBQzdCLE1BQU0sRUFBRSxFQUFFLEVBQ1YsT0FBTyxFQUFFLEVBQUUsRUFDWCxHQUFHLEVBQUUsRUFBRSxFQUFFLEVBQ1QsZUFBZSxFQUFFLFVBQVUsR0FBRyxTQUFTLEVBQ3ZDLE9BQU8sRUFBRSxvQkFBb0IsR0FDNUIsT0FBTyxDQUFDLGFBQWEsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUV0Qyx1RUFBdUU7SUFDdkUsd0JBQXdCLENBQ3RCLGdCQUFnQixFQUFFLGdCQUFnQixFQUNsQyxPQUFPLEVBQUUsRUFBRSxFQUNYLHFCQUFxQixFQUFFLE1BQU0sRUFDN0IsYUFBYSxFQUFFLHFDQUFxQyxHQUFHLFNBQVMsRUFDaEUsZUFBZSxFQUFFLFVBQVUsR0FBRyxTQUFTLEVBQ3ZDLE9BQU8sRUFBRSx5QkFBeUIsR0FDakMsT0FBTyxDQUFDLGtCQUFrQixDQUFDLENBQUM7SUFFL0I7Ozs7T0FJRztJQUNILHFCQUFxQixDQUFDLFFBQVEsRUFBRSxhQUFhLEVBQUUsTUFBTSxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUM7SUFFakY7OztPQUdHO0lBQ0gsMEJBQTBCLENBQ3hCLFFBQVEsRUFBRSxrQkFBa0IsRUFDNUIsTUFBTSxFQUFFLE1BQU0sR0FDYixPQUFPLENBQUMscUJBQXFCLEVBQUUsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUVoRCxzQkFBc0IsQ0FBQyxRQUFRLEVBQUUsYUFBYSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUUvRCx5R0FBeUc7SUFDekcsc0JBQXNCLENBQUMsUUFBUSxFQUFFLGtCQUFrQixHQUFHLE9BQU8sQ0FBQyxxQkFBcUIsRUFBRSxDQUFDLENBQUM7SUFFdkYsMEVBQTBFO0lBQzFFLG1CQUFtQixDQUFDLFFBQVEsRUFBRSxrQkFBa0IsRUFBRSxRQUFRLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxJQUFJLEdBQUcsT0FBTyxDQUFDLHFCQUFxQixFQUFFLENBQUMsQ0FBQztJQUV0SCwwQkFBMEIsQ0FDeEIsc0JBQXNCLEVBQUUsK0JBQStCLEVBQ3ZELFFBQVEsRUFBRSxVQUFVLEVBQ3BCLElBQUksRUFBRSxVQUFVLEVBQ2hCLFdBQVcsRUFBRSxXQUFXLEdBQUcsZ0JBQWdCLEdBQzFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQztDQUN2QiJ9

package/dest/interfaces/validator.d.ts.map

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

package/dest/interfaces/validator.js

@@ -0,0 +1,28 @@
+import { schemas, zodFor } from '@aztec/foundation/schemas';
+import { z } from 'zod';
+import { LocalSignerConfigSchema, ValidatorHASignerConfigSchema } from '../ha-signing/index.js';
+import { AllowedElementSchema } from './allowed_element.js';
+export const ValidatorClientConfigSchema = zodFor()(ValidatorHASignerConfigSchema.merge(LocalSignerConfigSchema).extend({
+    validatorAddresses: z.array(schemas.EthAddress).optional(),
+    disableValidator: z.boolean(),
+    disabledValidators: z.array(schemas.EthAddress),
+    attestationPollingIntervalMs: z.number().min(0),
+    validatorReexecute: z.boolean(),
+    alwaysReexecuteBlockProposals: z.boolean().optional(),
+    fishermanMode: z.boolean().optional(),
+    skipCheckpointProposalValidation: z.boolean().optional(),
+    skipPushProposedBlocksToArchiver: z.boolean().optional(),
+    attestToEquivocatedProposals: z.boolean().optional(),
+    validateMaxL2BlockGas: z.number().optional(),
+    validateMaxDABlockGas: z.number().optional(),
+    validateMaxTxsPerBlock: z.number().optional(),
+    validateMaxTxsPerCheckpoint: z.number().optional()
+}));
+export const ValidatorClientFullConfigSchema = zodFor()(ValidatorClientConfigSchema.extend({
+    txPublicSetupAllowListExtend: z.array(AllowedElementSchema).optional(),
+    broadcastInvalidBlockProposal: z.boolean().optional(),
+    slashBroadcastedInvalidBlockPenalty: schemas.BigInt,
+    slashDuplicateProposalPenalty: schemas.BigInt,
+    slashDuplicateAttestationPenalty: schemas.BigInt,
+    disableTransactions: z.boolean().optional()
+}));

package/dest/interfaces/world_state.d.ts

@@ -1,5 +1,10 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
+import type { PromiseWithResolvers } from '@aztec/foundation/promise';
 import { z } from 'zod';
+import type { BlockHash } from '../block/block_hash.js';
+import type { SnapshotDataKeys } from '../snapshots/types.js';
 import type { MerkleTreeReadOperations, MerkleTreeWriteOperations } from './merkle_tree_operations.js';
+export type { SnapshotDataKeys };
 /**
  * Defines the possible states of the world state synchronizer.
  */
@@ -10,10 +15,10 @@ export declare enum WorldStateRunningState {
     STOPPED = 3
 }
 export interface WorldStateSyncStatus {
-    latestBlockNumber: number;
+    latestBlockNumber: BlockNumber;
     latestBlockHash: string;
-    finalisedBlockNumber: number;
-    oldestHistoricBlockNumber: number;
+    finalizedBlockNumber: BlockNumber;
+    oldestHistoricBlockNumber: BlockNumber;
     treesAreSynched: boolean;
 }
 /**
@@ -31,55 +36,45 @@ export interface WorldStateSynchronizerStatus {
 }
 /** Provides writeable forks of the world state at a given block number. */
 export interface ForkMerkleTreeOperations {
-    /** Forks the world state at the given block number, defaulting to the latest one. */
-    fork(block?: number): Promise<MerkleTreeWriteOperations>;
+    /**
+     * Forks the world state at the given block number, defaulting to the latest one.
+     * @param block - The block number to fork at.
+     * @param opts - Optional parameters:
+     *  - closeDelayMs: number of milliseconds to wait before closing the fork on dispose.
+     */
+    fork(block?: BlockNumber, opts?: {
+        closeDelayMs?: number;
+    }): Promise<MerkleTreeWriteOperations>;
+    /** Backups the db to the target path. */
+    backupTo(dstPath: string, compact?: boolean): Promise<Record<Exclude<SnapshotDataKeys, 'archiver'>, string>>;
+}
+export interface ReadonlyWorldStateAccess {
+    /** Returns an instance of MerkleTreeAdminOperations that will not include uncommitted data. */
+    getCommitted(): MerkleTreeReadOperations;
     /** Gets a handle that allows reading the state as it was at the given block number. */
     getSnapshot(blockNumber: number): MerkleTreeReadOperations;
 }
 /** Defines the interface for a world state synchronizer. */
-export interface WorldStateSynchronizer extends ForkMerkleTreeOperations {
-    /**
-     * Starts the synchronizer.
-     * @returns A promise that resolves once the initial sync is completed.
-     */
-    start(): void;
-    /**
-     * Returns the current status of the synchronizer.
-     * @returns The current status of the synchronizer.
-     */
+export interface WorldStateSynchronizer extends ReadonlyWorldStateAccess, ForkMerkleTreeOperations {
+    /** Starts the synchronizer. */
+    start(): Promise<void | PromiseWithResolvers<void>>;
+    /** Returns the current status of the synchronizer. */
     status(): Promise<WorldStateSynchronizerStatus>;
-    /**
-     * Stops the synchronizer.
-     */
+    /** Stops the synchronizer and its database. */
     stop(): Promise<void>;
+    /** Stops the synchronizer from syncing, but keeps the database online. */
+    stopSync(): Promise<void>;
+    /** Resumes synching after a stopSync call. */
+    resumeSync(): void;
     /**
-     * Forces an immediate sync to an optionally provided minimum block number
-     * @param minBlockNumber - The minimum block number that we must sync to
+     * Forces an immediate sync to an optionally provided minimum block number.
+     * @param targetBlockNumber - The target block number that we must sync to. Will download unproven blocks if needed to reach it.
+     * @param blockHash - If provided, verifies the block at targetBlockNumber matches this hash. On mismatch, triggers a resync (reorg detection).
      * @returns A promise that resolves with the block number the world state was synced to
      */
-    syncImmediate(minBlockNumber?: number): Promise<number>;
-    /**
-     * Returns an instance of MerkleTreeAdminOperations that will not include uncommitted data.
-     */
-    getCommitted(): MerkleTreeReadOperations;
+    syncImmediate(minBlockNumber?: BlockNumber, blockHash?: BlockHash): Promise<BlockNumber>;
+    /** Deletes the db */
+    clear(): Promise<void>;
 }
-export declare const WorldStateSyncStatusSchema: z.ZodObject<{
-    finalisedBlockNumber: z.ZodNumber;
-    latestBlockNumber: z.ZodNumber;
-    latestBlockHash: z.ZodString;
-    oldestHistoricBlockNumber: z.ZodNumber;
-    treesAreSynched: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    finalisedBlockNumber: number;
-    latestBlockNumber: number;
-    latestBlockHash: string;
-    oldestHistoricBlockNumber: number;
-    treesAreSynched: boolean;
-}, {
-    finalisedBlockNumber: number;
-    latestBlockNumber: number;
-    latestBlockHash: string;
-    oldestHistoricBlockNumber: number;
-    treesAreSynched: boolean;
-}>;
-//# sourceMappingURL=world_state.d.ts.map
+export declare const WorldStateSyncStatusSchema: z.ZodType<WorldStateSyncStatus, z.ZodTypeDef, any>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ybGRfc3RhdGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnRlcmZhY2VzL3dvcmxkX3N0YXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQXFCLE1BQU0saUNBQWlDLENBQUM7QUFDakYsT0FBTyxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUV0RSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ3hELE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDOUQsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUseUJBQXlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUV2RyxZQUFZLEVBQUUsZ0JBQWdCLEVBQUUsQ0FBQztBQUVqQzs7R0FFRztBQUNILG9CQUFZLHNCQUFzQjtJQUNoQyxJQUFJLElBQUE7SUFDSixRQUFRLElBQUE7SUFDUixPQUFPLElBQUE7SUFDUCxPQUFPLElBQUE7Q0FDUjtBQUVELE1BQU0sV0FBVyxvQkFBb0I7SUFDbkMsaUJBQWlCLEVBQUUsV0FBVyxDQUFDO0lBQy9CLGVBQWUsRUFBRSxNQUFNLENBQUM7SUFDeEIsb0JBQW9CLEVBQUUsV0FBVyxDQUFDO0lBQ2xDLHlCQUF5QixFQUFFLFdBQVcsQ0FBQztJQUN2QyxlQUFlLEVBQUUsT0FBTyxDQUFDO0NBQzFCO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsNEJBQTRCO0lBQzNDOztPQUVHO0lBQ0gsS0FBSyxFQUFFLHNCQUFzQixDQUFDO0lBQzlCOztPQUVHO0lBQ0gsV0FBVyxFQUFFLG9CQUFvQixDQUFDO0NBQ25DO0FBRUQsMkVBQTJFO0FBQzNFLE1BQU0sV0FBVyx3QkFBd0I7SUFDdkM7Ozs7O09BS0c7SUFDSCxJQUFJLENBQUMsS0FBSyxDQUFDLEVBQUUsV0FBVyxFQUFFLElBQUksQ0FBQyxFQUFFO1FBQUUsWUFBWSxDQUFDLEVBQUUsTUFBTSxDQUFBO0tBQUUsR0FBRyxPQUFPLENBQUMseUJBQXlCLENBQUMsQ0FBQztJQUVoRyx5Q0FBeUM7SUFDekMsUUFBUSxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLGdCQUFnQixFQUFFLFVBQVUsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUM7Q0FDOUc7QUFFRCxNQUFNLFdBQVcsd0JBQXdCO0lBQ3ZDLCtGQUErRjtJQUMvRixZQUFZLElBQUksd0JBQXdCLENBQUM7SUFFekMsdUZBQXVGO0lBQ3ZGLFdBQVcsQ0FBQyxXQUFXLEVBQUUsTUFBTSxHQUFHLHdCQUF3QixDQUFDO0NBQzVEO0FBRUQsNERBQTREO0FBQzVELE1BQU0sV0FBVyxzQkFBdUIsU0FBUSx3QkFBd0IsRUFBRSx3QkFBd0I7SUFDaEcsK0JBQStCO0lBQy9CLEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxHQUFHLG9CQUFvQixDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7SUFFcEQsc0RBQXNEO0lBQ3RELE1BQU0sSUFBSSxPQUFPLENBQUMsNEJBQTRCLENBQUMsQ0FBQztJQUVoRCwrQ0FBK0M7SUFDL0MsSUFBSSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV0QiwwRUFBMEU7SUFDMUUsUUFBUSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUUxQiw4Q0FBOEM7SUFDOUMsVUFBVSxJQUFJLElBQUksQ0FBQztJQUVuQjs7Ozs7T0FLRztJQUNILGFBQWEsQ0FBQyxjQUFjLENBQUMsRUFBRSxXQUFXLEVBQUUsU0FBUyxDQUFDLEVBQUUsU0FBUyxHQUFHLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUV6RixxQkFBcUI7SUFDckIsS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUN4QjtBQUVELGVBQU8sTUFBTSwwQkFBMEIsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLG9CQUFvQixFQUFFLENBQUMsQ0FBQyxVQUFVLEVBQUUsR0FBRyxDQU14RixDQUFDIn0=

package/dest/interfaces/world_state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world_state.d.ts","sourceRoot":"","sources":["../../src/interfaces/world_state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAEvG;;GAEG;AACH,oBAAY,sBAAsB;IAChC,IAAI,IAAA;IACJ,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,OAAO,IAAA;CACR;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,sBAAsB,CAAC;IAC9B;;OAEG;IACH,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEzD,uFAAuF;IACvF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAAC;CAC5D;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB;IACtE;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEhD;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;OAIG;IACH,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExD;;OAEG;IACH,YAAY,IAAI,wBAAwB,CAAC;CAC1C;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAMK,CAAC"}
+{"version":3,"file":"world_state.d.ts","sourceRoot":"","sources":["../../src/interfaces/world_state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAEvG,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;GAEG;AACH,oBAAY,sBAAsB;IAChC,IAAI,IAAA;IACJ,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,OAAO,IAAA;CACR;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,WAAW,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,WAAW,CAAC;IAClC,yBAAyB,EAAE,WAAW,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,sBAAsB,CAAC;IAC9B;;OAEG;IACH,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEhG,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9G;AAED,MAAM,WAAW,wBAAwB;IACvC,+FAA+F;IAC/F,YAAY,IAAI,wBAAwB,CAAC;IAEzC,uFAAuF;IACvF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAAC;CAC5D;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB,EAAE,wBAAwB;IAChG,+BAA+B;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpD,sDAAsD;IACtD,MAAM,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEhD,+CAA+C;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,0EAA0E;IAC1E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,8CAA8C;IAC9C,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;;OAKG;IACH,aAAa,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzF,qBAAqB;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAMxF,CAAC"}

package/dest/interfaces/world_state.js

@@ -1,3 +1,4 @@
+import { BlockNumberSchema } from '@aztec/foundation/branded-types';
 import { z } from 'zod';
 /**
  * Defines the possible states of the world state synchronizer.
@@ -9,9 +10,9 @@ import { z } from 'zod';
     return WorldStateRunningState;
 }({});
 export const WorldStateSyncStatusSchema = z.object({
-    finalisedBlockNumber: z.number().int().nonnegative(),
-    latestBlockNumber: z.number().int().nonnegative(),
+    finalizedBlockNumber: BlockNumberSchema,
+    latestBlockNumber: BlockNumberSchema,
     latestBlockHash: z.string(),
-    oldestHistoricBlockNumber: z.number().int().nonnegative(),
+    oldestHistoricBlockNumber: BlockNumberSchema,
     treesAreSynched: z.boolean()
 });

package/dest/kernel/claimed_length_array.d.ts

@@ -0,0 +1,34 @@
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import { BufferReader, FieldReader, type Serializable, type Tuple } from '@aztec/foundation/serialize';
+import { inspect } from 'util';
+export declare class ClaimedLengthArray<T extends Serializable, N extends number> {
+    array: Tuple<T, N>;
+    claimedLength: number;
+    constructor(array: Tuple<T, N>, claimedLength: number);
+    static fromBuffer<T extends Serializable, N extends number>(buffer: Buffer | BufferReader, deserializer: {
+        fromBuffer: (reader: BufferReader) => T;
+    }, arrayLength: N): ClaimedLengthArray<T, N>;
+    toBuffer(): Buffer<ArrayBufferLike>;
+    static fromFields<T extends Serializable, N extends number>(fields: Fr[] | FieldReader, deserializer: {
+        fromFields: (reader: FieldReader) => T;
+    }, arrayLength: N): ClaimedLengthArray<T, N>;
+    toFields(): Fr[];
+    static empty<T extends Serializable, N extends number>(elem: {
+        empty: () => T;
+    }, arraySize: number): ClaimedLengthArray<T, N>;
+    isEmpty(): boolean;
+    getActiveItems(): T[];
+    getSize(): number;
+    [inspect.custom](): string;
+}
+export declare function ClaimedLengthArrayFromBuffer<T extends Serializable, N extends number>(deserializer: {
+    fromBuffer: (reader: BufferReader) => T;
+}, arrayLength: N): {
+    fromBuffer: (reader: BufferReader) => ClaimedLengthArray<T, N>;
+};
+export declare function ClaimedLengthArrayFromFields<T extends Serializable, N extends number>(deserializer: {
+    fromFields: (reader: FieldReader) => T;
+}, arrayLength: N): {
+    fromFields: (reader: FieldReader) => ClaimedLengthArray<T, N>;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhaW1lZF9sZW5ndGhfYXJyYXkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9rZXJuZWwvY2xhaW1lZF9sZW5ndGhfYXJyYXkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUNMLFlBQVksRUFDWixXQUFXLEVBQ1gsS0FBSyxZQUFZLEVBQ2pCLEtBQUssS0FBSyxFQUdYLE1BQU0sNkJBQTZCLENBQUM7QUFFckMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLE1BQU0sQ0FBQztBQUUvQixxQkFBYSxrQkFBa0IsQ0FBQyxDQUFDLFNBQVMsWUFBWSxFQUFFLENBQUMsU0FBUyxNQUFNO0lBRTdELEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUVsQixhQUFhLEVBQUUsTUFBTTtJQUg5QixZQUNTLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxFQUVsQixhQUFhLEVBQUUsTUFBTSxFQUMxQjtJQUVKLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQyxTQUFTLFlBQVksRUFBRSxDQUFDLFNBQVMsTUFBTSxFQUN4RCxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksRUFDN0IsWUFBWSxFQUFFO1FBQ1osVUFBVSxFQUFFLENBQUMsTUFBTSxFQUFFLFlBQVksS0FBSyxDQUFDLENBQUM7S0FDekMsRUFDRCxXQUFXLEVBQUUsQ0FBQyxHQUNiLGtCQUFrQixDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FLMUI7SUFFRCxRQUFRLDRCQUVQO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDLFNBQVMsWUFBWSxFQUFFLENBQUMsU0FBUyxNQUFNLEVBQ3hELE1BQU0sRUFBRSxFQUFFLEVBQUUsR0FBRyxXQUFXLEVBQzFCLFlBQVksRUFBRTtRQUNaLFVBQVUsRUFBRSxDQUFDLE1BQU0sRUFBRSxXQUFXLEtBQUssQ0FBQyxDQUFDO0tBQ3hDLEVBQ0QsV0FBVyxFQUFFLENBQUMsR0FDYixrQkFBa0IsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBSzFCO0lBRUQsUUFBUSxTQUVQO0lBRUQsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLFNBQVMsWUFBWSxFQUFFLENBQUMsU0FBUyxNQUFNLEVBQ25ELElBQUksRUFBRTtRQUFFLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FBQTtLQUFFLEVBQ3hCLFNBQVMsRUFBRSxNQUFNLEdBQ2hCLGtCQUFrQixDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FHMUI7SUFFRCxPQUFPLFlBRU47SUFFRCxjQUFjLElBQUksQ0FBQyxFQUFFLENBRXBCO0lBRUQsT0FBTyxXQUVOO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBT2Y7Q0FDRjtBQUVELHdCQUFnQiw0QkFBNEIsQ0FBQyxDQUFDLFNBQVMsWUFBWSxFQUFFLENBQUMsU0FBUyxNQUFNLEVBQ25GLFlBQVksRUFBRTtJQUNaLFVBQVUsRUFBRSxDQUFDLE1BQU0sRUFBRSxZQUFZLEtBQUssQ0FBQyxDQUFDO0NBQ3pDLEVBQ0QsV0FBVyxFQUFFLENBQUMsR0FDYjtJQUNELFVBQVUsRUFBRSxDQUFDLE1BQU0sRUFBRSxZQUFZLEtBQUssa0JBQWtCLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO0NBQ2hFLENBRUE7QUFFRCx3QkFBZ0IsNEJBQTRCLENBQUMsQ0FBQyxTQUFTLFlBQVksRUFBRSxDQUFDLFNBQVMsTUFBTSxFQUNuRixZQUFZLEVBQUU7SUFDWixVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsV0FBVyxLQUFLLENBQUMsQ0FBQztDQUN4QyxFQUNELFdBQVcsRUFBRSxDQUFDLEdBQ2I7SUFDRCxVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsV0FBVyxLQUFLLGtCQUFrQixDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztDQUMvRCxDQUVBIn0=

package/dest/kernel/claimed_length_array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimed_length_array.d.ts","sourceRoot":"","sources":["../../src/kernel/claimed_length_array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,KAAK,EAGX,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,qBAAa,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM;IAE7D,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAElB,aAAa,EAAE,MAAM;IAH9B,YACS,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAElB,aAAa,EAAE,MAAM,EAC1B;IAEJ,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,EACxD,MAAM,EAAE,MAAM,GAAG,YAAY,EAC7B,YAAY,EAAE;QACZ,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;KACzC,EACD,WAAW,EAAE,CAAC,GACb,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAK1B;IAED,QAAQ,4BAEP;IAED,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,EACxD,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,EAC1B,YAAY,EAAE;QACZ,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;KACxC,EACD,WAAW,EAAE,CAAC,GACb,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAK1B;IAED,QAAQ,SAEP;IAED,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,EACnD,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,EACxB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAG1B;IAED,OAAO,YAEN;IAED,cAAc,IAAI,CAAC,EAAE,CAEpB;IAED,OAAO,WAEN;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAOf;CACF;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,EACnF,YAAY,EAAE;IACZ,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;CACzC,EACD,WAAW,EAAE,CAAC,GACb;IACD,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAChE,CAEA;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,EACnF,YAAY,EAAE;IACZ,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;CACxC,EACD,WAAW,EAAE,CAAC,GACb;IACD,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC/D,CAEA"}