@aztec/archiver 0.0.1-commit.9593d84 → 0.0.1-commit.96bb3f7

package/dest/archiver/kv_archiver_store/block_store.js

@@ -1,24 +1,27 @@
-import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
-import { Fr } from '@aztec/foundation/fields';
+import { INITIAL_CHECKPOINT_NUMBER, INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
+import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
 import { toArray } from '@aztec/foundation/iterable';
 import { createLogger } from '@aztec/foundation/log';
 import { BufferReader } from '@aztec/foundation/serialize';
 import { bufferToHex } from '@aztec/foundation/string';
-import { Body, CommitteeAttestation, L2Block, L2BlockHash, PublishedL2Block } from '@aztec/stdlib/block';
-import { L2BlockHeader, deserializeValidateBlockResult, serializeValidateBlockResult } from '@aztec/stdlib/block';
+import { isDefined } from '@aztec/foundation/types';
+import { Body, CheckpointedL2Block, CommitteeAttestation, L2BlockHash, L2BlockNew, deserializeValidateCheckpointResult, serializeValidateCheckpointResult } from '@aztec/stdlib/block';
+import { L1PublishedData } from '@aztec/stdlib/checkpoint';
+import { CheckpointHeader } from '@aztec/stdlib/rollup';
 import { AppendOnlyTreeSnapshot } from '@aztec/stdlib/trees';
-import { TxHash, TxReceipt, deserializeIndexedTxEffect, serializeIndexedTxEffect } from '@aztec/stdlib/tx';
-import { BlockNumberNotSequentialError, InitialBlockNumberNotSequentialError } from '../errors.js';
+import { BlockHeader, TxHash, TxReceipt, deserializeIndexedTxEffect, serializeIndexedTxEffect } from '@aztec/stdlib/tx';
+import { BlockArchiveNotConsistentError, BlockIndexNotSequentialError, BlockNotFoundError, BlockNumberNotSequentialError, CheckpointNotFoundError, CheckpointNumberNotConsistentError, CheckpointNumberNotSequentialError, InitialBlockNumberNotSequentialError, InitialCheckpointNumberNotSequentialError } from '../errors.js';
 export { TxReceipt } from '@aztec/stdlib/tx';
 /**
  * LMDB implementation of the ArchiverDataStore interface.
  */ export class BlockStore {
     db;
     /** Map block number to block data */ #blocks;
+    /** Map checkpoint number to checkpoint data */ #checkpoints;
     /** Map block hash to list of tx hashes */ #blockTxs;
     /** Tx hash to serialized IndexedTxEffect */ #txEffects;
     /** Stores L1 block number in which the last processed L2 block was included */ #lastSynchedL1Block;
-    /** Stores l2 block number of the last proven block */ #lastProvenL2Block;
+    /** Stores last proven checkpoint */ #lastProvenCheckpoint;
     /** Stores the pending chain validation status */ #pendingChainValidationStatus;
     /** Index mapping a contract's address (as a string) to its location in a block */ #contractIndex;
     /** Index mapping block hash to block number */ #blockHashIndex;
@@ -34,11 +37,12 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         this.#blockHashIndex = db.openMap('archiver_block_hash_index');
         this.#blockArchiveIndex = db.openMap('archiver_block_archive_index');
         this.#lastSynchedL1Block = db.openSingleton('archiver_last_synched_l1_block');
-        this.#lastProvenL2Block = db.openSingleton('archiver_last_proven_l2_block');
+        this.#lastProvenCheckpoint = db.openSingleton('archiver_last_proven_l2_checkpoint');
         this.#pendingChainValidationStatus = db.openSingleton('archiver_pending_chain_validation_status');
+        this.#checkpoints = db.openMap('archiver_checkpoints');
     }
     /**
-   * Append new blocks to the store's list.
+   * Append new blocks to the store's list. All blocks must be for the 'current' checkpoint
    * @param blocks - The L2 blocks to be added to the store.
    * @returns True if the operation is successful.
    */ async addBlocks(blocks, opts = {}) {
@@ -47,84 +51,332 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         }
         return await this.db.transactionAsync(async ()=>{
             // Check that the block immediately before the first block to be added is present in the store.
-            const firstBlockNumber = blocks[0].block.number;
-            const [previousBlockNumber] = await toArray(this.#blocks.keysAsync({
-                reverse: true,
-                limit: 1,
-                end: firstBlockNumber - 1
-            }));
-            const hasPreviousBlock = firstBlockNumber === INITIAL_L2_BLOCK_NUM || previousBlockNumber !== undefined && previousBlockNumber === firstBlockNumber - 1;
-            if (!opts.force && !hasPreviousBlock) {
+            const firstBlockNumber = blocks[0].number;
+            const firstBlockCheckpointNumber = blocks[0].checkpointNumber;
+            const firstBlockIndex = blocks[0].indexWithinCheckpoint;
+            const firstBlockLastArchive = blocks[0].header.lastArchive.root;
+            // Extract the latest block and checkpoint numbers
+            const previousBlockNumber = await this.getLatestBlockNumber();
+            const previousCheckpointNumber = await this.getLatestCheckpointNumber();
+            // Check that the first block number is the expected one
+            if (!opts.force && previousBlockNumber !== firstBlockNumber - 1) {
                 throw new InitialBlockNumberNotSequentialError(firstBlockNumber, previousBlockNumber);
             }
-            // Iterate over blocks array and insert them, checking that the block numbers are sequential.
+            // The same check as above but for checkpoints
+            if (!opts.force && previousCheckpointNumber !== firstBlockCheckpointNumber - 1) {
+                throw new InitialCheckpointNumberNotSequentialError(firstBlockCheckpointNumber, previousCheckpointNumber);
+            }
+            // Extract the previous block if there is one and see if it is for the same checkpoint or not
+            const previousBlockResult = await this.getBlock(previousBlockNumber);
+            let expectedFirstblockIndex = 0;
+            let previousBlockIndex = undefined;
+            if (previousBlockResult !== undefined) {
+                if (previousBlockResult.checkpointNumber === firstBlockCheckpointNumber) {
+                    // The previous block is for the same checkpoint, therefore our index should follow it
+                    previousBlockIndex = previousBlockResult.indexWithinCheckpoint;
+                    expectedFirstblockIndex = previousBlockIndex + 1;
+                }
+                if (!previousBlockResult.archive.root.equals(firstBlockLastArchive)) {
+                    throw new BlockArchiveNotConsistentError(firstBlockNumber, previousBlockResult.number, firstBlockLastArchive, previousBlockResult.archive.root);
+                }
+            }
+            // Now check that the first block has the expected index value
+            if (!opts.force && expectedFirstblockIndex !== firstBlockIndex) {
+                throw new BlockIndexNotSequentialError(firstBlockIndex, previousBlockIndex);
+            }
+            // Iterate over blocks array and insert them, checking that the block numbers and indexes are sequential. Also check they are for the correct checkpoint.
             let previousBlock = undefined;
             for (const block of blocks){
-                if (!opts.force && previousBlock && previousBlock.block.number + 1 !== block.block.number) {
-                    throw new BlockNumberNotSequentialError(block.block.number, previousBlock.block.number);
+                if (!opts.force && previousBlock) {
+                    if (previousBlock.number + 1 !== block.number) {
+                        throw new BlockNumberNotSequentialError(block.number, previousBlock.number);
+                    }
+                    if (previousBlock.indexWithinCheckpoint + 1 !== block.indexWithinCheckpoint) {
+                        throw new BlockIndexNotSequentialError(block.indexWithinCheckpoint, previousBlock.indexWithinCheckpoint);
+                    }
+                    if (!previousBlock.archive.root.equals(block.header.lastArchive.root)) {
+                        throw new BlockArchiveNotConsistentError(block.number, previousBlock.number, block.header.lastArchive.root, previousBlock.archive.root);
+                    }
+                }
+                if (!opts.force && firstBlockCheckpointNumber !== block.checkpointNumber) {
+                    throw new CheckpointNumberNotConsistentError(block.checkpointNumber, firstBlockCheckpointNumber);
                 }
                 previousBlock = block;
-                const blockHash = L2BlockHash.fromField(await block.block.hash());
-                await this.#blocks.set(block.block.number, {
-                    header: block.block.header.toBuffer(),
-                    blockHash: blockHash.toBuffer(),
-                    archive: block.block.archive.toBuffer(),
-                    l1: block.l1,
-                    attestations: block.attestations.map((attestation)=>attestation.toBuffer())
-                });
-                for(let i = 0; i < block.block.body.txEffects.length; i++){
-                    const txEffect = {
-                        data: block.block.body.txEffects[i],
-                        l2BlockNumber: block.block.number,
-                        l2BlockHash: blockHash,
-                        txIndexInBlock: i
-                    };
-                    await this.#txEffects.set(txEffect.data.txHash.toString(), serializeIndexedTxEffect(txEffect));
+                await this.addBlockToDatabase(block, block.checkpointNumber, block.indexWithinCheckpoint);
+            }
+            return true;
+        });
+    }
+    /**
+   * Append new cheskpoints to the store's list.
+   * @param checkpoints - The L2 checkpoints to be added to the store.
+   * @returns True if the operation is successful.
+   */ async addCheckpoints(checkpoints, opts = {}) {
+        if (checkpoints.length === 0) {
+            return true;
+        }
+        return await this.db.transactionAsync(async ()=>{
+            // Check that the checkpoint immediately before the first block to be added is present in the store.
+            const firstCheckpointNumber = checkpoints[0].checkpoint.number;
+            const previousCheckpointNumber = await this.getLatestCheckpointNumber();
+            if (previousCheckpointNumber !== firstCheckpointNumber - 1 && !opts.force) {
+                throw new InitialCheckpointNumberNotSequentialError(firstCheckpointNumber, previousCheckpointNumber);
+            }
+            // Extract the previous checkpoint if there is one
+            let previousCheckpointData = undefined;
+            if (previousCheckpointNumber !== INITIAL_CHECKPOINT_NUMBER - 1) {
+                // There should be a previous checkpoint
+                previousCheckpointData = await this.getCheckpointData(previousCheckpointNumber);
+                if (previousCheckpointData === undefined) {
+                    throw new CheckpointNotFoundError(previousCheckpointNumber);
+                }
+            }
+            let previousBlockNumber = undefined;
+            let previousBlock = undefined;
+            // If we have a previous checkpoint then we need to get the previous block number
+            if (previousCheckpointData !== undefined) {
+                previousBlockNumber = BlockNumber(previousCheckpointData.startBlock + previousCheckpointData.numBlocks - 1);
+                previousBlock = await this.getBlock(previousBlockNumber);
+                if (previousBlock === undefined) {
+                    // We should be able to get the required previous block
+                    throw new BlockNotFoundError(previousBlockNumber);
+                }
+            }
+            // Iterate over checkpoints array and insert them, checking that the block numbers are sequential.
+            let previousCheckpoint = undefined;
+            for (const checkpoint of checkpoints){
+                if (!opts.force && previousCheckpoint && previousCheckpoint.checkpoint.number + 1 !== checkpoint.checkpoint.number) {
+                    throw new CheckpointNumberNotSequentialError(checkpoint.checkpoint.number, previousCheckpoint.checkpoint.number);
+                }
+                previousCheckpoint = checkpoint;
+                // Store every block in the database. the block may already exist, but this has come from chain and is assumed to be correct.
+                for(let i = 0; i < checkpoint.checkpoint.blocks.length; i++){
+                    const block = checkpoint.checkpoint.blocks[i];
+                    if (previousBlock) {
+                        // The blocks should have a sequential block number
+                        if (previousBlock.number !== block.number - 1) {
+                            throw new BlockNumberNotSequentialError(block.number, previousBlock.number);
+                        }
+                        // If the blocks are for the same checkpoint then they should have sequential indexes
+                        if (previousBlock.checkpointNumber === block.checkpointNumber && previousBlock.indexWithinCheckpoint !== block.indexWithinCheckpoint - 1) {
+                            throw new BlockIndexNotSequentialError(block.indexWithinCheckpoint, previousBlock.indexWithinCheckpoint);
+                        }
+                        if (!previousBlock.archive.root.equals(block.header.lastArchive.root)) {
+                            throw new BlockArchiveNotConsistentError(block.number, previousBlock.number, block.header.lastArchive.root, previousBlock.archive.root);
+                        }
+                    } else {
+                        // No previous block, must be block 1 at checkpoint index 0
+                        if (block.indexWithinCheckpoint !== 0) {
+                            throw new BlockIndexNotSequentialError(block.indexWithinCheckpoint, undefined);
+                        }
+                        if (block.number !== INITIAL_L2_BLOCK_NUM) {
+                            throw new BlockNumberNotSequentialError(block.number, undefined);
+                        }
+                    }
+                    previousBlock = block;
+                    await this.addBlockToDatabase(block, checkpoint.checkpoint.number, i);
                 }
-                await this.#blockTxs.set(blockHash.toString(), Buffer.concat(block.block.body.txEffects.map((tx)=>tx.txHash.toBuffer())));
-                // Update indices for block hash and archive
-                await this.#blockHashIndex.set(blockHash.toString(), block.block.number);
-                await this.#blockArchiveIndex.set(block.block.archive.root.toString(), block.block.number);
+                // Store the checkpoint in the database
+                await this.#checkpoints.set(checkpoint.checkpoint.number, {
+                    header: checkpoint.checkpoint.header.toBuffer(),
+                    archive: checkpoint.checkpoint.archive.toBuffer(),
+                    l1: checkpoint.l1.toBuffer(),
+                    attestations: checkpoint.attestations.map((attestation)=>attestation.toBuffer()),
+                    checkpointNumber: checkpoint.checkpoint.number,
+                    startBlock: checkpoint.checkpoint.blocks[0].number,
+                    numBlocks: checkpoint.checkpoint.blocks.length
+                });
             }
-            await this.#lastSynchedL1Block.set(blocks[blocks.length - 1].l1.blockNumber);
+            await this.#lastSynchedL1Block.set(checkpoints[checkpoints.length - 1].l1.blockNumber);
             return true;
         });
     }
