@aztec/stdlib 0.0.1-commit.f504929 → 0.0.1-commit.f5a9928

package/dest/block/l2_block_stream/l2_block_stream.js

@@ -1,9 +1,10 @@
-import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
+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 { BlockHash } from '../block_hash.js';
 import { makeL2BlockId } from '../l2_block_source.js';
-/** Maximum number of checkpoints to prefetch at once during sync. Matches MAX_RPC_CHECKPOINTS_LEN. */ export const CHECKPOINT_PREFETCH_LIMIT = 50;
+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;
@@ -21,6 +22,9 @@ 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_).
@@ -48,23 +52,68 @@ import { makeL2BlockId } from '../l2_block_source.js';
     }
     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`, {
                 sourceTips,
                 localTips
             });
-            // Check if there was a reorg and emit a chain-pruned event if so.
+            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;
+            // In tips-only mode there is no download loop to supply the chain-proposed event's header, so it must be
+            // fetched. Start the read now so it runs in parallel with the walk-back below.
+            const prefetch = this.opts.tipsOnly && localBlockIdDiffers(prePassProposed, sourceTips.proposed) ? {
+                hash: sourceTips.proposed.hash,
+                header: this.getHeaderFromSource(sourceTips.proposed.hash)
+            } : undefined;
+            // 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.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--;
             }
+            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) {
@@ -74,145 +123,56 @@ import { makeL2BlockId } from '../l2_block_source.js';
                 await this.emitEvent({
                     type: 'chain-pruned',
                     block: makeL2BlockId(latestBlockNumber, hash),
-                    checkpoint: sourceTips.checkpointed.checkpoint
+                    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 = BlockNumber(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;
-            }
-            let nextBlockNumber = latestBlockNumber + 1;
-            let nextCheckpointToEmit = CheckpointNumber(localTips.checkpointed.checkpoint.number + 1);
-            // When startingBlock is set, also skip ahead for checkpoints.
-            if (this.opts.startingBlock !== undefined && this.opts.startingBlock >= 1 && nextCheckpointToEmit <= sourceTips.checkpointed.checkpoint.number) {
-                const startingBlockCheckpoints = await this.l2BlockSource.getCheckpointedBlocks(BlockNumber(this.opts.startingBlock), 1);
-                if (startingBlockCheckpoints.length > 0) {
-                    nextCheckpointToEmit = CheckpointNumber(Math.max(nextCheckpointToEmit, startingBlockCheckpoints[0].checkpointNumber));
-                } else {
-                    // startingBlock is past all checkpointed blocks; skip Loop 1 entirely.
-                    nextCheckpointToEmit = CheckpointNumber(sourceTips.checkpointed.checkpoint.number + 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.block.number, nextBlockNumber);
-                // If the next checkpoint to emit is behind the finalized tip then skip forward
-                nextCheckpointToEmit = CheckpointNumber(Math.max(nextCheckpointToEmit, sourceTips.finalized.checkpoint.number));
-            }
-            // Loop 1: Emit checkpoint events for checkpoints whose blocks are already in local storage.
-            // This handles the case where blocks were synced as uncheckpointed and later became checkpointed.
-            // The guard `lastBlockInCheckpoint.number > localTips.proposed.number` ensures we don't emit
-            // checkpoints for blocks we don't have (e.g., when startingBlock skips earlier blocks).
-            // Since only one checkpoint can ever be uncheckpointed, this loop should iterate at most once.
-            if (!this.opts.ignoreCheckpoints) {
-                let loop1Iterations = 0;
-                while(nextCheckpointToEmit <= sourceTips.checkpointed.checkpoint.number){
-                    const checkpoints = await this.l2BlockSource.getCheckpoints(nextCheckpointToEmit, 1);
-                    if (checkpoints.length === 0) {
-                        break;
-                    }
-                    const lastBlockInCheckpoint = checkpoints[0].checkpoint.blocks.at(-1);
-                    // If this checkpoint has blocks we haven't seen yet, stop - they need to be fetched first
-                    if (lastBlockInCheckpoint.number > localTips.proposed.number) {
-                        break;
-                    }
-                    loop1Iterations++;
-                    if (loop1Iterations > 1) {
-                        this.log.warn(`Emitting multiple checkpoints (${loop1Iterations}) for already-local blocks. ` + `Next checkpoint: ${nextCheckpointToEmit}, source checkpointed: ${sourceTips.checkpointed.checkpoint.number}`);
-                    }
-                    const lastBlockHash = await lastBlockInCheckpoint.hash();
-                    await this.emitEvent({
-                        type: 'chain-checkpointed',
-                        checkpoint: checkpoints[0],
-                        block: makeL2BlockId(lastBlockInCheckpoint.number, lastBlockHash.toString())
+            // 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 — downloadBlocks aborts the pass in that case.
+            // Tips-only mode has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
+            const deliveredProposedHeader = this.opts.tipsOnly ? undefined : await this.downloadBlocks(latestBlockNumber, sourceTips);
+            // 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)) {
+                const availableHeader = prefetch?.hash === sourceTips.proposed.hash ? await prefetch.header : deliveredProposedHeader;
+                const header = availableHeader ?? await this.getHeaderFromSource(sourceTips.proposed.hash);
+                if (header === undefined) {
+                    // Abort the pass rather than skip just this event: the later tier events must not get ahead of a
+                    // proposed tip the consumer never received. Nothing advanced, so the next pass retries.
+                    this.log.warn(`No header for the proposed tip; aborting this sync pass`, {
+                        blockNumber: sourceTips.proposed.number,
+                        blockHash: sourceTips.proposed.hash
                     });
-                    nextCheckpointToEmit = CheckpointNumber(nextCheckpointToEmit + 1);
-                }
-            }
-            // Loop 2: Fetch new checkpointed blocks. For each checkpoint, emit all blocks
-            // from that checkpoint that we need, then emit the checkpoint event.
-            // We prefetch multiple checkpoints, then process them one by one.
-            let prefetchedCheckpoints = [];
-            let prefetchIdx = 0;
-            let nextCheckpointNumber;
-            // Find the starting checkpoint number
-            if (nextBlockNumber <= sourceTips.checkpointed.block.number) {
-                const blocks = await this.l2BlockSource.getCheckpointedBlocks(BlockNumber(nextBlockNumber), 1);
-                if (blocks.length > 0) {
-                    nextCheckpointNumber = blocks[0].checkpointNumber;
-                }
-            }
-            while(nextBlockNumber <= sourceTips.checkpointed.block.number && nextCheckpointNumber !== undefined){
-                // Refill the prefetch buffer when exhausted
-                if (prefetchIdx >= prefetchedCheckpoints.length) {
-                    const prefetchLimit = this.opts.checkpointPrefetchLimit ?? CHECKPOINT_PREFETCH_LIMIT;
-                    prefetchedCheckpoints = await this.l2BlockSource.getCheckpoints(nextCheckpointNumber, prefetchLimit);
-                    prefetchIdx = 0;
-                    if (prefetchedCheckpoints.length === 0) {
-                        break;
-                    }
-                }
-                const checkpoint = prefetchedCheckpoints[prefetchIdx];
-                // Get all blocks from this checkpoint that we need, respecting batchSize
-                const limit = Math.min(this.opts.batchSize ?? 50, sourceTips.checkpointed.block.number - nextBlockNumber + 1);
-                const blocksForCheckpoint = checkpoint.checkpoint.blocks.filter((b)=>b.number >= nextBlockNumber).slice(0, limit);
-                if (blocksForCheckpoint.length === 0) {
-                    break;
+                    throw new AbortError();
                 }
                 await this.emitEvent({
-                    type: 'blocks-added',
-                    blocks: blocksForCheckpoint
+                    type: 'chain-proposed',
+                    block: sourceTips.proposed,
+                    header
                 });
-                nextBlockNumber = blocksForCheckpoint.at(-1).number + 1;
-                // If we've reached the end of this checkpoint, emit the checkpoint event and move to next
-                const lastBlockInCheckpoint = checkpoint.checkpoint.blocks.at(-1);
-                if (nextBlockNumber > lastBlockInCheckpoint.number) {
-                    if (!this.opts.ignoreCheckpoints) {
-                        const lastBlockHash = await lastBlockInCheckpoint.hash();
-                        await this.emitEvent({
-                            type: 'chain-checkpointed',
-                            checkpoint,
-                            block: makeL2BlockId(lastBlockInCheckpoint.number, lastBlockHash.toString())
-                        });
-                    }
-                    prefetchIdx++;
-                    nextCheckpointNumber = CheckpointNumber(nextCheckpointNumber + 1);
-                }
             }
-            // Loop 3: Fetch any remaining uncheckpointed (proposed) blocks.
-            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(BlockNumber(nextBlockNumber), BlockNumber(limit));
-                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).number + 1;
             }
-            // Update the proven and finalized tips.
-            if (localTips.proven !== undefined && sourceTips.proven.block.number !== localTips.proven.block.number) {
+            if (reconcileTips.proven !== undefined && localBlockIdDiffers(reconcileTips.proven.block, sourceTips.proven.block)) {
                 await this.emitEvent({
                     type: 'chain-proven',
-                    block: sourceTips.proven.block
+                    block: sourceTips.proven.block,
+                    checkpoint: sourceTips.proven.checkpoint
                 });
             }
-            if (localTips.finalized !== undefined && sourceTips.finalized.block.number !== localTips.finalized.block.number) {
+            if (reconcileTips.finalized !== undefined && localBlockIdDiffers(reconcileTips.finalized.block, sourceTips.finalized.block)) {
                 await this.emitEvent({
                     type: 'chain-finalized',
-                    block: sourceTips.finalized.block
+                    block: sourceTips.finalized.block,
+                    checkpoint: sourceTips.finalized.checkpoint
                 });
             }
         } catch (err) {
@@ -223,13 +183,76 @@ import { makeL2BlockId } from '../l2_block_source.js';
         }
     }
     /**
+   * Delivers every block from the agreed-on point through the advertised proposed tip as `blocks-added` events,
+   * aborting the pass when the source's own answers prove that tip is no longer real.
+   * @returns The delivered tip's header, so the caller can avoid a re-fetch; undefined when there was nothing to
+   * download (already at the tip, or startingBlock past it).
+   */ 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; aborting this sync pass`, {
+                    from: nextBlockNumber,
+                    limit,
+                    sourceProposed: sourceTips.proposed.number
+                });
+                throw new AbortError();
+            }
+            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, see A-1061), so nothing
+            // was downloaded that could disprove the snapshot.
+            return undefined;
+        }
+        // The block delivered at the proposed height must carry 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; aborting this sync pass`, {
+                blockNumber: lastDeliveredBlock.number,
+                deliveredHash,
+                snapshotHash: sourceTips.proposed.hash
+            });
+            throw new AbortError();
+        }
+        return lastDeliveredBlock.header;
+    }
+    /**
    * 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
@@ -239,6 +262,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) {
@@ -247,6 +277,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
@@ -254,10 +293,22 @@ 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());
+    }
+    getHeaderFromSource(hash) {
+        return this.l2BlockSource.getBlockData({
+            hash: BlockHash.fromString(hash)
+        }).then((data)=>data?.header).catch((err)=>{
+            this.log.error(`Failed to read header for block`, err, {
+                blockHash: hash
+            });
+            return undefined;
+        });
     }
     async emitEvent(event) {
-        this.log.debug(`Emitting ${event.type} (${event.type === 'blocks-added' ? event.blocks.length : event.type === 'chain-checkpointed' ? event.checkpoint.checkpoint.number : 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,27 +1,23 @@
-import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
-import type { PublishedCheckpoint } from '../../checkpoint/published_checkpoint.js';
-import type { L2BlockTag } from '../l2_block_source.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';
 /**
  * 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 extends L2TipsStoreBase {
+    constructor(initialBlockHash: BlockHash);
     private readonly tips;
+    private readonly tipCheckpoints;
     private readonly blockHashes;
-    private readonly blockToCheckpoint;
-    private readonly checkpoints;
     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 getCheckpointNumberForBlock(blockNumber: BlockNumber): Promise<CheckpointNumber | undefined>;
-    protected setCheckpointNumberForBlock(blockNumber: BlockNumber, checkpointNumber: CheckpointNumber): Promise<void>;
-    protected deleteBlockToCheckpointBefore(blockNumber: BlockNumber): Promise<void>;
-    protected getCheckpoint(checkpointNumber: CheckpointNumber): Promise<PublishedCheckpoint | undefined>;
-    protected saveCheckpointData(checkpoint: PublishedCheckpoint): Promise<void>;
-    protected deleteCheckpointsBefore(checkpointNumber: CheckpointNumber): Promise<void>;
     protected runInTransaction<T>(fn: () => Promise<T>): Promise<T>;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19tZW1vcnlfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ibG9jay9sMl9ibG9ja19zdHJlYW0vbDJfdGlwc19tZW1vcnlfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBRWhGLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sMENBQTBDLENBQUM7QUFDcEYsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDeEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRTFEOzs7R0FHRztBQUNILHFCQUFhLGlCQUFrQixTQUFRLGVBQWU7SUFDcEQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQXNDO0lBQzNELE9BQU8sQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUE2QjtJQUN6RCxPQUFPLENBQUMsUUFBUSxDQUFDLGlCQUFpQixDQUF1QztJQUN6RSxPQUFPLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBMEM7SUFFdEUsU0FBUyxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxHQUFHLE9BQU8sQ0FBQyxXQUFXLEdBQUcsU0FBUyxDQUFDLENBRWxFO0lBRUQsU0FBUyxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUd6RTtJQUVELFNBQVMsQ0FBQyxrQkFBa0IsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRWxGO0lBRUQsU0FBUyxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUc1RTtJQUVELFNBQVMsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FPekU7SUFFRCxTQUFTLENBQUMsMkJBQTJCLENBQUMsV0FBVyxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsZ0JBQWdCLEdBQUcsU0FBUyxDQUFDLENBRXJHO0lBRUQsU0FBUyxDQUFDLDJCQUEyQixDQUFDLFdBQVcsRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUdqSDtJQUVELFNBQVMsQ0FBQyw2QkFBNkIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FPL0U7SUFFRCxTQUFTLENBQUMsYUFBYSxDQUFDLGdCQUFnQixFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxtQkFBbUIsR0FBRyxTQUFTLENBQUMsQ0FFcEc7SUFFRCxTQUFTLENBQUMsa0JBQWtCLENBQUMsVUFBVSxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FHM0U7SUFFRCxTQUFTLENBQUMsdUJBQXVCLENBQUMsZ0JBQWdCLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQU9uRjtJQUVELFNBQVMsQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FHOUQ7Q0FDRiJ9
+//# 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,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IAEtE,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,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,2BAA2B,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAErG;IAED,SAAS,CAAC,2BAA2B,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjH;IAED,SAAS,CAAC,6BAA6B,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/E;IAED,SAAS,CAAC,aAAa,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAEpG;IAED,SAAS,CAAC,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;IAED,SAAS,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnF;IAED,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9D;CACF"}
+{"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

@@ -3,10 +3,12 @@ import { L2TipsStoreBase } from './l2_tips_store_base.js';
  * 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);
+    }
     tips = new Map();
+    tipCheckpoints = new Map();
     blockHashes = new Map();
-    blockToCheckpoint = new Map();
-    checkpoints = new Map();
     getTip(tag) {
         return Promise.resolve(this.tips.get(tag));
     }
@@ -14,6 +16,13 @@ import { L2TipsStoreBase } from './l2_tips_store_base.js';
         this.tips.set(tag, blockNumber);
         return Promise.resolve();
     }
+    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));
     }
@@ -29,36 +38,6 @@ import { L2TipsStoreBase } from './l2_tips_store_base.js';
         }
         return Promise.resolve();
     }
-    getCheckpointNumberForBlock(blockNumber) {
-        return Promise.resolve(this.blockToCheckpoint.get(blockNumber));
-    }
-    setCheckpointNumberForBlock(blockNumber, checkpointNumber) {
-        this.blockToCheckpoint.set(blockNumber, checkpointNumber);
-        return Promise.resolve();
-    }
-    deleteBlockToCheckpointBefore(blockNumber) {
-        for (const key of this.blockToCheckpoint.keys()){
-            if (key < blockNumber) {
-                this.blockToCheckpoint.delete(key);
-            }
-        }
-        return Promise.resolve();
-    }
-    getCheckpoint(checkpointNumber) {
-        return Promise.resolve(this.checkpoints.get(checkpointNumber));
-    }
-    saveCheckpointData(checkpoint) {
-        this.checkpoints.set(checkpoint.checkpoint.number, checkpoint);
-        return Promise.resolve();
-    }
-    deleteCheckpointsBefore(checkpointNumber) {
-        for (const key of this.checkpoints.keys()){
-            if (key < checkpointNumber) {
-                this.checkpoints.delete(key);
-            }
-        }
-        return Promise.resolve();
-    }
     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

@@ -1,49 +1,51 @@
-import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
-import type { PublishedCheckpoint } from '../../checkpoint/published_checkpoint.js';
+import { BlockNumber } from '@aztec/foundation/branded-types';
+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 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>;
-    /** 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>;
+    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;
-    private saveCheckpoint;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV9iYXNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX3RpcHNfc3RvcmVfYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsV0FBVyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFaEYsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwwQ0FBMEMsQ0FBQztBQUNwRixPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUM5QyxPQUFPLEVBSUwsS0FBSyxVQUFVLEVBQ2YsS0FBSyxNQUFNLEVBQ1osTUFBTSx1QkFBdUIsQ0FBQztBQUMvQixPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSx5QkFBeUIsRUFBRSw4QkFBOEIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRXJIOzs7R0FHRztBQUNILDhCQUFzQixlQUFnQixZQUFXLHlCQUF5QixFQUFFLDhCQUE4QjtJQUd4Ryw2Q0FBNkM7SUFDN0MsU0FBUyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRTdFLDZDQUE2QztJQUM3QyxTQUFTLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXBGLG9EQUFvRDtJQUNwRCxTQUFTLENBQUMsUUFBUSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQztJQUU3RixvREFBb0Q7SUFDcEQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsV0FBVyxFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV2Rix5RUFBeUU7SUFDekUsU0FBUyxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVwRiwyREFBMkQ7SUFDM0QsU0FBUyxDQUFDLFFBQVEsQ0FBQywyQkFBMkIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUVoSCwyREFBMkQ7SUFDM0QsU0FBUyxDQUFDLFFBQVEsQ0FBQywyQkFBMkIsQ0FDNUMsV0FBVyxFQUFFLFdBQVcsRUFDeEIsZ0JBQWdCLEVBQUUsZ0JBQWdCLEdBQ2pDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVqQix5RkFBeUY7SUFDekYsU0FBUyxDQUFDLFFBQVEsQ0FBQyw2QkFBNkIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUUxRix1Q0FBdUM7SUFDdkMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsZ0JBQWdCLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLG1CQUFtQixHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRS9HLDBCQUEwQjtJQUMxQixTQUFTLENBQUMsUUFBUSxDQUFDLGtCQUFrQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFdEYsa0VBQWtFO0lBQ2xFLFNBQVMsQ0FBQyxRQUFRLENBQUMsdUJBQXVCLENBQUMsZ0JBQWdCLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTlGLDRGQUE0RjtJQUM1RixTQUFTLENBQUMsUUFBUSxDQUFDLGdCQUFnQixDQUFDLENBQUMsRUFBRSxFQUFFLEVBQUUsTUFBTSxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBSWxFLGNBQWMsQ0FBQyxNQUFNLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRXRFO0lBRU0sU0FBUyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FzQmxDO0lBRVksc0JBQXNCLENBQUMsS0FBSyxFQUFFLGtCQUFrQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FrQjVFO0lBR0QsU0FBUyxDQUFDLGdCQUFnQixDQUFDLEtBQUssRUFBRSxPQUFPLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUUxRDtZQUlhLFVBQVU7WUFZVixlQUFlO1lBaUJmLGlCQUFpQjtZQWFqQix1QkFBdUI7WUFVdkIsaUJBQWlCO1lBY2pCLGlCQUFpQjtZQVNqQixvQkFBb0I7WUFpQnBCLE9BQU87WUFPUCxjQUFjO0NBUzdCIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV9iYXNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX3RpcHNfc3RvcmVfYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFvQixNQUFNLGlDQUFpQyxDQUFDO0FBRWhGLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzlDLE9BQU8sRUFDTCxLQUFLLFlBQVksRUFFakIsS0FBSyxTQUFTLEVBQ2QsS0FBSyxVQUFVLEVBQ2YsS0FBSyxXQUFXLEVBQ2pCLE1BQU0sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUseUJBQXlCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUVySDs7O0dBR0c7QUFDSCw4QkFBc0IsZUFBZ0IsWUFBVyx5QkFBeUIsRUFBRSw4QkFBOEI7SUFDNUYsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsRUFBRSxTQUFTO0lBQTFELFlBQStCLGdCQUFnQixFQUFFLFNBQVMsRUFBSTtJQUc5RCw2Q0FBNkM7SUFDN0MsU0FBUyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRTdFLDZDQUE2QztJQUM3QyxTQUFTLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXBGLCtEQUErRDtJQUMvRCxTQUFTLENBQUMsUUFBUSxDQUFDLGdCQUFnQixDQUFDLEdBQUcsRUFBRSxVQUFVLEdBQUcsT0FBTyxDQUFDLFlBQVksR0FBRyxTQUFTLENBQUMsQ0FBQztJQUV4RixpREFBaUQ7SUFDakQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxHQUFHLEVBQUUsVUFBVSxFQUFFLFVBQVUsRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTlGLG9EQUFvRDtJQUNwRCxTQUFTLENBQUMsUUFBUSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQztJQUU3RixvREFBb0Q7SUFDcEQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsV0FBVyxFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV2Rix5RUFBeUU7SUFDekUsU0FBUyxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVwRiw0RkFBNEY7SUFDNUYsU0FBUyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUk1RCxjQUFjLENBQUMsTUFBTSxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQyxDQUs1RTtJQUVNLFNBQVMsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLENBc0J2QztJQUVEOzs7OztPQUtHO0lBQ1UsaUJBQWlCLENBQUMsTUFBTSxFQUFFLFNBQVMsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FRakU7SUFFWSxzQkFBc0IsQ0FBQyxLQUFLLEVBQUUsa0JBQWtCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQXFCNUU7SUFHRCxTQUFTLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBRTFEO1lBSWEsVUFBVTtZQVlWLGVBQWU7SUFnQjdCLE9BQU8sQ0FBQyxtQkFBbUI7WUFJYixpQkFBaUI7WUFhakIsbUJBQW1CO1lBU25CLHVCQUF1QjtZQVV2QixpQkFBaUI7WUEyQmpCLGlCQUFpQjtZQVVqQixvQkFBb0I7WUFtQnBCLE9BQU87Q0FNdEIifQ==

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

@@ -1 +1 @@
-{"version":3,"file":"l2_tips_store_base.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_tips_store_base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,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;IAGxG,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,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,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,CAAC,2BAA2B,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAEhH,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,CAAC,2BAA2B,CAC5C,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,yFAAyF;IACzF,SAAS,CAAC,QAAQ,CAAC,6BAA6B,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1F,uCAAuC;IACvC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAE/G,0BAA0B;IAC1B,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtF,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F,4FAA4F;IAC5F,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAIlE,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtE;IAEM,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAsBlC;IAEY,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E;IAGD,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;YAIa,UAAU;YAYV,eAAe;YAiBf,iBAAiB;YAajB,uBAAuB;YAUvB,iBAAiB;YAcjB,iBAAiB;YASjB,oBAAoB;YAiBpB,OAAO;YAOP,cAAc;CAS7B"}
+{"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"}