@aztec/stdlib 0.0.1-commit.5daedc8 → 0.0.1-commit.6201a7b05

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

@@ -1,15 +1,16 @@
-import type { Fr } from '@aztec/foundation/fields';
-import type { Timer } from '@aztec/foundation/timer';
+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 { L2Block } from '../block/l2_block.js';
 import type { ChainConfig, SequencerConfig } from '../config/chain-config.js';
 import type { L1RollupConstants } from '../epoch-helpers/index.js';
 import type { Gas } from '../gas/gas.js';
-import type { MerkleTreeWriteOperations } from '../trees/index.js';
 import type { BlockHeader } from '../tx/block_header.js';
-import type { GlobalVariables } from '../tx/global_variables.js';
+import type { CheckpointGlobalVariables, GlobalVariables } from '../tx/global_variables.js';
 import type { FailedTx, ProcessedTx } from '../tx/processed_tx.js';
 import { Tx } from '../tx/tx.js';
 import type { TxValidator } from '../tx/validator/tx_validator.js';
+import type { MerkleTreeWriteOperations } from './merkle_tree_operations.js';
 import type { ProcessedTxHandler } from './processed-tx-handler.js';
 /** The interface to a block builder. Generates an L2 block out of a set of processed txs. */
 export interface IBlockFactory extends ProcessedTxHandler {
@@ -29,34 +30,70 @@ 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;
-}
+    /** 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;
+};
+/** 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 interface BuildBlockResult {
+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 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(processedCount: number, minRequired: number, failedTxs: FailedTx[]);
+}
+/** Result of building a block within a checkpoint. */
+export type BuildBlockInCheckpointResult = {
     block: L2Block;
-    publicGas: Gas;
     publicProcessorDuration: number;
-    numMsgs: number;
     numTxs: number;
     failedTxs: FailedTx[];
-    blockBuildingTimer: Timer;
     usedTxs: Tx[];
+};
+/** Interface for building blocks within a checkpoint context. */
+export interface ICheckpointBlockBuilder {
+    /** 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>;
 }
-export type FullNodeBlockBuilderConfig = Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'> & Pick<ChainConfig, 'l1ChainId' | 'rollupVersion'> & Pick<SequencerConfig, 'txPublicSetupAllowList' | 'fakeProcessingDelayPerTxMs'>;
-export interface IFullNodeBlockBuilder {
-    getConfig(): FullNodeBlockBuilderConfig;
-    updateConfig(config: Partial<FullNodeBlockBuilderConfig>): void;
-    buildBlock(txs: Iterable<Tx> | AsyncIterable<Tx>, l1ToL2Messages: Fr[], globalVariables: GlobalVariables, options: PublicProcessorLimits, fork?: MerkleTreeWriteOperations): Promise<BuildBlockResult>;
-    getFork(blockNumber: number): Promise<MerkleTreeWriteOperations>;
+/** Interface for creating checkpoint builders. */
+export interface ICheckpointsBuilder {
+    getFork(blockNumber: BlockNumber): Promise<MerkleTreeWriteOperations>;
+    startCheckpoint(checkpointNumber: CheckpointNumber, constants: CheckpointGlobalVariables, feeAssetPriceModifier: bigint, l1ToL2Messages: Fr[], previousCheckpointOutHashes: Fr[], fork: MerkleTreeWriteOperations, bindings?: LoggerBindings): Promise<ICheckpointBlockBuilder>;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2stYnVpbGRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYmxvY2stYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNuRCxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVyRCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDbkUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNqQyxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBFLDZGQUE2RjtBQUM3RixNQUFNLFdBQVcsYUFBYyxTQUFRLGtCQUFrQjtJQUN2RDs7OztPQUlHO0lBQ0gsYUFBYSxDQUFDLGVBQWUsRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVyRjs7O09BR0c7SUFDSCxNQUFNLENBQUMsR0FBRyxFQUFFLFdBQVcsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUUxQzs7T0FFRztJQUNILGlCQUFpQixDQUFDLG1CQUFtQixDQUFDLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FBQztDQUN4RTtBQUVELE1BQU0sV0FBVyxxQkFBcUI7SUFDcEMsZUFBZSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3pCLFlBQVksQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN0QixXQUFXLENBQUMsRUFBRSxHQUFHLENBQUM7SUFDbEIsYUFBYSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3ZCLFFBQVEsQ0FBQyxFQUFFLElBQUksQ0FBQztDQUNqQjtBQUVELE1BQU0sV0FBVyx3QkFBd0I7SUFDdkMsbUJBQW1CLENBQUMsRUFBRSxXQUFXLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDdEMsY0FBYyxDQUFDLEVBQUU7UUFBRSxhQUFhLEVBQUUsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLEtBQUssSUFBSSxDQUFBO0tBQUUsQ0FBQztDQUNwRTtBQUNELE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0IsS0FBSyxFQUFFLE9BQU8sQ0FBQztJQUNmLFNBQVMsRUFBRSxHQUFHLENBQUM7SUFDZix1QkFBdUIsRUFBRSxNQUFNLENBQUM7SUFDaEMsT0FBTyxFQUFFLE1BQU0sQ0FBQztJQUNoQixNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ2YsU0FBUyxFQUFFLFFBQVEsRUFBRSxDQUFDO0lBQ3RCLGtCQUFrQixFQUFFLEtBQUssQ0FBQztJQUMxQixPQUFPLEVBQUUsRUFBRSxFQUFFLENBQUM7Q0FDZjtBQUVELE1BQU0sTUFBTSwwQkFBMEIsR0FBRyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsZUFBZSxHQUFHLGNBQWMsQ0FBQyxHQUNoRyxJQUFJLENBQUMsV0FBVyxFQUFFLFdBQVcsR0FBRyxlQUFlLENBQUMsR0FDaEQsSUFBSSxDQUFDLGVBQWUsRUFBRSx3QkFBd0IsR0FBRyw0QkFBNEIsQ0FBQyxDQUFDO0FBRWpGLE1BQU0sV0FBVyxxQkFBcUI7SUFDcEMsU0FBUyxJQUFJLDBCQUEwQixDQUFDO0lBRXhDLFlBQVksQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLDBCQUEwQixDQUFDLEdBQUcsSUFBSSxDQUFDO0lBRWhFLFVBQVUsQ0FDUixHQUFHLEVBQUUsUUFBUSxDQUFDLEVBQUUsQ0FBQyxHQUFHLGFBQWEsQ0FBQyxFQUFFLENBQUMsRUFDckMsY0FBYyxFQUFFLEVBQUUsRUFBRSxFQUNwQixlQUFlLEVBQUUsZUFBZSxFQUNoQyxPQUFPLEVBQUUscUJBQXFCLEVBQzlCLElBQUksQ0FBQyxFQUFFLHlCQUF5QixHQUMvQixPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztJQUU3QixPQUFPLENBQUMsV0FBVyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMseUJBQXlCLENBQUMsQ0FBQztDQUNsRSJ9
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2stYnVpbGRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYmxvY2stYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNyRixPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUU1RCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDNUYsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RSxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBFLDZGQUE2RjtBQUM3RixNQUFNLFdBQVcsYUFBYyxTQUFRLGtCQUFrQjtJQUN2RDs7OztP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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

@@ -1 +1,23 @@
-export { };
+export const FullNodeBlockBuilderConfigKeys = [
+    'l1GenesisTime',
+    'slotDuration',
+    'l1ChainId',
+    'rollupVersion',
+    'txPublicSetupAllowListExtend',
+    'fakeProcessingDelayPerTxMs',
+    'fakeThrowAfterProcessingTxCount',
+    'maxTxsPerBlock',
+    'maxTxsPerCheckpoint',
+    'maxL2BlockGas',
+    'maxDABlockGas',
+    'rollupManaLimit'
+];
+/** Thrown when the number of successfully processed transactions is below the required minimum. */ export class InsufficientValidTxsError extends Error {
+    processedCount;
+    minRequired;
+    failedTxs;
+    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';
+    }
+}

package/dest/interfaces/block_response.d.ts

@@ -0,0 +1,156 @@
+import type { BlockNumber, CheckpointNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
+import type { IfFlag, Prettify } from '@aztec/foundation/types';
+import { z } from 'zod';
+import { BlockHash } from '../block/block_hash.js';
+import { Body } from '../block/body.js';
+import { CommitteeAttestation } from '../block/proposal/committee_attestation.js';
+import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
+import { BlockHeader } from '../tx/block_header.js';
+import { type L1PublishInfo } from './l1_publish_info.js';
+/** Options for narrowing the response of `getBlock` / `getBlocks`. */
+export type BlockIncludeOptions = {
+    /** Include the block body (tx effects). Off by default. */
+    includeTransactions?: boolean;
+    /** Include L1 publish info (populated with `published: false` if not yet on L1). Off by default. */
+    includeL1PublishInfo?: boolean;
+    /** Include committee attestations. Empty array until the block's checkpoint is published. Off by default. */
+    includeAttestations?: boolean;
+};
+export declare const BlockIncludeOptionsSchema: z.ZodType<BlockIncludeOptions>;
+/** Required metadata always present on a {@link BlockResponse}. */
+export type BlockResponseBase = {
+    /** Block header. */
+    header: BlockHeader;
+    /** Archive tree snapshot after this block. */
+    archive: AppendOnlyTreeSnapshot;
+    /** Hash of the block header. */
+    hash: BlockHash;
+    /** Checkpoint number this block belongs to. */
+    checkpointNumber: CheckpointNumber;
+    /** Position of the block within its checkpoint. */
+    indexWithinCheckpoint: IndexWithinCheckpoint;
+    /** L2 block number. */
+    number: BlockNumber;
+};
+/**
+ * RPC-surface representation of an L2 block.
+ *
+ * Generic over the include-options so that flagged fields become required when the caller passes a
+ * literal `true`. The default type argument ({@link BlockIncludeOptions}) yields the widest shape
+ * (all include-fields optional) — this is what the JSON-RPC wire layer validates against.
+ *
+ * @example
+ * const b: BlockResponse<{ includeTransactions: true }> = await node.getBlock(1, { includeTransactions: true });
+ * b.body; // required, not optional
+ */
+export type BlockResponse<Opts extends BlockIncludeOptions = BlockIncludeOptions> = Prettify<BlockResponseBase & IfFlag<BlockIncludeOptions, Opts, 'includeTransactions', {
+    body: Body;
+}> & IfFlag<BlockIncludeOptions, Opts, 'includeL1PublishInfo', {
+    l1: L1PublishInfo;
+}> & IfFlag<BlockIncludeOptions, Opts, 'includeAttestations', {
+    attestations: CommitteeAttestation[];
+}>>;
+/** Zod schema for the widest {@link BlockResponse} shape (all include-gated fields optional). */
+export declare const BlockResponseSchema: z.ZodObject<{
+    header: import("@aztec/foundation/schemas").ZodFor<BlockHeader>;
+    archive: z.ZodEffects<z.ZodObject<{
+        root: z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>;
+        nextAvailableLeafIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        root: import("@aztec/foundation/schemas").Fr;
+        nextAvailableLeafIndex: number;
+    }, {
+        root: string;
+        nextAvailableLeafIndex: string | number | bigint;
+    }>, AppendOnlyTreeSnapshot, {
+        root: string;
+        nextAvailableLeafIndex: string | number | bigint;
+    }>;
+    hash: import("@aztec/foundation/schemas").ZodFor<BlockHash>;
+    checkpointNumber: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, CheckpointNumber, string | number | bigint>;
+    indexWithinCheckpoint: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, IndexWithinCheckpoint, string | number | bigint>;
+    number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
+    body: z.ZodOptional<import("@aztec/foundation/schemas").ZodFor<Body>>;
+    l1: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        published: z.ZodLiteral<false>;
+    }, "strip", z.ZodTypeAny, {
+        published: false;
+    }, {
+        published: false;
+    }>, z.ZodObject<{
+        published: z.ZodLiteral<true>;
+        blockNumber: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
+        timestamp: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
+        blockHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        published: true;
+        blockNumber: bigint;
+        timestamp: bigint;
+        blockHash: string;
+    }, {
+        published: true;
+        blockNumber: string | number | bigint;
+        timestamp: string | number | bigint;
+        blockHash: string;
+    }>]>>;
+    attestations: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        address: z.ZodType<import("@aztec/foundation/eth-address").EthAddress, any, string>;
+        signature: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, `0x${string}`, string>, `0x${string}`, string>, import("../block/proposal/committee_attestation.js").Signature, string>;
+    }, "strip", z.ZodTypeAny, {
+        address: import("@aztec/foundation/eth-address").EthAddress;
+        signature: import("../block/proposal/committee_attestation.js").Signature;
+    }, {
+        address: string;
+        signature: string;
+    }>, CommitteeAttestation, {
+        address: string;
+        signature: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    header: BlockHeader;
+    archive: AppendOnlyTreeSnapshot;
+    hash: BlockHash;
+    checkpointNumber: number & {
+        _branding: "CheckpointNumber";
+    };
+    indexWithinCheckpoint: number & {
+        _branding: "IndexWithinCheckpoint";
+    };
+    number: number & {
+        _branding: "BlockNumber";
+    };
+    body?: Body | undefined;
+    l1?: {
+        published: false;
+    } | {
+        published: true;
+        blockNumber: bigint;
+        timestamp: bigint;
+        blockHash: string;
+    } | undefined;
+    attestations?: CommitteeAttestation[] | undefined;
+}, {
+    header?: any;
+    archive: {
+        root: string;
+        nextAvailableLeafIndex: string | number | bigint;
+    };
+    hash?: any;
+    checkpointNumber: string | number | bigint;
+    indexWithinCheckpoint: string | number | bigint;
+    number: string | number | bigint;
+    body?: any;
+    l1?: {
+        published: false;
+    } | {
+        published: true;
+        blockNumber: string | number | bigint;
+        timestamp: string | number | bigint;
+        blockHash: string;
+    } | undefined;
+    attestations?: {
+        address: string;
+        signature: string;
+    }[] | undefined;
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfcmVzcG9uc2UuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnRlcmZhY2VzL2Jsb2NrX3Jlc3BvbnNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUtBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzVHLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVoRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNuRCxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDeEMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sNENBQTRDLENBQUM7QUFDbEYsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sdUNBQXVDLENBQUM7QUFDL0UsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BELE9BQU8sRUFBRSxLQUFLLGFBQWEsRUFBdUIsTUFBTSxzQkFBc0IsQ0FBQztBQUUvRSxzRUFBc0U7QUFDdEUsTUFBTSxNQUFNLG1CQUFtQixHQUFHO0lBQ2hDLDJEQUEyRDtJQUMzRCxtQkFBbUIsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUM5QixvR0FBb0c7SUFDcEcsb0JBQW9CLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDL0IsNkdBQTZHO0lBQzdHLG1CQUFtQixDQUFDLEVBQUUsT0FBTyxDQUFDO0NBQy9CLENBQUM7QUFFRixlQUFPLE1BQU0seUJBQXlCLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsQ0FJbkUsQ0FBQztBQUVILG1FQUFtRTtBQUNuRSxNQUFNLE1BQU0saUJBQWlCLEdBQUc7SUFDOUIsb0JBQW9CO0lBQ3BCLE1BQU0sRUFBRSxXQUFXLENBQUM7SUFDcEIsOENBQThDO0lBQzlDLE9BQU8sRUFBRSxzQkFBc0IsQ0FBQztJQUNoQyxnQ0FBZ0M7SUFDaEMsSUFBSSxFQUFFLFNBQVMsQ0FBQztJQUNoQiwrQ0FBK0M7SUFDL0MsZ0JBQWdCLEVBQUUsZ0JBQWdCLENBQUM7SUFDbkMsbURBQW1EO0lBQ25ELHFCQUFxQixFQUFFLHFCQUFxQixDQUFDO0lBQzdDLHVCQUF1QjtJQUN2QixNQUFNLEVBQUUsV0FBVyxDQUFDO0NBQ3JCLENBQUM7QUFFRjs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxNQUFNLGFBQWEsQ0FBQyxJQUFJLFNBQVMsbUJBQW1CLEdBQUcsbUJBQW1CLElBQUksUUFBUSxDQUMxRixpQkFBaUIsR0FDZixNQUFNLENBQUMsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLHFCQUFxQixFQUFFO0lBQUUsSUFBSSxFQUFFLElBQUksQ0FBQTtDQUFFLENBQUMsR0FDeEUsTUFBTSxDQUFDLG1CQUFtQixFQUFFLElBQUksRUFBRSxzQkFBc0IsRUFBRTtJQUFFLEVBQUUsRUFBRSxhQUFhLENBQUE7Q0FBRSxDQUFDLEdBQ2hGLE1BQU0sQ0FBQyxtQkFBbUIsRUFBRSxJQUFJLEVBQUUscUJBQXFCLEVBQUU7SUFBRSxZQUFZLEVBQUUsb0JBQW9CLEVBQUUsQ0FBQTtDQUFFLENBQUMsQ0FDckcsQ0FBQztBQUVGLGlHQUFpRztBQUNqRyxlQUFPLE1BQU0sbUJBQW1COzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztFQVU5QixDQUFDIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"block_response.d.ts","sourceRoot":"","sources":["../../src/interfaces/block_response.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC5G,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAE/E,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAInE,CAAC;AAEH,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oBAAoB;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,sBAAsB,CAAC;IAChC,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,+CAA+C;IAC/C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mDAAmD;IACnD,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,uBAAuB;IACvB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,mBAAmB,GAAG,mBAAmB,IAAI,QAAQ,CAC1F,iBAAiB,GACf,MAAM,CAAC,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,GACxE,MAAM,CAAC,mBAAmB,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAAE,EAAE,EAAE,aAAa,CAAA;CAAE,CAAC,GAChF,MAAM,CAAC,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAAC,CACrG,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU9B,CAAC"}

package/dest/interfaces/block_response.js

@@ -0,0 +1,24 @@
+import { BlockNumberSchema, CheckpointNumberSchema, IndexWithinCheckpointSchema } from '@aztec/foundation/branded-types';
+import { z } from 'zod';
+import { BlockHash } from '../block/block_hash.js';
+import { Body } from '../block/body.js';
+import { CommitteeAttestation } from '../block/proposal/committee_attestation.js';
+import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
+import { BlockHeader } from '../tx/block_header.js';
+import { L1PublishInfoSchema } from './l1_publish_info.js';
+export const BlockIncludeOptionsSchema = z.object({
+    includeTransactions: z.boolean().optional(),
+    includeL1PublishInfo: z.boolean().optional(),
+    includeAttestations: z.boolean().optional()
+});
+/** Zod schema for the widest {@link BlockResponse} shape (all include-gated fields optional). */ export const BlockResponseSchema = z.object({
+    header: BlockHeader.schema,
+    archive: AppendOnlyTreeSnapshot.schema,
+    hash: BlockHash.schema,
+    checkpointNumber: CheckpointNumberSchema,
+    indexWithinCheckpoint: IndexWithinCheckpointSchema,
+    number: BlockNumberSchema,
+    body: Body.schema.optional(),
+    l1: L1PublishInfoSchema.optional(),
+    attestations: z.array(CommitteeAttestation.schema).optional()
+});

package/dest/interfaces/chain_tips.d.ts

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+import { type L2BlockTag, type L2Tips } from '../block/l2_block_source.js';
+/**
+ * Public chain-tip selectors usable in RPC requests.
+ * Omits internal-only tags (e.g. `proposedCheckpoint`) from {@link L2BlockTag}.
+ */
+export type ChainTip = Exclude<L2BlockTag, 'proposedCheckpoint'>;
+export declare const ChainTipSchema: z.ZodUnion<[z.ZodLiteral<"proposed">, z.ZodLiteral<"checkpointed">, z.ZodLiteral<"proven">, z.ZodLiteral<"finalized">]>;
+/**
+ * Tips of the L2 chain.
+ * Omits the sequencer-internal `proposedCheckpoint` from the public RPC surface.
+ */
+export type ChainTips = Omit<L2Tips, 'proposedCheckpoint'>;
+export declare const ChainTipsSchema: z.ZodObject<Omit<{
+    proposed: z.ZodObject<{
+        number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").BlockNumber, string | number | bigint>;
+        hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        number: number & {
+            _branding: "BlockNumber";
+        };
+        hash: string;
+    }, {
+        number: string | number | bigint;
+        hash: string;
+    }>;
+    checkpointed: z.ZodObject<{
+        block: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").BlockNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+        checkpoint: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").CheckpointNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    }, {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    }>;
+    proposedCheckpoint: z.ZodObject<{
+        block: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").BlockNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+        checkpoint: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").CheckpointNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    }, {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    }>;
+    proven: z.ZodObject<{
+        block: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").BlockNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+        checkpoint: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").CheckpointNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    }, {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    }>;
+    finalized: z.ZodObject<{
+        block: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").BlockNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+        checkpoint: z.ZodObject<{
+            number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").CheckpointNumber, string | number | bigint>;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        }, {
+            number: string | number | bigint;
+            hash: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    }, {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    }>;
+}, "proposedCheckpoint">, "strip", z.ZodTypeAny, {
+    proposed: {
+        number: number & {
+            _branding: "BlockNumber";
+        };
+        hash: string;
+    };
+    checkpointed: {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    };
+    proven: {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    };
+    finalized: {
+        block: {
+            number: number & {
+                _branding: "BlockNumber";
+            };
+            hash: string;
+        };
+        checkpoint: {
+            number: number & {
+                _branding: "CheckpointNumber";
+            };
+            hash: string;
+        };
+    };
+}, {
+    proposed: {
+        number: string | number | bigint;
+        hash: string;
+    };
+    checkpointed: {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    };
+    proven: {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    };
+    finalized: {
+        block: {
+            number: string | number | bigint;
+            hash: string;
+        };
+        checkpoint: {
+            number: string | number | bigint;
+            hash: string;
+        };
+    };
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhaW5fdGlwcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvY2hhaW5fdGlwcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFBRSxLQUFLLFVBQVUsRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSw2QkFBNkIsQ0FBQztBQUV6Rjs7O0dBR0c7QUFDSCxNQUFNLE1BQU0sUUFBUSxHQUFHLE9BQU8sQ0FBQyxVQUFVLEVBQUUsb0JBQW9CLENBQUMsQ0FBQztBQUVqRSxlQUFPLE1BQU0sY0FBYyx5SEFLSyxDQUFDO0FBRWpDOzs7R0FHRztBQUNILE1BQU0sTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLE1BQU0sRUFBRSxvQkFBb0IsQ0FBQyxDQUFDO0FBRTNELGVBQU8sTUFBTSxlQUFlOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0VBQWtELENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain_tips.d.ts","sourceRoot":"","sources":["../../src/interfaces/chain_tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAgB,MAAM,6BAA6B,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAEjE,eAAO,MAAM,cAAc,yHAKK,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE3D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkD,CAAC"}