+    async addBlockToDatabase(block, checkpointNumber, indexWithinCheckpoint) {
+        const blockHash = L2BlockHash.fromField(await block.hash());
+        await this.#blocks.set(block.number, {
+            header: block.header.toBuffer(),
+            blockHash: blockHash.toBuffer(),
+            archive: block.archive.toBuffer(),
+            checkpointNumber,
+            indexWithinCheckpoint
+        });
+        for(let i = 0; i < block.body.txEffects.length; i++){
+            const txEffect = {
+                data: block.body.txEffects[i],
+                l2BlockNumber: block.number,
+                l2BlockHash: blockHash,
+                txIndexInBlock: i
+            };
+            await this.#txEffects.set(txEffect.data.txHash.toString(), serializeIndexedTxEffect(txEffect));
+        }
+        await this.#blockTxs.set(blockHash.toString(), Buffer.concat(block.body.txEffects.map((tx)=>tx.txHash.toBuffer())));
+        // Update indices for block hash and archive
+        await this.#blockHashIndex.set(blockHash.toString(), block.number);
+        await this.#blockArchiveIndex.set(block.archive.root.toString(), block.number);
+    }
     /**
-   * Unwinds blocks from the database
+   * Unwinds checkpoints from the database
    * @param from -  The tip of the chain, passed for verification purposes,
    *                ensuring that we don't end up deleting something we did not intend
-   * @param blocksToUnwind - The number of blocks we are to unwind
+   * @param checkpointsToUnwind - The number of checkpoints we are to unwind
    * @returns True if the operation is successful
-   */ async unwindBlocks(from, blocksToUnwind) {
+   */ async unwindCheckpoints(from, checkpointsToUnwind) {
         return await this.db.transactionAsync(async ()=>{
-            const last = await this.getSynchedL2BlockNumber();
+            const last = await this.getLatestCheckpointNumber();
             if (from !== last) {
-                throw new Error(`Can only unwind blocks from the tip (requested ${from} but current tip is ${last})`);
+                throw new Error(`Can only unwind checkpoints from the tip (requested ${from} but current tip is ${last})`);
             }
-            const proven = await this.getProvenL2BlockNumber();
-            if (from - blocksToUnwind < proven) {
-                await this.setProvenL2BlockNumber(from - blocksToUnwind);
+            const proven = await this.getProvenCheckpointNumber();
+            if (from - checkpointsToUnwind < proven) {
+                await this.setProvenCheckpointNumber(CheckpointNumber(from - checkpointsToUnwind));
             }
-            for(let i = 0; i < blocksToUnwind; i++){
-                const blockNumber = from - i;
-                const block = await this.getBlock(blockNumber);
-                if (block === undefined) {
-                    this.#log.warn(`Cannot remove block ${blockNumber} from the store since we don't have it`);
+            for(let i = 0; i < checkpointsToUnwind; i++){
+                const checkpointNumber = from - i;
+                const checkpoint = await this.#checkpoints.getAsync(checkpointNumber);
+                if (checkpoint === undefined) {
+                    this.#log.warn(`Cannot remove checkpoint ${checkpointNumber} from the store since we don't have it`);
                     continue;
                 }
-                await this.#blocks.delete(block.block.number);
-                await Promise.all(block.block.body.txEffects.map((tx)=>this.#txEffects.delete(tx.txHash.toString())));
-                const blockHash = (await block.block.hash()).toString();
-                await this.#blockTxs.delete(blockHash);
-                // Clean up indices
-                await this.#blockHashIndex.delete(blockHash);
-                await this.#blockArchiveIndex.delete(block.block.archive.root.toString());
-                this.#log.debug(`Unwound block ${blockNumber} ${blockHash}`);
+                await this.#checkpoints.delete(checkpointNumber);
+                const maxBlock = checkpoint.startBlock + checkpoint.numBlocks - 1;
+                for(let blockNumber = checkpoint.startBlock; blockNumber <= maxBlock; blockNumber++){
+                    const block = await this.getBlock(BlockNumber(blockNumber));
+                    if (block === undefined) {
+                        this.#log.warn(`Cannot remove block ${blockNumber} from the store since we don't have it`);
+                        continue;
+                    }
+                    await this.#blocks.delete(block.number);
+                    await Promise.all(block.body.txEffects.map((tx)=>this.#txEffects.delete(tx.txHash.toString())));
+                    const blockHash = (await block.hash()).toString();
+                    await this.#blockTxs.delete(blockHash);
+                    // Clean up indices
+                    await this.#blockHashIndex.delete(blockHash);
+                    await this.#blockArchiveIndex.delete(block.archive.root.toString());
+                    this.#log.debug(`Unwound block ${blockNumber} ${blockHash} for checkpoint ${checkpointNumber}`);
+                }
             }
             return true;
         });
     }
+    async getCheckpointData(checkpointNumber) {
+        const checkpointStorage = await this.#checkpoints.getAsync(checkpointNumber);
+        if (!checkpointStorage) {
+            return undefined;
+        }
+        return this.checkpointDataFromCheckpointStorage(checkpointStorage);
+    }
+    async getRangeOfCheckpoints(from, limit) {
+        const checkpoints = [];
+        for(let checkpointNumber = from; checkpointNumber < from + limit; checkpointNumber++){
+            const checkpoint = await this.#checkpoints.getAsync(checkpointNumber);
+            if (!checkpoint) {
+                break;
+            }
+            checkpoints.push(this.checkpointDataFromCheckpointStorage(checkpoint));
+        }
+        return checkpoints;
+    }
+    checkpointDataFromCheckpointStorage(checkpointStorage) {
+        const data = {
+            header: CheckpointHeader.fromBuffer(checkpointStorage.header),
+            archive: AppendOnlyTreeSnapshot.fromBuffer(checkpointStorage.archive),
+            checkpointNumber: CheckpointNumber(checkpointStorage.checkpointNumber),
+            startBlock: checkpointStorage.startBlock,
+            numBlocks: checkpointStorage.numBlocks,
+            l1: L1PublishedData.fromBuffer(checkpointStorage.l1),
+            attestations: checkpointStorage.attestations
+        };
+        return data;
+    }
+    async getBlocksForCheckpoint(checkpointNumber) {
+        const checkpoint = await this.#checkpoints.getAsync(checkpointNumber);
+        if (!checkpoint) {
+            return undefined;
+        }
+        const blocksForCheckpoint = await toArray(this.#blocks.entriesAsync({
+            start: checkpoint.startBlock,
+            end: checkpoint.startBlock + checkpoint.numBlocks
+        }));
+        const converted = await Promise.all(blocksForCheckpoint.map((x)=>this.getBlockFromBlockStorage(x[0], x[1])));
+        return converted.filter(isDefined);
+    }
+    async getProvenBlockNumber() {
+        const provenCheckpointNumber = await this.getProvenCheckpointNumber();
+        if (provenCheckpointNumber === INITIAL_CHECKPOINT_NUMBER - 1) {
+            return BlockNumber(INITIAL_L2_BLOCK_NUM - 1);
+        }
+        const checkpointStorage = await this.#checkpoints.getAsync(provenCheckpointNumber);
+        if (!checkpointStorage) {
+            throw new CheckpointNotFoundError(provenCheckpointNumber);
+        } else {
+            return BlockNumber(checkpointStorage.startBlock + checkpointStorage.numBlocks - 1);
+        }
+    }
+    async getLatestBlockNumber() {
+        const [latestBlocknumber] = await toArray(this.#blocks.keysAsync({
+            reverse: true,
+            limit: 1
+        }));
+        return typeof latestBlocknumber === 'number' ? BlockNumber(latestBlocknumber) : BlockNumber(INITIAL_L2_BLOCK_NUM - 1);
+    }
+    async getLatestCheckpointNumber() {
+        const [latestCheckpointNumber] = await toArray(this.#checkpoints.keysAsync({
+            reverse: true,
+            limit: 1
+        }));
+        if (latestCheckpointNumber === undefined) {
+            return CheckpointNumber(INITIAL_CHECKPOINT_NUMBER - 1);
+        }
+        return CheckpointNumber(latestCheckpointNumber);
+    }
+    async getCheckpointedBlock(number) {
+        const blockStorage = await this.#blocks.getAsync(number);
+        if (!blockStorage) {
+            return undefined;
+        }
+        const checkpoint = await this.#checkpoints.getAsync(blockStorage.checkpointNumber);
+        if (!checkpoint) {
+            return undefined;
+        }
+        const block = await this.getBlockFromBlockStorage(number, blockStorage);
+        if (!block) {
+            return undefined;
+        }
+        return new CheckpointedL2Block(CheckpointNumber(checkpoint.checkpointNumber), block, L1PublishedData.fromBuffer(checkpoint.l1), checkpoint.attestations.map((buf)=>CommitteeAttestation.fromBuffer(buf)));
+    }
+    /**
+   * Gets up to `limit` amount of Checkpointed L2 blocks starting from `from`.
+   * @param start - Number of the first block to return (inclusive).
+   * @param limit - The number of blocks to return.
+   * @returns The requested L2 blocks
+   */ async *getCheckpointedBlocks(start, limit) {
+        const checkpointCache = new Map();
+        for await (const [blockNumber, blockStorage] of this.getBlockStorages(start, limit)){
+            const block = await this.getBlockFromBlockStorage(blockNumber, blockStorage);
+            if (block) {
+                const checkpoint = checkpointCache.get(CheckpointNumber(blockStorage.checkpointNumber)) ?? await this.#checkpoints.getAsync(blockStorage.checkpointNumber);
+                if (checkpoint) {
+                    checkpointCache.set(CheckpointNumber(blockStorage.checkpointNumber), checkpoint);
+                    const checkpointedBlock = new CheckpointedL2Block(CheckpointNumber(checkpoint.checkpointNumber), block, L1PublishedData.fromBuffer(checkpoint.l1), checkpoint.attestations.map((buf)=>CommitteeAttestation.fromBuffer(buf)));
+                    yield checkpointedBlock;
+                }
+            }
+        }
+    }
+    async getCheckpointedBlockByHash(blockHash) {
+        const blockNumber = await this.#blockHashIndex.getAsync(blockHash.toString());
+        if (blockNumber === undefined) {
+            return undefined;
+        }
+        return this.getCheckpointedBlock(BlockNumber(blockNumber));
+    }
+    async getCheckpointedBlockByArchive(archive) {
+        const blockNumber = await this.#blockArchiveIndex.getAsync(archive.toString());
+        if (blockNumber === undefined) {
+            return undefined;
+        }
+        return this.getCheckpointedBlock(BlockNumber(blockNumber));
+    }
     /**
    * Gets up to `limit` amount of L2 blocks starting from `from`.
    * @param start - Number of the first block to return (inclusive).
@@ -158,7 +410,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (blockNumber === undefined) {
             return undefined;
         }
-        return this.getBlock(blockNumber);
+        return this.getBlock(BlockNumber(blockNumber));
     }
     /**
    * Gets an L2 block by its archive root.
@@ -169,7 +421,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (blockNumber === undefined) {
             return undefined;
         }
-        return this.getBlock(blockNumber);
+        return this.getBlock(BlockNumber(blockNumber));
     }
     /**
    * Gets a block header by its hash.
@@ -184,7 +436,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (!blockStorage || !blockStorage.header) {
             return undefined;
         }
-        return L2BlockHeader.fromBuffer(blockStorage.header).toBlockHeader();
+        return BlockHeader.fromBuffer(blockStorage.header);
     }
     /**
    * Gets a block header by its archive root.
@@ -199,7 +451,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (!blockStorage || !blockStorage.header) {
             return undefined;
         }
-        return L2BlockHeader.fromBuffer(blockStorage.header).toBlockHeader();
+        return BlockHeader.fromBuffer(blockStorage.header);
     }
     /**
    * Gets the headers for a sequence of L2 blocks.
@@ -208,7 +460,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
    * @returns The requested L2 block headers
    */ async *getBlockHeaders(start, limit) {
         for await (const [blockNumber, blockStorage] of this.getBlockStorages(start, limit)){
-            const header = L2BlockHeader.fromBuffer(blockStorage.header).toBlockHeader();
+            const header = BlockHeader.fromBuffer(blockStorage.header);
             if (header.getBlockNumber() !== blockNumber) {
                 throw new Error(`Block number mismatch when retrieving block header from archive (expected ${blockNumber} but got ${header.getBlockNumber()})`);
             }
@@ -229,7 +481,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         }
     }
     async getBlockFromBlockStorage(blockNumber, blockStorage) {
-        const header = L2BlockHeader.fromBuffer(blockStorage.header);
+        const header = BlockHeader.fromBuffer(blockStorage.header);
         const archive = AppendOnlyTreeSnapshot.fromBuffer(blockStorage.archive);
         const blockHash = blockStorage.blockHash;
         const blockHashString = bufferToHex(blockHash);
@@ -250,16 +502,11 @@ export { TxReceipt } from '@aztec/stdlib/tx';
             txEffects.push(deserializeIndexedTxEffect(txEffect).data);
         }
         const body = new Body(txEffects);
-        const block = new L2Block(archive, header, body, Fr.fromBuffer(blockHash));
+        const block = new L2BlockNew(archive, header, body, CheckpointNumber(blockStorage.checkpointNumber), blockStorage.indexWithinCheckpoint);
         if (block.number !== blockNumber) {
             throw new Error(`Block number mismatch when retrieving block from archive (expected ${blockNumber} but got ${block.number} with hash ${blockHashString})`);
         }
-        const attestations = blockStorage.attestations.map(CommitteeAttestation.fromBuffer);
-        return PublishedL2Block.fromFields({
-            block,
-            l1: blockStorage.l1,
-            attestations
-        });
+        return block;
     }
     /**
    * Gets a tx effect.
@@ -281,7 +528,7 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (!txEffect) {
             return undefined;
         }
-        return new TxReceipt(txHash, TxReceipt.statusFromRevertCode(txEffect.data.revertCode), '', txEffect.data.transactionFee.toBigInt(), txEffect.l2BlockHash, txEffect.l2BlockNumber);
+        return new TxReceipt(txHash, TxReceipt.statusFromRevertCode(txEffect.data.revertCode), '', txEffect.data.transactionFee.toBigInt(), txEffect.l2BlockHash, BlockNumber(txEffect.l2BlockNumber));
     }
     /**
    * Looks up which block included the requested tx effect.
@@ -306,14 +553,22 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         return this.#contractIndex.getAsync(contractAddress.toString());
     }
     /**
-   * Gets the number of the latest L2 block processed.
-   * @returns The number of the latest L2 block processed.
-   */ async getSynchedL2BlockNumber() {
+   * Gets the number of the latest L2 block checkpointed.
+   * @returns The number of the latest L2 block checkpointed.
+   */ async getCheckpointedL2BlockNumber() {
+        const latestCheckpointNumber = await this.getLatestCheckpointNumber();
+        const checkpoint = await this.getCheckpointData(latestCheckpointNumber);
+        if (!checkpoint) {
+            return BlockNumber(INITIAL_L2_BLOCK_NUM - 1);
+        }
+        return BlockNumber(checkpoint.startBlock + checkpoint.numBlocks - 1);
+    }
+    async getLatestL2BlockNumber() {
         const [lastBlockNumber] = await toArray(this.#blocks.keysAsync({
             reverse: true,
             limit: 1
         }));
-        return typeof lastBlockNumber === 'number' ? lastBlockNumber : INITIAL_L2_BLOCK_NUM - 1;
+        return typeof lastBlockNumber === 'number' ? BlockNumber(lastBlockNumber) : BlockNumber(INITIAL_L2_BLOCK_NUM - 1);
     }
     /**
    * Gets the most recent L1 block processed.
@@ -324,15 +579,16 @@ export { TxReceipt } from '@aztec/stdlib/tx';
     setSynchedL1BlockNumber(l1BlockNumber) {
         return this.#lastSynchedL1Block.set(l1BlockNumber);
     }
-    async getProvenL2BlockNumber() {
-        const [latestBlockNumber, provenBlockNumber] = await Promise.all([
-            this.getSynchedL2BlockNumber(),
-            this.#lastProvenL2Block.getAsync()
+    async getProvenCheckpointNumber() {
+        const [latestCheckpointNumber, provenCheckpointNumber] = await Promise.all([
+            this.getLatestCheckpointNumber(),
+            this.#lastProvenCheckpoint.getAsync()
         ]);
-        return (provenBlockNumber ?? 0) > latestBlockNumber ? latestBlockNumber : provenBlockNumber ?? 0;
+        return (provenCheckpointNumber ?? 0) > latestCheckpointNumber ? latestCheckpointNumber : CheckpointNumber(provenCheckpointNumber ?? 0);
     }
-    setProvenL2BlockNumber(blockNumber) {
-        return this.#lastProvenL2Block.set(blockNumber);
+    async setProvenCheckpointNumber(checkpointNumber) {
+        const result = await this.#lastProvenCheckpoint.set(checkpointNumber);
+        return result;
     }
     #computeBlockRange(start, limit) {
         if (limit < 1) {
@@ -354,14 +610,14 @@ export { TxReceipt } from '@aztec/stdlib/tx';
         if (!buffer) {
             return undefined;
         }
-        return deserializeValidateBlockResult(buffer);
+        return deserializeValidateCheckpointResult(buffer);
     }
     /**
    * Sets the pending chain validation status.
    * @param status - The validation status to store.
    */ async setPendingChainValidationStatus(status) {
         if (status) {
-            const buffer = serializeValidateBlockResult(status);
+            const buffer = serializeValidateCheckpointResult(status);
             await this.#pendingChainValidationStatus.set(buffer);
         } else {
             await this.#pendingChainValidationStatus.delete();

package/dest/archiver/kv_archiver_store/contract_class_store.d.ts

@@ -1,4 +1,4 @@
-import { Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import type { AztecAsyncKVStore } from '@aztec/kv-store';
 import type { ContractClassPublic, ExecutablePrivateFunctionWithMembershipProof, UtilityFunctionWithMembershipProof } from '@aztec/stdlib/contract';
 /**
@@ -15,4 +15,4 @@ export declare class ContractClassStore {
     getContractClassIds(): Promise<Fr[]>;
     addFunctions(contractClassId: Fr, newPrivateFunctions: ExecutablePrivateFunctionWithMembershipProof[], newUtilityFunctions: UtilityFunctionWithMembershipProof[]): Promise<boolean>;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3Nfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcmNoaXZlci9rdl9hcmNoaXZlcl9zdG9yZS9jb250cmFjdF9jbGFzc19zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFHOUMsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFFeEUsT0FBTyxLQUFLLEVBQ1YsbUJBQW1CLEVBRW5CLDRDQUE0QyxFQUM1QyxrQ0FBa0MsRUFDbkMsTUFBTSx3QkFBd0IsQ0FBQztBQUdoQzs7R0FFRztBQUNILHFCQUFhLGtCQUFrQjs7SUFJakIsT0FBTyxDQUFDLEVBQUU7SUFBdEIsWUFBb0IsRUFBRSxFQUFFLGlCQUFpQixFQUd4QztJQUVLLGdCQUFnQixDQUNwQixhQUFhLEVBQUUsbUJBQW1CLEVBQ2xDLGtCQUFrQixFQUFFLEVBQUUsRUFDdEIsV0FBVyxFQUFFLE1BQU0sR0FDbEIsT0FBTyxDQUFDLElBQUksQ0FBQyxDQU1mO0lBRUsscUJBQXFCLENBQUMsYUFBYSxFQUFFLG1CQUFtQixFQUFFLFdBQVcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQU1sRztJQUVLLGdCQUFnQixDQUFDLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLG1CQUFtQixHQUFHLFNBQVMsQ0FBQyxDQUd2RTtJQUVLLHFCQUFxQixDQUFDLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLEVBQUUsR0FBRyxTQUFTLENBQUMsQ0FHM0Q7SUFFSyxtQkFBbUIsSUFBSSxPQUFPLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FFekM7SUFFSyxZQUFZLENBQ2hCLGVBQWUsRUFBRSxFQUFFLEVBQ25CLG1CQUFtQixFQUFFLDRDQUE0QyxFQUFFLEVBQ25FLG1CQUFtQixFQUFFLGtDQUFrQyxFQUFFLEdBQ3hELE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0F5QmxCO0NBQ0YifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3Nfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcmNoaXZlci9rdl9hcmNoaXZlcl9zdG9yZS9jb250cmFjdF9jbGFzc19zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFHcEQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFFeEUsT0FBTyxLQUFLLEVBQ1YsbUJBQW1CLEVBRW5CLDRDQUE0QyxFQUM1QyxrQ0FBa0MsRUFDbkMsTUFBTSx3QkFBd0IsQ0FBQztBQUdoQzs7R0FFRztBQUNILHFCQUFhLGtCQUFrQjs7SUFJakIsT0FBTyxDQUFDLEVBQUU7SUFBdEIsWUFBb0IsRUFBRSxFQUFFLGlCQUFpQixFQUd4QztJQUVLLGdCQUFnQixDQUNwQixhQUFhLEVBQUUsbUJBQW1CLEVBQ2xDLGtCQUFrQixFQUFFLEVBQUUsRUFDdEIsV0FBVyxFQUFFLE1BQU0sR0FDbEIsT0FBTyxDQUFDLElBQUksQ0FBQyxDQU1mO0lBRUsscUJBQXFCLENBQUMsYUFBYSxFQUFFLG1CQUFtQixFQUFFLFdBQVcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQU1sRztJQUVLLGdCQUFnQixDQUFDLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLG1CQUFtQixHQUFHLFNBQVMsQ0FBQyxDQUd2RTtJQUVLLHFCQUFxQixDQUFDLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLEVBQUUsR0FBRyxTQUFTLENBQUMsQ0FHM0Q7SUFFSyxtQkFBbUIsSUFBSSxPQUFPLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FFekM7SUFFSyxZQUFZLENBQ2hCLGVBQWUsRUFBRSxFQUFFLEVBQ25CLG1CQUFtQixFQUFFLDRDQUE0QyxFQUFFLEVBQ25FLG1CQUFtQixFQUFFLGtDQUFrQyxFQUFFLEdBQ3hELE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0F5QmxCO0NBQ0YifQ==

package/dest/archiver/kv_archiver_store/contract_class_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract_class_store.d.ts","sourceRoot":"","sources":["../../../src/archiver/kv_archiver_store/contract_class_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAG9C,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AAExE,OAAO,KAAK,EACV,mBAAmB,EAEnB,4CAA4C,EAC5C,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,qBAAa,kBAAkB;;IAIjB,OAAO,CAAC,EAAE;IAAtB,YAAoB,EAAE,EAAE,iBAAiB,EAGxC;IAEK,gBAAgB,CACpB,aAAa,EAAE,mBAAmB,EAClC,kBAAkB,EAAE,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;IAEK,qBAAqB,CAAC,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlG;IAEK,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAGvE;IAEK,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAG3D;IAEK,mBAAmB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAEzC;IAEK,YAAY,CAChB,eAAe,EAAE,EAAE,EACnB,mBAAmB,EAAE,4CAA4C,EAAE,EACnE,mBAAmB,EAAE,kCAAkC,EAAE,GACxD,OAAO,CAAC,OAAO,CAAC,CAyBlB;CACF"}
+{"version":3,"file":"contract_class_store.d.ts","sourceRoot":"","sources":["../../../src/archiver/kv_archiver_store/contract_class_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAGpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AAExE,OAAO,KAAK,EACV,mBAAmB,EAEnB,4CAA4C,EAC5C,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,qBAAa,kBAAkB;;IAIjB,OAAO,CAAC,EAAE;IAAtB,YAAoB,EAAE,EAAE,iBAAiB,EAGxC;IAEK,gBAAgB,CACpB,aAAa,EAAE,mBAAmB,EAClC,kBAAkB,EAAE,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;IAEK,qBAAqB,CAAC,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlG;IAEK,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAGvE;IAEK,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAG3D;IAEK,mBAAmB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAEzC;IAEK,YAAY,CAChB,eAAe,EAAE,EAAE,EACnB,mBAAmB,EAAE,4CAA4C,EAAE,EACnE,mBAAmB,EAAE,kCAAkC,EAAE,GACxD,OAAO,CAAC,OAAO,CAAC,CAyBlB;CACF"}

package/dest/archiver/kv_archiver_store/contract_class_store.js

@@ -1,4 +1,4 @@
-import { Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { toArray } from '@aztec/foundation/iterable';
 import { BufferReader, numToUInt8, serializeToBuffer } from '@aztec/foundation/serialize';
 import { FunctionSelector } from '@aztec/stdlib/abi';

package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts

@@ -1,4 +1,4 @@
-import type { Fr } from '@aztec/foundation/fields';
+import type { Fr } from '@aztec/foundation/curves/bn254';
 import type { AztecAsyncKVStore } from '@aztec/kv-store';
 import type { AztecAddress } from '@aztec/stdlib/aztec-address';
 import { type ContractInstanceUpdateWithAddress, type ContractInstanceWithAddress } from '@aztec/stdlib/contract';
@@ -21,4 +21,4 @@ export declare class ContractInstanceStore {
     getContractInstanceDeploymentBlockNumber(address: AztecAddress): Promise<number | undefined>;
 }
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2Vfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcmNoaXZlci9rdl9hcmNoaXZlcl9zdG9yZS9jb250cmFjdF9pbnN0YW5jZV9zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNuRCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUN4RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEVBQ0wsS0FBSyxpQ0FBaUMsRUFDdEMsS0FBSywyQkFBMkIsRUFHakMsTUFBTSx3QkFBd0IsQ0FBQztBQUNoQyxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVsRCxLQUFLLHlCQUF5QixHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztBQUU3RTs7R0FFRztBQUNILHFCQUFhLHFCQUFxQjs7SUFLcEIsT0FBTyxDQUFDLEVBQUU7SUFBdEIsWUFBb0IsRUFBRSxFQUFFLGlCQUFpQixFQUl4QztJQUVELG1CQUFtQixDQUFDLGdCQUFnQixFQUFFLDJCQUEyQixFQUFFLFdBQVcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVFyRztJQUVELHNCQUFzQixDQUFDLGdCQUFnQixFQUFFLDJCQUEyQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FLbkY7SUFFRCxZQUFZLENBQUMsZUFBZSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFFLFFBQVEsQ0FBQyxFQUFFLE1BQU0sR0FBRyx5QkFBeUIsQ0FNM0c7SUFFRCx5QkFBeUIsQ0FDdkIsc0JBQXNCLEVBQUUsaUNBQWlDLEVBQ3pELFNBQVMsRUFBRSxNQUFNLEVBQ2pCLFFBQVEsRUFBRSxNQUFNLEdBQ2YsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUtmO0lBRUQsNEJBQTRCLENBQzFCLHNCQUFzQixFQUFFLGlDQUFpQyxFQUN6RCxTQUFTLEVBQUUsTUFBTSxFQUNqQixRQUFRLEVBQUUsTUFBTSxHQUNmLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFZjtJQUVLLGlDQUFpQyxDQUFDLE9BQU8sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxlQUFlLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FvQmxIO0lBRUssbUJBQW1CLENBQ3ZCLE9BQU8sRUFBRSxZQUFZLEVBQ3JCLFNBQVMsRUFBRSxNQUFNLEdBQ2hCLE9BQU8sQ0FBQywyQkFBMkIsR0FBRyxTQUFTLENBQUMsQ0FhbEQ7SUFFRCx3Q0FBd0MsQ0FBQyxPQUFPLEVBQUUsWUFBWSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRTNGO0NBQ0YifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2Vfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcmNoaXZlci9rdl9hcmNoaXZlcl9zdG9yZS9jb250cmFjdF9pbnN0YW5jZV9zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUN4RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEVBQ0wsS0FBSyxpQ0FBaUMsRUFDdEMsS0FBSywyQkFBMkIsRUFHakMsTUFBTSx3QkFBd0IsQ0FBQztBQUNoQyxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVsRCxLQUFLLHlCQUF5QixHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztBQUU3RTs7R0FFRztBQUNILHFCQUFhLHFCQUFxQjs7SUFLcEIsT0FBTyxDQUFDLEVBQUU7SUFBdEIsWUFBb0IsRUFBRSxFQUFFLGlCQUFpQixFQUl4QztJQUVELG1CQUFtQixDQUFDLGdCQUFnQixFQUFFLDJCQUEyQixFQUFFLFdBQVcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVFyRztJQUVELHNCQUFzQixDQUFDLGdCQUFnQixFQUFFLDJCQUEyQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FLbkY7SUFFRCxZQUFZLENBQUMsZUFBZSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFFLFFBQVEsQ0FBQyxFQUFFLE1BQU0sR0FBRyx5QkFBeUIsQ0FNM0c7SUFFRCx5QkFBeUIsQ0FDdkIsc0JBQXNCLEVBQUUsaUNBQWlDLEVBQ3pELFNBQVMsRUFBRSxNQUFNLEVBQ2pCLFFBQVEsRUFBRSxNQUFNLEdBQ2YsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUtmO0lBRUQsNEJBQTRCLENBQzFCLHNCQUFzQixFQUFFLGlDQUFpQyxFQUN6RCxTQUFTLEVBQUUsTUFBTSxFQUNqQixRQUFRLEVBQUUsTUFBTSxHQUNmLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFZjtJQUVLLGlDQUFpQyxDQUFDLE9BQU8sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxlQUFlLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FvQmxIO0lBRUssbUJBQW1CLENBQ3ZCLE9BQU8sRUFBRSxZQUFZLEVBQ3JCLFNBQVMsRUFBRSxNQUFNLEdBQ2hCLE9BQU8sQ0FBQywyQkFBMkIsR0FBRyxTQUFTLENBQUMsQ0FhbEQ7SUFFRCx3Q0FBd0MsQ0FBQyxPQUFPLEVBQUUsWUFBWSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRTNGO0NBQ0YifQ==