@aztec/stdlib 0.0.0-test.1 → 0.0.1-commit.017a351

package/dest/block/l2_block_stream/l2_tips_store_base.d.ts

@@ -0,0 +1,52 @@
+import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
+import type { PublishedCheckpoint } from '../../checkpoint/published_checkpoint.js';
+import type { BlockHash } from '../block_hash.js';
+import type { L2Block } from '../l2_block.js';
+import { type L2BlockTag, type L2Tips } from '../l2_block_source.js';
+import type { L2BlockStreamEvent, L2BlockStreamEventHandler, L2BlockStreamLocalDataProvider } from './interfaces.js';
+/**
+ * Abstract base class for L2 tips stores. Provides common event handling logic
+ * while delegating storage operations to subclasses.
+ */
+export declare abstract class L2TipsStoreBase implements L2BlockStreamEventHandler, L2BlockStreamLocalDataProvider {
+    protected readonly initialBlockHash: BlockHash;
+    constructor(initialBlockHash: BlockHash);
+    /** Gets the block number for a given tag. */
+    protected abstract getTip(tag: L2BlockTag): Promise<BlockNumber | undefined>;
+    /** Sets the block number for a given tag. */
+    protected abstract setTip(tag: L2BlockTag, blockNumber: BlockNumber): Promise<void>;
+    /** Gets the block hash for a given block number. */
+    protected abstract getStoredBlockHash(blockNumber: BlockNumber): Promise<string | undefined>;
+    /** Sets the block hash for a given block number. */
+    protected abstract setBlockHash(blockNumber: BlockNumber, hash: string): Promise<void>;
+    /** Deletes all block hashes for blocks before the given block number. */
+    protected abstract deleteBlockHashesBefore(blockNumber: BlockNumber): Promise<void>;
+    /** Gets the checkpoint number for a given block number. */
+    protected abstract getCheckpointNumberForBlock(blockNumber: BlockNumber): Promise<CheckpointNumber | undefined>;
+    /** Sets the checkpoint number for a given block number. */
+    protected abstract setCheckpointNumberForBlock(blockNumber: BlockNumber, checkpointNumber: CheckpointNumber): Promise<void>;
+    /** Deletes all block-to-checkpoint mappings for blocks before the given block number. */
+    protected abstract deleteBlockToCheckpointBefore(blockNumber: BlockNumber): Promise<void>;
+    /** Gets a checkpoint by its number. */
+    protected abstract getCheckpoint(checkpointNumber: CheckpointNumber): Promise<PublishedCheckpoint | undefined>;
+    /** Saves a checkpoint. */
+    protected abstract saveCheckpointData(checkpoint: PublishedCheckpoint): Promise<void>;
+    /** Deletes all checkpoints before the given checkpoint number. */
+    protected abstract deleteCheckpointsBefore(checkpointNumber: CheckpointNumber): Promise<void>;
+    /** Runs the given function in a transaction. Memory stores can just execute immediately. */
+    protected abstract runInTransaction<T>(fn: () => Promise<T>): Promise<T>;
+    getL2BlockHash(number: BlockNumber): Promise<string | undefined>;
+    getL2Tips(): Promise<L2Tips>;
+    handleBlockStreamEvent(event: L2BlockStreamEvent): Promise<void>;
+    protected computeBlockHash(block: L2Block): Promise<string>;
+    private getBlockId;
+    private getCheckpointId;
+    private handleBlocksAdded;
+    private handleChainCheckpointed;
+    private handleChainPruned;
+    private handleChainProven;
+    private handleChainFinalized;
+    private saveTag;
+    private saveCheckpoint;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV9iYXNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX3RpcHNfc3RvcmVfYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFaEYsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwwQ0FBMEMsQ0FBQztBQUNwRixPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNsRCxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUM5QyxPQUFPLEVBSUwsS0FBSyxVQUFVLEVBQ2YsS0FBSyxNQUFNLEVBQ1osTUFBTSx1QkFBdUIsQ0FBQztBQUMvQixPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSx5QkFBeUIsRUFBRSw4QkFBOEIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRXJIOzs7R0FHRztBQUNILDhCQUFzQixlQUFnQixZQUFXLHlCQUF5QixFQUFFLDhCQUE4QjtJQUM1RixTQUFTLENBQUMsUUFBUSxDQUFDLGdCQUFnQixFQUFFLFNBQVM7SUFBMUQsWUFBK0IsZ0JBQWdCLEVBQUUsU0FBUyxFQUFJO0lBRzlELDZDQUE2QztJQUM3QyxTQUFTLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxHQUFHLE9BQU8sQ0FBQyxXQUFXLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFN0UsNkNBQTZDO0lBQzdDLFNBQVMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLEdBQUcsRUFBRSxVQUFVLEVBQUUsV0FBVyxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFcEYsb0RBQW9EO0lBQ3BELFNBQVMsQ0FBQyxRQUFRLENBQUMsa0JBQWtCLENBQUMsV0FBVyxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRTdGLG9EQUFvRDtJQUNwRCxTQUFTLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXZGLHlFQUF5RTtJQUN6RSxTQUFTLENBQUMsUUFBUSxDQUFDLHVCQUF1QixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXBGLDJEQUEyRDtJQUMzRCxTQUFTLENBQUMsUUFBUSxDQUFDLDJCQUEyQixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRWhILDJEQUEyRDtJQUMzRCxTQUFTLENBQUMsUUFBUSxDQUFDLDJCQUEyQixDQUM1QyxXQUFXLEVBQUUsV0FBVyxFQUN4QixnQkFBZ0IsRUFBRSxnQkFBZ0IsR0FDakMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRWpCLHlGQUF5RjtJQUN6RixTQUFTLENBQUMsUUFBUSxDQUFDLDZCQUE2QixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTFGLHVDQUF1QztJQUN2QyxTQUFTLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxnQkFBZ0IsRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsbUJBQW1CLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFL0csMEJBQTBCO0lBQzFCLFNBQVMsQ0FBQyxRQUFRLENBQUMsa0JBQWtCLENBQUMsVUFBVSxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV0RixrRUFBa0U7SUFDbEUsU0FBUyxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQyxnQkFBZ0IsRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFOUYsNEZBQTRGO0lBQzVGLFNBQVMsQ0FBQyxRQUFRLENBQUMsZ0JBQWdCLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxNQUFNLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFJNUQsY0FBYyxDQUFDLE1BQU0sRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FLNUU7SUFFTSxTQUFTLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQTJCbEM7SUFFWSxzQkFBc0IsQ0FBQyxLQUFLLEVBQUUsa0JBQWtCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQWtCNUU7SUFHRCxTQUFTLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBRTFEO1lBSWEsVUFBVTtZQVlWLGVBQWU7WUFnQmYsaUJBQWlCO1lBYWpCLHVCQUF1QjtZQWdCdkIsaUJBQWlCO1lBZWpCLGlCQUFpQjtZQVNqQixvQkFBb0I7WUFvQ3BCLE9BQU87WUFPUCxjQUFjO0NBUzdCIn0=

package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map

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

package/dest/block/l2_block_stream/l2_tips_store_base.js

@@ -0,0 +1,211 @@
+import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
+import { GENESIS_CHECKPOINT_HEADER_HASH } from '../l2_block_source.js';
+/**
+ * Abstract base class for L2 tips stores. Provides common event handling logic
+ * while delegating storage operations to subclasses.
+ */ export class L2TipsStoreBase {
+    initialBlockHash;
+    constructor(initialBlockHash){
+        this.initialBlockHash = initialBlockHash;
+    }
+    // Public interface implementation
+    async getL2BlockHash(number) {
+        if (number === 0) {
+            return await this.getStoredBlockHash(number) ?? this.initialBlockHash.toString();
+        }
+        return this.getStoredBlockHash(number);
+    }
+    getL2Tips() {
+        return this.runInTransaction(async ()=>{
+            const [proposedBlockId, finalizedBlockId, provenBlockId, checkpointedBlockId, proposedCheckpointBlockId] = await Promise.all([
+                this.getBlockId('proposed'),
+                this.getBlockId('finalized'),
+                this.getBlockId('proven'),
+                this.getBlockId('checkpointed'),
+                this.getBlockId('proposedCheckpoint')
+            ]);
+            const [finalizedCheckpointId, provenCheckpointId, checkpointedCheckpointId, proposedCheckpointId] = await Promise.all([
+                this.getCheckpointId('finalized'),
+                this.getCheckpointId('proven'),
+                this.getCheckpointId('checkpointed'),
+                this.getCheckpointId('proposedCheckpoint')
+            ]);
+            return {
+                proposed: proposedBlockId,
+                finalized: {
+                    block: finalizedBlockId,
+                    checkpoint: finalizedCheckpointId
+                },
+                proven: {
+                    block: provenBlockId,
+                    checkpoint: provenCheckpointId
+                },
+                checkpointed: {
+                    block: checkpointedBlockId,
+                    checkpoint: checkpointedCheckpointId
+                },
+                proposedCheckpoint: {
+                    block: proposedCheckpointBlockId,
+                    checkpoint: proposedCheckpointId
+                }
+            };
+        });
+    }
+    async handleBlockStreamEvent(event) {
+        switch(event.type){
+            case 'blocks-added':
+                await this.handleBlocksAdded(event);
+                break;
+            case 'chain-checkpointed':
+                await this.handleChainCheckpointed(event);
+                break;
+            case 'chain-pruned':
+                await this.handleChainPruned(event);
+                break;
+            case 'chain-proven':
+                await this.handleChainProven(event);
+                break;
+            case 'chain-finalized':
+                await this.handleChainFinalized(event);
+                break;
+        }
+    }
+    // Protected helper that subclasses can override for block hash computation
+    computeBlockHash(block) {
+        return block.hash().then((hash)=>hash.toString());
+    }
+    // Private implementation
+    async getBlockId(tag) {
+        const blockNumber = await this.getTip(tag);
+        if (blockNumber === undefined || blockNumber === 0) {
+            return {
+                number: BlockNumber.ZERO,
+                hash: this.initialBlockHash.toString()
+            };
+        }
+        const blockHash = await this.getStoredBlockHash(blockNumber);
+        if (!blockHash) {
+            throw new Error(`Block hash not found for block number ${blockNumber}`);
+        }
+        return {
+            number: blockNumber,
+            hash: blockHash
+        };
+    }
+    async getCheckpointId(tag) {
+        const blockNumber = await this.getTip(tag);
+        if (blockNumber === undefined || blockNumber === 0) {
+            return {
+                number: CheckpointNumber.ZERO,
+                hash: GENESIS_CHECKPOINT_HEADER_HASH.toString()
+            };
+        }
+        const checkpointNumber = await this.getCheckpointNumberForBlock(blockNumber);
+        if (checkpointNumber === undefined) {
+            return {
+                number: CheckpointNumber.ZERO,
+                hash: GENESIS_CHECKPOINT_HEADER_HASH.toString()
+            };
+        }
+        const checkpoint = await this.getCheckpoint(checkpointNumber);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found for checkpoint number ${checkpointNumber}`);
+        }
+        return {
+            number: checkpointNumber,
+            hash: checkpoint.checkpoint.hash().toString()
+        };
+    }
+    async handleBlocksAdded(event) {
+        if (event.type !== 'blocks-added') {
+            return;
+        }
+        await this.runInTransaction(async ()=>{
+            const blocks = event.blocks;
+            for (const block of blocks){
+                await this.setBlockHash(block.number, await this.computeBlockHash(block));
+            }
+            await this.setTip('proposed', blocks.at(-1).number);
+        });
+    }
+    async handleChainCheckpointed(event) {
+        if (event.type !== 'chain-checkpointed') {
+            return;
+        }
+        await this.runInTransaction(async ()=>{
+            await this.saveTag('checkpointed', event.block);
+            await this.saveCheckpoint(event.checkpoint);
+            // proposedCheckpoint is always >= checkpointed. If checkpointed has caught up
+            // or surpassed it, advance proposedCheckpoint to match.
+            const proposedCheckpointBlock = await this.getBlockId('proposedCheckpoint');
+            if (event.block.number > proposedCheckpointBlock.number) {
+                await this.saveTag('proposedCheckpoint', event.block);
+            }
+        });
+    }
+    async handleChainPruned(event) {
+        if (event.type !== 'chain-pruned') {
+            return;
+        }
+        await this.runInTransaction(async ()=>{
+            await this.saveTag('proposed', event.block);
+            await this.saveTag('checkpointed', event.block);
+            await this.saveTag('proposedCheckpoint', event.block);
+            const storeProven = await this.getBlockId('proven');
+            if (storeProven.number > event.block.number) {
+                await this.saveTag('proven', event.block);
+            }
+        });
+    }
+    async handleChainProven(event) {
+        if (event.type !== 'chain-proven') {
+            return;
+        }
+        await this.runInTransaction(async ()=>{
+            await this.saveTag('proven', event.block);
+        });
+    }
+    async handleChainFinalized(event) {
+        if (event.type !== 'chain-finalized') {
+            return;
+        }
+        await this.runInTransaction(async ()=>{
+            await this.saveTag('finalized', event.block);
+            const finalizedCheckpointNumber = await this.getCheckpointNumberForBlock(event.block.number);
+            // Cap the deletion bound at the lowest live tip. This should always be the finalized tip, but
+            // we have hit bugs where this is not the case. Deleting the block hash, block-to-checkpoint mapping,
+            // or enclosing checkpoint object for a live tip would dangle subsequent `getBlockId`/`getCheckpointId`
+            // lookups and lock the block stream into an error loop.
+            const tips = await Promise.all([
+                this.getTip('proposed'),
+                this.getTip('proposedCheckpoint'),
+                this.getTip('checkpointed'),
+                this.getTip('proven')
+            ]);
+            const liveTipBlocks = tips.filter((t)=>t !== undefined && t > 0);
+            const safeBlockBound = BlockNumber(Math.min(event.block.number, ...liveTipBlocks));
+            await this.deleteBlockHashesBefore(safeBlockBound);
+            await this.deleteBlockToCheckpointBefore(safeBlockBound);
+            if (finalizedCheckpointNumber !== undefined) {
+                const tipCheckpoints = await Promise.all(liveTipBlocks.map((b)=>this.getCheckpointNumberForBlock(b)));
+                const safeCheckpointBound = CheckpointNumber(Math.min(finalizedCheckpointNumber, ...tipCheckpoints.filter((c)=>c !== undefined && c > 0)));
+                await this.deleteCheckpointsBefore(safeCheckpointBound);
+            }
+        });
+    }
+    async saveTag(name, block) {
+        await this.setTip(name, block.number);
+        if (block.hash) {
+            await this.setBlockHash(block.number, block.hash);
+        }
+    }
+    async saveCheckpoint(publishedCheckpoint) {
+        const checkpoint = publishedCheckpoint.checkpoint;
+        const lastBlock = checkpoint.blocks.at(-1);
+        // Only store the mapping for the last block since tips only point to checkpoint boundaries
+        await Promise.all([
+            this.setCheckpointNumberForBlock(lastBlock.number, checkpoint.number),
+            this.saveCheckpointData(publishedCheckpoint)
+        ]);
+    }
+}

package/dest/block/proposal/attestations_and_signers.d.ts

@@ -0,0 +1,48 @@
+import type { ViemCommitteeAttestations } from '@aztec/ethereum/contracts';
+import { z } from 'zod';
+import { type CoordinationSignatureContext, type CoordinationSignatureType, type Signable } from '../../p2p/signature_utils.js';
+import { CommitteeAttestation, EthAddress } from './committee_attestation.js';
+export declare class CommitteeAttestationsAndSigners implements Signable {
+    attestations: CommitteeAttestation[];
+    readonly signatureContext: CoordinationSignatureContext;
+    readonly primaryType: CoordinationSignatureType;
+    constructor(attestations: CommitteeAttestation[], signatureContext: CoordinationSignatureContext);
+    static get schema(): z.ZodPipe<z.ZodObject<{
+        attestations: z.ZodArray<z.ZodPipe<z.ZodObject<{
+            address: z.ZodType<EthAddress, string, z.core.$ZodTypeInternals<EthAddress, string>>;
+            signature: z.ZodPipe<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>, z.ZodTransform<import("./committee_attestation.js").Signature, `0x${string}`>>;
+        }, z.core.$strip>, z.ZodTransform<CommitteeAttestation, {
+            address: EthAddress;
+            signature: import("./committee_attestation.js").Signature;
+        }>>>;
+        signatureContext: import("@aztec/foundation/schemas").ZodFor<CoordinationSignatureContext>;
+    }, z.core.$strip>, z.ZodTransform<CommitteeAttestationsAndSigners, {
+        attestations: CommitteeAttestation[];
+        signatureContext: CoordinationSignatureContext;
+    }>>;
+    getPayloadToSign(): Buffer;
+    static empty(signatureContext: CoordinationSignatureContext): CommitteeAttestationsAndSigners;
+    toString(): void;
+    getSigners(): EthAddress[];
+    getSignedAttestations(): CommitteeAttestation[];
+    /**
+     * Packs an array of committee attestations into the format expected by the Solidity contract
+     *
+     * @param attestations - Array of committee attestations with addresses and signatures
+     * @returns Packed attestations with bitmap and tightly packed signature/address data
+     */
+    static packAttestations(attestations: CommitteeAttestation[]): ViemCommitteeAttestations;
+    getPackedAttestations(): ViemCommitteeAttestations;
+}
+/**
+ * Malicious extension of CommitteeAttestationsAndSigners that keeps separate attestations and
+ * signers. Used for tricking the L1 contract into accepting attestations by reconstructing
+ * the correct committee commitment (which relies on the signers, ignoring the signatures)
+ * with an invalid set of attestation signatures.
+ */
+export declare class MaliciousCommitteeAttestationsAndSigners extends CommitteeAttestationsAndSigners {
+    private signers;
+    constructor(attestations: CommitteeAttestation[], signers: EthAddress[], signatureContext: CoordinationSignatureContext);
+    getSigners(): EthAddress[];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXR0ZXN0YXRpb25zX2FuZF9zaWduZXJzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svcHJvcG9zYWwvYXR0ZXN0YXRpb25zX2FuZF9zaWduZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFJM0UsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQ0wsS0FBSyw0QkFBNEIsRUFDakMsS0FBSyx5QkFBeUIsRUFDOUIsS0FBSyxRQUFRLEVBRWQsTUFBTSw4QkFBOEIsQ0FBQztBQUN0QyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsVUFBVSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFOUUscUJBQWEsK0JBQWdDLFlBQVcsUUFBUTtJQUlyRCxZQUFZLEVBQUUsb0JBQW9CLEVBQUU7YUFDM0IsZ0JBQWdCLEVBQUUsNEJBQTRCO0lBSmhFLFFBQVEsQ0FBQyxXQUFXLEVBQUUseUJBQXlCLENBQTRCO0lBRTNFLFlBQ1MsWUFBWSxFQUFFLG9CQUFvQixFQUFFLEVBQzNCLGdCQUFnQixFQUFFLDRCQUE0QixFQUM1RDtJQUVKLE1BQU0sS0FBSyxNQUFNOzs7Ozs7Ozs7Ozs7UUFPaEI7SUFFRCxnQkFBZ0IsSUFBSSxNQUFNLENBV3pCO0lBRUQsTUFBTSxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsRUFBRSw0QkFBNEIsR0FBRywrQkFBK0IsQ0FFNUY7SUFFRCxRQUFRLFNBRVA7SUFFRCxVQUFVLGlCQUVUO0lBRUQscUJBQXFCLDJCQUVwQjtJQUVEOzs7OztPQUtHO0lBQ0gsTUFBTSxDQUFDLGdCQUFnQixDQUFDLFlBQVksRUFBRSxvQkFBb0IsRUFBRSxHQUFHLHlCQUF5QixDQStEdkY7SUFFRCxxQkFBcUIsSUFBSSx5QkFBeUIsQ0FFakQ7Q0FDRjtBQUVEOzs7OztHQUtHO0FBQ0gscUJBQWEsd0NBQXlDLFNBQVEsK0JBQStCO0lBR3pGLE9BQU8sQ0FBQyxPQUFPO0lBRmpCLFlBQ0UsWUFBWSxFQUFFLG9CQUFvQixFQUFFLEVBQzVCLE9BQU8sRUFBRSxVQUFVLEVBQUUsRUFDN0IsZ0JBQWdCLEVBQUUsNEJBQTRCLEVBRy9DO0lBRVEsVUFBVSxJQUFJLFVBQVUsRUFBRSxDQUVsQztDQUNGIn0=

package/dest/block/proposal/attestations_and_signers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestations_and_signers.d.ts","sourceRoot":"","sources":["../../../src/block/proposal/attestations_and_signers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAI3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,QAAQ,EAEd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE9E,qBAAa,+BAAgC,YAAW,QAAQ;IAIrD,YAAY,EAAE,oBAAoB,EAAE;aAC3B,gBAAgB,EAAE,4BAA4B;IAJhE,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAA4B;IAE3E,YACS,YAAY,EAAE,oBAAoB,EAAE,EAC3B,gBAAgB,EAAE,4BAA4B,EAC5D;IAEJ,MAAM,KAAK,MAAM;;;;;;;;;;;;QAOhB;IAED,gBAAgB,IAAI,MAAM,CAWzB;IAED,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,4BAA4B,GAAG,+BAA+B,CAE5F;IAED,QAAQ,SAEP;IAED,UAAU,iBAET;IAED,qBAAqB,2BAEpB;IAED;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,yBAAyB,CA+DvF;IAED,qBAAqB,IAAI,yBAAyB,CAEjD;CACF;AAED;;;;;GAKG;AACH,qBAAa,wCAAyC,SAAQ,+BAA+B;IAGzF,OAAO,CAAC,OAAO;IAFjB,YACE,YAAY,EAAE,oBAAoB,EAAE,EAC5B,OAAO,EAAE,UAAU,EAAE,EAC7B,gBAAgB,EAAE,4BAA4B,EAG/C;IAEQ,UAAU,IAAI,UAAU,EAAE,CAElC;CACF"}

package/dest/block/proposal/attestations_and_signers.js

@@ -0,0 +1,121 @@
+import { hexToBuffer } from '@aztec/foundation/string';
+import { encodeAbiParameters, parseAbiParameters } from 'viem';
+import { z } from 'zod';
+import { coordinationSignatureContextSchema } from '../../p2p/signature_utils.js';
+import { CommitteeAttestation } from './committee_attestation.js';
+export class CommitteeAttestationsAndSigners {
+    attestations;
+    signatureContext;
+    primaryType;
+    constructor(attestations, signatureContext){
+        this.attestations = attestations;
+        this.signatureContext = signatureContext;
+        this.primaryType = 'AttestationsAndSigners';
+    }
+    static get schema() {
+        return z.object({
+            attestations: CommitteeAttestation.schema.array(),
+            signatureContext: coordinationSignatureContextSchema
+        }).transform((obj)=>new CommitteeAttestationsAndSigners(obj.attestations, obj.signatureContext));
+    }
+    getPayloadToSign() {
+        // Matches the L1 abi.encode(attestations, signers) in AttestationLib.sol#getAttestationsAndSignersDigest.
+        const abi = parseAbiParameters('(bytes,bytes),address[]');
+        const packed = this.getPackedAttestations();
+        const encodedData = encodeAbiParameters(abi, [
+            [
+                packed.signatureIndices,
+                packed.signaturesOrAddresses
+            ],
+            this.getSigners().map((s)=>s.toString())
+        ]);
+        return hexToBuffer(encodedData);
+    }
+    static empty(signatureContext) {
+        return new CommitteeAttestationsAndSigners([], signatureContext);
+    }
+    toString() {
+        throw new Error('Not implemented');
+    }
+    getSigners() {
+        return this.attestations.filter((a)=>!a.signature.isEmpty()).map((a)=>a.address);
+    }
+    getSignedAttestations() {
+        return this.attestations.filter((a)=>!a.signature.isEmpty());
+    }
+    /**
+   * Packs an array of committee attestations into the format expected by the Solidity contract
+   *
+   * @param attestations - Array of committee attestations with addresses and signatures
+   * @returns Packed attestations with bitmap and tightly packed signature/address data
+   */ static packAttestations(attestations) {
+        const length = attestations.length;
+        const viemAttestations = attestations.map((a)=>a.toViem());
+        // Calculate bitmap size (1 bit per attestation, rounded up to nearest byte)
+        const bitmapSize = Math.ceil(length / 8);
+        const signatureIndices = new Uint8Array(bitmapSize);
+        // Calculate total data size needed
+        let totalDataSize = 0;
+        for (const attestation of viemAttestations){
+            const signature = attestation.signature;
+            // Check if signature is empty (v = 0)
+            const isEmpty = signature.v === 0;
+            if (!isEmpty) {
+                totalDataSize += 65; // v (1) + r (32) + s (32)
+            } else {
+                totalDataSize += 20; // address only
+            }
+        }
+        const signaturesOrAddresses = new Uint8Array(totalDataSize);
+        let dataIndex = 0;
+        // Pack the data
+        for (const [i, attestation] of viemAttestations.entries()){
+            const signature = attestation.signature;
+            // Check if signature is empty
+            const isEmpty = signature.v === 0;
+            if (!isEmpty) {
+                // Set bit in bitmap (bit 7-0 in each byte, left to right)
+                const byteIndex = Math.floor(i / 8);
+                const bitIndex = 7 - i % 8;
+                signatureIndices[byteIndex] = (signatureIndices[byteIndex] ?? 0) | 1 << bitIndex;
+                // Pack signature: v + r + s
+                signaturesOrAddresses[dataIndex] = signature.v;
+                dataIndex++;
+                // Pack r (32 bytes)
+                const rBytes = Buffer.from(signature.r.slice(2), 'hex');
+                signaturesOrAddresses.set(rBytes, dataIndex);
+                dataIndex += 32;
+                // Pack s (32 bytes)
+                const sBytes = Buffer.from(signature.s.slice(2), 'hex');
+                signaturesOrAddresses.set(sBytes, dataIndex);
+                dataIndex += 32;
+            } else {
+                // Pack address only (20 bytes)
+                const addrBytes = Buffer.from(attestation.addr.slice(2), 'hex');
+                signaturesOrAddresses.set(addrBytes, dataIndex);
+                dataIndex += 20;
+            }
+        }
+        return {
+            signatureIndices: `0x${Buffer.from(signatureIndices).toString('hex')}`,
+            signaturesOrAddresses: `0x${Buffer.from(signaturesOrAddresses).toString('hex')}`
+        };
+    }
+    getPackedAttestations() {
+        return CommitteeAttestationsAndSigners.packAttestations(this.attestations);
+    }
+}
+/**
+ * Malicious extension of CommitteeAttestationsAndSigners that keeps separate attestations and
+ * signers. Used for tricking the L1 contract into accepting attestations by reconstructing
+ * the correct committee commitment (which relies on the signers, ignoring the signatures)
+ * with an invalid set of attestation signatures.
+ */ export class MaliciousCommitteeAttestationsAndSigners extends CommitteeAttestationsAndSigners {
+    signers;
+    constructor(attestations, signers, signatureContext){
+        super(attestations, signatureContext), this.signers = signers;
+    }
+    getSigners() {
+        return this.signers;
+    }
+}

package/dest/block/proposal/committee_attestation.d.ts

@@ -0,0 +1,30 @@
+import type { ViemCommitteeAttestation, ViemCommitteeAttestations } from '@aztec/ethereum/contracts';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Signature } from '@aztec/foundation/eth-signature';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { z } from 'zod';
+export { EthAddress, Signature };
+export declare class CommitteeAttestation {
+    readonly address: EthAddress;
+    readonly signature: Signature;
+    constructor(address: EthAddress, signature: Signature);
+    static get schema(): z.ZodPipe<z.ZodObject<{
+        address: z.ZodType<EthAddress, string, z.core.$ZodTypeInternals<EthAddress, string>>;
+        signature: z.ZodPipe<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>, z.ZodTransform<Signature, `0x${string}`>>;
+    }, z.core.$strip>, z.ZodTransform<CommitteeAttestation, {
+        address: EthAddress;
+        signature: Signature;
+    }>>;
+    static fromAddress(address: EthAddress): CommitteeAttestation;
+    static fromAddressAndSignature(address: EthAddress, signature: Signature): CommitteeAttestation;
+    static fromSignature(signature: Signature): CommitteeAttestation;
+    static fromViem(viem: ViemCommitteeAttestation): CommitteeAttestation;
+    static fromBuffer(buffer: Buffer | BufferReader): CommitteeAttestation;
+    static random(): CommitteeAttestation;
+    static empty(): CommitteeAttestation;
+    static fromPacked(packed: ViemCommitteeAttestations, committeeSize: number): CommitteeAttestation[];
+    toBuffer(): Buffer;
+    equals(other: CommitteeAttestation): boolean;
+    toViem(): ViemCommitteeAttestation;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWl0dGVlX2F0dGVzdGF0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svcHJvcG9zYWwvY29tbWl0dGVlX2F0dGVzdGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLHlCQUF5QixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDckcsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQzNELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM1RCxPQUFPLEVBQUUsWUFBWSxFQUFxQixNQUFNLDZCQUE2QixDQUFDO0FBRTlFLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxFQUFFLFVBQVUsRUFBRSxTQUFTLEVBQUUsQ0FBQztBQUVqQyxxQkFBYSxvQkFBb0I7YUFFYixPQUFPLEVBQUUsVUFBVTthQUNuQixTQUFTLEVBQUUsU0FBUztJQUZ0QyxZQUNrQixPQUFPLEVBQUUsVUFBVSxFQUNuQixTQUFTLEVBQUUsU0FBUyxFQUNsQztJQUVKLE1BQU0sS0FBSyxNQUFNOzs7Ozs7UUFPaEI7SUFHRCxNQUFNLENBQUMsV0FBVyxDQUFDLE9BQU8sRUFBRSxVQUFVLEdBQUcsb0JBQW9CLENBRTVEO0lBR0QsTUFBTSxDQUFDLHVCQUF1QixDQUFDLE9BQU8sRUFBRSxVQUFVLEVBQUUsU0FBUyxFQUFFLFNBQVMsR0FBRyxvQkFBb0IsQ0FFOUY7SUFFRCxNQUFNLENBQUMsYUFBYSxDQUFDLFNBQVMsRUFBRSxTQUFTLEdBQUcsb0JBQW9CLENBRS9EO0lBRUQsTUFBTSxDQUFDLFFBQVEsQ0FBQyxJQUFJLEVBQUUsd0JBQXdCLEdBQUcsb0JBQW9CLENBRXBFO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxvQkFBb0IsQ0FLckU7SUFFRCxNQUFNLENBQUMsTUFBTSxJQUFJLG9CQUFvQixDQUdwQztJQUVELE1BQU0sQ0FBQyxLQUFLLElBQUksb0JBQW9CLENBRW5DO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUseUJBQXlCLEVBQUUsYUFBYSxFQUFFLE1BQU0sR0FBRyxvQkFBb0IsRUFBRSxDQTZDbEc7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxLQUFLLEVBQUUsb0JBQW9CLEdBQUcsT0FBTyxDQUUzQztJQUVELE1BQU0sSUFBSSx3QkFBd0IsQ0FLakM7Q0FDRiJ9

package/dest/block/proposal/committee_attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"committee_attestation.d.ts","sourceRoot":"","sources":["../../../src/block/proposal/committee_attestation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAEjC,qBAAa,oBAAoB;aAEb,OAAO,EAAE,UAAU;aACnB,SAAS,EAAE,SAAS;IAFtC,YACkB,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,SAAS,EAClC;IAEJ,MAAM,KAAK,MAAM;;;;;;QAOhB;IAGD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,oBAAoB,CAE5D;IAGD,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,oBAAoB,CAE9F;IAED,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,oBAAoB,CAE/D;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CAEpE;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,oBAAoB,CAKrE;IAED,MAAM,CAAC,MAAM,IAAI,oBAAoB,CAGpC;IAED,MAAM,CAAC,KAAK,IAAI,oBAAoB,CAEnC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA6ClG;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAE3C;IAED,MAAM,IAAI,wBAAwB,CAKjC;CACF"}

package/dest/block/proposal/committee_attestation.js

@@ -0,0 +1,101 @@
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Signature } from '@aztec/foundation/eth-signature';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { z } from 'zod';
+export { EthAddress, Signature };
+export class CommitteeAttestation {
+    address;
+    signature;
+    constructor(address, signature){
+        this.address = address;
+        this.signature = signature;
+    }
+    static get schema() {
+        return z.object({
+            address: EthAddress.schema,
+            signature: Signature.schema
+        }).transform(({ address, signature })=>new CommitteeAttestation(address, signature));
+    }
+    // Create an empty attestation for an address that has not signed
+    static fromAddress(address) {
+        return new CommitteeAttestation(address, Signature.empty());
+    }
+    // Create an attestation from an address and a signature
+    static fromAddressAndSignature(address, signature) {
+        return new CommitteeAttestation(address, signature);
+    }
+    static fromSignature(signature) {
+        return new CommitteeAttestation(EthAddress.ZERO, signature);
+    }
+    static fromViem(viem) {
+        return new CommitteeAttestation(EthAddress.fromString(viem.addr), Signature.fromViemSignature(viem.signature));
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const address = reader.readObject(EthAddress);
+        const signature = reader.readObject(Signature);
+        return new CommitteeAttestation(address, signature);
+    }
+    static random() {
+        // note: will be invalid
+        return new CommitteeAttestation(EthAddress.random(), Signature.random());
+    }
+    static empty() {
+        return new CommitteeAttestation(EthAddress.ZERO, Signature.empty());
+    }
+    static fromPacked(packed, committeeSize) {
+        const signatureIndicesBuffer = Buffer.from(packed.signatureIndices.slice(2), 'hex');
+        const dataBuffer = Buffer.from(packed.signaturesOrAddresses.slice(2), 'hex');
+        const attestations = [];
+        let dataIndex = 0;
+        for(let i = 0; i < committeeSize; i++){
+            // Check if this position has a signature
+            const byteIndex = Math.floor(i / 8);
+            const bitIndex = 7 - i % 8;
+            const hasSignature = byteIndex < signatureIndicesBuffer.length && (signatureIndicesBuffer[byteIndex] & 1 << bitIndex) !== 0;
+            if (hasSignature) {
+                // Extract signature: v (1 byte) + r (32 bytes) + s (32 bytes)
+                if (dataIndex + 65 > dataBuffer.length) {
+                    throw new Error(`Insufficient data for signature at position ${i}`);
+                }
+                const v = dataBuffer[dataIndex];
+                const r = `0x${dataBuffer.subarray(dataIndex + 1, dataIndex + 33).toString('hex')}`;
+                const s = `0x${dataBuffer.subarray(dataIndex + 33, dataIndex + 65).toString('hex')}`;
+                const signature = Signature.fromViemSignature({
+                    r,
+                    s,
+                    v
+                });
+                // For signed attestations, we use a zero address as the address is recovered from the signature
+                attestations.push(new CommitteeAttestation(EthAddress.ZERO, signature));
+                dataIndex += 65;
+            } else {
+                // Extract address (20 bytes)
+                if (dataIndex + 20 > dataBuffer.length) {
+                    throw new Error(`Insufficient data for address at position ${i}`);
+                }
+                const addressBytes = dataBuffer.subarray(dataIndex, dataIndex + 20);
+                const address = EthAddress.fromString(`0x${addressBytes.toString('hex')}`);
+                // For address-only attestations, use empty signature
+                attestations.push(new CommitteeAttestation(address, Signature.empty()));
+                dataIndex += 20;
+            }
+        }
+        return attestations;
+    }
+    toBuffer() {
+        return serializeToBuffer([
+            this.address,
+            this.signature
+        ]);
+    }
+    equals(other) {
+        return this.address.equals(other.address) && this.signature.equals(other.signature);
+    }
+    toViem() {
+        return {
+            addr: this.address.toString(),
+            signature: this.signature.toViemSignature()
+        };
+    }
+}

package/dest/block/proposal/index.d.ts

@@ -0,0 +1,3 @@
+export * from './committee_attestation.js';
+export * from './attestations_and_signers.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ibG9jay9wcm9wb3NhbC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsK0JBQStCLENBQUMifQ==

package/dest/block/proposal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/block/proposal/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC"}

package/dest/block/proposal/index.js

@@ -0,0 +1,2 @@
+export * from './committee_attestation.js';
+export * from './attestations_and_signers.js';

package/dest/block/test/index.d.ts

@@ -0,0 +1,2 @@
+export * from './l2_tips_store_test_suite.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ibG9jay90ZXN0L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsK0JBQStCLENBQUMifQ==

package/dest/block/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/block/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/dest/block/test/index.js

@@ -0,0 +1 @@
+export * from './l2_tips_store_test_suite.js';

package/dest/block/test/l2_tips_store_test_suite.d.ts

@@ -0,0 +1,3 @@
+import type { L2TipsStore } from '../l2_block_stream/index.js';
+export declare function testL2TipsStore(makeTipsStore: () => Promise<L2TipsStore>): void;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV90ZXN0X3N1aXRlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svdGVzdC9sMl90aXBzX3N0b3JlX3Rlc3Rfc3VpdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFL0Qsd0JBQWdCLGVBQWUsQ0FBQyxhQUFhLEVBQUUsTUFBTSxPQUFPLENBQUMsV0FBVyxDQUFDLFFBOGdCeEUifQ==

package/dest/block/test/l2_tips_store_test_suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2_tips_store_test_suite.d.ts","sourceRoot":"","sources":["../../../src/block/test/l2_tips_store_test_suite.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,QA8gBxE"}