@aztec/archiver 0.0.0-test.1 → 0.0.1-commit.1142ef1

package/dest/archiver/kv_archiver_store/message_store.js

@@ -1,57 +1,113 @@
-import { L1_TO_L2_MSG_SUBTREE_HEIGHT } from '@aztec/constants';
-import { Fr } from '@aztec/foundation/fields';
+import { CheckpointNumber } from '@aztec/foundation/branded-types';
+import { Buffer16, Buffer32 } from '@aztec/foundation/buffer';
+import { toArray } from '@aztec/foundation/iterable';
 import { createLogger } from '@aztec/foundation/log';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { mapRange } from '@aztec/kv-store';
 import { InboxLeaf } from '@aztec/stdlib/messaging';
-/**
- * LMDB implementation of the ArchiverDataStore interface.
- */ export class MessageStore {
+import { deserializeInboxMessage, serializeInboxMessage, updateRollingHash } from '../structs/inbox_message.js';
+export class MessageStoreError extends Error {
+    inboxMessage;
+    constructor(message, inboxMessage){
+        super(message), this.inboxMessage = inboxMessage;
+        this.name = 'MessageStoreError';
+    }
+}
+export class MessageStore {
     db;
-    #l1ToL2Messages;
-    #l1ToL2MessageIndices;
-    #lastSynchedL1Block;
-    #totalMessageCount;
+    /** Maps from message index to serialized InboxMessage */ #l1ToL2Messages;
+    /** Maps from hex-stringified message leaf to its index */ #l1ToL2MessageIndices;
+    /** Stores L1 block number and hash of the L1 synchpoint */ #lastSynchedL1Block;
+    /** Stores total messages stored */ #totalMessageCount;
     #log;
-    #l1ToL2MessagesSubtreeSize;
     constructor(db){
         this.db = db;
         this.#log = createLogger('archiver:message_store');
-        this.#l1ToL2MessagesSubtreeSize = 2 ** L1_TO_L2_MSG_SUBTREE_HEIGHT;
         this.#l1ToL2Messages = db.openMap('archiver_l1_to_l2_messages');
         this.#l1ToL2MessageIndices = db.openMap('archiver_l1_to_l2_message_indices');
-        this.#lastSynchedL1Block = db.openSingleton('archiver_last_l1_block_new_messages');
+        this.#lastSynchedL1Block = db.openSingleton('archiver_last_l1_block_id');
         this.#totalMessageCount = db.openSingleton('archiver_l1_to_l2_message_count');
     }
     async getTotalL1ToL2MessageCount() {
         return await this.#totalMessageCount.getAsync() ?? 0n;
     }
-    /**
-   * Gets the last L1 block number that emitted new messages.
-   * @returns The last L1 block number processed
-   */ getSynchedL1BlockNumber() {
-        return this.#lastSynchedL1Block.getAsync();
+    /** Gets the last L1 block synced. */ async getSynchedL1Block() {
+        const buffer = await this.#lastSynchedL1Block.getAsync();
+        if (!buffer) {
+            return undefined;
+        }
+        const reader = BufferReader.asReader(buffer);
+        return {
+            l1BlockNumber: reader.readUInt256(),
+            l1BlockHash: Buffer32.fromBuffer(reader.readBytes(Buffer32.SIZE))
+        };
     }
-    async setSynchedL1BlockNumber(l1BlockNumber) {
-        await this.#lastSynchedL1Block.set(l1BlockNumber);
+    /** Sets the last L1 block synced */ async setSynchedL1Block(l1Block) {
+        const buffer = serializeToBuffer([
+            l1Block.l1BlockNumber,
+            l1Block.l1BlockHash
+        ]);
+        await this.#lastSynchedL1Block.set(buffer);
     }
     /**
    * Append L1 to L2 messages to the store.
-   * @param messages - The L1 to L2 messages to be added to the store and the last processed L1 block.
-   * @returns True if the operation is successful.
+   * Requires new messages to be in order and strictly after the last message added.
+   * Throws if out of order messages are added or if the rolling hash is invalid.
    */ addL1ToL2Messages(messages) {
+        if (messages.length === 0) {
+            return Promise.resolve();
+        }
         return this.db.transactionAsync(async ()=>{
-            const lastL1BlockNumber = await this.#lastSynchedL1Block.getAsync() ?? 0n;
-            if (lastL1BlockNumber >= messages.lastProcessedL1BlockNumber) {
-                return false;
+            let lastMessage = await this.getLastMessage();
+            let messageCount = 0;
+            for (const message of messages){
+                // Check messages are inserted in increasing order, but allow reinserting messages.
+                if (lastMessage && message.index <= lastMessage.index) {
+                    const existing = await this.#l1ToL2Messages.getAsync(this.indexToKey(message.index));
+                    if (existing && deserializeInboxMessage(existing).rollingHash.equals(message.rollingHash)) {
+                        // We reinsert instead of skipping in case the message was re-orged and got added in a different L1 block.
+                        this.#log.trace(`Reinserting message with index ${message.index} in the store`);
+                        await this.#l1ToL2Messages.set(this.indexToKey(message.index), serializeInboxMessage(message));
+                        continue;
+                    }
+                    throw new MessageStoreError(`Cannot insert L1 to L2 message with index ${message.index} before last message with index ${lastMessage.index}`, message);
+                }
+                // Check rolling hash is valid.
+                const previousRollingHash = lastMessage?.rollingHash ?? Buffer16.ZERO;
+                const expectedRollingHash = updateRollingHash(previousRollingHash, message.leaf);
+                if (!expectedRollingHash.equals(message.rollingHash)) {
+                    throw new MessageStoreError(`Invalid rolling hash for incoming L1 to L2 message ${message.leaf.toString()} ` + `with index ${message.index} ` + `(expected ${expectedRollingHash.toString()} from previous hash ${previousRollingHash} but got ${message.rollingHash.toString()})`, message);
+                }
+                // Check index corresponds to the checkpoint number.
+                const [expectedStart, expectedEnd] = InboxLeaf.indexRangeForCheckpoint(message.checkpointNumber);
+                if (message.index < expectedStart || message.index >= expectedEnd) {
+                    throw new MessageStoreError(`Invalid index ${message.index} for incoming L1 to L2 message ${message.leaf.toString()} ` + `at checkpoint ${message.checkpointNumber} (expected value in range [${expectedStart}, ${expectedEnd}))`, message);
+                }
+                // Check there are no gaps in the indices within the same checkpoint.
+                if (lastMessage && message.checkpointNumber === lastMessage.checkpointNumber && message.index !== lastMessage.index + 1n) {
+                    throw new MessageStoreError(`Missing prior message for incoming L1 to L2 message ${message.leaf.toString()} ` + `with index ${message.index}`, message);
+                }
+                // Check the first message in a block has the correct index.
+                if ((!lastMessage || message.checkpointNumber > lastMessage.checkpointNumber) && message.index !== expectedStart) {
+                    throw new MessageStoreError(`Message ${message.leaf.toString()} for checkpoint ${message.checkpointNumber} has wrong index ` + `${message.index} (expected ${expectedStart})`, message);
+                }
+                // Perform the insertions.
+                await this.#l1ToL2Messages.set(this.indexToKey(message.index), serializeInboxMessage(message));
+                await this.#l1ToL2MessageIndices.set(this.leafToIndexKey(message.leaf), message.index);
+                messageCount++;
+                this.#log.trace(`Inserted L1 to L2 message ${message.leaf} with index ${message.index} into the store`);
+                lastMessage = message;
             }
-            await this.#lastSynchedL1Block.set(messages.lastProcessedL1BlockNumber);
-            for (const message of messages.retrievedData){
-                const key = `${message.index}`;
-                await this.#l1ToL2Messages.set(key, message.leaf.toBuffer());
-                await this.#l1ToL2MessageIndices.set(message.leaf.toString(), message.index);
+            // Update the L1 sync point to that of the last message added.
+            const currentSyncPoint = await this.getSynchedL1Block();
+            if (!currentSyncPoint || currentSyncPoint.l1BlockNumber < lastMessage.l1BlockNumber) {
+                await this.setSynchedL1Block({
+                    l1BlockNumber: lastMessage.l1BlockNumber,
+                    l1BlockHash: lastMessage.l1BlockHash
+                });
             }
-            const lastTotalMessageCount = await this.getTotalL1ToL2MessageCount();
-            await this.#totalMessageCount.set(lastTotalMessageCount + BigInt(messages.retrievedData.length));
-            return true;
+            // Update total message count with the number of inserted messages.
+            await this.increaseTotalMessageCount(messageCount);
         });
     }
     /**
@@ -59,27 +115,74 @@ import { InboxLeaf } from '@aztec/stdlib/messaging';
    * @param l1ToL2Message - The L1 to L2 message.
    * @returns The index of the L1 to L2 message in the L1 to L2 message tree (undefined if not found).
    */ getL1ToL2MessageIndex(l1ToL2Message) {
-        return this.#l1ToL2MessageIndices.getAsync(l1ToL2Message.toString());
+        return this.#l1ToL2MessageIndices.getAsync(this.leafToIndexKey(l1ToL2Message));
+    }
+    async getLastMessage() {
+        const [msg] = await toArray(this.#l1ToL2Messages.valuesAsync({
+            reverse: true,
+            limit: 1
+        }));
+        return msg ? deserializeInboxMessage(msg) : undefined;
     }
-    async getL1ToL2Messages(blockNumber) {
+    async getL1ToL2Messages(checkpointNumber) {
         const messages = [];
-        let undefinedMessageFound = false;
-        const startIndex = Number(InboxLeaf.smallestIndexFromL2Block(blockNumber));
-        for(let i = startIndex; i < startIndex + this.#l1ToL2MessagesSubtreeSize; i++){
-            // This is inefficient but probably fine for now.
-            const key = `${i}`;
-            const message = await this.#l1ToL2Messages.getAsync(key);
-            if (message) {
-                if (undefinedMessageFound) {
-                    throw new Error(`L1 to L2 message gap found in block ${blockNumber}`);
-                }
-                messages.push(Fr.fromBuffer(message));
-            } else {
-                undefinedMessageFound = true;
-            // We continue iterating over messages here to verify that there are no more messages after the undefined one.
-            // --> If this was the case this would imply there is some issue with log fetching.
+        const [startIndex, endIndex] = InboxLeaf.indexRangeForCheckpoint(checkpointNumber);
+        let lastIndex = startIndex - 1n;
+        for await (const msgBuffer of this.#l1ToL2Messages.valuesAsync({
+            start: this.indexToKey(startIndex),
+            end: this.indexToKey(endIndex)
+        })){
+            const msg = deserializeInboxMessage(msgBuffer);
+            if (msg.checkpointNumber !== checkpointNumber) {
+                throw new Error(`L1 to L2 message with index ${msg.index} has invalid checkpoint number ${msg.checkpointNumber}`);
+            } else if (msg.index !== lastIndex + 1n) {
+                throw new Error(`Expected L1 to L2 message with index ${lastIndex + 1n} but got ${msg.index}`);
             }
+            lastIndex = msg.index;
+            messages.push(msg.leaf);
         }
         return messages;
     }
+    async *iterateL1ToL2Messages(range = {}) {
+        const entriesRange = mapRange(range, this.indexToKey);
+        for await (const msgBuffer of this.#l1ToL2Messages.valuesAsync(entriesRange)){
+            yield deserializeInboxMessage(msgBuffer);
+        }
+    }
+    removeL1ToL2Messages(startIndex) {
+        this.#log.debug(`Deleting L1 to L2 messages from index ${startIndex}`);
+        let deleteCount = 0;
+        return this.db.transactionAsync(async ()=>{
+            for await (const [key, msgBuffer] of this.#l1ToL2Messages.entriesAsync({
+                start: this.indexToKey(startIndex)
+            })){
+                this.#log.trace(`Deleting L1 to L2 message with index ${key - 1} from the store`);
+                await this.#l1ToL2Messages.delete(key);
+                await this.#l1ToL2MessageIndices.delete(this.leafToIndexKey(deserializeInboxMessage(msgBuffer).leaf));
+                deleteCount++;
+            }
+            await this.increaseTotalMessageCount(-deleteCount);
+            this.#log.warn(`Deleted ${deleteCount} L1 to L2 messages from index ${startIndex} from the store`);
+        });
+    }
+    rollbackL1ToL2MessagesToCheckpoint(targetCheckpointNumber) {
+        this.#log.debug(`Deleting L1 to L2 messages up to target checkpoint ${targetCheckpointNumber}`);
+        const startIndex = InboxLeaf.smallestIndexForCheckpoint(CheckpointNumber(targetCheckpointNumber + 1));
+        return this.removeL1ToL2Messages(startIndex);
+    }
+    indexToKey(index) {
+        return Number(index);
+    }
+    leafToIndexKey(leaf) {
+        return leaf.toString();
+    }
+    async increaseTotalMessageCount(count) {
+        if (count === 0) {
+            return;
+        }
+        return await this.db.transactionAsync(async ()=>{
+            const lastTotalMessageCount = await this.getTotalL1ToL2MessageCount();
+            await this.#totalMessageCount.set(lastTotalMessageCount + BigInt(count));
+        });
+    }
 }

package/dest/archiver/l1/bin/retrieve-calldata.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cmlldmUtY2FsbGRhdGEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcmNoaXZlci9sMS9iaW4vcmV0cmlldmUtY2FsbGRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dest/archiver/l1/bin/retrieve-calldata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-calldata.d.ts","sourceRoot":"","sources":["../../../../src/archiver/l1/bin/retrieve-calldata.ts"],"names":[],"mappings":""}

package/dest/archiver/l1/bin/retrieve-calldata.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { CheckpointNumber } from '@aztec/foundation/branded-types';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { createLogger } from '@aztec/foundation/log';
+import { createPublicClient, http } from 'viem';
+import { mainnet } from 'viem/chains';
+import { CalldataRetriever } from '../calldata_retriever.js';
+const logger = createLogger('archiver:calldata-test');
+function parseArgs() {
+    const args = process.argv.slice(2);
+    if (args.length < 2) {
+        // eslint-disable-next-line no-console
+        console.error('Usage: node index.js <rollup-address> <tx-hash> [target-committee-size]');
+        // eslint-disable-next-line no-console
+        console.error('');
+        // eslint-disable-next-line no-console
+        console.error('Environment variables:');
+        // eslint-disable-next-line no-console
+        console.error('  ETHEREUM_HOST or RPC_URL - Ethereum RPC endpoint');
+        // eslint-disable-next-line no-console
+        console.error('');
+        // eslint-disable-next-line no-console
+        console.error('Example:');
+        // eslint-disable-next-line no-console
+        console.error('  RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY \\');
+        // eslint-disable-next-line no-console
+        console.error('  node index.js 0x1234... 0xabcd... 32');
+        process.exit(1);
+    }
+    const rollupAddress = EthAddress.fromString(args[0]);
+    const txHash = args[1];
+    const targetCommitteeSize = args[2] ? parseInt(args[2], 10) : 24;
+    const rpcUrl = process.env.ETHEREUM_HOST || process.env.RPC_URL;
+    if (!rpcUrl) {
+        // eslint-disable-next-line no-console
+        console.error('Error: ETHEREUM_HOST or RPC_URL environment variable must be set');
+        process.exit(1);
+    }
+    if (targetCommitteeSize <= 0 || targetCommitteeSize > 256) {
+        // eslint-disable-next-line no-console
+        console.error('Error: target-committee-size must be between 1 and 256');
+        process.exit(1);
+    }
+    return {
+        rollupAddress,
+        txHash,
+        rpcUrl,
+        targetCommitteeSize
+    };
+}
+async function main() {
+    const { rollupAddress, txHash, rpcUrl, targetCommitteeSize } = parseArgs();
+    logger.info('Calldata Retriever Test Script');
+    logger.info('===============================');
+    logger.info(`Rollup Address: ${rollupAddress.toString()}`);
+    logger.info(`Transaction Hash: ${txHash}`);
+    logger.info(`RPC URL: ${rpcUrl}`);
+    logger.info(`Target Committee Size: ${targetCommitteeSize}`);
+    logger.info('');
+    try {
+        // Create viem public client
+        const publicClient = createPublicClient({
+            chain: mainnet,
+            transport: http(rpcUrl, {
+                batch: false
+            })
+        });
+        logger.info('Fetching transaction...');
+        const tx = await publicClient.getTransaction({
+            hash: txHash
+        });
+        if (!tx) {
+            throw new Error(`Transaction ${txHash} not found`);
+        }
+        logger.info(`Transaction found in block ${tx.blockNumber}`);
+        // For simplicity, use zero addresses for optional contract addresses
+        // In production, these would be fetched from the rollup contract or configuration
+        const slashingProposerAddress = EthAddress.ZERO;
+        const governanceProposerAddress = EthAddress.ZERO;
+        const slashFactoryAddress = undefined;
+        logger.info('Using zero addresses for governance/slashing (can be configured if needed)');
+        // Create CalldataRetriever
+        const retriever = new CalldataRetriever(publicClient, publicClient, targetCommitteeSize, undefined, logger, {
+            rollupAddress,
+            governanceProposerAddress,
+            slashingProposerAddress,
+            slashFactoryAddress
+        });
+        // Extract L2 block number from transaction logs
+        logger.info('Decoding transaction to extract L2 block number...');
+        const receipt = await publicClient.getTransactionReceipt({
+            hash: txHash
+        });
+        const l2BlockProposedEvent = receipt.logs.find((log)=>{
+            try {
+                // Try to match the L2BlockProposed event
+                return log.address.toLowerCase() === rollupAddress.toString().toLowerCase() && log.topics[0] === '0x2f1d0e696fa5186494a2f2f89a0e0bcbb15d607f6c5eac4637e07e1e5e7d3c00' // L2BlockProposed event signature
+                ;
+            } catch  {
+                return false;
+            }
+        });
+        let l2BlockNumber;
+        if (l2BlockProposedEvent && l2BlockProposedEvent.topics[1]) {
+            // L2 block number is typically the first indexed parameter
+            l2BlockNumber = Number(BigInt(l2BlockProposedEvent.topics[1]));
+            logger.info(`L2 Block Number (from event): ${l2BlockNumber}`);
+        } else {
+            // Fallback: try to extract from transaction data or use a default
+            logger.warn('Could not extract L2 block number from event, using block number as fallback');
+            l2BlockNumber = Number(tx.blockNumber);
+        }
+        logger.info('');
+        logger.info('Retrieving block header from rollup transaction...');
+        logger.info('');
+        // For this script, we don't have blob hashes or expected hashes, so pass empty arrays/objects
+        const result = await retriever.getCheckpointFromRollupTx(txHash, [], CheckpointNumber(l2BlockNumber), {});
+        logger.info(' Successfully retrieved block header!');
+        logger.info('');
+        logger.info('Block Header Details:');
+        logger.info('====================');
+        logger.info(`Checkpoint Number: ${result.checkpointNumber}`);
+        logger.info(`Block Hash: ${result.blockHash}`);
+        logger.info(`Archive Root: ${result.archiveRoot.toString()}`);
+        logger.info('');
+        logger.info('Header:');
+        logger.info(`  Slot Number: ${result.header.slotNumber.toString()}`);
+        logger.info(`  Timestamp: ${result.header.timestamp.toString()}`);
+        logger.info(`  Coinbase: ${result.header.coinbase.toString()}`);
+        logger.info(`  Fee Recipient: ${result.header.feeRecipient.toString()}`);
+        logger.info(`  Total Mana Used: ${result.header.totalManaUsed.toString()}`);
+        logger.info('');
+        logger.info('Attestations:');
+        logger.info(`  Count: ${result.attestations.length}`);
+        logger.info(`  Non-empty attestations: ${result.attestations.filter((a)=>!a.signature.isEmpty()).length}`);
+        process.exit(0);
+    } catch (error) {
+        logger.error('Error retrieving block header:');
+        logger.error(error instanceof Error ? error.message : String(error));
+        if (error instanceof Error && error.stack) {
+            logger.debug(error.stack);
+        }
+        process.exit(1);
+    }
+}
+// Only run if this is the main module
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void main();
+}

package/dest/archiver/l1/calldata_retriever.d.ts

@@ -0,0 +1,112 @@
+import type { ViemPublicClient, ViemPublicDebugClient } from '@aztec/ethereum/types';
+import { CheckpointNumber } from '@aztec/foundation/branded-types';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import type { Logger } from '@aztec/foundation/log';
+import { CommitteeAttestation } from '@aztec/stdlib/block';
+import { CheckpointHeader } from '@aztec/stdlib/rollup';
+import { type Hex, type Transaction } from 'viem';
+import type { ArchiverInstrumentation } from '../instrumentation.js';
+/**
+ * Extracts calldata to the `propose` method of the rollup contract from an L1 transaction
+ * in order to reconstruct an L2 block header.
+ */
+export declare class CalldataRetriever {
+    private readonly publicClient;
+    private readonly debugClient;
+    private readonly targetCommitteeSize;
+    private readonly instrumentation;
+    private readonly logger;
+    /** Pre-computed valid contract calls for validation */
+    private readonly validContractCalls;
+    private readonly rollupAddress;
+    constructor(publicClient: ViemPublicClient, debugClient: ViemPublicDebugClient, targetCommitteeSize: number, instrumentation: ArchiverInstrumentation | undefined, logger: Logger, contractAddresses: {
+        rollupAddress: EthAddress;
+        governanceProposerAddress: EthAddress;
+        slashingProposerAddress: EthAddress;
+        slashFactoryAddress?: EthAddress;
+    });
+    /**
+     * Gets checkpoint header and metadata from the calldata of an L1 transaction.
+     * Tries multicall3 decoding, falls back to trace-based extraction.
+     * @param txHash - Hash of the tx that published it.
+     * @param blobHashes - Blob hashes for the checkpoint.
+     * @param checkpointNumber - Checkpoint number.
+     * @param expectedHashes - Optional expected hashes from the CheckpointProposed event for validation
+     * @returns Checkpoint header and metadata from the calldata, deserialized
+     */
+    getCheckpointFromRollupTx(txHash: `0x${string}`, _blobHashes: Buffer[], checkpointNumber: CheckpointNumber, expectedHashes: {
+        attestationsHash?: Hex;
+        payloadDigest?: Hex;
+    }): Promise<{
+        checkpointNumber: CheckpointNumber;
+        archiveRoot: Fr;
+        header: CheckpointHeader;
+        attestations: CommitteeAttestation[];
+        blockHash: string;
+    }>;
+    /** Gets rollup propose calldata from a transaction */
+    protected getProposeCallData(tx: Transaction, checkpointNumber: CheckpointNumber): Promise<Hex>;
+    /**
+     * Attempts to decode a transaction as a Spire Proposer multicall wrapper.
+     * If successful, extracts the wrapped call and validates it as either multicall3 or direct propose.
+     * @param tx - The transaction to decode
+     * @returns The propose calldata if successfully decoded and validated, undefined otherwise
+     */
+    protected tryDecodeSpireProposer(tx: Transaction): Promise<Hex | undefined>;
+    /**
+     * Attempts to decode transaction input as multicall3 and extract propose calldata.
+     * Returns undefined if validation fails.
+     * @param tx - The transaction-like object with to, input, and hash
+     * @returns The propose calldata if successfully validated, undefined otherwise
+     */
+    protected tryDecodeMulticall3(tx: {
+        to: Hex | null | undefined;
+        input: Hex;
+        hash: Hex;
+    }): Hex | undefined;
+    /**
+     * Attempts to decode transaction as a direct propose call to the rollup contract.
+     * Returns undefined if validation fails.
+     * @param tx - The transaction-like object with to, input, and hash
+     * @returns The propose calldata if successfully validated, undefined otherwise
+     */
+    protected tryDecodeDirectPropose(tx: {
+        to: Hex | null | undefined;
+        input: Hex;
+        hash: Hex;
+    }): Hex | undefined;
+    /**
+     * Uses debug/trace RPC to extract the actual calldata from the successful propose call.
+     * This is the definitive fallback that works for any transaction pattern.
+     * Tries trace_transaction first, then falls back to debug_traceTransaction.
+     * @param txHash - The transaction hash to trace
+     * @returns The propose calldata from the successful call
+     */
+    protected extractCalldataViaTrace(txHash: Hex): Promise<Hex>;
+    /**
+     * Extracts the CommitteeAttestations struct definition from RollupAbi.
+     * Finds the _attestations parameter by name in the propose function.
+     * Lazy-loaded to avoid issues during module initialization.
+     */
+    private getCommitteeAttestationsStructDef;
+    /**
+     * Decodes propose calldata and builds the checkpoint header structure.
+     * @param proposeCalldata - The propose function calldata
+     * @param blockHash - The L1 block hash containing this transaction
+     * @param checkpointNumber - The checkpoint number
+     * @param expectedHashes - Optional expected hashes from the CheckpointProposed event for validation
+     * @returns The decoded checkpoint header and metadata
+     */
+    protected decodeAndBuildCheckpoint(proposeCalldata: Hex, blockHash: Hex, checkpointNumber: CheckpointNumber, expectedHashes: {
+        attestationsHash?: Hex;
+        payloadDigest?: Hex;
+    }): {
+        checkpointNumber: CheckpointNumber;
+        archiveRoot: Fr;
+        header: CheckpointHeader;
+        attestations: CommitteeAttestation[];
+        blockHash: string;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FsbGRhdGFfcmV0cmlldmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXJjaGl2ZXIvbDEvY2FsbGRhdGFfcmV0cmlldmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLHFCQUFxQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDckYsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUUzRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQVFwRCxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUUzRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUV4RCxPQUFPLEVBRUwsS0FBSyxHQUFHLEVBQ1IsS0FBSyxXQUFXLEVBT2pCLE1BQU0sTUFBTSxDQUFDO0FBRWQsT0FBTyxLQUFLLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQU1yRTs7O0dBR0c7QUFDSCxxQkFBYSxpQkFBaUI7SUFPMUIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxZQUFZO0lBQzdCLE9BQU8sQ0FBQyxRQUFRLENBQUMsV0FBVztJQUM1QixPQUFPLENBQUMsUUFBUSxDQUFDLG1CQUFtQjtJQUNwQyxPQUFPLENBQUMsUUFBUSxDQUFDLGVBQWU7SUFDaEMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxNQUFNO0lBVnpCLHVEQUF1RDtJQUN2RCxPQUFPLENBQUMsUUFBUSxDQUFDLGtCQUFrQixDQUFzQjtJQUV6RCxPQUFPLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBYTtJQUUzQyxZQUNtQixZQUFZLEVBQUUsZ0JBQWdCLEVBQzlCLFdB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

package/dest/archiver/l1/calldata_retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calldata_retriever.d.ts","sourceRoot":"","sources":["../../../src/archiver/l1/calldata_retriever.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAEL,KAAK,GAAG,EACR,KAAK,WAAW,EAOjB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE;;;GAGG;AACH,qBAAa,iBAAiB;IAO1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAE3C,YACmB,YAAY,EAAE,gBAAgB,EAC9B,WAAW,EAAE,qBAAqB,EAClC,mBAAmB,EAAE,MAAM,EAC3B,eAAe,EAAE,uBAAuB,GAAG,SAAS,EACpD,MAAM,EAAE,MAAM,EAC/B,iBAAiB,EAAE;QACjB,aAAa,EAAE,UAAU,CAAC;QAC1B,yBAAyB,EAAE,UAAU,CAAC;QACtC,uBAAuB,EAAE,UAAU,CAAC;QACpC,mBAAmB,CAAC,EAAE,UAAU,CAAC;KAClC,EAIF;IAED;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,MAAM,EAAE,KAAK,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE;QACd,gBAAgB,CAAC,EAAE,GAAG,CAAC;QACvB,aAAa,CAAC,EAAE,GAAG,CAAC;KACrB,GACA,OAAO,CAAC;QACT,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,WAAW,EAAE,EAAE,CAAC;QAChB,MAAM,EAAE,gBAAgB,CAAC;QACzB,YAAY,EAAE,oBAAoB,EAAE,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CASD;IAED,sDAAsD;IACtD,UAAgB,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CA+BpG;IAED;;;;;OAKG;IACH,UAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CA4BhF;IAED;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,CAAC,EAAE,EAAE;QAAE,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,GAAG,GAAG,SAAS,CAuFxG;IAED;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,EAAE,EAAE;QAAE,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,GAAG,GAAG,SAAS,CA0B3G;IAED;;;;;;OAMG;IACH,UAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAyCjE;IAED;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;IAgCzC;;;;;;;OAOG;IACH,SAAS,CAAC,wBAAwB,CAChC,eAAe,EAAE,GAAG,EACpB,SAAS,EAAE,GAAG,EACd,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE;QACd,gBAAgB,CAAC,EAAE,GAAG,CAAC;QACvB,aAAa,CAAC,EAAE,GAAG,CAAC;KACrB,GACA;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,WAAW,EAAE,EAAE,CAAC;QAChB,MAAM,EAAE,gBAAgB,CAAC;QACzB,YAAY,EAAE,oBAAoB,EAAE,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC;KACnB,CA6FA;CACF"}