@aztec/stdlib 0.0.1-commit.2b2662070 → 0.0.1-commit.2c0ee1788

package/dest/interfaces/aztec-node.js

@@ -8,10 +8,8 @@ import { BlockHash } from '../block/block_hash.js';
 import { BlockParameterSchema } from '../block/block_parameter.js';
 import { CheckpointedL2Block } from '../block/checkpointed_l2_block.js';
 import { dataInBlockSchemaFor } from '../block/in_block.js';
-import { L2Block } from '../block/l2_block.js';
 import { L2TipsSchema } from '../block/l2_block_source.js';
 import { CheckpointDataSchema } from '../checkpoint/checkpoint_data.js';
-import { PublishedCheckpoint } from '../checkpoint/published_checkpoint.js';
 import { ContractClassPublicSchema, ContractInstanceWithAddressSchema, NodeInfoSchema, ProtocolContractAddressesSchema } from '../contract/index.js';
 import { ManaUsageEstimate } from '../gas/fee_math.js';
 import { GasFees } from '../gas/gas_fees.js';
@@ -26,12 +24,15 @@ import { SingleValidatorStatsSchema, ValidatorsStatsSchema } from '../validators
 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 { BlockIncludeOptionsSchema, BlockResponseSchema } from './block_response.js';
+import { ChainTipSchema, ChainTipsSchema } from './chain_tips.js';
+import { CheckpointParameterSchema } from './checkpoint_parameter.js';
+import { CheckpointIncludeOptionsSchema, CheckpointResponseSchema } from './checkpoint_response.js';
 import { GetContractClassLogsResponseSchema, GetPublicLogsResponseSchema } from './get_logs_response.js';
 import { WorldStateSyncStatusSchema } from './world_state.js';
 const MAX_SIGNATURES_PER_REGISTER_CALL = 100;
 const MAX_SIGNATURE_LEN = 10000;
 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()),
@@ -46,19 +47,22 @@ export const AztecNodeApiSchema = {
     getL1ToL2MessageCheckpoint: z.function().args(schemas.Fr).returns(CheckpointNumberSchema.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),
-    getCheckpointNumber: z.function().returns(CheckpointNumberSchema),
-    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)),
+    getBlockNumber: z.function().args(optional(ChainTipSchema)).returns(BlockNumberSchema),
+    getCheckpointNumber: z.function().args(optional(ChainTipSchema)).returns(CheckpointNumberSchema),
+    getChainTips: z.function().args().returns(ChainTipsSchema),
+    getL2Tips: z.function().args().returns(L2TipsSchema),
+    getBlockHeader: z.function().args(z.union([
+        BlockNumberSchema,
+        z.literal('latest')
+    ])).returns(BlockHeader.schema.optional()),
     getCheckpointedBlocks: z.function().args(BlockNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_BLOCKS_LEN)).returns(z.array(CheckpointedL2Block.schema)),
     getCheckpointsDataForEpoch: z.function().args(EpochNumberSchema).returns(z.array(CheckpointDataSchema)),
+    getBlock: z.function().args(BlockParameterSchema, optional(BlockIncludeOptionsSchema)).returns(BlockResponseSchema.optional()),
+    getBlocks: z.function().args(BlockNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_BLOCKS_LEN), optional(BlockIncludeOptionsSchema)).returns(z.array(BlockResponseSchema)),
+    getCheckpoint: z.function().args(CheckpointParameterSchema, optional(CheckpointIncludeOptionsSchema)).returns(CheckpointResponseSchema.optional()),
+    getCheckpoints: z.function().args(CheckpointNumberPositiveSchema, z.number().gt(0).lte(MAX_RPC_CHECKPOINTS_LEN), optional(CheckpointIncludeOptionsSchema)).returns(z.array(CheckpointResponseSchema)),
+    isReady: z.function().returns(z.boolean()),
+    getNodeInfo: z.function().returns(NodeInfoSchema),
     getCurrentMinFees: z.function().returns(GasFees.schema),
     getPredictedMinFees: z.function().args(optional(z.nativeEnum(ManaUsageEstimate))).returns(z.array(GasFees.schema)),
     getMaxPriorityFees: z.function().returns(GasFees.schema),
@@ -80,8 +84,6 @@ export const AztecNodeApiSchema = {
     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),

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"}

package/dest/interfaces/chain_tips.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { L2TipsSchema } from '../block/l2_block_source.js';
+export const ChainTipSchema = z.union([
+    z.literal('proposed'),
+    z.literal('checkpointed'),
+    z.literal('proven'),
+    z.literal('finalized')
+]);
+export const ChainTipsSchema = L2TipsSchema.omit({
+    proposedCheckpoint: true
+});

package/dest/interfaces/checkpoint_parameter.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * Selector for a checkpoint in RPC calls.
+ *
+ * Accepts a numeric checkpoint number (or `{ number }`), a slot number (`{ slot }`), a chain-tip
+ * name (e.g. `'proven'`), or `'latest'` (alias for `'proposed'` — on the checkpoint side, this
+ * means the most recent confirmed checkpoint).
+ */
+export declare const CheckpointParameterSchema: z.ZodUnion<[z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").CheckpointNumber, string | number | bigint>, z.ZodUnion<[z.ZodLiteral<"proposed">, z.ZodLiteral<"checkpointed">, z.ZodLiteral<"proven">, z.ZodLiteral<"finalized">]>, z.ZodLiteral<"latest">, 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>;
+}, "strip", z.ZodTypeAny, {
+    number: number & {
+        _branding: "CheckpointNumber";
+    };
+}, {
+    number: string | number | bigint;
+}>, z.ZodObject<{
+    slot: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, import("@aztec/foundation/branded-types").SlotNumber, string | number | bigint>;
+}, "strip", z.ZodTypeAny, {
+    slot: number & {
+        _branding: "SlotNumber";
+    };
+}, {
+    slot: string | number | bigint;
+}>]>;
+export type CheckpointParameter = z.infer<typeof CheckpointParameterSchema>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9wYXJhbWV0ZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnRlcmZhY2VzL2NoZWNrcG9pbnRfcGFyYW1ldGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFJeEI7Ozs7OztHQU1HO0FBQ0gsZUFBTyxNQUFNLHlCQUF5Qjs7Ozs7Ozs7Ozs7Ozs7OztJQU1wQyxDQUFDO0FBRUgsTUFBTSxNQUFNLG1CQUFtQixHQUFHLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyx5QkFBeUIsQ0FBQyxDQUFDIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint_parameter.d.ts","sourceRoot":"","sources":["../../src/interfaces/checkpoint_parameter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;IAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dest/interfaces/checkpoint_parameter.js

@@ -0,0 +1,20 @@
+import { CheckpointNumberSchema, SlotNumberSchema } from '@aztec/foundation/branded-types';
+import { z } from 'zod';
+import { ChainTipSchema } from './chain_tips.js';
+/**
+ * Selector for a checkpoint in RPC calls.
+ *
+ * Accepts a numeric checkpoint number (or `{ number }`), a slot number (`{ slot }`), a chain-tip
+ * name (e.g. `'proven'`), or `'latest'` (alias for `'proposed'` — on the checkpoint side, this
+ * means the most recent confirmed checkpoint).
+ */ export const CheckpointParameterSchema = z.union([
+    CheckpointNumberSchema,
+    ChainTipSchema,
+    z.literal('latest'),
+    z.object({
+        number: CheckpointNumberSchema
+    }),
+    z.object({
+        slot: SlotNumberSchema
+    })
+]);