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

package/dest/queries.js

@@ -1,35 +1,143 @@
-import { GovernanceContract } from './contracts/governance.js';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { BaseError } from 'viem';
+import { DefaultL1ContractsConfig } from './config.js';
+import { ReadOnlyGovernanceContract } from './contracts/governance.js';
+import { GovernanceProposerContract } from './contracts/governance_proposer.js';
+import { InboxContract } from './contracts/inbox.js';
 import { RollupContract } from './contracts/rollup.js';
+/**
+ * Returns the L1 finalized block, or `undefined` if the chain does not yet have one
+ * (common on freshly started devnets). Rethrows any other RPC error.
+ */ export async function getFinalizedL1Block(client) {
+    try {
+        return await client.getBlock({
+            blockTag: 'finalized',
+            includeTransactions: false
+        });
+    } catch (err) {
+        if (isFinalizedBlockTagNotFoundError(err)) {
+            return undefined;
+        }
+        throw err;
+    }
+}
+// Error messages returned by popular Ethereum execution clients when
+// eth_getBlockByNumber / eth_call is called with blockTag "finalized" or
+// "safe" and no such block has been produced yet:
+//
+//   geth       "finalized block not found"
+//              "safe block not found"
+//   reth       "block not found: finalized"
+//              "block not found: safe"
+//   nethermind "Unknown block error"           (same for both tags)
+//   besu       "Unknown block"
+//   erigon     'block "finalized" not available (head block: N)'
+//              'block "safe" not available (head block: N)'
+//
+// A combined regex covers all five:
+const FINALIZED_BLOCK_TAG_NOT_FOUND_MESSAGE_RE = /(finalized|safe) block not found|block not found: (finalized|safe)|unknown block|block "(finalized|safe)" not available/i;
+/**
+ * Returns true if the error originates from an RPC call that failed because
+ * the "finalized" (or "safe") block tag is not yet available on the chain.
+ */ export function isFinalizedBlockTagNotFoundError(err) {
+    if (!err) {
+        return false;
+    }
+    if (err instanceof BaseError) {
+        const hit = err.walk((e)=>matchesFinalizedBlockTagNotFound(e));
+        if (hit) {
+            return true;
+        }
+    }
+    for(let cur = err, i = 0; cur && i < 10; cur = cur.cause, i++){
+        if (matchesFinalizedBlockTagNotFound(cur)) {
+            return true;
+        }
+    }
+    return false;
+}
+function matchesFinalizedBlockTagNotFound(e) {
+    if (!e) {
+        return false;
+    }
+    const text = `${e.details ?? ''} ${e.message ?? ''} ${e.shortMessage ?? ''}`;
+    return FINALIZED_BLOCK_TAG_NOT_FOUND_MESSAGE_RE.test(text);
+}
 /** Reads the L1ContractsConfig from L1 contracts. */ export async function getL1ContractsConfig(publicClient, addresses) {
-    const governance = new GovernanceContract(addresses.governanceAddress.toString(), publicClient, undefined);
-    const governanceProposer = await governance.getProposer();
-    const rollupAddress = addresses.rollupAddress ?? (await governance.getGovernanceAddresses()).rollupAddress;
+    const governance = new ReadOnlyGovernanceContract(addresses.governanceAddress.toString(), publicClient);
+    const governanceProposerAddress = await governance.getGovernanceProposerAddress();
+    const governanceProposer = new GovernanceProposerContract(publicClient, governanceProposerAddress.toString());
+    const rollupAddress = addresses.rollupAddress ?? await governanceProposer.getRollupAddress();
     const rollup = new RollupContract(publicClient, rollupAddress.toString());
     const slasherProposer = await rollup.getSlashingProposer();
-    const [l1StartBlock, l1GenesisTime, aztecEpochDuration, aztecProofSubmissionWindow, aztecSlotDuration, aztecTargetCommitteeSize, minimumStake, governanceProposerQuorum, governanceProposerRoundSize, slashingQuorum, slashingRoundSize] = await Promise.all([
+    const slasher = await rollup.getSlasherContract();
+    const rollupAddresses = await rollup.getRollupAddresses();
+    const inboxContract = new InboxContract(publicClient, rollupAddresses.inboxAddress.toString());
+    const [l1StartBlock, l1GenesisTime, aztecEpochDuration, aztecSlotDuration, aztecProofSubmissionEpochs, aztecTargetCommitteeSize, lagInEpochsForValidatorSet, lagInEpochsForRandao, inboxLag, activationThreshold, ejectionThreshold, localEjectionThreshold, governanceProposerQuorum, governanceProposerRoundSize, slashingQuorum, slashingRoundSize, slashingLifetimeInRounds, slashingExecutionDelayInRounds, slashingOffsetInRounds, slashingAmounts, slashingVetoer, slashingDisableDuration, manaTarget, provingCostPerMana, rollupVersion, genesisArchiveTreeRoot, exitDelay] = await Promise.all([
         rollup.getL1StartBlock(),
         rollup.getL1GenesisTime(),
         rollup.getEpochDuration(),
-        rollup.getProofSubmissionWindow(),
         rollup.getSlotDuration(),
+        rollup.getProofSubmissionEpochs(),
         rollup.getTargetCommitteeSize(),
-        rollup.getMinimumStake(),
+        rollup.getLagInEpochsForValidatorSet(),
+        rollup.getLagInEpochsForRandao(),
+        inboxContract.getLag(),
+        rollup.getActivationThreshold(),
+        rollup.getEjectionThreshold(),
+        rollup.getLocalEjectionThreshold(),
         governanceProposer.getQuorumSize(),
         governanceProposer.getRoundSize(),
-        slasherProposer.getQuorumSize(),
-        slasherProposer.getRoundSize()
+        slasherProposer?.getQuorumSize() ?? 0n,
+        slasherProposer?.getRoundSize() ?? 0n,
+        slasherProposer?.getLifetimeInRounds() ?? 0n,
+        slasherProposer?.getExecutionDelayInRounds() ?? 0n,
+        slasherProposer?.getSlashOffsetInRounds() ?? 0n,
+        slasherProposer?.getSlashingAmounts() ?? [
+            0n,
+            0n,
+            0n
+        ],
+        slasher?.getVetoer() ?? EthAddress.ZERO,
+        slasher?.getSlashingDisableDuration() ?? 0,
+        rollup.getManaTarget(),
+        rollup.getProvingCostPerMana(),
+        rollup.getVersion(),
+        rollup.getGenesisArchiveTreeRoot(),
+        rollup.getExitDelay()
     ]);
     return {
         l1StartBlock,
         l1GenesisTime,
         aztecEpochDuration: Number(aztecEpochDuration),
-        aztecProofSubmissionWindow: Number(aztecProofSubmissionWindow),
         aztecSlotDuration: Number(aztecSlotDuration),
+        aztecProofSubmissionEpochs: Number(aztecProofSubmissionEpochs),
         aztecTargetCommitteeSize: Number(aztecTargetCommitteeSize),
+        lagInEpochsForValidatorSet: Number(lagInEpochsForValidatorSet),
+        lagInEpochsForRandao: Number(lagInEpochsForRandao),
+        inboxLag: Number(inboxLag),
         governanceProposerQuorum: Number(governanceProposerQuorum),
         governanceProposerRoundSize: Number(governanceProposerRoundSize),
-        minimumStake,
+        governanceVotingDuration: DefaultL1ContractsConfig.governanceVotingDuration,
+        activationThreshold,
+        ejectionThreshold,
+        localEjectionThreshold,
         slashingQuorum: Number(slashingQuorum),
-        slashingRoundSize: Number(slashingRoundSize)
+        slashingRoundSizeInEpochs: Number(Number(slashingRoundSize) / aztecEpochDuration),
+        slashingLifetimeInRounds: Number(slashingLifetimeInRounds),
+        slashingExecutionDelayInRounds: Number(slashingExecutionDelayInRounds),
+        slashingVetoer,
+        slashingDisableDuration,
+        manaTarget,
+        provingCostPerMana: provingCostPerMana,
+        rollupVersion: Number(rollupVersion),
+        genesisArchiveTreeRoot: genesisArchiveTreeRoot.toString(),
+        exitDelaySeconds: Number(exitDelay),
+        slasherEnabled: !!slasherProposer,
+        slashingOffsetInRounds: Number(slashingOffsetInRounds),
+        slashAmountSmall: slashingAmounts[0],
+        slashAmountMedium: slashingAmounts[1],
+        slashAmountLarge: slashingAmounts[2],
+        initialEthPerFeeAsset: DefaultL1ContractsConfig.initialEthPerFeeAsset
     };
 }

package/dest/test/chain_monitor.d.ts

@@ -0,0 +1,95 @@
+import type { ManaMinFeeComponents, RollupContract } from '@aztec/ethereum/contracts';
+import { InboxContract } from '@aztec/ethereum/contracts';
+import { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { DateProvider } from '@aztec/foundation/timer';
+import { EventEmitter } from 'events';
+/** L2 fee data reported by the chain monitor. */
+export type L2FeeData = ManaMinFeeComponents & {
+    /** Total minimum fee per mana in Fee Juice (sum of sequencerCost + proverCost + congestionCost). */
+    minFeePerMana: bigint;
+    /** L1 base fee observed by the oracle. */
+    l1BaseFee: bigint;
+    /** L1 blob fee observed by the oracle. */
+    l1BlobFee: bigint;
+    /** ETH per fee asset exchange rate (1e12 precision). */
+    ethPerFeeAsset: bigint;
+    /** Mana target per checkpoint. */
+    manaTarget: bigint;
+};
+export type ChainMonitorEventMap = {
+    'l1-block': [{
+        l1BlockNumber: number;
+        timestamp: bigint;
+    }];
+    checkpoint: [
+        {
+            checkpointNumber: CheckpointNumber;
+            l1BlockNumber: number;
+            l2SlotNumber: SlotNumber;
+            timestamp: bigint;
+        }
+    ];
+    'checkpoint-proven': [{
+        provenCheckpointNumber: CheckpointNumber;
+        l1BlockNumber: number;
+        timestamp: bigint;
+    }];
+    'l2-messages': [{
+        totalL2Messages: number;
+        l1BlockNumber: number;
+    }];
+    'l2-epoch': [{
+        l2EpochNumber: EpochNumber;
+        timestamp: bigint;
+        committee: EthAddress[] | undefined;
+    }];
+    'l2-slot': [{
+        l2SlotNumber: SlotNumber;
+        timestamp: bigint;
+    }];
+    'l2-fees': [L2FeeData];
+};
+/** Utility class that polls the chain on quick intervals and logs new L1 blocks, L2 blocks, and L2 proofs. */
+export declare class ChainMonitor extends EventEmitter<ChainMonitorEventMap> {
+    private readonly rollup;
+    private readonly dateProvider;
+    private readonly logger;
+    private readonly intervalMs;
+    private readonly l1Client;
+    private inbox;
+    private handle;
+    private running;
+    /** Current L1 block number */
+    l1BlockNumber: number;
+    /** Current checkpoint number */
+    checkpointNumber: CheckpointNumber;
+    /** Current proven checkpoint number */
+    provenCheckpointNumber: CheckpointNumber;
+    /** L1 timestamp for the current checkpoint */
+    checkpointTimestamp: bigint;
+    /** L1 timestamp for the proven checkpoint */
+    provenCheckpointTimestamp: bigint;
+    /** Total number of L2 messages pushed into the Inbox */
+    totalL2Messages: number;
+    /** Current L2 epoch number */
+    l2EpochNumber: EpochNumber;
+    /** Current L2 slot number */
+    l2SlotNumber: SlotNumber;
+    /** Current L2 fee data (components of the minimum fee per mana). */
+    l2FeeData: L2FeeData;
+    constructor(rollup: RollupContract, dateProvider?: DateProvider, logger?: import("@aztec/foundation/log").Logger, intervalMs?: number);
+    start(): this;
+    stop(): Promise<void>;
+    protected getInbox(): Promise<InboxContract>;
+    protected safeRun(): void;
+    run(force?: boolean): Promise<this>;
+    waitUntilL2Slot(slot: SlotNumber): Promise<void>;
+    waitUntilNextL2Slot(): Promise<void>;
+    waitUntilL1Block(block: number | bigint): Promise<void>;
+    waitUntilL1Timestamp(timestamp: number | bigint): Promise<void>;
+    waitUntilCheckpoint(checkpointNumber: CheckpointNumber): Promise<void>;
+    private fetchFeeData;
+    private hasFeeDataChanged;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhaW5fbW9uaXRvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3QvY2hhaW5fbW9uaXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxvQkFBb0IsRUFBRSxjQUFjLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUN0RixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDMUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLFdBQVcsRUFBRSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM1RixPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFHM0QsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRXZELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFJdEMsaURBQWlEO0FBQ2pELE1BQU0sTUFBTSxTQUFTLEdBQUcsb0JBQW9CLEdBQUc7SUFDN0Msb0dBQW9HO0lBQ3BHLGFBQWEsRUFBRSxNQUFNLENBQUM7SUFDdEIsMENBQTBDO0lBQzFDLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsMENBQTBDO0lBQzFDLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsd0RBQXdEO0lBQ3hELGNBQWMsRUFBRSxNQUFNLENBQUM7SUFDdkIsa0NBQWtDO0lBQ2xDLFVBQVUsRUFBRSxNQUFNLENBQUM7Q0FDcEIsQ0FBQztBQUVGLE1BQU0sTUFBTSxvQkFBb0IsR0FBRztJQUNqQyxVQUFVLEVBQUUsQ0FBQztRQUFFLGFBQWEsRUFBRSxNQUFNLENBQUM7UUFBQyxTQUFTLEVBQUUsTUFBTSxDQUFBO0tBQUUsQ0FBQyxDQUFDO0lBQzNELFVBQVUsRUFBRTtRQUNWO1lBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLENBQUM7WUFBQyxhQUFhLEVBQUUsTUFBTSxDQUFDO1lBQUMsWUFBWSxFQUFFLFVBQVUsQ0FBQztZQUFDLFNBQVMs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

package/dest/test/chain_monitor.d.ts.map

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

package/dest/test/chain_monitor.js

@@ -0,0 +1,249 @@
+import { InboxContract } from '@aztec/ethereum/contracts';
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import { createLogger } from '@aztec/foundation/log';
+import { promiseWithResolvers } from '@aztec/foundation/promise';
+import { DateProvider } from '@aztec/foundation/timer';
+import { EventEmitter } from 'events';
+/** Utility class that polls the chain on quick intervals and logs new L1 blocks, L2 blocks, and L2 proofs. */ export class ChainMonitor extends EventEmitter {
+    rollup;
+    dateProvider;
+    logger;
+    intervalMs;
+    l1Client;
+    inbox;
+    handle;
+    // eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
+    running;
+    /** Current L1 block number */ l1BlockNumber;
+    /** Current checkpoint number */ checkpointNumber;
+    /** Current proven checkpoint number */ provenCheckpointNumber;
+    /** L1 timestamp for the current checkpoint */ checkpointTimestamp;
+    /** L1 timestamp for the proven checkpoint */ provenCheckpointTimestamp;
+    /** Total number of L2 messages pushed into the Inbox */ totalL2Messages;
+    /** Current L2 epoch number */ l2EpochNumber;
+    /** Current L2 slot number */ l2SlotNumber;
+    /** Current L2 fee data (components of the minimum fee per mana). */ l2FeeData;
+    constructor(rollup, dateProvider = new DateProvider(), logger = createLogger('aztecjs:utils:chain_monitor'), intervalMs = 200){
+        super(), this.rollup = rollup, this.dateProvider = dateProvider, this.logger = logger, this.intervalMs = intervalMs, this.running = new Set(), this.totalL2Messages = 0;
+        this.l1Client = rollup.client;
+    }
+    start() {
+        if (this.handle) {
+            throw new Error('Chain monitor already started');
+        }
+        this.handle = setInterval(this.safeRun.bind(this), this.intervalMs);
+        return this;
+    }
+    async stop() {
+        try {
+            this.removeAllListeners();
+            if (this.handle) {
+                clearInterval(this.handle);
+                this.handle = undefined;
+            }
+            await Promise.allSettled([
+                ...this.running
+            ]);
+        } catch (err) {
+            this.logger.error('Error stopping chain monitor', err);
+        }
+    }
+    async getInbox() {
+        if (!this.inbox) {
+            const { inboxAddress } = await this.rollup.getRollupAddresses();
+            this.inbox = new InboxContract(this.l1Client, inboxAddress);
+        }
+        return this.inbox;
+    }
+    safeRun() {
+        const running = promiseWithResolvers();
+        this.running.add(running.promise);
+        void this.run().catch((error)=>{
+            this.logger.error('Error in chain monitor loop', error);
+        }).finally(()=>{
+            running.resolve();
+            this.running.delete(running.promise);
+        });
+    }
+    async run(force = false) {
+        const newL1BlockNumber = Number(await this.l1Client.getBlockNumber({
+            cacheTime: 0
+        }));
+        if (!force && this.l1BlockNumber === newL1BlockNumber) {
+            return this;
+        }
+        this.l1BlockNumber = newL1BlockNumber;
+        const [l2SlotNumber, l2Epoch, l1block] = await Promise.all([
+            this.rollup.getSlotNumber(),
+            this.rollup.getCurrentEpoch(),
+            this.l1Client.getBlock({
+                blockNumber: BigInt(newL1BlockNumber),
+                includeTransactions: false
+            })
+        ]);
+        const timestamp = l1block.timestamp;
+        const timestampString = new Date(Number(timestamp) * 1000).toTimeString().split(' ')[0];
+        this.emit('l1-block', {
+            l1BlockNumber: newL1BlockNumber,
+            timestamp
+        });
+        let msg = `L1 block ${newL1BlockNumber} mined at ${timestampString}`;
+        const newCheckpointNumber = await this.rollup.getCheckpointNumber();
+        if (this.checkpointNumber !== newCheckpointNumber) {
+            const epochNumber = await this.rollup.getEpochNumberForCheckpoint(newCheckpointNumber);
+            msg += ` with new checkpoint ${newCheckpointNumber} for epoch ${epochNumber}`;
+            this.checkpointNumber = newCheckpointNumber;
+            this.checkpointTimestamp = timestamp;
+            this.emit('checkpoint', {
+                checkpointNumber: newCheckpointNumber,
+                l1BlockNumber: newL1BlockNumber,
+                l2SlotNumber,
+                timestamp
+            });
+        }
+        const newProvenCheckpointNumber = await this.rollup.getProvenCheckpointNumber();
+        if (this.provenCheckpointNumber !== newProvenCheckpointNumber) {
+            const epochNumber = await this.rollup.getEpochNumberForCheckpoint(newProvenCheckpointNumber);
+            msg += ` with proof up to checkpoint ${newProvenCheckpointNumber} for epoch ${epochNumber}`;
+            this.provenCheckpointNumber = newProvenCheckpointNumber;
+            this.provenCheckpointTimestamp = timestamp;
+            this.emit('checkpoint-proven', {
+                provenCheckpointNumber: newProvenCheckpointNumber,
+                l1BlockNumber: newL1BlockNumber,
+                timestamp
+            });
+        }
+        const inbox = await this.getInbox();
+        const newTotalL2Messages = await inbox.getState().then((s)=>Number(s.totalMessagesInserted));
+        if (this.totalL2Messages !== newTotalL2Messages) {
+            msg += ` with ${newTotalL2Messages - this.totalL2Messages} new L2 messages (total ${newTotalL2Messages})`;
+            this.totalL2Messages = newTotalL2Messages;
+            this.emit('l2-messages', {
+                totalL2Messages: newTotalL2Messages,
+                l1BlockNumber: newL1BlockNumber
+            });
+        }
+        let committee;
+        if (l2Epoch !== this.l2EpochNumber) {
+            this.l2EpochNumber = l2Epoch;
+            committee = await this.rollup.getCurrentEpochCommittee();
+            this.emit('l2-epoch', {
+                l2EpochNumber: l2Epoch,
+                timestamp,
+                committee
+            });
+            msg += ` starting new epoch ${this.l2EpochNumber}`;
+        }
+        if (l2SlotNumber !== this.l2SlotNumber) {
+            this.l2SlotNumber = l2SlotNumber;
+            this.emit('l2-slot', {
+                l2SlotNumber,
+                timestamp
+            });
+        }
+        const feeData = await this.fetchFeeData(timestamp);
+        if (this.hasFeeDataChanged(feeData)) {
+            msg += ` with L2 min fee ${feeData.minFeePerMana}`;
+            this.l2FeeData = feeData;
+            this.emit('l2-fees', feeData);
+        }
+        this.logger.info(msg, {
+            currentTimestamp: this.dateProvider.nowInSeconds(),
+            l1Timestamp: timestamp,
+            l1BlockNumber: this.l1BlockNumber,
+            l2SlotNumber,
+            l2Epoch,
+            checkpointNumber: this.checkpointNumber,
+            provenCheckpointNumber: this.provenCheckpointNumber,
+            totalL2Messages: this.totalL2Messages,
+            committee,
+            ...this.l2FeeData
+        });
+        return this;
+    }
+    waitUntilL2Slot(slot) {
+        if (this.l2SlotNumber >= slot) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve)=>{
+            const listener = (data)=>{
+                if (data.l2SlotNumber >= slot) {
+                    this.off('l2-slot', listener);
+                    resolve();
+                }
+            };
+            this.on('l2-slot', listener);
+        });
+    }
+    async waitUntilNextL2Slot() {
+        const targetSlot = SlotNumber.add((await this.run()).l2SlotNumber, 1);
+        return this.waitUntilL2Slot(targetSlot);
+    }
+    waitUntilL1Block(block) {
+        const targetBlock = typeof block === 'bigint' ? block.valueOf() : block;
+        if (this.l1BlockNumber >= targetBlock) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve)=>{
+            const listener = (data)=>{
+                if (data.l1BlockNumber >= targetBlock) {
+                    this.off('l1-block', listener);
+                    resolve();
+                }
+            };
+            this.on('l1-block', listener);
+        });
+    }
+    waitUntilL1Timestamp(timestamp) {
+        const targetTimestamp = typeof timestamp === 'bigint' ? timestamp.valueOf() : timestamp;
+        if (this.l1BlockNumber >= targetTimestamp) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve)=>{
+            const listener = (data)=>{
+                if (data.timestamp >= targetTimestamp) {
+                    this.off('l1-block', listener);
+                    resolve();
+                }
+            };
+            this.on('l1-block', listener);
+        });
+    }
+    waitUntilCheckpoint(checkpointNumber) {
+        if (this.checkpointNumber >= checkpointNumber) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve)=>{
+            const listener = (data)=>{
+                if (data.checkpointNumber >= checkpointNumber) {
+                    this.off('checkpoint', listener);
+                    resolve();
+                }
+            };
+            this.on('checkpoint', listener);
+        });
+    }
+    async fetchFeeData(timestamp) {
+        const [components, minFeePerMana, l1Fees, ethPerFeeAsset, manaTarget] = await Promise.all([
+            this.rollup.getManaMinFeeComponentsAt(timestamp, true),
+            this.rollup.getManaMinFeeAt(timestamp, true),
+            this.rollup.getL1FeesAt(timestamp),
+            this.rollup.getEthPerFeeAsset(),
+            this.rollup.getManaTarget()
+        ]);
+        return {
+            ...components,
+            minFeePerMana,
+            l1BaseFee: l1Fees.baseFee,
+            l1BlobFee: l1Fees.blobFee,
+            ethPerFeeAsset,
+            manaTarget
+        };
+    }
+    hasFeeDataChanged(newData) {
+        if (!this.l2FeeData) {
+            return true;
+        }
+        return this.l2FeeData.sequencerCost !== newData.sequencerCost || this.l2FeeData.proverCost !== newData.proverCost || this.l2FeeData.congestionCost !== newData.congestionCost || this.l2FeeData.l1BaseFee !== newData.l1BaseFee || this.l2FeeData.l1BlobFee !== newData.l1BlobFee || this.l2FeeData.ethPerFeeAsset !== newData.ethPerFeeAsset;
+    }
+}