@aztec-labs/epoch-cache 6.0.0-nightly.20260829

package/dest/epoch_cache.js

@@ -0,0 +1,452 @@
+import { createEthereumChain } from '@aztec-labs/ethereum/chain';
+import { makeL1HttpTransport } from '@aztec-labs/ethereum/client';
+import { NoCommitteeError, RollupContract } from '@aztec-labs/ethereum/contracts';
+import { getFinalizedL1Block } from '@aztec-labs/ethereum/queries';
+import { SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { createLogger } from '@aztec-labs/foundation/log';
+import { DateProvider } from '@aztec-labs/foundation/timer';
+import { getEpochAtSlot, getEpochNumberAtTimestamp, getNextL1SlotTimestamp, getSlotAtNextL1Block, getSlotAtTimestamp, getSlotRangeForEpoch, getStartTimestampForEpoch, getTimestampForSlot } from '@aztec-labs/stdlib/epoch-helpers';
+import { createPublicClient, encodeAbiParameters, keccak256 } from 'viem';
+import { getEpochCacheConfigEnvVars } from './config.js';
+/** The proposer pipelines by building one slot ahead. */ export const PROPOSER_PIPELINING_SLOT_OFFSET = 1;
+/**
+ * Epoch cache
+ *
+ * This class is responsible for managing traffic to the l1 node, by caching the validator set.
+ * Keeps the last N epochs in cache.
+ * It also provides a method to get the current or next proposer, and to check who is in the current slot.
+ *
+ * Note: This class is very dependent on the system clock being in sync.
+ */ export class EpochCache {
+    rollup;
+    l1constants;
+    dateProvider;
+    config;
+    /**
+   * Single map holding both resolved entries and in-flight promises.
+   * A `Promise` value means a fetch is in progress; concurrent callers await it.
+   */ cache;
+    allValidators;
+    lastValidatorRefresh;
+    log;
+    constructor(rollup, l1constants, dateProvider = new DateProvider(), config = {
+        cacheSize: 12,
+        validatorRefreshIntervalSeconds: 60
+    }){
+        this.rollup = rollup;
+        this.l1constants = l1constants;
+        this.dateProvider = dateProvider;
+        this.config = config;
+        this.cache = new Map();
+        this.allValidators = new Set();
+        this.lastValidatorRefresh = 0;
+        this.log = createLogger('epoch-cache');
+        this.log.debug(`Initialized EpochCache`, {
+            l1constants
+        });
+    }
+    static async create(rollupOrAddress, config, deps = {}) {
+        config = config ?? getEpochCacheConfigEnvVars();
+        // Load the rollup contract if we were given an address
+        let rollup;
+        if ('address' in rollupOrAddress) {
+            rollup = rollupOrAddress;
+        } else {
+            const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
+            const publicClient = createPublicClient({
+                chain: chain.chainInfo,
+                transport: makeL1HttpTransport(config.l1RpcUrls, {
+                    timeout: config.l1HttpTimeoutMS
+                }),
+                pollingInterval: config.viemPollingIntervalMS
+            });
+            rollup = new RollupContract(publicClient, rollupOrAddress.toString());
+        }
+        const [l1StartBlock, l1GenesisTime, proofSubmissionEpochs, slotDuration, epochDuration, lagInEpochsForValidatorSet, lagInEpochsForRandao, targetCommitteeSize, rollupManaLimit] = await Promise.all([
+            rollup.getL1StartBlock(),
+            rollup.getL1GenesisTime(),
+            rollup.getProofSubmissionEpochs(),
+            rollup.getSlotDuration(),
+            rollup.getEpochDuration(),
+            rollup.getLagInEpochsForValidatorSet(),
+            rollup.getLagInEpochsForRandao(),
+            rollup.getTargetCommitteeSize(),
+            rollup.getManaLimit()
+        ]);
+        const l1RollupConstants = {
+            l1StartBlock,
+            l1GenesisTime,
+            proofSubmissionEpochs: Number(proofSubmissionEpochs),
+            slotDuration: Number(slotDuration),
+            epochDuration: Number(epochDuration),
+            ethereumSlotDuration: config.ethereumSlotDuration,
+            lagInEpochsForValidatorSet: Number(lagInEpochsForValidatorSet),
+            lagInEpochsForRandao: Number(lagInEpochsForRandao),
+            targetCommitteeSize: Number(targetCommitteeSize),
+            rollupManaLimit: Number(rollupManaLimit)
+        };
+        return new EpochCache(rollup, l1RollupConstants, deps.dateProvider, {
+            cacheSize: 12,
+            validatorRefreshIntervalSeconds: 60
+        });
+    }
+    getL1Constants() {
+        return this.l1constants;
+    }
+    /**
+   * The number of epochs by which validator-set sampling lags. The committee for epoch `E` samples the
+   * validator set as of `lagInEpochsForValidatorSet` epochs before `E` (see
+   * `ValidatorSelectionLib.stableEpochToValidatorSetSampleTime` on L1), so a newly staked validator only
+   * becomes eligible for a committee this many epochs after staking.
+   */ getLagInEpochsForValidatorSet() {
+        return this.l1constants.lagInEpochsForValidatorSet;
+    }
+    getSlotNow() {
+        return this.getEpochAndSlotNow().slot;
+    }
+    getTargetSlot() {
+        const slotNow = this.getSlotNow();
+        const offset = PROPOSER_PIPELINING_SLOT_OFFSET;
+        return SlotNumber(slotNow + offset);
+    }
+    getEpochNow() {
+        return this.getEpochAndSlotNow().epoch;
+    }
+    getTargetEpoch() {
+        return getEpochAtSlot(this.getTargetSlot(), this.l1constants);
+    }
+    getEpochAndSlotNow() {
+        const nowMs = BigInt(this.dateProvider.now());
+        const nowSeconds = nowMs / 1000n;
+        return {
+            ...this.getEpochAndSlotAtTimestamp(nowSeconds),
+            nowMs
+        };
+    }
+    getEpochAndSlotAtSlot(slot) {
+        return this.getEpochAndSlotAtTimestamp(getTimestampForSlot(slot, this.l1constants));
+    }
+    getEpochAndSlotInNextL1Slot() {
+        const nowSeconds = this.dateProvider.nowInSeconds();
+        const nextSlotTs = getNextL1SlotTimestamp(nowSeconds, this.l1constants);
+        return {
+            ...this.getEpochAndSlotAtTimestamp(nextSlotTs),
+            nowSeconds: BigInt(nowSeconds)
+        };
+    }
+    getTargetEpochAndSlotInNextL1Slot() {
+        const result = this.getEpochAndSlotInNextL1Slot();
+        const offset = PROPOSER_PIPELINING_SLOT_OFFSET;
+        const targetSlot = SlotNumber(result.slot + offset);
+        return {
+            ...result,
+            slot: targetSlot,
+            epoch: getEpochAtSlot(targetSlot, this.l1constants)
+        };
+    }
+    getEpochAndSlotAtTimestamp(ts) {
+        const slot = getSlotAtTimestamp(ts, this.l1constants);
+        const epoch = getEpochNumberAtTimestamp(ts, this.l1constants);
+        return {
+            slot,
+            epoch,
+            ts: getTimestampForSlot(slot, this.l1constants)
+        };
+    }
+    getCommitteeForEpoch(epoch) {
+        const [startSlot] = getSlotRangeForEpoch(epoch, this.l1constants);
+        return this.getCommittee(startSlot);
+    }
+    /** Returns whether the escape hatch is open for the given epoch. */ async isEscapeHatchOpen(epoch) {
+        const info = await this.getCommitteeForEpoch(epoch);
+        return info.isEscapeHatchOpen;
+    }
+    /**
+   * Returns whether the escape hatch is open for the epoch containing the given slot.
+   *
+   * This is a lightweight helper intended for callers that already have a slot number and only
+   * need the escape hatch flag (without pulling full committee info).
+   */ async isEscapeHatchOpenAtSlot(slot = 'now') {
+        const epoch = slot === 'now' ? this.getEpochNow() : slot === 'next' ? this.getEpochAndSlotInNextL1Slot().epoch : getEpochAtSlot(slot, this.l1constants);
+        return await this.isEscapeHatchOpen(epoch);
+    }
+    /**
+   * Get the current validator set.
+   *
+   * Returns cached data if the entry is finalized or still fresh (queried less than one
+   * Ethereum slot ago). Stale non-finalized entries are re-queried, and concurrent callers
+   * coalesce on the same in-flight promise so the L1 query happens only once.
+   */ async getCommittee(slot = 'now') {
+        const { epoch, ts } = this.getEpochAndTimestamp(slot);
+        const cached = this.cache.get(epoch);
+        // In-flight promise: another caller is already fetching this epoch — just await it.
+        if (cached instanceof Promise) {
+            return (await cached).data;
+        }
+        // Resolved entry: return it if finalized or still fresh.
+        if (cached && (cached.finalized || !this.isStale(cached))) {
+            return cached.data;
+        }
+        // Stale non-finalized entry: do a lightweight refresh first (check block hash + finalized ts).
+        // Only fall back to a full re-fetch if the L1 block was reorged.
+        if (cached) {
+            const promise = this.refreshStaleEntry(cached, epoch, ts);
+            this.cache.set(epoch, promise);
+            try {
+                return (await promise).data;
+            } catch (err) {
+                this.cache.set(epoch, cached);
+                throw err;
+            }
+        }
+        // No entry at all: full fetch.
+        const promise = this.fetchAndCache(epoch, ts);
+        this.cache.set(epoch, promise);
+        try {
+            return (await promise).data;
+        } catch (err) {
+            this.cache.delete(epoch);
+            throw err;
+        }
+    }
+    getEpochAndTimestamp(slot = 'now') {
+        if (slot === 'now') {
+            return this.getEpochAndSlotNow();
+        } else if (slot === 'next') {
+            return this.getEpochAndSlotInNextL1Slot();
+        } else {
+            return this.getEpochAndSlotAtSlot(slot);
+        }
+    }
+    /** Evicts oldest cache entries (resolved or in-flight) beyond cacheSize. */ purgeCache() {
+        if (this.cache.size <= this.config.cacheSize) {
+            return;
+        }
+        const toPurge = Array.from(this.cache.keys()).sort((a, b)=>Number(b - a)).slice(this.config.cacheSize);
+        toPurge.forEach((key)=>this.cache.delete(key));
+    }
+    /** Returns true if a non-finalized cache entry is older than one Ethereum slot. */ isStale(entry) {
+        const nowSeconds = BigInt(this.dateProvider.nowInSeconds());
+        return nowSeconds - entry.lastRefreshL1Timestamp >= BigInt(this.l1constants.ethereumSlotDuration);
+    }
+    /** Whether a cached epoch entry has been marked as finalized. Returns undefined if not cached or still in-flight. */ isFinalized(epoch) {
+        const entry = this.cache.get(epoch);
+        if (!entry || entry instanceof Promise) {
+            return undefined;
+        }
+        return entry.finalized;
+    }
+    /** Returns the latest L1 timestamp stored in the cached entry. Undefined if not cached or in-flight. */ getCachedLastRefreshL1Timestamp(epoch) {
+        const entry = this.cache.get(epoch);
+        if (!entry || entry instanceof Promise) {
+            return undefined;
+        }
+        return entry.lastRefreshL1Timestamp;
+    }
+    /** Computes the sampling timestamp for an epoch's committee data. */ getSamplingTimestamp(epoch) {
+        const { lagInEpochsForRandao, epochDuration, slotDuration } = this.l1constants;
+        const epochStartTs = getStartTimestampForEpoch(epoch, this.l1constants);
+        return epochStartTs - BigInt(lagInEpochsForRandao) * BigInt(epochDuration) * BigInt(slotDuration);
+    }
+    /**
+   * Lightweight refresh for a stale non-finalized entry. Queries only the block hash at
+   * the original block number and the finalized block timestamp — avoids the expensive
+   * getCommitteeAt and getSampleSeedAt calls on the rollup contract.
+   *
+   * If the block hash still matches (no L1 reorg), we keep the existing data and just
+   * update the provenance timestamp. If the finalized block has caught up, we promote the
+   * entry to finalized. If there was a reorg (hash mismatch), we fall back to a full fetch.
+   */ async refreshStaleEntry(stale, epoch, ts) {
+        const [blockAtOriginal, l1FinalizedBlock, latestBlock] = await Promise.all([
+            this.rollup.client.getBlock({
+                blockNumber: stale.lastQueryL1BlockNumber,
+                includeTransactions: false
+            }),
+            getFinalizedL1Block(this.rollup.client),
+            this.rollup.client.getBlock({
+                includeTransactions: false
+            })
+        ]);
+        if (blockAtOriginal.hash === stale.lastQueryL1BlockHash) {
+            // No reorg: the data is still valid. Check if we can now mark it as finalized.
+            const samplingTs = this.getSamplingTimestamp(epoch);
+            const finalized = !!(stale.data.committee && stale.data.committee.length > 0) && l1FinalizedBlock !== undefined && samplingTs <= l1FinalizedBlock.timestamp;
+            const refreshed = {
+                ...stale,
+                lastRefreshL1Timestamp: latestBlock.timestamp,
+                finalized
+            };
+            this.cache.set(epoch, refreshed);
+            return refreshed;
+        }
+        // Reorg detected: block hash mismatch. Do a full re-fetch.
+        // Pass the already-fetched block timestamps to avoid redundant queries.
+        this.log.warn(`L1 reorg detected for epoch ${epoch}: block ${stale.lastQueryL1BlockNumber} hash changed`, {
+            epoch,
+            expectedHash: stale.lastQueryL1BlockHash,
+            actualHash: blockAtOriginal.hash
+        });
+        return this.fetchAndCache(epoch, ts, {
+            latestBlock,
+            finalizedBlock: l1FinalizedBlock
+        });
+    }
+    /**
+   * Fetches committee data from L1, determines finalization status, and stores in the cache.
+   *
+   * Uses `lagInEpochsForRandao` (the binding constraint, always <= lagInEpochsForValidatorSet)
+   * and computes the sampling timestamp from the epoch start to match the L1 contract's logic.
+   *
+   * When called from refreshStaleEntry after a reorg, the latest and finalized blocks are
+   * passed in to avoid redundant L1 queries.
+   */ async fetchAndCache(epoch, ts, prefetched) {
+        const [committee, seedBuffer, latestBlock, finalizedBlock, isEscapeHatchOpen] = await Promise.all([
+            this.rollup.getCommitteeAt(ts),
+            this.rollup.getSampleSeedAt(ts),
+            prefetched?.latestBlock ?? this.rollup.client.getBlock({
+                includeTransactions: false
+            }),
+            prefetched !== undefined ? prefetched.finalizedBlock : getFinalizedL1Block(this.rollup.client),
+            this.rollup.isEscapeHatchOpen(epoch)
+        ]);
+        const samplingTs = this.getSamplingTimestamp(epoch);
+        if (samplingTs > latestBlock.timestamp) {
+            throw new Error(`Cannot query committee for future epoch ${epoch}: ` + `sampling timestamp ${samplingTs} is beyond latest L1 block at ${latestBlock.timestamp}. ` + `Check your Ethereum node is synced.`);
+        }
+        // Empty committees are never marked finalized so they always get re-queried after TTL.
+        // If L1 has no finalized block yet (devnet startup), entries stay unfinalized.
+        const hasCommittee = !!(committee && committee.length > 0);
+        const finalized = hasCommittee && finalizedBlock !== undefined && samplingTs <= finalizedBlock.timestamp;
+        const data = {
+            committee,
+            seed: seedBuffer.toBigInt(),
+            epoch,
+            isEscapeHatchOpen
+        };
+        const entry = {
+            data,
+            lastQueryL1BlockNumber: latestBlock.number,
+            lastQueryL1BlockHash: latestBlock.hash,
+            lastRefreshL1Timestamp: latestBlock.timestamp,
+            finalized
+        };
+        this.cache.set(epoch, entry);
+        this.purgeCache();
+        return entry;
+    }
+    /**
+   * Get the ABI encoding of the proposer index - see ValidatorSelectionLib.sol computeProposerIndex
+   */ getProposerIndexEncoding(epoch, slot, seed) {
+        return encodeAbiParameters([
+            {
+                type: 'uint256',
+                name: 'epoch'
+            },
+            {
+                type: 'uint256',
+                name: 'slot'
+            },
+            {
+                type: 'uint256',
+                name: 'seed'
+            }
+        ], [
+            BigInt(epoch),
+            BigInt(slot),
+            seed
+        ]);
+    }
+    computeProposerIndex(slot, epoch, seed, size) {
+        // if committe size is 0, then mod 1 is 0
+        if (size === 0n) {
+            return 0n;
+        }
+        return BigInt(keccak256(this.getProposerIndexEncoding(epoch, slot, seed))) % size;
+    }
+    /** Returns the current and next L2 slot in next eth L1 Slot. */ getCurrentAndNextSlot() {
+        const currentSlot = this.getSlotNow();
+        const next = this.getEpochAndSlotInNextL1Slot();
+        return {
+            currentSlot,
+            nextSlot: next.slot
+        };
+    }
+    /** Returns the target and next L2 slot in the next L1 slot. */ getTargetAndNextSlot() {
+        const nowSeconds = BigInt(this.dateProvider.nowInSeconds());
+        const offset = PROPOSER_PIPELINING_SLOT_OFFSET;
+        const currentSlot = getSlotAtTimestamp(nowSeconds, this.l1constants);
+        const targetSlot = SlotNumber(currentSlot + offset);
+        const nextL2SlotOnL1 = getSlotAtNextL1Block(nowSeconds, this.l1constants);
+        const nextSlot = SlotNumber(nextL2SlotOnL1 + offset);
+        return {
+            targetSlot,
+            nextSlot
+        };
+    }
+    /**
+   * Get the proposer attester address in the given L2 slot
+   * @returns The proposer attester address. If the committee does not exist, we throw a NoCommitteeError.
+   * If the committee is empty (i.e. target committee size is 0, and anyone can propose), we return undefined.
+   */ getProposerAttesterAddressInSlot(slot) {
+        const epochAndSlot = this.getEpochAndSlotAtSlot(slot);
+        return this.getProposerAttesterAddressAt(epochAndSlot);
+    }
+    /**
+   * Get the proposer attester address in the next slot
+   * @returns The proposer attester address. If the committee does not exist, we throw a NoCommitteeError.
+   * If the committee is empty (i.e. target committee size is 0, and anyone can propose), we return undefined.
+   */ getProposerAttesterAddressInNextSlot() {
+        const epochAndSlot = this.getEpochAndSlotInNextL1Slot();
+        return this.getProposerAttesterAddressAt(epochAndSlot);
+    }
+    /**
+   * Get the proposer attester address at a given epoch and slot
+   * @param when - The epoch and slot to get the proposer attester address at
+   * @returns The proposer attester address. If the committee does not exist, we throw a NoCommitteeError.
+   * If the committee is empty (i.e. target committee size is 0, and anyone can propose), we return undefined.
+   */ async getProposerAttesterAddressAt(when) {
+        const { epoch, slot } = when;
+        const { committee, seed } = await this.getCommittee(slot);
+        if (!committee) {
+            throw new NoCommitteeError();
+        } else if (committee.length === 0) {
+            return undefined;
+        }
+        const proposerIndex = this.computeProposerIndex(slot, epoch, seed, BigInt(committee.length));
+        return committee[Number(proposerIndex)];
+    }
+    getProposerFromEpochCommittee(epochCommitteeInfo, slot) {
+        if (!epochCommitteeInfo.committee || epochCommitteeInfo.committee.length === 0) {
+            return undefined;
+        }
+        const proposerIndex = this.computeProposerIndex(slot, epochCommitteeInfo.epoch, epochCommitteeInfo.seed, BigInt(epochCommitteeInfo.committee.length));
+        return epochCommitteeInfo.committee[Number(proposerIndex)];
+    }
+    /** Check if a validator is in the given slot's committee */ async isInCommittee(slot, validator) {
+        const { committee } = await this.getCommittee(slot);
+        if (!committee) {
+            return false;
+        }
+        return committee.some((v)=>v.equals(validator));
+    }
+    /** From the set of given addresses, return all that are on the committee for the given slot */ async filterInCommittee(slot, validators) {
+        const { committee } = await this.getCommittee(slot);
+        if (!committee) {
+            return [];
+        }
+        const committeeSet = new Set(committee.map((v)=>v.toString()));
+        return validators.filter((v)=>committeeSet.has(v.toString()));
+    }
+    async getRegisteredValidators() {
+        const validatorRefreshIntervalMs = this.config.validatorRefreshIntervalSeconds * 1000;
+        const validatorRefreshTime = this.lastValidatorRefresh + validatorRefreshIntervalMs;
+        const now = this.dateProvider.now();
+        if (validatorRefreshTime < now) {
+            const currentSet = await this.rollup.getAttesters(BigInt(Math.floor(now / 1000)));
+            this.allValidators = new Set(currentSet.map((v)=>v.toString()));
+            this.lastValidatorRefresh = now;
+        }
+        return Array.from(this.allValidators.keys()).map((v)=>EthAddress.fromString(v));
+    }
+}

package/dest/index.d.ts

@@ -0,0 +1,3 @@
+export * from './epoch_cache.js';
+export * from './config.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsYUFBYSxDQUFDIn0=

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dest/index.js

@@ -0,0 +1,2 @@
+export * from './epoch_cache.js';
+export * from './config.js';

package/dest/test/index.d.ts

@@ -0,0 +1,2 @@
+export * from './test_epoch_cache.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsdUJBQXVCLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dest/test/index.js

@@ -0,0 +1 @@
+export * from './test_epoch_cache.js';

package/dest/test/test_epoch_cache.d.ts

@@ -0,0 +1,91 @@
+import { EpochNumber, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import type { L1RollupConstants } from '@aztec-labs/stdlib/epoch-helpers';
+import { type EpochAndSlot, type EpochCacheInterface, type EpochCommitteeInfo, type SlotTag } from '../epoch_cache.js';
+/**
+ * A test implementation of EpochCacheInterface that allows manual configuration
+ * of committee, proposer, slot, and escape hatch state for use in tests.
+ *
+ * Unlike the real EpochCache, this class doesn't require any RPC connections
+ * or mock setup. Simply use the setter methods to configure the test state.
+ */
+export declare class TestEpochCache implements EpochCacheInterface {
+    private committee;
+    private proposerAddress;
+    private currentSlot;
+    private escapeHatchOpen;
+    private seed;
+    private registeredValidators;
+    private l1Constants;
+    private lagInEpochsForValidatorSet;
+    constructor(l1Constants?: Partial<L1RollupConstants>);
+    setLagInEpochsForValidatorSet(lag: number): this;
+    /**
+     * Sets the committee members. Used in validation and attestation flows.
+     * @param committee - Array of committee member addresses.
+     */
+    setCommittee(committee: EthAddress[]): this;
+    /**
+     * Sets the proposer address returned by getProposerAttesterAddressInSlot.
+     * @param proposer - The address of the current proposer.
+     */
+    setProposer(proposer: EthAddress | undefined): this;
+    /**
+     * Sets the current slot number.
+     * @param slot - The slot number to set.
+     */
+    setCurrentSlot(slot: SlotNumber): this;
+    /**
+     * Sets whether the escape hatch is open.
+     * @param open - True if escape hatch should be open.
+     */
+    setEscapeHatchOpen(open: boolean): this;
+    /**
+     * Sets the randomness seed used for proposer selection.
+     * @param seed - The seed value.
+     */
+    setSeed(seed: bigint): this;
+    /**
+     * Sets the list of registered validators (all validators, not just committee).
+     * @param validators - Array of validator addresses.
+     */
+    setRegisteredValidators(validators: EthAddress[]): this;
+    /**
+     * Sets the L1 constants used for epoch/slot calculations.
+     * @param constants - Partial constants to override defaults.
+     */
+    setL1Constants(constants: Partial<L1RollupConstants>): this;
+    getL1Constants(): L1RollupConstants;
+    getLagInEpochsForValidatorSet(): number;
+    getCommittee(_slot?: SlotTag): Promise<EpochCommitteeInfo>;
+    getSlotNow(): SlotNumber;
+    getTargetSlot(): SlotNumber;
+    getEpochNow(): EpochNumber;
+    getTargetEpoch(): EpochNumber;
+    getEpochAndSlotNow(): EpochAndSlot & {
+        nowMs: bigint;
+    };
+    getEpochAndSlotInNextL1Slot(): EpochAndSlot & {
+        nowSeconds: bigint;
+    };
+    getTargetEpochAndSlotInNextL1Slot(): EpochAndSlot & {
+        nowSeconds: bigint;
+    };
+    getProposerIndexEncoding(epoch: EpochNumber, slot: SlotNumber, seed: bigint): `0x${string}`;
+    computeProposerIndex(slot: SlotNumber, _epoch: EpochNumber, _seed: bigint, size: bigint): bigint;
+    getCurrentAndNextSlot(): {
+        currentSlot: SlotNumber;
+        nextSlot: SlotNumber;
+    };
+    getTargetAndNextSlot(): {
+        targetSlot: SlotNumber;
+        nextSlot: SlotNumber;
+    };
+    getProposerAttesterAddressInSlot(_slot: SlotNumber): Promise<EthAddress | undefined>;
+    getRegisteredValidators(): Promise<EthAddress[]>;
+    isInCommittee(_slot: SlotTag, validator: EthAddress): Promise<boolean>;
+    filterInCommittee(_slot: SlotTag, validators: EthAddress[]): Promise<EthAddress[]>;
+    isEscapeHatchOpen(_epoch: EpochNumber): Promise<boolean>;
+    isEscapeHatchOpenAtSlot(_slot?: SlotTag): Promise<boolean>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdF9lcG9jaF9jYWNoZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3QvdGVzdF9lcG9jaF9jYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQy9FLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBUTFFLE9BQU8sRUFDTCxLQUFLLFlBQVksRUFDakIsS0FBSyxtQkFBbUIsRUFDeEIsS0FBSyxrQkFBa0IsRUFFdkIsS0FBSyxPQUFPLEVBQ2IsTUFBTSxtQkFBbUIsQ0FBQztBQWMzQjs7Ozs7O0dBTUc7QUFDSCxxQkFBYSxjQUFlLFlBQVcsbUJBQW1CO0lBQ3hELE9BQU8sQ0FBQyxTQUFTLENBQW9CO0lBQ3JDLE9BQU8sQ0FBQyxlQUFlLENBQXlCO0lBQ2hELE9BQU8sQ0FBQyxXQUFXLENBQTZCO0lBQ2hELE9BQU8sQ0FBQyxlQUFlLENBQWtCO0lBQ3pDLE9BQU8sQ0FBQyxJQUFJLENBQWM7SUFDMUIsT0FBTyxDQUFDLG9CQUFvQixDQUFvQjtJQUNoRCxPQUFPLENBQUMsV0FBVyxDQUFvQjtJQUN2QyxPQUFPLENBQUMsMEJBQTBCLENBQUs7SUFFdkMsWUFBWSxXQUFXLEdBQUUsT0FBTyxDQUFDLGlCQUFpQixDQUFNLEVBRXZEO0lBRUQsNkJBQTZCLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxJQUFJLENBRy9DO0lBRUQ7OztPQUdHO0lBQ0gsWUFBWSxDQUFDLFNBQVMsRUFBRSxVQUFVLEVBQUUsR0FBRyxJQUFJLENBRzFDO0lBRUQ7OztPQUdHO0lBQ0gsV0FBVyxDQUFDLFFBQVEsRUFBRSxVQUFVLEdBQUcsU0FBUyxHQUFHLElBQUksQ0FHbEQ7SUFFRDs7O09BR0c7SUFDSCxjQUFjLENBQUMsSUFBSSxFQUFFLFVBQVUsR0FBRyxJQUFJLENBR3JDO0lBRUQ7OztPQUdHO0lBQ0gsa0JBQWtCLENBQUMsSUFBSSxFQUFFLE9BQU8sR0FBRyxJQUFJLENBR3RDO0lBRUQ7OztPQUdHO0lBQ0gsT0FBTyxDQUFDLElBQUksRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUcxQjtJQUVEOzs7T0FHRztJQUNILHVCQUF1QixDQUFDLFVBQVUsRUFBRSxVQUFVLEVBQUUsR0FBRyxJQUFJLENBR3REO0lBRUQ7OztPQUdHO0lBQ0gsY0FBYyxDQUFDLFNBQVMsRUFBRSxPQUFPLENBQUMsaUJBQWlCLENBQUMsR0FBRyxJQUFJLENBRzFEO0lBRUQsY0FBYyxJQUFJLGlCQUFpQixDQUVsQztJQUVELDZCQUE2QixJQUFJLE1BQU0sQ0FFdEM7SUFFRCxZQUFZLENBQUMsS0FBSyxDQUFDLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQVF6RDtJQUVELFVBQVUsSUFBSSxVQUFVLENBRXZCO0lBRUQsYUFBYSxJQUFJLFVBQVUsQ0FFMUI7SUFFRCxXQUFXLElBQUksV0FBVyxDQUV6QjtJQUVELGNBQWMsSUFBSSxXQUFXLENBRTVCO0lBRUQsa0JBQWtCLElBQUksWUFBWSxHQUFHO1FBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBWXJEO0lBRUQsMkJBQTJCLElBQUksWUFBWSxHQUFHO1FBQUUsVUFBVSxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBWW5FO0lBRUQsaUNBQWlDLElBQUksWUFBWSxHQUFHO1FBQUUsVUFBVSxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBS3pFO0lBRUQsd0JBQXdCLENBQUMsS0FBSyxFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsS0FBSyxNQUFNLEVBQUUsQ0FHMUY7SUFFRCxvQkFBb0IsQ0FBQyxJQUFJLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FLL0Y7SUFFRCxxQkFBcUIsSUFBSTtRQUFFLFdBQVcsRUFBRSxVQUFVLENBQUM7UUFBQyxRQUFRLEVBQUUsVUFBVSxDQUFBO0tBQUUsQ0FRekU7SUFFRCxvQkFBb0IsSUFBSTtRQUFFLFVBQVUsRUFBRSxVQUFVLENBQUM7UUFBQyxRQUFRLEVBQUUsVUFBVSxDQUFBO0tBQUUsQ0FRdkU7SUFFRCxnQ0FBZ0MsQ0FBQyxLQUFLLEVBQUUsVUFBVSxHQUFHLE9BQU8sQ0FBQyxVQUFVLEdBQUcsU0FBUyxDQUFDLENBRW5GO0lBRUQsdUJBQXVCLElBQUksT0FBTyxDQUFDLFVBQVUsRUFBRSxDQUFDLENBRS9DO0lBRUQsYUFBYSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBRXJFO0lBRUQsaUJBQWlCLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsRUFBRSxDQUFDLENBR2pGO0lBRUQsaUJBQWlCLENBQUMsTUFBTSxFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBRXZEO0lBRUQsdUJBQXVCLENBQUMsS0FBSyxDQUFDLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FFekQ7Q0FDRiJ9

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

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