@aztec/stdlib 0.0.1-commit.b655e406 → 0.0.1-commit.b8a057fa

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

@@ -1 +1 @@
-{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_block_stream.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAsB,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAErH,uHAAuH;AACvH,qBAAa,aAAa;IAMtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAGjB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,WAAW,CAAC,EACzF,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kHAAkH;QAClH,aAAa,CAAC,EAAE,OAAO,CAAC;KACpB;IAKD,KAAK;IAKC,IAAI;IAIV,SAAS;IAIH,IAAI;cAMD,IAAI;IAuFpB;;;;OAIG;YACW,qBAAqB;IAwBnC,OAAO,CAAC,sBAAsB;YAOhB,SAAS;CASxB"}
+{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_block_stream.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,aAAa,EAAmC,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EAEpC,MAAM,iBAAiB,CAAC;AAEzB,wGAAwG;AACxG,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;AAElG,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2HAA2H;IAC3H,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,uHAAuH;AACvH,qBAAa,aAAa;IAMtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAE3B,YACU,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE,oBAAyB,EAaxC;IAEM,KAAK,SAGX;IAEY,IAAI,kBAEhB;IAEM,SAAS,YAEf;IAED;;;;OAIG;IACU,IAAI,kBAIhB;IAED,UAAgB,IAAI,kBAwInB;YASa,cAAc;YAmEd,qBAAqB;IAwCnC,OAAO,CAAC,sBAAsB;YAOhB,SAAS;CAexB"}

package/dest/block/l2_block_stream/l2_block_stream.js

@@ -1,7 +1,9 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
 import { AbortError } from '@aztec/foundation/error';
 import { createLogger } from '@aztec/foundation/log';
 import { RunningPromise } from '@aztec/foundation/running-promise';
 import { makeL2BlockId } from '../l2_block_source.js';
+import { localBlockIdDiffers } from './interfaces.js';
 /** Creates a stream of events for new blocks, chain tips updates, and reorgs, out of polling an archiver or a node. */ export class L2BlockStream {
     l2BlockSource;
     localData;
@@ -19,6 +21,13 @@ import { makeL2BlockId } from '../l2_block_source.js';
         this.opts = opts;
         this.isSyncing = false;
         this.hasStarted = false;
+        if (opts.tipsOnly && (opts.startingBlock !== undefined || opts.batchSize !== undefined || opts.skipFinalized)) {
+            throw new Error('tipsOnly is incompatible with startingBlock, batchSize, and skipFinalized: all three are ' + 'block-download options and there is no download loop in tips-only mode.');
+        }
+        // Note that RunningPromise is in stopped state by default. This promise won't run until someone invokes `start`,
+        // which makes it run periodically, or `sync`, which triggers it once.
+        // Users of L2BlockStream decide what mode to run it in (_periodically_ vs _manually triggered_).
+        // The default is _manually triggered_.
         this.runningPromise = new RunningPromise(()=>this.work(), log, this.opts.pollIntervalMS ?? 1000);
     }
     start() {
@@ -31,94 +40,122 @@ import { makeL2BlockId } from '../l2_block_source.js';
     isRunning() {
         return this.runningPromise.isRunning();
     }
-    async sync() {
+    /**
+   * Runs the synchronization process once.
+   *
+   * If you want to run this process continuously use `start` and `stop` instead.
+   */ async sync() {
         this.isSyncing = true;
         await this.runningPromise.trigger();
         this.isSyncing = false;
     }
     async work() {
         try {
-            const sourceTips = await this.l2BlockSource.getL2Tips();
+            // The source tips snapshot is the plan for this pass; it is re-read after the walk-back if a divergence is found.
+            let sourceTips = await this.l2BlockSource.getL2Tips();
             const localTips = await this.localData.getL2Tips();
             this.log.trace(`Running L2 block stream`, {
-                sourceLatest: sourceTips.latest.number,
-                localLatest: localTips.latest.number,
-                sourceFinalized: sourceTips.finalized.number,
-                localFinalized: localTips.finalized.number,
-                sourceProven: sourceTips.proven.number,
-                localProven: localTips.proven.number,
-                sourceLatestHash: sourceTips.latest.hash,
-                localLatestHash: localTips.latest.hash,
-                sourceProvenHash: sourceTips.proven.hash,
-                localProvenHash: localTips.proven.hash,
-                sourceFinalizedHash: sourceTips.finalized.hash,
-                localFinalizedHash: localTips.finalized.hash
+                sourceTips,
+                localTips
             });
-            // Check if there was a reorg and emit a chain-pruned event if so.
-            let latestBlockNumber = localTips.latest.number;
+            if (!this.opts.ignoreCheckpoints && localTips.checkpointed === undefined) {
+                throw new Error('Local data provider does not expose a checkpointed tip; checkpoint events require one ' + '(set ignoreCheckpoints or provide checkpointed tips).');
+            }
+            // Baseline for the chain-proposed event; captured before the local store mutates during the pass.
+            const prePassProposed = localTips.proposed;
+            // Walk back to find a reorg, floored at the local finalized tip (a legitimate reorg can never reach it, since
+            // finalized means the proving tx is itself L1-finalized). Seed the cache with ONLY the proposed tip: a stale
+            // tier seed at a reorged height equals the local old-fork hash, faking agreement and stopping the walk above the
+            // true divergence (an under-deep prune no later pass re-detects), whereas a stale proposed seed only masks the
+            // tip for one pass.
+            let latestBlockNumber = localTips.proposed.number;
             const sourceCache = new BlockHashCache([
-                sourceTips.latest
+                sourceTips.proposed
             ]);
+            const walkFloor = localTips.finalized.block.number;
             while(!await this.areBlockHashesEqualAt(latestBlockNumber, {
-                sourceCache
+                sourceCache,
+                sourceProposed: sourceTips.proposed.number
             })){
+                if (latestBlockNumber === 0) {
+                    // Walked back to genesis and the hashes still differ: the two sides disagree on block 0 itself (usually
+                    // different genesisTimestamp/prefilled state). Fail loudly rather than underflow into negative heights.
+                    this.log.error(`Genesis block hash mismatch between local store and source`, {
+                        localBlockHash: await this.localData.getL2BlockHash(BlockNumber.ZERO),
+                        sourceBlockHash: sourceCache.get(0) ?? await this.getBlockHashFromSource(BlockNumber.ZERO)
+                    });
+                    throw new Error('Genesis block hash mismatch between local store and source: refusing to walk past block 0. ' + 'This usually indicates the two sides were configured with different genesis values ' + '(e.g. genesisTimestamp or prefilled public data).');
+                }
+                if (latestBlockNumber <= walkFloor) {
+                    // A mismatch at or below the finalized tip cannot be a reorg (it contradicts L1-finalized state), so stop
+                    // here and prune at most to the finalized tip rather than pruning finalized state on non-reorg evidence.
+                    this.log.warn(`Block hash mismatch at or below the local finalized tip; stopping the walk-back here`, {
+                        blockNumber: latestBlockNumber,
+                        finalizedBlockNumber: walkFloor,
+                        localBlockHash: await this.localData.getL2BlockHash(latestBlockNumber),
+                        sourceBlockHash: sourceCache.get(latestBlockNumber) ?? await this.getBlockHashFromSource(latestBlockNumber)
+                    });
+                    break;
+                }
                 latestBlockNumber--;
             }
-            if (latestBlockNumber < localTips.latest.number) {
-                latestBlockNumber = Math.min(latestBlockNumber, sourceTips.latest.number); // see #13471
+            let pruned = false;
+            if (latestBlockNumber < localTips.proposed.number) {
+                // Re-read the source tips after the (possibly slow) walk-back so the prune event carries fresh checkpointed
+                // and proven tips, and the prune-target clamp, download plan, and tier reconciliation track the post-prune
+                // source chain. Append only the re-read proposed tip: it is a fresh entry that cannot poison the (already
+                // finished) walk and serves the prune-event hash lookup below.
+                sourceTips = await this.l2BlockSource.getL2Tips();
+                sourceCache.add(sourceTips.proposed);
+                latestBlockNumber = BlockNumber(Math.min(latestBlockNumber, sourceTips.proposed.number)); // see #13471
                 const hash = sourceCache.get(latestBlockNumber) ?? await this.getBlockHashFromSource(latestBlockNumber);
                 if (latestBlockNumber !== 0 && !hash) {
                     throw new Error(`Block hash not found in block source for block number ${latestBlockNumber}`);
                 }
-                this.log.verbose(`Reorg detected. Pruning blocks from ${latestBlockNumber + 1} to ${localTips.latest.number}.`);
+                this.log.verbose(`Reorg detected. Pruning blocks from ${latestBlockNumber + 1} to ${localTips.proposed.number}.`);
                 await this.emitEvent({
                     type: 'chain-pruned',
-                    block: makeL2BlockId(latestBlockNumber, hash)
+                    block: makeL2BlockId(latestBlockNumber, hash),
+                    checkpointed: sourceTips.checkpointed,
+                    proven: sourceTips.proven
                 });
+                pruned = true;
             }
-            // If we are just starting, use the starting block number from the options.
-            if (latestBlockNumber === 0 && this.opts.startingBlock !== undefined) {
-                latestBlockNumber = Math.max(this.opts.startingBlock - 1, 0);
-            }
-            // Only log this entry once (for sanity)
-            if (!this.hasStarted) {
-                this.log.verbose(`Starting sync from block number ${latestBlockNumber}`);
-                this.hasStarted = true;
+            // Pass atomicity: a prune mid-download leaves the source unable to serve the planned blocks, so the snapshot's
+            // tier tips may reference blocks the consumer never saw — skip tier reconciliation in that case. Tips-only mode
+            // has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
+            if (!this.opts.tipsOnly && !await this.downloadBlocks(latestBlockNumber, sourceTips)) {
+                return;
             }
-            let nextBlockNumber = latestBlockNumber + 1;
-            if (this.opts.skipFinalized) {
-                // When skipping finalized blocks we need to provide reliable reorg detection while fetching as few blocks as
-                // possible. Finalized blocks cannot be reorged by definition, so we can skip most of them. We do need the very
-                // last finalized block however in order to guarantee that we will eventually find a block in which our local
-                // store matches the source.
-                // If the last finalized block is behind our local tip, there is nothing to skip.
-                nextBlockNumber = Math.max(sourceTips.finalized.number, nextBlockNumber);
+            // End-of-pass reconciliation: chain-proposed fires against the pre-pass baseline (a post-prune re-read would
+            // equal the source tip and suppress it), then the tiers highest-to-lowest so the finalized <= proven <=
+            // checkpointed <= proposed invariant holds mid-pass.
+            if (localBlockIdDiffers(prePassProposed, sourceTips.proposed)) {
+                await this.emitEvent({
+                    type: 'chain-proposed',
+                    block: sourceTips.proposed
+                });
             }
-            // Request new blocks from the source.
-            while(nextBlockNumber <= sourceTips.latest.number){
-                const limit = Math.min(this.opts.batchSize ?? 50, sourceTips.latest.number - nextBlockNumber + 1);
-                this.log.trace(`Requesting blocks from ${nextBlockNumber} limit ${limit} proven=${this.opts.proven}`);
-                const blocks = await this.l2BlockSource.getPublishedBlocks(nextBlockNumber, limit, this.opts.proven);
-                if (blocks.length === 0) {
-                    break;
-                }
+            const reconcileTips = pruned ? await this.localData.getL2Tips() : localTips;
+            if (!this.opts.ignoreCheckpoints && localBlockIdDiffers(reconcileTips.checkpointed?.block, sourceTips.checkpointed.block)) {
                 await this.emitEvent({
-                    type: 'blocks-added',
-                    blocks
+                    type: 'chain-checkpointed',
+                    block: sourceTips.checkpointed.block,
+                    checkpoint: sourceTips.checkpointed.checkpoint
                 });
-                nextBlockNumber = blocks.at(-1).block.number + 1;
             }
-            // Update the proven and finalized tips.
-            if (localTips.proven !== undefined && sourceTips.proven.number !== localTips.proven.number) {
+            if (reconcileTips.proven !== undefined && localBlockIdDiffers(reconcileTips.proven.block, sourceTips.proven.block)) {
                 await this.emitEvent({
                     type: 'chain-proven',
-                    block: sourceTips.proven
+                    block: sourceTips.proven.block,
+                    checkpoint: sourceTips.proven.checkpoint
                 });
             }
-            if (localTips.finalized !== undefined && sourceTips.finalized.number !== localTips.finalized.number) {
+            if (reconcileTips.finalized !== undefined && localBlockIdDiffers(reconcileTips.finalized.block, sourceTips.finalized.block)) {
                 await this.emitEvent({
                     type: 'chain-finalized',
-                    block: sourceTips.finalized
+                    block: sourceTips.finalized.block,
+                    checkpoint: sourceTips.finalized.checkpoint
                 });
             }
         } catch (err) {
@@ -129,13 +166,76 @@ import { makeL2BlockId } from '../l2_block_source.js';
         }
     }
     /**
+   * Downloads every block from the post-prune cursor through the source's proposed tip, emitting `blocks-added`
+   * events. The return value gates tier-cursor advancement (pass atomicity): tier tips may only be reconciled when
+   * the plan that backs them ran to the proposed tip.
+   * @returns `true` if the plan completed (caught up, or delivered the proposed tip with a matching hash); `false` if
+   * the source no longer has a promised block, or served a fork at the proposed height mid-pass.
+   */ async downloadBlocks(latestBlockNumber, sourceTips) {
+        // The post-prune cursor: the highest block number both sides agree on. Block downloads resume from here.
+        let nextBlockNumber = latestBlockNumber + 1;
+        // From a fresh local store, fast-forward past history the consumer doesn't care about.
+        const startingBlock = this.opts.startingBlock !== undefined ? BlockNumber(this.opts.startingBlock) : undefined;
+        if (latestBlockNumber === 0 && startingBlock !== undefined) {
+            nextBlockNumber = Math.max(startingBlock, 1);
+        }
+        if (this.opts.skipFinalized) {
+            // Finalized blocks cannot be reorged, so skip them — but keep the last finalized block as the guaranteed point
+            // where local and source agree, the floor the walk-back terminates against.
+            nextBlockNumber = Math.max(sourceTips.finalized.block.number, nextBlockNumber);
+        }
+        if (!this.hasStarted) {
+            this.log.verbose(`Starting sync from block number ${nextBlockNumber - 1}`);
+            this.hasStarted = true;
+        }
+        let lastDeliveredBlock;
+        while(nextBlockNumber <= sourceTips.proposed.number){
+            const limit = Math.min(this.opts.batchSize ?? 50, sourceTips.proposed.number - nextBlockNumber + 1);
+            this.log.trace(`Requesting blocks from ${nextBlockNumber} limit ${limit}`);
+            const blocks = await this.l2BlockSource.getBlocks({
+                from: BlockNumber(nextBlockNumber),
+                limit
+            });
+            if (blocks.length === 0) {
+                // The source no longer has a block the snapshot promised: the snapshot is provably stale, so report the plan
+                // incomplete and skip reconciliation this pass.
+                this.log.warn(`Block source returned no blocks for a promised range; skipping reconciliation this pass`, {
+                    from: nextBlockNumber,
+                    limit,
+                    sourceProposed: sourceTips.proposed.number
+                });
+                return false;
+            }
+            await this.emitEvent({
+                type: 'blocks-added',
+                blocks
+            });
+            lastDeliveredBlock = blocks.at(-1);
+            nextBlockNumber = lastDeliveredBlock.number + 1;
+        }
+        if (lastDeliveredBlock === undefined) {
+            // Loop never ran: caught up before the plan started, or startingBlock past the tip (A-1061). Trivially complete.
+            return true;
+        }
+        // Complete iff the block delivered at the proposed height carries the snapshot's proposed hash; a different hash
+        // means a same-height fork swap happened mid-pass, so the snapshot is stale.
+        const deliveredHash = (await lastDeliveredBlock.hash()).toString();
+        if (deliveredHash !== sourceTips.proposed.hash) {
+            this.log.warn(`Delivered proposed-block hash differs from snapshot; skipping reconciliation this pass`, {
+                blockNumber: lastDeliveredBlock.number,
+                deliveredHash,
+                snapshotHash: sourceTips.proposed.hash
+            });
+            return false;
+        }
+        return true;
+    }
+    /**
    * Returns whether the source and local agree on the block hash at a given height.
    * @param blockNumber - The block number to test.
-   * @param args - A cache of data already requested from source, to avoid re-requesting it.
+   * @param args - A cache of data already requested from source (to avoid re-requesting it) and the source's
+   * advertised proposed tip from the pass snapshot (to detect an incoherent source).
    */ async areBlockHashesEqualAt(blockNumber, args) {
-        if (blockNumber === 0) {
-            return true;
-        }
         const localBlockHash = await this.localData.getL2BlockHash(blockNumber);
         if (!localBlockHash && this.opts.skipFinalized) {
             // Failing to find a block hash when skipping finalized blocks can be highly problematic as we'd potentially need
@@ -145,6 +245,13 @@ import { makeL2BlockId } from '../l2_block_source.js';
             this.log.error(`No local block hash for block number ${blockNumber}`);
             throw new AbortError();
         }
+        if (!localBlockHash) {
+            // A missing local hash compares UNEQUAL: treating both-undefined as equal would stop the walk above the true
+            // divergence (an under-deep prune no later pass re-detects). Over-deep is the safe direction, and block 0 always
+            // resolves via the store's initialBlockHash so the walk always terminates.
+            this.log.trace(`No local block hash for block number ${blockNumber}; treating as unequal`);
+            return false;
+        }
         const sourceBlockHashFromCache = args.sourceCache.get(blockNumber);
         const sourceBlockHash = args.sourceCache.get(blockNumber) ?? await this.getBlockHashFromSource(blockNumber);
         if (!sourceBlockHashFromCache && sourceBlockHash) {
@@ -153,6 +260,15 @@ import { makeL2BlockId } from '../l2_block_source.js';
                 hash: sourceBlockHash
             });
         }
+        if (!sourceBlockHash && blockNumber !== 0 && blockNumber <= args.sourceProposed) {
+            // No source data at or below the source's own proposed tip: the source contradicts itself (mid-reorg unwind or
+            // a transient read failure), so skip this pass.
+            this.log.warn(`Source has no data for a block at or below its proposed tip; skipping this sync pass`, {
+                blockNumber,
+                sourceProposed: args.sourceProposed
+            });
+            throw new AbortError();
+        }
         this.log.trace(`Comparing block hashes for block ${blockNumber}`, {
             localBlockHash,
             sourceBlockHash
@@ -160,10 +276,12 @@ import { makeL2BlockId } from '../l2_block_source.js';
         return localBlockHash === sourceBlockHash;
     }
     getBlockHashFromSource(blockNumber) {
-        return this.l2BlockSource.getBlockHeader(blockNumber).then((h)=>h?.hash()).then((hash)=>hash?.toString());
+        return this.l2BlockSource.getBlockData({
+            number: blockNumber
+        }).then((d)=>d?.header.hash()).then((hash)=>hash?.toString());
     }
     async emitEvent(event) {
-        this.log.debug(`Emitting ${event.type} (${event.type === 'blocks-added' ? event.blocks.length : event.block.number})`);
+        this.log.debug(`Emitting ${event.type} (${event.type === 'blocks-added' ? event.blocks.length : event.type === 'chain-checkpointed' ? event.checkpoint.number : event.block.number})`);
         await this.handler.handleBlockStreamEvent(event);
         if (!this.isRunning() && !this.isSyncing) {
             throw new AbortError();

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

@@ -1,18 +1,23 @@
-import type { L2Block } from '../l2_block.js';
-import type { L2BlockId, L2BlockTag, L2Tips } from '../l2_block_source.js';
-import type { L2BlockStreamEvent, L2BlockStreamEventHandler, L2BlockStreamLocalDataProvider } from './interfaces.js';
+import type { BlockNumber } from '@aztec/foundation/branded-types';
+import type { BlockHash } from '../block_hash.js';
+import type { CheckpointId, L2BlockTag } from '../l2_block_source.js';
+import { L2TipsStoreBase } from './l2_tips_store_base.js';
 /**
- * Stores currently synced L2 tips and unfinalized block hashes.
- * @dev tests in kv-store/src/stores/l2_tips_memory_store.test.ts
+ * In-memory implementation of L2 tips store. Useful for testing and lightweight clients.
+ * @dev Tests in kv-store/src/stores/l2_tips_memory_store.test.ts
  */
-export declare class L2TipsMemoryStore implements L2BlockStreamEventHandler, L2BlockStreamLocalDataProvider {
-    protected readonly l2TipsStore: Map<L2BlockTag, number>;
-    protected readonly l2BlockHashesStore: Map<number, string>;
-    getL2BlockHash(number: number): Promise<string | undefined>;
-    getL2Tips(): Promise<L2Tips>;
-    private getL2Tip;
-    handleBlockStreamEvent(event: L2BlockStreamEvent): Promise<void>;
-    protected saveTag(name: L2BlockTag, block: L2BlockId): void;
-    protected computeBlockHash(block: L2Block): Promise<`0x${string}`>;
+export declare class L2TipsMemoryStore extends L2TipsStoreBase {
+    constructor(initialBlockHash: BlockHash);
+    private readonly tips;
+    private readonly tipCheckpoints;
+    private readonly blockHashes;
+    protected getTip(tag: L2BlockTag): Promise<BlockNumber | undefined>;
+    protected setTip(tag: L2BlockTag, blockNumber: BlockNumber): Promise<void>;
+    protected getTipCheckpoint(tag: L2BlockTag): Promise<CheckpointId | undefined>;
+    protected setTipCheckpoint(tag: L2BlockTag, checkpoint: CheckpointId): Promise<void>;
+    protected getStoredBlockHash(blockNumber: BlockNumber): Promise<string | undefined>;
+    protected setBlockHash(blockNumber: BlockNumber, hash: string): Promise<void>;
+    protected deleteBlockHashesBefore(blockNumber: BlockNumber): Promise<void>;
+    protected runInTransaction<T>(fn: () => Promise<T>): Promise<T>;
 }
-//# sourceMappingURL=l2_tips_memory_store.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19tZW1vcnlfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ibG9jay9sMl9ibG9ja19zdHJlYW0vbDJfdGlwc19tZW1vcnlfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbkUsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDbEQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLFVBQVUsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3RFLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUUxRDs7O0dBR0c7QUFDSCxxQkFBYSxpQkFBa0IsU0FBUSxlQUFlO0lBQ3BELFlBQVksZ0JBQWdCLEVBQUUsU0FBUyxFQUV0QztJQUVELE9BQU8sQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFzQztJQUMzRCxPQUFPLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBdUM7SUFDdEUsT0FBTyxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQTZCO0lBRXpELFNBQVMsQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQyxDQUVsRTtJQUVELFNBQVMsQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLFVBQVUsRUFBRSxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FHekU7SUFFRCxTQUFTLENBQUMsZ0JBQWdCLENBQUMsR0FBRyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsWUFBWSxHQUFHLFNBQVMsQ0FBQyxDQUU3RTtJQUVELFNBQVMsQ0FBQyxnQkFBZ0IsQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFVBQVUsRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUduRjtJQUVELFNBQVMsQ0FBQyxrQkFBa0IsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRWxGO0lBRUQsU0FBUyxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUc1RTtJQUVELFNBQVMsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FPekU7SUFFRCxTQUFTLENBQUMsZ0JBQWdCLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxNQUFNLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBRzlEO0NBQ0YifQ==

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

@@ -1 +1 @@
-{"version":3,"file":"l2_tips_memory_store.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_tips_memory_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAErH;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,yBAAyB,EAAE,8BAA8B;IACjG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAa;IACpE,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAEhE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAQnC,OAAO,CAAC,QAAQ;IAaH,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B7E,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS;IAOpD,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO;CAG1C"}
+{"version":3,"file":"l2_tips_memory_store.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_tips_memory_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,YAAY,gBAAgB,EAAE,SAAS,EAEtC;IAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAElE;IAED,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;IAED,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAE7E;IAED,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;IAED,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAElF;IAED,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;IAED,SAAS,CAAC,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;IAED,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9D;CACF"}

package/dest/block/l2_block_stream/l2_tips_memory_store.js

@@ -1,70 +1,45 @@
+import { L2TipsStoreBase } from './l2_tips_store_base.js';
 /**
- * Stores currently synced L2 tips and unfinalized block hashes.
- * @dev tests in kv-store/src/stores/l2_tips_memory_store.test.ts
- */ export class L2TipsMemoryStore {
-    l2TipsStore = new Map();
-    l2BlockHashesStore = new Map();
-    getL2BlockHash(number) {
-        return Promise.resolve(this.l2BlockHashesStore.get(number));
+ * In-memory implementation of L2 tips store. Useful for testing and lightweight clients.
+ * @dev Tests in kv-store/src/stores/l2_tips_memory_store.test.ts
+ */ export class L2TipsMemoryStore extends L2TipsStoreBase {
+    constructor(initialBlockHash){
+        super(initialBlockHash);
     }
-    getL2Tips() {
-        return Promise.resolve({
-            latest: this.getL2Tip('latest'),
-            finalized: this.getL2Tip('finalized'),
-            proven: this.getL2Tip('proven')
-        });
+    tips = new Map();
+    tipCheckpoints = new Map();
+    blockHashes = new Map();
+    getTip(tag) {
+        return Promise.resolve(this.tips.get(tag));
     }
-    getL2Tip(tag) {
-        const blockNumber = this.l2TipsStore.get(tag);
-        if (blockNumber === undefined || blockNumber === 0) {
-            return {
-                number: 0,
-                hash: undefined
-            };
-        }
-        const blockHash = this.l2BlockHashesStore.get(blockNumber);
-        if (!blockHash) {
-            throw new Error(`Block hash not found for block number ${blockNumber}`);
-        }
-        return {
-            number: blockNumber,
-            hash: blockHash
-        };
+    setTip(tag, blockNumber) {
+        this.tips.set(tag, blockNumber);
+        return Promise.resolve();
     }
-    async handleBlockStreamEvent(event) {
-        switch(event.type){
-            case 'blocks-added':
-                {
-                    const blocks = event.blocks.map((b)=>b.block);
-                    for (const block of blocks){
-                        this.l2BlockHashesStore.set(block.number, await this.computeBlockHash(block));
-                    }
-                    this.l2TipsStore.set('latest', blocks.at(-1).number);
-                    break;
-                }
-            case 'chain-pruned':
-                this.saveTag('latest', event.block);
-                break;
-            case 'chain-proven':
-                this.saveTag('proven', event.block);
-                break;
-            case 'chain-finalized':
-                this.saveTag('finalized', event.block);
-                for (const key of this.l2BlockHashesStore.keys()){
-                    if (key < event.block.number) {
-                        this.l2BlockHashesStore.delete(key);
-                    }
-                }
-                break;
-        }
+    getTipCheckpoint(tag) {
+        return Promise.resolve(this.tipCheckpoints.get(tag));
+    }
+    setTipCheckpoint(tag, checkpoint) {
+        this.tipCheckpoints.set(tag, checkpoint);
+        return Promise.resolve();
+    }
+    getStoredBlockHash(blockNumber) {
+        return Promise.resolve(this.blockHashes.get(blockNumber));
+    }
+    setBlockHash(blockNumber, hash) {
+        this.blockHashes.set(blockNumber, hash);
+        return Promise.resolve();
     }
-    saveTag(name, block) {
-        this.l2TipsStore.set(name, block.number);
-        if (block.hash) {
-            this.l2BlockHashesStore.set(block.number, block.hash);
+    deleteBlockHashesBefore(blockNumber) {
+        for (const key of this.blockHashes.keys()){
+            if (key < blockNumber) {
+                this.blockHashes.delete(key);
+            }
         }
+        return Promise.resolve();
     }
-    computeBlockHash(block) {
-        return block.hash().then((hash)=>hash.toString());
+    runInTransaction(fn) {
+        // Memory store doesn't need transactions - just execute immediately
+        return fn();
     }
 }

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

@@ -0,0 +1,51 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
+import type { BlockHash } from '../block_hash.js';
+import type { L2Block } from '../l2_block.js';
+import { type CheckpointId, type L2BlockId, type L2BlockTag, type LocalL2Tips } 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 checkpoint id recorded for a given tag, if any. */
+    protected abstract getTipCheckpoint(tag: L2BlockTag): Promise<CheckpointId | undefined>;
+    /** Records the checkpoint id for a given tag. */
+    protected abstract setTipCheckpoint(tag: L2BlockTag, checkpoint: CheckpointId): 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>;
+    /** 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<LocalL2Tips>;
+    /**
+     * Records `(number → hash)` witnesses into the block-hash index without moving any tip cursor. In tips-only mode
+     * the hash history is sparse (one anchor per tip-moving poll), so a consumer that materializes per-height state
+     * should witness those heights or its prunes are over-deep by the gap to the nearest anchor. Witnesses are compared
+     * against the source, not trusted, so they cannot cause under-deep prunes; this is always safe to call.
+     */
+    recordBlockHashes(blocks: L2BlockId[]): Promise<void>;
+    handleBlockStreamEvent(event: L2BlockStreamEvent): Promise<void>;
+    protected computeBlockHash(block: L2Block): Promise<string>;
+    private getBlockId;
+    private getCheckpointId;
+    private genesisCheckpointId;
+    private handleBlocksAdded;
+    private handleChainProposed;
+    private handleChainCheckpointed;
+    private handleChainPruned;
+    private handleChainProven;
+    private handleChainFinalized;
+    private saveTag;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV9iYXNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX3RpcHNfc3RvcmVfYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFvQixNQUFNLGlDQUFpQyxDQUFDO0FBRWhGLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzlDLE9BQU8sRUFDTCxLQUFLLFlBQVksRUFFakIsS0FBSyxTQUFTLEVBQ2QsS0FBSyxVQUFVLEVBQ2YsS0FBSyxXQUFXLEVBQ2pCLE1BQU0sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUseUJBQXlCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUVySDs7O0dBR0c7QUFDSCw4QkFBc0IsZUFBZ0IsWUFBVyx5QkFBeUIsRUFBRSw4QkFBOEI7SUFDNUYsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsRUFBRSxTQUFTO0lBQTFELFlBQStCLGdCQUFnQixFQUFFLFNBQVMsRUFBSTtJQUc5RCw2Q0FBNkM7SUFDN0MsU0FBUyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRTdFLDZDQUE2QztJQUM3QyxTQUFTLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXBGLCtEQUErRDtJQUMvRCxTQUFTLENBQUMsUUFBUSxDQUFDLGdCQUFnQixDQUFDLEdBQUcsRUFBRSxVQUFVLEdBQUcsT0FBTyxDQUFDLFlBQVksR0FBRyxTQUFTLENBQUMsQ0FBQztJQUV4RixpREFBaUQ7SUFDakQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFVBQVUsRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTlGLG9EQUFvRDtJQUNwRCxTQUFTLENBQUMsUUFBUSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQztJQUU3RixvREFBb0Q7SUFDcEQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsV0FBVyxFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV2Rix5RUFBeUU7SUFDekUsU0FBUyxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVwRiw0RkFBNEY7SUFDNUYsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUk1RCxjQUFjLENBQUMsTUFBTSxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQyxDQUs1RTtJQUVNLFNBQVMsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLENBc0J2QztJQUVEOzs7OztPQUtHO0lBQ1UsaUJBQWlCLENBQUMsTUFBTSxFQUFFLFNBQVMsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FRakU7SUFFWSxzQkFBc0IsQ0FBQyxLQUFLLEVBQUUsa0JBQWtCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQXFCNUU7SUFHRCxTQUFTLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBRTFEO1lBSWEsVUFBVTtZQVlWLGVBQWU7SUFnQjdCLE9BQU8sQ0FBQyxtQkFBbUI7WUFJYixpQkFBaUI7WUFhakIsbUJBQW1CO1lBU25CLHVCQUF1QjtZQVV2QixpQkFBaUI7WUEyQmpCLGlCQUFpQjtZQVVqQixvQkFBb0I7WUFtQnBCLE9BQU87Q0FNdEIifQ==

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":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,iCAAiC,CAAC;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAErH;;;GAGG;AACH,8BAAsB,eAAgB,YAAW,yBAAyB,EAAE,8BAA8B;IAC5F,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS;IAA1D,YAA+B,gBAAgB,EAAE,SAAS,EAAI;IAG9D,6CAA6C;IAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAE7E,6CAA6C;IAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,+DAA+D;IAC/D,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAExF,iDAAiD;IACjD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F,oDAAoD;IACpD,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE7F,oDAAoD;IACpD,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF,yEAAyE;IACzE,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,4FAA4F;IAC5F,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAI5D,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK5E;IAEM,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAsBvC;IAED;;;;;OAKG;IACU,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjE;IAEY,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E;IAGD,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;YAIa,UAAU;YAYV,eAAe;IAgB7B,OAAO,CAAC,mBAAmB;YAIb,iBAAiB;YAajB,mBAAmB;YASnB,uBAAuB;YAUvB,iBAAiB;YA2BjB,iBAAiB;YAUjB,oBAAoB;YAmBpB,OAAO;CAMtB"}