@aztec/epoch-cache 0.0.1-commit.d431d1c → 0.0.1-commit.d939eb5aa

package/dest/test/test_epoch_cache.js

@@ -0,0 +1,198 @@
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import { getEpochAtSlot, getSlotAtTimestamp, getTimestampRangeForEpoch } from '@aztec/stdlib/epoch-helpers';
+import { PROPOSER_PIPELINING_SLOT_OFFSET } from '../epoch_cache.js';
+/** Default L1 constants for testing. */ const DEFAULT_L1_CONSTANTS = {
+    l1StartBlock: 0n,
+    l1GenesisTime: 0n,
+    slotDuration: 24,
+    epochDuration: 16,
+    ethereumSlotDuration: 12,
+    proofSubmissionEpochs: 2,
+    targetCommitteeSize: 48,
+    rollupManaLimit: Number.MAX_SAFE_INTEGER
+};
+/**
+ * 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 class TestEpochCache {
+    committee = [];
+    proposerAddress;
+    currentSlot = SlotNumber(0);
+    escapeHatchOpen = false;
+    seed = 0n;
+    registeredValidators = [];
+    l1Constants;
+    proposerPipeliningEnabled = false;
+    constructor(l1Constants = {}){
+        this.l1Constants = {
+            ...DEFAULT_L1_CONSTANTS,
+            ...l1Constants
+        };
+    }
+    /**
+   * Sets the committee members. Used in validation and attestation flows.
+   * @param committee - Array of committee member addresses.
+   */ setCommittee(committee) {
+        this.committee = committee;
+        return this;
+    }
+    /**
+   * Sets the proposer address returned by getProposerAttesterAddressInSlot.
+   * @param proposer - The address of the current proposer.
+   */ setProposer(proposer) {
+        this.proposerAddress = proposer;
+        return this;
+    }
+    /**
+   * Sets the current slot number.
+   * @param slot - The slot number to set.
+   */ setCurrentSlot(slot) {
+        this.currentSlot = slot;
+        return this;
+    }
+    /**
+   * Sets whether the escape hatch is open.
+   * @param open - True if escape hatch should be open.
+   */ setEscapeHatchOpen(open) {
+        this.escapeHatchOpen = open;
+        return this;
+    }
+    /**
+   * Sets the randomness seed used for proposer selection.
+   * @param seed - The seed value.
+   */ setSeed(seed) {
+        this.seed = seed;
+        return this;
+    }
+    /**
+   * Sets the list of registered validators (all validators, not just committee).
+   * @param validators - Array of validator addresses.
+   */ setRegisteredValidators(validators) {
+        this.registeredValidators = validators;
+        return this;
+    }
+    /**
+   * Sets the L1 constants used for epoch/slot calculations.
+   * @param constants - Partial constants to override defaults.
+   */ setL1Constants(constants) {
+        this.l1Constants = {
+            ...this.l1Constants,
+            ...constants
+        };
+        return this;
+    }
+    getL1Constants() {
+        return this.l1Constants;
+    }
+    setProposerPipeliningEnabled(enabled) {
+        this.proposerPipeliningEnabled = enabled;
+    }
+    getCommittee(_slot) {
+        const epoch = getEpochAtSlot(this.currentSlot, this.l1Constants);
+        return Promise.resolve({
+            committee: this.committee,
+            epoch,
+            seed: this.seed,
+            isEscapeHatchOpen: this.escapeHatchOpen
+        });
+    }
+    getSlotNow() {
+        return this.currentSlot;
+    }
+    getTargetSlot() {
+        return this.proposerPipeliningEnabled ? SlotNumber(this.currentSlot + PROPOSER_PIPELINING_SLOT_OFFSET) : this.currentSlot;
+    }
+    getEpochNow() {
+        return getEpochAtSlot(this.currentSlot, this.l1Constants);
+    }
+    getTargetEpoch() {
+        return getEpochAtSlot(this.getTargetSlot(), this.l1Constants);
+    }
+    isProposerPipeliningEnabled() {
+        return this.proposerPipeliningEnabled;
+    }
+    pipeliningOffset() {
+        return this.proposerPipeliningEnabled ? PROPOSER_PIPELINING_SLOT_OFFSET : 0;
+    }
+    getEpochAndSlotNow() {
+        const epochNow = getEpochAtSlot(this.currentSlot, this.l1Constants);
+        const ts = getTimestampRangeForEpoch(epochNow, this.l1Constants)[0];
+        return {
+            epoch: epochNow,
+            slot: this.currentSlot,
+            ts,
+            nowMs: ts * 1000n
+        };
+    }
+    getEpochAndSlotInNextL1Slot() {
+        const nowTs = getTimestampRangeForEpoch(getEpochAtSlot(this.currentSlot, this.l1Constants), this.l1Constants)[0];
+        const nextSlotTs = nowTs + BigInt(this.l1Constants.ethereumSlotDuration);
+        const nextSlot = getSlotAtTimestamp(nextSlotTs, this.l1Constants);
+        const epochNow = getEpochAtSlot(nextSlot, this.l1Constants);
+        const ts = getTimestampRangeForEpoch(epochNow, this.l1Constants)[0];
+        return {
+            epoch: epochNow,
+            slot: nextSlot,
+            ts,
+            nowSeconds: nowTs
+        };
+    }
+    getTargetEpochAndSlotInNextL1Slot() {
+        const result = this.getEpochAndSlotInNextL1Slot();
+        const offset = this.isProposerPipeliningEnabled() ? PROPOSER_PIPELINING_SLOT_OFFSET : 0;
+        const targetSlot = SlotNumber(result.slot + offset);
+        return {
+            ...result,
+            slot: targetSlot,
+            epoch: getEpochAtSlot(targetSlot, this.l1Constants)
+        };
+    }
+    getProposerIndexEncoding(epoch, slot, seed) {
+        // Simple encoding for testing purposes
+        return `0x${epoch.toString(16).padStart(64, '0')}${slot.toString(16).padStart(64, '0')}${seed.toString(16).padStart(64, '0')}`;
+    }
+    computeProposerIndex(slot, _epoch, _seed, size) {
+        if (size === 0n) {
+            return 0n;
+        }
+        return BigInt(slot) % size;
+    }
+    getCurrentAndNextSlot() {
+        const currentSlot = this.getSlotNow();
+        const next = this.getEpochAndSlotInNextL1Slot();
+        return {
+            currentSlot,
+            nextSlot: next.slot
+        };
+    }
+    getTargetAndNextSlot() {
+        const targetSlot = this.getTargetSlot();
+        const next = this.getTargetEpochAndSlotInNextL1Slot();
+        return {
+            targetSlot,
+            nextSlot: next.slot
+        };
+    }
+    getProposerAttesterAddressInSlot(_slot) {
+        return Promise.resolve(this.proposerAddress);
+    }
+    getRegisteredValidators() {
+        return Promise.resolve(this.registeredValidators);
+    }
+    isInCommittee(_slot, validator) {
+        return Promise.resolve(this.committee.some((v)=>v.equals(validator)));
+    }
+    filterInCommittee(_slot, validators) {
+        const committeeSet = new Set(this.committee.map((v)=>v.toString()));
+        return Promise.resolve(validators.filter((v)=>committeeSet.has(v.toString())));
+    }
+    isEscapeHatchOpen(_epoch) {
+        return Promise.resolve(this.escapeHatchOpen);
+    }
+    isEscapeHatchOpenAtSlot(_slot) {
+        return Promise.resolve(this.escapeHatchOpen);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/epoch-cache",
-  "version": "0.0.1-commit.d431d1c",
+  "version": "0.0.1-commit.d939eb5aa",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
@@ -26,11 +26,10 @@
     "../package.common.json"
   ],
   "dependencies": {
-    "@aztec/ethereum": "0.0.1-commit.d431d1c",
-    "@aztec/foundation": "0.0.1-commit.d431d1c",
-    "@aztec/l1-artifacts": "0.0.1-commit.d431d1c",
-    "@aztec/stdlib": "0.0.1-commit.d431d1c",
-    "@viem/anvil": "^0.0.10",
+    "@aztec/ethereum": "0.0.1-commit.d939eb5aa",
+    "@aztec/foundation": "0.0.1-commit.d939eb5aa",
+    "@aztec/l1-artifacts": "0.0.1-commit.d939eb5aa",
+    "@aztec/stdlib": "0.0.1-commit.d939eb5aa",
     "dotenv": "^16.0.3",
     "get-port": "^7.1.0",
     "jest-mock-extended": "^4.0.0",

package/src/config.ts

@@ -1,11 +1,17 @@
 import { type L1ContractsConfig, getL1ContractsConfigEnvVars } from '@aztec/ethereum/config';
 import { type L1ReaderConfig, getL1ReaderConfigFromEnv } from '@aztec/ethereum/l1-reader';
+import { type PipelineConfig, getPipelineConfigEnvVars } from '@aztec/stdlib/config';
 
 export type EpochCacheConfig = Pick<
-  L1ReaderConfig & L1ContractsConfig,
-  'l1RpcUrls' | 'l1ChainId' | 'viemPollingIntervalMS' | 'ethereumSlotDuration'
+  L1ReaderConfig & L1ContractsConfig & PipelineConfig,
+  | 'l1RpcUrls'
+  | 'l1ChainId'
+  | 'viemPollingIntervalMS'
+  | 'ethereumSlotDuration'
+  | 'l1HttpTimeoutMS'
+  | 'enableProposerPipelining'
 >;
 
 export function getEpochCacheConfigEnvVars(): EpochCacheConfig {
-  return { ...getL1ReaderConfigFromEnv(), ...getL1ContractsConfigEnvVars() };
+  return { ...getL1ReaderConfigFromEnv(), ...getL1ContractsConfigEnvVars(), ...getPipelineConfigEnvVars() };
 }